Skip to content

Interactive Java Swing quiz app for classroom use with student ID tracking, attempt limits, and results analytics. Built for UIU OOP Lab.

License

Notifications You must be signed in to change notification settings

litch07/quiz-master-java

Repository files navigation

Quiz Master

Java Swing License

A professional quiz application built with Java Swing for the Object-Oriented Programming Lab at United International University. Create questions, run quizzes, and track results with a clean, consistent UI.

Features

  • Interactive quiz flow with real-time score and progress
  • Student identity capture (name + ID)
  • Configurable max attempts per student
  • Results window with statistics, recent results, and leaderboard tabs
  • Question manager with validation (password protected)
  • Reset Data option to clear attempts and results

Tech Stack

Component Technology
Language Java 8+
GUI Swing
Storage Text files
Dependencies None

Prerequisites

  • Java Development Kit (JDK) 8+ (only needed to build from source)
  • Git (optional)

Getting Started

# Clone the repository
git clone https://github.com/litch07/quiz-master-java.git
cd quiz-master-java

# Compile all Java files
javac *.java

# Run the application
java Main

Windows Portable Build (Release Asset)

Download the Windows ZIP to run without installing Java. It includes a bundled runtime, the app JAR, and questions.txt. Just extract and run run.bat.

Usage Notes

  • Default teacher password: admin
  • Teacher can set max attempts in Settings (0 = no trials)
  • Results opens a window with tabs for Statistics, Recent Results, and Leaderboard
  • Reset Data clears attempts, results, and statistics (and resets max attempts to 1)

Question File Format

Each question uses 6 lines in questions.txt:

Question text
Option 1
Option 2
Option 3
Option 4
Correct option text

Blank lines may separate questions.

Project Structure

quiz-master-java/
+-- Main.java              # Entry point
+-- Dashboard.java         # Main navigation
+-- StartQuiz.java         # Quiz intro screen
+-- MainWindow.java        # Quiz interface
+-- ResultsWindow.java     # Results & grading
+-- QuestionManager.java   # Question CRUD
+-- Questions.java         # Data model
+-- questions.txt          # Question database
+-- .gitignore
+-- LICENSE
+-- README.md

License

This project is licensed under the MIT License. See the LICENSE file for details.

Author

Sadid Ahmed

About

Interactive Java Swing quiz app for classroom use with student ID tracking, attempt limits, and results analytics. Built for UIU OOP Lab.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages