Skip to content

atmarquez/exam-web

Repository files navigation

Language: English | Español

📝 Exam‑Web by Naidel

License Python Platform Backend Status Release GitHub repo size Last commit GitHub Pages Website Documentation

Exam‑Web is a desktop application for Windows that allows you to manage and run a local web‑based exam server, designed for training, self‑assessment and exam simulation.

The project separates server control (Windows GUI) from the exam experience (web interface), providing a clean, flexible and reusable study tool.


🚀 Features

🖥️ Windows Desktop Control

  • Start and stop the web exam server
  • Select question database (Excel, Access or SQLite)
  • Configure port and protocol (HTTP / HTTPS)
  • Optional TLS configuration for HTTPS
  • Auto‑start server
  • Minimize to system tray
  • Integrated live log console
  • Persistent configuration (config.json)

🌐 Web Exam Interface

  • Multiple‑choice questions
  • Answer randomization
  • Per‑question and session timers
  • Progressive visual alerts
  • Session and global statistics
  • Question review flags
  • Access to glossary, graphics and annotations
  • Calculator and database viewer

🧱 Supported Data Sources

  • ✅ Microsoft Excel (.xls, .xlsx, .xlsm)
  • ✅ Microsoft Access (.mdb, .accdb)
  • ✅ SQLite (.db, .sqlite)

The data source is detected automatically.


🛠️ Technologies Used

  • Python 3
  • Tkinter (desktop GUI)
  • Flask (web server)
  • Werkzeug (embedded WSGI server)
  • pystray (system tray)
  • Pillow (images)
  • HTML / CSS / JavaScript

▶️ How to Run (development)

python main.py

📦 Building the Windows Executable

The project is designed to be packaged with PyInstaller.

pyinstaller main.spec

📄 License

This project is licensed under the GNU General Public License v3.0 or later (GPL‑3.0‑or‑later).


❤️ Support the Project

👉 https://paypal.me/atmarquez

© 2024–2026 Antonio Teodomiro Márquez Muñoz (Naidel)


🌐 Documentation

The official documentation is available at:

👉 https://atmarquez.github.io/exam-web/


🧠 Designed for study, practice and real‑exam simulation.

About

Exam‑Web es una aplicación de escritorio para Windows que permite gestionar y lanzar un servidor web de exámenes de forma sencilla, flexible y local.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages