📝 Online Exam System
A desktop-based Online Exam System built with Python and CustomTkinter, designed for both students and administrators.
The system provides exam management, student accounts, timed examinations, result tracking, secure password handling, and optional webcam-based monitoring.
🚀 Features
👨💼 Admin Features
- Create and manage student accounts
- Edit and delete student accounts
- Create multiple exams
- Set exam title, duration, and pass mark
- Add, edit, and delete exam questions
- View students’ exam results
- Identify results below 50% for attention
👨🎓 Student Features
- Create a personal student account
- Browse available exams
- Take timed exams
- Navigate between questions
- Submit exams and receive results
- View personal exam history
- Receive improvement notices for scores below 50%
🔐 Security
- Passwords are not stored in plain text
- Password hashing uses PBKDF2-SHA256
- Each user receives a random salt
- No hardcoded administrator account
- First-run setup creates the administrator account
- Failed login attempts are throttled
📷 Optional Exam Monitoring
- Fullscreen exam mode
- Optional local webcam preview
- Focus-loss events are monitored during exams
- Webcam monitoring requires user consent
- No video is recorded or saved
Note: The monitoring system is designed as a classroom-level deterrent and is not intended to provide tamper-proof security.
🛠️ Technologies Used
- Python
- CustomTkinter — Modern desktop GUI
- SQLite / JSON-based application data
- OpenCV — Webcam access
- Pillow (PIL) — Image processing and camera preview
- hashlib — Secure password hashing
- secrets — Random security values
📂 Project Structure
Online-Exam-System/
│
├── online_exam_system.py
├── README.md
└── data/
└── Application data generated by the system
⚙️ Installation
1. Clone the repository
git clone https://github.com/your-username/online-exam-system.git
2. Navigate to the project
3. Install dependencies
pip install customtkinter opencv-python pillow
4. Run the application
python online_exam_system.py
🔑 First Run
When the application is launched for the first time, the system guides the administrator through the initial setup.
There is no hardcoded admin account. The administrator account is created through the application’s setup process.
📝 How It Works
Administrator
- Launch the application.
- Complete the first-run administrator setup.
- Log in to the admin dashboard.
- Create student accounts or manage existing students.
- Create an exam.
- Configure the exam title, duration, and pass mark.
- Add questions and answer choices.
- Review submitted exam results.
Student
- Create a student account.
- Log in to the application.
- Select an available exam.
- Read the exam instructions.
- Start the timed examination.
- Answer the questions.
- Submit the exam.
- Review the result and previous exam history.
⏱️ Exam System
During an exam, students can:
- View the current question
- Select from multiple-choice answers
- Move between questions
- Track exam progress
- See the remaining time
- Submit the exam when finished
When monitoring is enabled, the exam can run in fullscreen mode while the application displays a local webcam preview and tracks focus-loss events.
🔒 Password Security
The application uses PBKDF2-SHA256 with a randomly generated per-user salt instead of storing passwords as plain text. Repeated failed login attempts are also throttled.
📷 Privacy
The webcam feature provides a local live preview only.
The project does not record or save webcam video to disk.
🎯 Project Goals
This project was developed to demonstrate practical skills in:
- Python application development
- GUI development
- Object-oriented programming
- User authentication
- Password security
- Exam and question management
- Timed application workflows
- Result processing
- Webcam integration
- Event handling
- Building a complete desktop application
👨💻 Author
Ziad Sayed Ahmed (Zico)
📧 Email: z.hamzawyyy@gmail.com
📌 Disclaimer
This project is intended for educational and demonstration purposes.
The optional proctoring functionality provides basic classroom-level monitoring and should not be considered a secure or tamper-proof examination proctoring solution.