QuizScanner 3.1.0

Największe wydanie od początku projektu — wzory matematyczne, motywy, dźwięki i pełne raporty po lekcji. Zawiera wszystko z pominiętej wersji 3.0.0.

🧮 Wzory matematyczne

Dwie drogi, obie z jednego przybornika w edytorze:

• Symbole Unicode w sześciu sekcjach: podstawowe (± × ÷ ≤ ≥ ≈), potęgi i ułamki (² ³ ⁿ √ ½), greka (α β π Δ Σ), zbiory i logika (∈ ⊂ ∪ ∀ ⇒ ℝ), geometria (∠ ⊥ ∥ △ ≅), analiza (∑ ∏ ∫ ∂ lim).
• LaTeX renderowany przez KaTeX — wzór zamykasz w dolarach:

  Ile wynosi $\frac{1}{2} + \frac{1}{4}$ ?
  Pole koła: $\pi r^2$,  granica: $\lim_{x \to 0} \frac{\sin x}{x}$
  $$\begin{cases} x + y = 2 \\ x - y = 0 \end{cases}$$
  

  Gotowe szablony: ułamek piętrowy, pierwiastek stopnia n, całka z granicami, suma, granica, symbol Newtona, wektor, układ równań, macierz. Podwójne dolary dają wzór wyśrodkowany.

Szablony działają na zaznaczeniu — zaznacz x+1, kliknij √( ), wychodzi √(x+1). Przyciski x² / x₂ zamieniają zaznaczenie na indeks górny lub dolny. Pod przybornikiem jest podgląd na żywo: widzisz dokładnie to, co pojawi się na tablicy, a błąd składni świeci się od razu.

KaTeX razem z czcionkami siedzi w repozytorium i w pliku .exe (~600 kB) — nic nie pobiera się z internetu, aplikacja dalej działa w pełni offline.

🎨 Siedem motywów, ciemny domyślnie

Ciemny · Jasny · Ocean · Las · Zachód słońca · Cukierkowy · Wysoki kontrast

Wybór z listy w panelu lub edytorze przebiera od razu także tablicę — również wtedy, gdy tablica stoi na drugim komputerze przy rzutniku. Do jasnej sali najlepszy jest Wysoki kontrast.

🔊 Dźwięki tablicy

Sygnał startu pytania, ciche odliczanie w ostatnich pięciu sekundach (ostatnia wyżej), koniec czasu, fanfara przy wyniku i na podium. Generowane w przeglądarce — zero plików audio. Przełącznik i suwak głośności w panelu.

📊 Raport po lekcji

Nowy przycisk „📊 Raport": ranking, skuteczność każdego ucznia, odpowiedź na każde pytanie (kolumny P1, P2, …), rozkład A/B/C/D i wskazanie najtrudniejszego pytania.

Format	Do czego
PDF	wydruk, teczka wychowawcy
XLSX	dziennik, przeliczanie na oceny
CSV	import gdzie indziej (Excel otwiera bez kreatora)
HTML	podgląd i wydruk przez Ctrl+P
JSON	własne zestawienia i skrypty
TXT	szybki podgląd, wklejenie do wiadomości

Po ostatnim pytaniu komplet HTML + CSV + JSON zapisuje się sam do data/raporty/. W raportach wzory zapisywane są tekstem ($\frac{1}{2}$ → (1)/(2)), a pełny LaTeX zostaje w eksporcie JSON.

⬆️ Automatyczna aktualizacja

Program przy starcie pyta GitHuba o najnowsze wydanie. Gdy jest nowsze, u góry panelu pojawia się pasek — jedno kliknięcie pobiera plik, a podmiana dzieje się przy zamykaniu programu. Sprawdzanie można wyłączyć; wtedy aplikacja nie wykonuje żadnych połączeń na zewnątrz.

🗂️ Porządek w plikach

• Kod w pakiecie quizscanner/, dokumentacja w docs/, skrypty w scripts/.
• Wszystkie Twoje dane w jednym folderze data/ obok programu: quizy, media, lista uczniów, raporty, ustawienia. Łatwiej skopiować i zarchiwizować, a aktualizacja tego folderu nie dotyka.
• Serwer ze źródeł uruchamia się przez python -m quizscanner (dawniej python app.py).

📖 Dokumentacja

