KiMu-Dienste

Kirchenmusikalische Dienste erfassen, verwalten und exportieren – auf Smartphone, Tablet und Desktop.

Version 2.0.0-dev.1 · Stand 16. 7. 2026

Beschreibung

  1. Es ist früh am Sonntag. Alles ist vorbereitet für den Gottesdienst. Alles? Wo ist der Zettel, auf dem man seinen Gottesdiensteinsatz notieren kann? Schon das letzte Mal war keiner da und so langsam verliert man den Überblick, was noch nachzutragen ist. Vielleicht könnte da eine App auf dem eigenen Smartphone oder iPhone helfen.
  2. Stummschalten muss man es vor Beginn des Gottesdienstes sowieso. Also gleich noch die App KiMu-Dienste gestartet, Kirchengemeinde aus der Liste ausgewählt, dann noch die Art des Gottesdienstes aus der dritten Liste. Beim Tippen in das Datumsfeld wird das aktuelle Datum eingetragen. Ebenso wird die aktuelle Uhrzeit in das Feld zum Gottesdienstbeginn eingetragen.
    Nach dem Ende des Orgelnachspieles noch in das Uhrzeitfeld Gottesdienstende tippen. Speichern – und Fertig. Und schon kann es zum nächsten Gottesdienst gehen.
  3. Das Ganze hat vielleicht 10-15 Sekunden in Anspruch genommen. Die Dienste sind auf dem Smartphone gespeichert und können zum Monats-/Jahresende als PDF- oder EXCEL-Datei exportiert bzw. ausgedruckt werden.
  4. Sollte irgendein Eintrag falsch ausgewählt worden sein – kein Problem: Man kann den Diensteinsatz auch noch nachträglich bearbeiten und auch wieder löschen. Und natürlich ist es möglich, Diensteinsätze nachzutragen.
  5. Nachträglich bearbeiten: Fehler passieren – Einträge lassen sich jederzeit ändern oder löschen. Auch Nachträge sind kein Problem.
Startbildschirm KiMu-Dienste

Editionen

KiMu-Dienste gibt es in drei Ausführungen. Die Edition wird beim Bauen der App festgelegt und bestimmt, welche Funktionen verfügbar sind.

Free

Einsteigerversion

Komplett offline – alle Daten lokal auf dem Gerät. Kein Login, kein Server.

  • Benutzer, Gemeinden, Vergütungssätze verwalten
  • Dienste erfassen und bearbeiten
  • Excel-Export, PDF-Sulzbach-Export
  • Datensicherung: Alle Daten werden exportiert/importiert
  • SQLite-Datenbank (Drift)
Gemeinde

Für eine Kirchengemeinde

Wie Free, aber mit Passwort-Login (PBKDF2) und Datenisolation pro Benutzer.

  • Setup-Assistent nach Login (wenn keine eigenen Daten vorhanden)
  • Admin-Benutzerverwaltung (anlegen, deaktivieren, löschen)
  • Hilfe-Dialog auf Anmelde- und Registrierungsseite
  • Ladebalken während des Login-Vorgangs
  • Mehrere Benutzer auf einem Gerät
  • Jeder Nutzer sieht nur seine Daten (owner_id)
  • Admin sieht alle Daten
  • Passwort-Sicherheit (20k Iterationen SHA-512, legacy-kompatibel)
  • Daten weiterhin lokal (SQLite)
  • Lizenz-System (KMD-Key oder 30-Tage-Testphase)
  • Datensicherung: Admin exportiert/importiert alle Daten, User nur eigene
Premium

Zentrale Serverlösung

Für Kirchenbezirke und Dekanate mit zentralem Server (Dart/Shelf + MariaDB).

  • Server-Client-Architektur mit JWT-Auth
  • MariaDB als zentrales Backend
  • Mehrere Nutzer gleichzeitig
  • Daten immer synchron und gesichert
  • Erfordert eigenen Server (Linux + Dart)
  • Clients: Android, iOS, Linux, Windows, macOS, Web
  • Datensicherung: Admin exportiert/importiert alle Daten, User nur eigene

Premium-Architektur

Premium trennt die App in einen Client (auf dem Gerät des Nutzers) und einen zentralen Server. Alle Plattformen kommunizieren über HTTP/HTTPS mit demselben Backend. Daten werden nicht lokal, sondern zentral in einer MariaDB gespeichert.

