QuizAI Teacher (mobile)

Empowering Educators with AI-Driven Classroom Management

QuizAI Teacher is the Android companion app for the QuizAI V2 platform. It mirrors the teacher-facing features of the web app and adds camera-based answer-sheet scanning, making it ideal for classrooms where students take printed quizzes and the teacher wants to grade them on the spot.

Send us an email to download from Google Play Store while the app is pending public availability.

📖 New to QuizAI? Start with the Teacher How-To Guide — a plain-language walkthrough of the four ways to run a quiz, from live sessions to AutoQuiz answer keys.

✨ Features

🔐 Authentication

  • Google Sign-In using your school's educational account.
  • Local password fallback — sign in with the email/ID + password managed by your Institution's QuizAI admin if Google SSO is not available.
  • Biometric session unlock — Fingerprint / Face ID gating, backed by the Android Keystore. Bearer tokens are stored via FlutterSecureStorage.
  • Signed-out by default after uninstall — sensitive data is excluded from cloud backups.

📅 Classes & rosters

  • View schedules synced from the ACCESS School Management System.
  • Add a class with the button at the bottom of the classes list — manual classes live alongside the SIS-synced ones (which the sync continues to own).
  • Edit class details (subject description, code number, units, meeting days / time / room) from a bottom-sheet editor.
  • Per-class actions menu (⋮) — create an AutoQuiz on the bubble matrix, scan a master answer sheet, or jump straight to the class's quizzes.
  • Add or remove students from a class roster without round-tripping through ACCESS. Student IDs are digits-only (they must fit the OMR answer sheet's bubble matrix).

✨ AutoQuiz — a quiz from just its answer key

  • Create a quiz for a class without typing a single question, two ways:
    • Scan a master answer sheet — the answer key with the correct bubbles shaded, captured with the same camera overlay as student sheets. The server parses it in the background and notifies you when the quiz is ready.
    • Build the key on a bubble matrix — 40 rows presented (add more in batches), tap the correct option per item, add a description, and press Finalize. Only items with a shaded option are included — they form the score denominator.
  • The result is a draft quiz named QuizAI-<reference number> with blank placeholder questions and options; only the correct letters are set. Fill in the text before publishing, or use it as-is for paper-only scoring.
  • Answer Key screen — the parsed key rendered as a large bubble matrix (one row per item, correct option shaded). Until the first answer sheet is scanned you can: tap an option to set or change the key (the bubble shades lightly, then fully once saved), slide a row right to delete it, long-press and drag to re-arrange, append blank items, and edit the description (auto-saved when the field loses focus).
  • AutoQuizzes are asynchronous only with sequential item order; questionnaires are managed internally (the single answer key is the scoring reference). Once an answer sheet is processed, the quiz definition is frozen and the quiz can no longer be deleted; before that, deleting an AutoQuiz removes its questions, options, and key for real.

📝 Quiz authoring

  • Create / edit / publish multiple-choice quizzes.
  • Edit or delete questions in place — questions already captured on scanned answer sheets are locked (a "N scans" badge explains why), so historic scores stay reproducible. Duplicate the quiz to revise a locked question.
  • Default and per-question timer overrides.
  • Optional question randomization per session.
  • View generated questionnaires (each carries a unique reference code printed on the answer sheet) and launch them in presentation mode. Deleting a questionnaire is done from the web app, where the PDF and answer-sheet impact can be reviewed first.

📷 Answer-sheet scanning (OMR)

  • Capture pages with the device camera or pick from the gallery.
  • Scan from the quiz (Scan sheets on any quiz card) — every upload is bound to that quiz, so a missing, smudged, or improperly set reference number on the sheet can never send a score to the wrong quiz. The server falls back to the quiz's own answer key whenever the printed code is unusable.
  • Two parsing modes, switchable in Settings → OMR Scanning:
    • Server OMR (default) — the photo is uploaded to the server, which runs the full pipeline and supports every sheet version (incl. >60 items).
    • Device OMR — the answer sheet is parsed entirely on the phone; only the extracted answers leave the device. Uses the default 60-item / 7-digit-SID layout. Works offline (modulo eventual upload of the audit copy).
  • Outbox queue — your scan is never lost. The captured image is cached locally before the upload is attempted. If the upload succeeds, the cached copy is removed and you see "Successfully queued for processing". If anything goes wrong — no signal, slow network, server busy, or a stale session — the scan stays safely in the queue with a clear status message:
    • "No connection — saved to queue"
    • "Server busy — saved to queue"
    • "Session expired — saved to queue. Sign in again to upload."
    • "Upload rejected (HTTP 4xx) — saved to queue"
  • Auto-retry cascade. When any single upload succeeds, every other queued scan retries automatically in the background. You can also tap Retry all in the queue panel, or retry one item at a time.
  • Auto-send toggle. With Auto-send scans off (Settings → OMR Scanning), every capture goes straight to the queue and you upload manually when ready — useful for batch scanning a stack of papers in the field.
  • No surprise logout. A stale-session 401 from a scan upload no longer kicks you back to the sign-in screen — the scan is preserved in the queue and the session is only torn down when another action (loading the dashboard, viewing results, …) confirms the session is genuinely revoked.
  • Camera framing aid. The viewfinder draws four corner reticles where the printed registration marks should land, so even hand-held captures stay within the OMR pipeline's tolerance. Every capture is automatically cropped to the marker region before upload, and a brief "Sheet captured" confirmation appears per shot.
  • Live Alignment (experimental, Settings → Live Alignment). Three independent opt-in tiers:
    1. Live marker check — the corner reticles tint red / amber / green in real time as each printed registration mark is detected.
    2. Auto-capture on lock — the shutter fires by itself once all four markers stay green for ~0.8 s (requires tier 1).
    3. On-device perspective warp — captured stills are rectified to the canonical sheet geometry on the phone before upload, in every mode.
  • Pending Scans (dashboard tile) — see every sheet still queued or processing on the server, with status, error messages, and a thumbnail viewer, so nothing disappears into a black box after capture.
  • Results sync back into the same scan history visible on the web, including the Review console for in-place corrections.

🔔 In-app notifications

  • While the app is open it checks the server for one new notification at a time — a parsed master sheet (with the new quiz's reference number and item count) or a scored student answer sheet (with the student's name and score).
  • Notifications appear as a centered dialog with a Close button; the next one is fetched a full interval after you close the current one, so they never stack.
  • The check interval is adjustable in Settings → Notifications (5–60 seconds, default 15). Each notification is delivered exactly once — the server marks it received as it hands it out.

🎤 Live-quiz presentation mode

  • Pick a printed questionnaire and start the live session — the same state row drives the web teacher console and every joined student device, so you can switch between mobile and web mid-class.
  • Question Picker — push any specific question to all students by tapping it; the picker labels are the printed item numbers, so live Q-N matches what students see on their answer sheet.
  • Live submission counter and per-student answered indicator.

📊 Results

  • Per-quiz results with score, score-distribution, and per-student breakdown — each row shows the student's ID with their name appended when the account is known (e.g. "20240001 · Dela Cruz, Juan").
  • Online sessions and OMR-scanned sheets are merged into one list, deduplicated per student using the same precedence as the web app.
  • Item analysis (when the quiz is closed) — discrimination and difficulty indices per question.

⚙️ Settings & profile

  • Edit Profile (Settings → Edit Profile) — update display name, email address, or password without leaving the app.
    • If your account uses Google Sign-In only (no password set), you must set a password before changing your email to avoid being locked out. The app prompts you for one automatically.
    • Changing email on an SSO-linked account disconnects Google Sign-In and shows a confirmation dialog before saving.
  • OMR scanning toggles: auto-send scans, upload original image, and Skip on-device OMR (upload the raw photo and let the server do everything).
  • Live Alignment toggles (live marker check, auto-capture on lock, on-device perspective warp) — all off by default.
  • Notification check interval (5–60 seconds, default 15).
  • Biometric unlock opt-in / opt-out.
  • Theme selection (light / dark / system).

🩺 Diagnostics & logging

  • The app reports diagnostic events (sign-in outcomes, network errors, and unexpected crashes) to the server so your institution's QuizAI admin can troubleshoot issues from the web Mobile Logs page — no tethered device or adb logcat required.
  • Reporting is best-effort and fire-and-forget: it never blocks what you're doing, and events are buffered and retried if the network is unavailable.
  • No secrets are logged. Tokens, passwords, and sign-in credentials are never included in diagnostic events (and the server strips known credential fields defensively as a second line of defence).

🌗 UX

  • Light, dark, and system-following themes.
  • Materialize-aligned visual language for parity with the web app.

🛡️ Privacy & permissions

  • Camera — requested only when scanning answer sheets. The optional Live Alignment feature analyzes preview frames on the device only; preview frames are never uploaded.
  • Storage / media access — requested only when picking images from the gallery.
  • Biometric — optional, opt-in.
  • Internet — required for all API calls (HTTPS only).
  • Diagnostics — anonymous-by-default operational events (sign-in outcomes, network/crash errors) are sent to your institution's QuizAI server for troubleshooting. No credentials or answer-sheet images are included.
  • No location, no advertising IDs.

Full privacy notice: Teacher Mobile · Privacy Policy.

📬 Support

Developed by ACCESS Software Solutions. info@accessph.net · https://accessph.net