maturita.c

Vzdělávací GTK 4 aplikace k přípravě na maturitu. / An educational GTK 4 app for the Czech maturita exam.

Česky · English

---

Česky

Rozhraní je v češtině a angličtině. Hotové jsou čtyři předměty; ostatní jsou zatím zamčené placeholdery. Aplikace se po instalaci aktualizuje sama.

Úvod	Předměty	Německá cesta

Instalace

Žádné releasy ani čísla verzí nejsou. CI po každém pushi na main uloží balíčky do větve builds. Instalátor samotnou aplikaci neobsahuje — při spuštění si dohledá aktuální commit větve builds a stáhne ten soubor, ne kešovanou kopii podle názvu větve.

Stáhni zip, rozbal ho a otevři instalátor. Nic víc (žádný Terminál):

Platforma	Soubor	Jak spustit
macOS (Apple Silicon)	maturita-installer-macos.zip	Rozbalit, pravý klik na Nainstalovat maturita.C → Otevřít
Windows (x64)	maturita-installer-windows.zip	Rozbalit a dvojklik; u SmartScreenu Další informace → Přesto spustit
Linux (x86_64)	maturita-installer-linux.zip	Rozbalit a dvojklik na instalátor
Android (8+)	maturita-installer-android.zip	Rozbalit, otevřít Stahnout maturita.C.html a nainstalovat APK (neznámé zdroje)
iOS (26+)	maturita-installer-ios.zip	Rozbalit, otevřít Jak nainstalovat maturita.C.html. Nejjednodušší: Xcode na Macu, nebo IPA přes AltStore

Kam se to nainstaluje: /Applications nebo ~/Applications (macOS), %LOCALAPPDATA%\Programs\Maturita (Windows), ~/Applications (Linux).

Buildy zatím nejsou notarizované (chybí Apple Developer ID), proto je při prvním spuštění potřeba výše uvedený krok navíc. Aplikace se pak udržuje sama: po startu porovná svůj commit se souborem VERSION ve větvi builds a aktualizaci nabídne v pruhu nahoře. Ruční kontrola je v Nastavení → Aktualizace.

Bez instalátoru

Na větvi builds jsou i hotové balíčky. Odkazy podle názvu větve umí CDN kešovat, proto je spolehlivější instalátor výše, nebo stažení přímo z té stránky větve:

• maturita-macos-arm64.zip
• maturita-windows-x64.zip
• maturita-linux-x86_64.AppImage
• maturita-android.apk
• maturita-ios.ipa

Postup a nastavení se ukládají vedle .app / složky / AppImage do progress/. Na Androidu a iOS do úložiště aplikace (stejné statistiky, témata a jazyk).

Intel Mac, jiná architektura nebo úpravy kódu → sestavení ze zdroje.

Co v aplikaci je

• Deutsch — 3 otevřené jednotky (Neue Freunde, Aus aller Welt, Bei uns zu Hause): cvičení, nápovědy, vokabeltraining
• Správa počítačových sítí — 1. ročník, 27 lekcí (VLSM + teorie a kvízy); ročníky 2–4 jsou zamčené
• Technické vybavení — 3 lekce (architektura, historie, bit/byte)
• Český jazyk a literatura — mluvnice (20 cvičení) a maturitní četba (1984, Spalovač mrtvol); literatura je zatím zamčená
• statistiky, hledání (lupa nebo Cmd/Ctrl+K), 10 témat, tmavý/světlý režim, čeština/angličtina
• ukončení: Cmd/Super+Q nebo Alt+F4

Použití

1. Pokračuj otevře mapu předmětů.
2. Otevřený předmět (vlajka, Wi‑Fi, čip, česká vlajka) vede na učební cestu.
3. Uzly cvičení / lekcí otevřou obsah; zamčené nic nedělají.
4. Hledat (lupa), Statistiky (graf) a Nastavení (ozubené kolo) jsou vpravo nahoře.

Sestavení ze zdroje

# macOS
brew install gtk4 gcc make pkg-config

# Debian / Ubuntu
sudo apt install build-essential pkg-config libgtk-4-dev

# Fedora
sudo dnf install gcc make pkgconf-pkg-config gtk4-devel

# Arch
sudo pacman -S base-devel pkgconf gtk4

git clone https://github.com/pepaskopec-blip/maturita.c.git
cd maturita.c
make
make run          # nebo ./maturita
make bundle       # AppImage / .app zip / Windows složka s DLL

Volitelně CMake: cmake -S . -B build && cmake --build build.

