Lesson management for music teachers: students, lessons, notes, pieces, recitals, metronome and tuning tone.
Qupil 2 is the complete rewrite of Qupil 1.x – from a Qt Widgets desktop program to Qt 6 / QML that runs on Windows, macOS, Linux, iPhone, iPad and Android from one code base.
Deutsch: Qupil ist die Unterrichtsverwaltung für Instrumentalpädagoginnen und -pädagogen. Qupil 2 läuft auf Desktop, Tablet und Handy und gleicht die Geräte per WLAN oder Nextcloud ab.
Status: testing. Nearly all features of 1.4.1 are in place, plus sync between devices; nightly test builds for every platform are on the nightly release. Until the first release, keep using Qupil 1.4.1 from qupil.de for daily work.
- Everything Qupil 1.4.1 does: students and lessons, timetable, lesson notes (also for group lessons), pieces with status, activities, instruments and rentals, sheet music library, recitals with programme and timing, recital and ensemble candidates, birthdays and reminders, metronome and tuning tone, PDF documents, CSV import
- One layout for every screen: tab bar on phones, sidebar + list + detail on tablets and desktops
- Sync between your devices over local Wi-Fi or Nextcloud/WebDAV, end-to-end encrypted, without a Qupil account
- Backups as a single database file, restorable on any device
- English, German, French and Spanish; light and dark mode that follow the system
Requirements: Qt 6.5 or later (6.8 LTS recommended) with Qt Quick, Qt Quick Controls and the Qt Linguist tools, CMake 3.21+, a C++17 compiler.
cmake -S . -B build -G Ninja -DCMAKE_PREFIX_PATH=/path/to/Qt/6.8.3/gcc_64
cmake --build build
ctest --test-dir build --output-on-failure
./build/qupilA self-contained copy with the Qt runtime: cmake --install build --prefix "$PWD/dist" (the prefix must be an absolute path).
For Android and iOS, configure with the qt-cmake of the mobile Qt kit and point QT_HOST_PATH to the desktop Qt of the same version. Android also needs OpenSSL for HTTPS (the Nextcloud sync): check out KDAB/android_openssl and pass -DQUPIL_ANDROID_OPENSSL=<that folder>. .github/workflows/mobile.yml shows the exact commands.
Every push and pull request is built on GitHub Actions:
| Workflow | What it does | Download |
|---|---|---|
| Desktop | Linux, Windows, macOS (universal): build, unit tests, QML smoke test (loads the UI, switches all languages and colour schemes, fails on any QML warning), package with Qt runtime; Windows installer, checked by installing, updating and uninstalling it; Microsoft Store package (MSIX), checked by installing it with a test certificate, starting it and uninstalling it (docs/microsoft-store.md) | Linux .tar.gz, macOS .zip, Windows Setup.exe (a newer one updates the installed Qupil) and .msix for the Store |
| Mobile | Android arm64 APK signed with a public test key (installs as an update over older test builds); iOS device build without signing | test APK, unsigned IPA |
| TestFlight | Started by hand: iOS App Store archive with Xcode 26, checks (bundle ID, build number, icon, launch screen, privacy manifest), signed in Apple's cloud and uploaded to TestFlight; needs the App Store Connect secrets listed in testflight.yml |
– (TestFlight app) |
| Translations | TS files match the catalog, placeholders and plurals consistent, every string translated | – |
Downloads are on the run's page under Artifacts and are kept for 30 days. The desktop builds are not code-signed, so macOS Gatekeeper and Windows SmartScreen warn; Qupil from the Microsoft Store is signed by Microsoft.
qml/ user interface (Main.qml, Theme.qml, pages/)
src/ C++ (main.cpp, core/ with LanguageManager)
i18n/ qupil_en/de/fr/es.ts – generated, see docs/i18n.md
tools/i18n/ string catalog (single source of truth) and generators
tools/icons/ renders all app icons from the logo (assets/icons/*.svg)
assets/ font (Figtree), logo and app icons, the alert sounds of Qupil 1.x
platform/ platform files (Windows icon, Linux desktop entry and start scripts, iOS/Android icons and localisation,
Android alarms and notifications)
tests/ unit tests
docs/ developer documentation
English is the source language. German keeps the wording of Qupil 1.4.1; French and Spanish are new. All texts live in tools/i18n/catalog.py; the TS files are generated from it. Details and how to add a language: docs/i18n.md.
Copyright © 2006–2026 Felix Hammer.
Qupil is free software under the GNU General Public License v3.0 or later with an additional permission for app stores (GPLv3 section 7): anyone may distribute Qupil through app stores as long as the complete source code stays freely available.
The Figtree font is © The Figtree Project Authors, SIL Open Font License 1.1. Qt is used under the LGPLv3.
Contributions are welcome – see CONTRIBUTING.md.