Clients
A Android
i iOS
L Linux
W Windows
M macOS
W Web (Browser)
→
HTTP/HTTPS
JSON + JWT
→
Server
S KiMu-Server
Dart / Shelf + JWT
→
SQL
D MariaDB
Zentrale Datenbank

Android / iOS / macOS benötigen eine explizite Netzwerkberechtigung. Diese ist in den Builds ab v2.0.0-dev.1 bereits vorkonfiguriert (INTERNET-Permission bzw. NSAppTransportSecurity-Ausnahme).

Web greift per HTTPS auf den Server zu. Der Server sendet CORS-Header (Access-Control-Allow-Origin: *), damit die Web-App von jeder Domain aus zugelassen wird.

Linux / Windows benötigen keine besondere Konfiguration – HTTP/HTTPS funktioniert systembedingt.

Server-Installation erfordert einen Linux-Rechner mit Dart-Runtime und MariaDB. Details: Server-Installation.

Downloads

Wähle deine Edition und Plattform. Jede Edition wird als eigenständige App ausgeliefert.

★
Android
ab Android 7.0 · APK + AAB
Free 16. 7. 2026
Universal arm64 arm32 x86_64 AAB
Gemeinde 16. 7. 2026
Universal arm64 arm32 x86_64 AAB
Premium 16. 7. 2026
Universal arm64 arm32 x86_64 AAB
  1. Lade die passende APK-Datei herunter (Universal-APK für die meisten Geräte).
  2. Öffne die heruntergeladene Datei aus der Benachrichtigungsleiste oder dem Download-Ordner.
  3. Falls die Meldung Installation aus unbekannten Quellen blockiert erscheint, tippe auf Einstellungen und erlaube die Installation für die Dateiverwaltung oder den Browser.
  4. Tippe auf Installieren.
  5. Nach der Installation kannst du die App öffnen.

Hinweis: Universal-APK läuft auf allen Geräten. Die architekturspezifischen APKs (arm64, arm32, x86_64) sind kleiner und werden für die jeweilige CPU optimiert.

Premium: Die Android-App besitzt die INTERNET-Berechtigung und usesCleartextTraffic für HTTP-Server im lokalen Netzwerk. Bei HTTPS entfällt Letzteres.
⌕
Linux
Ubuntu 22.04+ · .deb · AppImage · tar.xz
Free 16. 7. 2026
.deb AppImage tar.xz
Gemeinde 16. 7. 2026
.deb AppImage tar.xz
Premium 16. 7. 2026
.deb AppImage tar.xz

.deb (Debian / Ubuntu / Linux Mint):

sudo dpkg -i kimu-dienst_2.0.0-dev.1_free_amd64.deb

AppImage (alle Distributionen):

chmod +x kimu_dienst_2.0.0-dev.1_free_amd64.AppImage
./kimu_dienst_2.0.0-dev.1_free_amd64.AppImage

tar.xz (portabel):

tar xf kimu_dienst_2.0.0-dev.1_free_amd64.tar.xz
./kimu_dienst
Premium: Keine Netzwerkkonfiguration nötig – HTTP/HTTPS funktioniert unter Linux systemweit.
🌐
Web
Online starten · oder offline nutzen
Free 16. 7. 2026
Web-App starten Offline-Paket
Gemeinde 16. 7. 2026
Web-App starten Offline-Paket
Premium 16. 7. 2026
Web-App starten Offline-Paket

Online: Klicke auf einen der Web-App starten-Links und verwende die App direkt im Browser. Die Daten werden lokal im Browser gespeichert (Free/Gemeinde) oder auf dem Server (Premium).

Offline: Lade das Offline-Paket herunter, entpacke es und öffne die Datei index.html im Browser.

Premium (CORS): Der Server sendet Access-Control-Allow-Origin: *. Die Web-App kann daher von jeder Domain auf den Server zugreifen. Bei HTTPS müssen Zertifikate vertrauenswürdig sein.
⚊
Windows
Manuell erstellt
Free 16. 7. 2026
ZIP-Paket
Gemeinde 16. 7. 2026
ZIP-Paket
Premium 16. 7. 2026
ZIP-Paket
  1. Lade das ZIP-Paket deiner Edition herunter und entpacke es.
  2. Starte kimu_dienst.exe.
  3. Falls eine DLL fehlt (z. B. VCRUNTIME140.dll), installiere das Microsoft Visual C++ Redistributable.