Na macOS make bundle automaticky vloží aktuální Git commit, aby fungovala kontrola aktualizací. Při balení ze zdrojů bez .git zadejte COMMIT=<zdrojový-commit> make bundle. Samotné make nadále vytváří vývojový build bez aktualizací.

Aby stažená aplikace na macOS šla otevřít bez potvrzení v Nastavení, CI potřebuje Apple Developer Program a GitHub Secrets:

• MACOS_CERTIFICATE — Developer ID Application .p12 v base64
• MACOS_CERTIFICATE_PASSWORD
• APPLE_API_KEY, APPLE_API_KEY_ID, APPLE_API_ISSUER — notarizace (nebo APPLE_ID + APPLE_APP_SPECIFIC_PASSWORD + APPLE_TEAM_ID)

Bez toho zůstane jen ad-hoc podpis a Gatekeeper stažený build zablokuje.

Windows (MSYS2 UCRT64, bez Visual Studia)

winget install --id MSYS2.MSYS2 -e --source winget
C:\msys64\ucrt64.exe pacman -S --noconfirm mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-gtk4 mingw-w64-ucrt-x86_64-pkg-config make

V terminálu MSYS2 UCRT64:

cd /c/Users/<jméno>/maturita.c  # C:\Users\<jméno>\maturita.c v MSYS2
make
./maturita.exe
make bundle                     # dist/maturita.exe jde spustit i z Průzkumníka

Struktura

src/                 C zdroje a maturita.h
android/             Jetpack Compose přehrávač (stejný obsah)
ios/                 SwiftUI přehrávač (stejný obsah)
data/                style.css, share/, podpisy, Windows .rc
assets/              zdrojová ikona a screenshoty
installers/          instalátory, které stáhnou aktuální build
scripts/             balení AppImage, .app, IPA a extract-android-content.py
.github/workflows/   CI: push na main → větev builds
progress/            vzniká za běhu (cvičení, nastavení)

Android ze zdroje (JDK 17 + Android SDK):

python3 scripts/extract-android-content.py
cd android
./gradlew :app:assembleRelease
# APK: android/app/build/outputs/apk/release/app-release.apk

nebo z kořene make android.

APK se podepisuje klíčem android/keystore/sideload.jks (není tajný – jde o sideload, ne o Google Play), aby aktualizace z aplikace šla nainstalovat přes předchozí build. Vlastní klíč lze dodat přes MATURITA_KEYSTORE a MATURITA_KEYSTORE_PASSWORD. Buildy android-5 a starší mají jiný podpis – jednou odinstalujte a nainstalujte znovu.

iOS ze zdroje (Xcode 26, iOS 26+ / Liquid Glass):

open Maturita.xcworkspace          # v kořeni repozitáře
# Simulátor: vyber iPhone a Run, nic dalšího není potřeba (obsah se
# vytáhne z C zdrojů při buildu). Na iPhone: v Signing vyber svůj Team.
# nebo: make ios   # unsigned IPA v dist-ios/maturita-ios.ipa

Workspace odkazuje na ios/Maturita.xcodeproj. Projekt nepřesouvejte – build čte ../src a ../scripts a v kořeni by Maturita/ kolidovalo se zkompilovaným binárem maturita.

Licence: GPL-3.0.

---

English

The UI is Czech and English. Four subjects are playable; the rest are locked placeholders. After install the app updates itself.

Welcome	Subjects	German path

Install

There are no releases and no version numbers. CI writes packages to the builds branch whenever main changes. The installer carries no app of its own — it fetches the current builds commit when you run it, not a CDN-cached copy of the branch-named file.

Download the zip, unzip it, and open the installer. No Terminal:

Platform	File	How to run
macOS (Apple Silicon)	maturita-installer-macos.zip	Unzip, right-click Nainstalovat maturita.C → Open
Windows (x64)	maturita-installer-windows.zip	Unzip and double-click; if SmartScreen appears, More info → Run anyway
Linux (x86_64)	maturita-installer-linux.zip	Unzip and double-click the installer
Android (8+)	maturita-installer-android.zip	Unzip, open Stahnout maturita.C.html, then install the APK (unknown sources)
iOS (26+)	maturita-installer-ios.zip	Unzip, open Jak nainstalovat maturita.C.html. Easiest: Xcode on a Mac, or the IPA via AltStore

Install locations: /Applications or ~/Applications (macOS), %LOCALAPPDATA%\Programs\Maturita (Windows), ~/Applications (Linux).

The builds are not notarized yet (no Apple Developer ID), so the first launch still needs the extra step above. After that the app stays current: it compares its commit to VERSION on builds and offers an update in a banner. Manual check: Settings → Updates.

Packages without the installer