• FAQ — ok. 45 pytań o karty, kamerę, wzory, raporty, prywatność i typowe kłopoty.
• Przebudowana strona repozytorium i CHANGELOG.
• python tools/selftest.py — szybkie sprawdzenie, czy wszystko działa: strony, API, karty PDF, cały przebieg quizu, wszystkie formaty raportu i kompletność tłumaczeń PL/EN.

📦 Instalacja

• Windows: pobierz QuizScanner-v3.1.0.exe, przenieś na Pulpit, kliknij dwukrotnie. Bez Pythona, bez instalacji.
• Linux / macOS: ./scripts/install.sh, potem ./start.sh.

Aktualizujesz z wersji 2.x? Twoje quizy i lista uczniów leżą obok starego programu — przenieś quizzes/ i students.csv do nowego folderu data/.

QuizScanner 2.0.1 — polskie znaki

Wydanie porządkujące teksty: pełne polskie znaki w całym projekcie.

Co zostało poprawione

W wersji 2.0 znaki diakrytyczne trafiły tylko do interfejsu i kart do druku.
Kod źródłowy, komunikaty programu, launcher i skrypty instalacyjne nadal były
zapisane bez ogonków — kontrola wykazała 506 takich miejsc w 23 plikach.

• 465 poprawek: komentarze, dokumentacja, komunikaty, opisy w wierszu poleceń
• Podgląd kamery — imiona uczniów rysowane są teraz przez PIL. Wcześniej
  "Zofia Zielińska" wyświetlała się jako znaki zapytania, bo OpenCV potrafi
  rysować wyłącznie znaki ASCII.
• build_exe.ps1 zapisany w UTF-8 z BOM (bez BOM PowerShell psuje polskie znaki)
• Konsola przełączana na UTF-8, żeby komunikaty nie wywracały programu
• Narzędzia kontrolne (tools/check_polish.py) pilnują, aby błąd się nie powtórzył

Pobranie (Windows)

Pobierz QuizScanner-v2.0.1.exe, przenieś na Pulpit i kliknij dwukrotnie.
Przy pierwszym uruchomieniu: "Więcej informacji" -> "Uruchom mimo to".

Wszystkie funkcje z wersji 2.0 pozostają bez zmian — testy 8/8 przechodzą.

QuizScanner 2.0

Duza aktualizacja: jezyki, tryb automatyczny, media w pytaniach i telefon jako kamera.

Nowosci

• Polskie znaki wszedzie - interfejs i karty do druku maja pelna polska
  diakrytyke (wczesniej "Obroc wybrana litere", teraz "Obroc wybrana litere"
  poprawnie z ogonkami).
• Jezyk polski i angielski - przelacznik w panelu; tablica przelacza sie sama.
• Tryb automatyczny - wciskasz Start i quiz prowadzi sie sam: odlicza czas,
  pokazuje wynik, przechodzi do nastepnego pytania, konczy rankingiem.
• Zdjecia i filmy w pytaniach - wgrywasz plik w edytorze, pokazuje sie na tablicy.
• Quiz jako plik do dzielenia sie - "Zapisz do pliku" tworzy plik .quiz razem
  z osadzonymi mediami; drugi nauczyciel wczytuje go jednym kliknieciem.
• Ustawienia quizu w edytorze - domyslny czas i punkty, losowa kolejnosc pytan
  i odpowiedzi, rozklad odpowiedzi, opoznienia trybu automatycznego.
• Telefon zamiast kamery - wpisujesz adres strumienia z aplikacji IP Webcam /
  DroidCam / Iriun. W panelu jest instrukcja krok po kroku.

Poprawki

• Mniej falszywych odczytow - skaner ignoruje kody spoza listy klasy oraz
  wzory bez wyraznego czarno-bialego kontrastu. W tescie mieszanej sceny:
  wykrycia 1,2,2,3,150,200,240 -> po filtrach zostaje dokladnie 1,2,3.
• Duzo szybszy interfejs - serwer uzywa HTTP/1.1 z trwalym polaczeniem;
  czas zapytania spadl z okolo 2000 ms do ponizej 1 ms.

Pobranie (Windows)

Pobierz QuizScanner-v2.0.0.exe, przenies na Pulpit, kliknij dwukrotnie.
Przy pierwszym starcie: "Wiecej informacji" -> "Uruchom mimo to".