Premium: Keine Netzwerkkonfiguration nötig – HTTP/HTTPS funktioniert unter Windows systemweit. Die Windows-Firewall fragt beim ersten Start ggf. nach einer Bestätigung.
macOS
Manuell erstellt
Free 16. 7. 2026
ZIP-Paket
Gemeinde 16. 7. 2026
ZIP-Paket
Premium 16. 7. 2026
ZIP-Paket
  1. Lade das ZIP-Paket deiner Edition herunter und entpacke es.
  2. Verschiebe KiMu-Dienste.app in den Programme-Ordner (optional).
  3. Beim ersten Start erscheint die Meldung „KiMu-Dienste“ kann nicht geöffnet werden, da es von einem nicht verifizierten Entwickler stammt. – öffne die App mit Rechtsklick > Öffnen und bestätige mit Öffnen.

Alternativ: Gehe zu Systemeinstellungen > Datenschutz & Sicherheit und klicke auf Trotzdem öffnen.

Premium: Die macOS-App hat eine NSAppTransportSecurity-Ausnahme für HTTP-Verbindungen vorkonfiguriert. Bei HTTPS sind keine Anpassungen nötig.
iOS
Noch nicht verfügbar
Free
In Planung
Gemeinde
In Planung
Premium
In Planung

Eine iOS-Version ist derzeit in Planung. Apple verlangt eine kostenpflichtige Entwickler-Mitgliedschaft (99 $ / Jahr) für die Veröffentlichung im App Store.

Bei Interesse bitte Rückmeldung an kimudienste@choralvorspiele.de – bei genügend Nachfrage wird dies umgesetzt.

Premium (Vorbereitung): Die iOS-Info.plist enthält bereits eine NSAppTransportSecurity-Ausnahme für HTTP. Sobald iOS-Builds verfügbar sind, können diese sofort auf einen HTTP-Premium-Server zugreifen.

Admin-Tool (Desktop)

Das Admin-Tool ist eine separate Flutter-Desktop-App zur Lizenzverwaltung. Es läuft auf Linux, macOS und Windows.

Features

Lizenzverwaltung

  • KMD-Lizenzschlüssel lokal generieren (HMAC-SHA256)
  • Lizenzen verwalten (Liste, Filter, Widerruf)
  • Kunden verwalten und Lizenzen zuordnen
  • Lizenzschlüssel per E-Mail senden (SMTP)
  • Dashboard mit Statistiken
  • HTTP-Server für App-Validierung (Port 8081)
Starten

Installation

Das Admin-Tool wird über das Hilfsmenü gestartet oder direkt:

  • cd admin_tool && flutter run -d linux
  • Oder: ./hilfe.sh → „Admin-Tool starten"
  • HTTP-Server startet automatisch auf Port 8081
  • Lizenz-DB wird lokal gespeichert (data/admin.db)

Dokumentation

Benutzerhandbücher – passend zu jeder App-Ausführung.

📖
Handbuch Free
Einsteigerversion – kein Login, keine Datenisolierung
HTML PDF
📖
Handbuch Gemeinde
Passwort-Login, Benutzerverwaltung, Lizenz-System
HTML PDF
📖
Handbuch Premium
Serververbindung, MariaDB, JWT-Auth
HTML PDF Server-Installation

Hinweise

macOS / Windows: Diese Pakete werden separat auf den jeweiligen Systemen gebaut und manuell ins Verzeichnis kopiert. Falls ein Paket fehlt, ist es noch nicht verfügbar.
iOS: Bisher keine iOS-Version. Apple verlangt 99 $ / Jahr für die Bereitstellung. Bei Interesse bitte melden – bei genügend Nachfrage wird dies umgesetzt.
Premium-Netzwerkkonfiguration: Android (INTERNET + Cleartext), iOS/macOS (NSAppTransportSecurity) und Web (CORS) sind ab Werk vorkonfiguriert. Linux und Windows benötigen keine Anpassungen. Siehe Architektur.
Lizenzierung & Hilfe: Gemeinde und Premium erfordern eine Lizenz (KMD-Key). Der Admin kann Lizenzen über das Admin-Tool (Desktop) generieren. Eine 30-tägige Testphase ist verfügbar. Auf der Anmeldeseite steht ein ?-Hilfe-Button mit Erklärungen zu den Eingabefeldern und zur Datenhaltung zur Verfügung.
Testen & Feedback: Kirchenmusiker, die die App testen und Rückmeldung geben möchten, schreiben bitte an kimudienste@choralvorspiele.de.