The same files live on builds. Branch-named raw URLs can be cached by the CDN, so prefer the installer above, or download from that branch page:

• maturita-macos-arm64.zip
• maturita-windows-x64.zip
• maturita-linux-x86_64.AppImage
• maturita-android.apk
• maturita-ios.ipa

Progress and settings live in progress/ next to the .app / folder / AppImage. On Android and iOS they stay in app storage (same stats, themes, language).

Intel Mac, another architecture, or hacking on the code → build from source.

What’s inside

• Deutsch — 3 open units (Neue Freunde, Aus aller Welt, Bei uns zu Hause): exercises, hints, vocabulary training
• Computer networks — year 1, 27 lessons (VLSM + theory/quizzes); years 2–4 are locked
• Computer hardware — 3 lessons (architecture, history, bit/byte)
• Czech language — grammar (20 exercises) and required reading (1984, Spalovač mrtvol); literature theory is still locked
• statistics, search (magnifier or Cmd/Ctrl+K), 10 palettes, dark/light mode, Czech/English
• quit with Cmd/Super+Q or Alt+F4

Usage

1. Continue opens the subject map.
2. An open subject (flag, Wi‑Fi, chip, Czech flag) opens its path.
3. Exercise / lesson nodes open content; locked nodes do nothing.
4. Search (magnifier), Statistics (chart) and Settings (gear) sit in the top-right.

Build from source

# macOS
brew install gtk4 gcc make pkg-config

# Debian / Ubuntu
sudo apt install build-essential pkg-config libgtk-4-dev

# Fedora
sudo dnf install gcc make pkgconf-pkg-config gtk4-devel

# Arch
sudo pacman -S base-devel pkgconf gtk4

git clone https://github.com/pepaskopec-blip/maturita.c.git
cd maturita.c
make
make run          # or ./maturita
make bundle       # AppImage / .app zip / Windows DLL folder

Optional CMake: cmake -S . -B build && cmake --build build.

On macOS, make bundle embeds the current Git commit so the installed app can check for updates. When packaging a source export without .git, use COMMIT=<source-commit> make bundle. Plain make still produces a development build without updates.

Skipping Gatekeeper on a downloaded macOS build needs an Apple Developer Program membership and these GitHub Secrets:

• MACOS_CERTIFICATE — Developer ID Application .p12, base64-encoded
• MACOS_CERTIFICATE_PASSWORD
• APPLE_API_KEY, APPLE_API_KEY_ID, APPLE_API_ISSUER for notarization (or APPLE_ID + APPLE_APP_SPECIFIC_PASSWORD + APPLE_TEAM_ID)

Without them the bundle stays ad-hoc signed and Gatekeeper still blocks it.

Windows (MSYS2 UCRT64, no Visual Studio)

winget install --id MSYS2.MSYS2 -e --source winget
C:\msys64\ucrt64.exe pacman -S --noconfirm mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-gtk4 mingw-w64-ucrt-x86_64-pkg-config make

In an MSYS2 UCRT64 terminal:

cd /c/Users/<name>/maturita.c   # C:\Users\<name>\maturita.c in MSYS2
make
./maturita.exe
make bundle                     # dist/maturita.exe can be double-clicked

Layout

src/                 C sources and maturita.h
android/             Jetpack Compose player (same content)
ios/                 SwiftUI player (same content)
data/                style.css, share/, signing files, Windows .rc
assets/              source icon and screenshots
installers/          fetch-the-latest installers
scripts/             AppImage / .app / IPA bundlers and extract-android-content.py
.github/workflows/   CI: push to main → builds branch
progress/            created at runtime (exercises, settings)

Android from source (JDK 17 + Android SDK):

python3 scripts/extract-android-content.py
cd android
./gradlew :app:assembleRelease
# APK: android/app/build/outputs/apk/release/app-release.apk

or make android from the repo root.

The APK is signed with android/keystore/sideload.jks (not a secret – this is a sideloaded app, not a Play release) so in-app updates install over the previous build. Supply your own key through MATURITA_KEYSTORE and MATURITA_KEYSTORE_PASSWORD. Builds android-5 and older carry a different signature – uninstall once and install again.

iOS from source (Xcode 26, iOS 26+ / Liquid Glass):

open Maturita.xcworkspace          # at the repo root
# Simulator: pick an iPhone and Run, nothing else needed (content is
# extracted from the C sources during the build). Device: pick your Team.
# or: make ios   # unsigned IPA at dist-ios/maturita-ios.ipa

The workspace points at ios/Maturita.xcodeproj. Do not move the project – the build reads ../src and ../scripts, and at the root Maturita/ would collide with the compiled maturita binary.

License: GPL-3.0.