Karty do druku

W aplikacji: edytor -> Uczniowie -> "Pobierz karty (PDF)".
Gotowy przyklad: karty_przykladowe_40.pdf ponizej.

QuizScanner 1.3 - naprawa skanera

System quizowy z odczytem odpowiedzi z kamery (markery ArUco) - darmowa alternatywa Plickers.

WAZNA POPRAWKA w 1.3

Skaner wykrywal tylko czesc kart (czesto tylko jedna). Przyczyna: detekcja
odbywala sie na obrazie odbitym lustrzanie, a markery ArUco nie sa symetryczne -
odbity wzor nie pasuje do slownika. Pomiar przed poprawka: wykrywane 2 karty z 12.
Teraz: 12 z 12.

Lustro nadal dziala w podgladzie (wygodne patrzenie), ale rozpoznawanie idzie
po oryginalnym obrazie. Zalecana aktualizacja dla kazdego.

Pobranie (Windows)

Pobierz QuizScanner-v1.3.0.exe, przenies na Pulpit, kliknij dwukrotnie.
Przy pierwszym starcie: "Wiecej informacji" -> "Uruchom mimo to" (program niepodpisany).

Karty do druku

• W aplikacji: edytor -> Uczniowie -> "Pobierz karty (PDF)".
• Gotowy przyklad: karty_przykladowe_40.pdf ponizej (40 kart o numerach 0-39).

Pelna instrukcja

INSTALACJA.md w repozytorium (Windows / Linux / macOS, zapora, kamera, problemy).

QuizScanner 1.2

System quizowy z odczytem odpowiedzi z kamery (markery ArUco) - darmowa alternatywa Plickers.

Nowosc w 1.2

• Logo aplikacji i spojna oprawa (favicon, naglowki paneli, ekran tablicy).
• Dopracowana strona repozytorium (README z logo, plakietkami, sekcja Funkcje).
• Licencja MIT.

Pobranie (Windows)

Pobierz QuizScanner-v1.2.0.exe, przenies na Pulpit, kliknij dwukrotnie.
Przy pierwszym starcie: "Wiecej informacji" -> "Uruchom mimo to" (program niepodpisany).

Karty do druku

• W aplikacji: edytor -> Uczniowie -> "Pobierz karty (PDF)".
• Gotowy przyklad: karty_przykladowe_40.pdf ponizej (40 kart o numerach 0-39).

Pelna instrukcja

INSTALACJA.md w repozytorium (Windows / Linux / macOS, zapora, kamera, problemy).

QuizScanner 1.1

System quizowy z odczytem odpowiedzi z kamery (markery ArUco) - darmowa alternatywa Plickers.

Nowosc w 1.1

• Przycisk "Pobierz karty (PDF)" w edytorze (zakladka Uczniowie): generuje
  karty do druku wprost z aplikacji, takze z pliku .exe. Nie trzeba juz Pythona
  do zrobienia kart.

Pobranie (Windows)

Pobierz QuizScanner-v1.1.0.exe, przenies na Pulpit, kliknij dwukrotnie.
Przy pierwszym starcie: "Wiecej informacji" -> "Uruchom mimo to" (program niepodpisany).

Karty do druku

• W aplikacji: edytor -> Uczniowie -> "Pobierz karty (PDF)".
• Gotowy przyklad: karty_przykladowe_40.pdf ponizej (40 kart o numerach 0-39).

Pelna instrukcja

INSTALACJA.md w repozytorium (Windows / Linux / macOS, zapora, kamera, problemy).

QuizScanner 1.0

System quizowy z odczytem odpowiedzi z kamery (markery ArUco) - darmowa alternatywa Plickers.

Pobranie (Windows)

Pobierz QuizScanner-v1.0.0.exe ponizej, przenies na Pulpit i kliknij dwukrotnie.
Nie trzeba instalowac Pythona ani niczego innego.
Przy pierwszym starcie: "Wiecej informacji" -> "Uruchom mimo to" (program niepodpisany).

Uwaga

To starsze wydanie. Nowsza wersja (z pobieraniem kart do druku w aplikacji)
jest dostepna jako Latest.

Pelna instrukcja

INSTALACJA.md w repozytorium.