Free Open Source Software Fahrtenbuch für Android
FOSStenbuch ist ein quelloffenes, digitales Fahrtenbuch für Android – entwickelt für Privatpersonen, Selbstständige und Unternehmen, die ihre Fahrten einfach, datenschutzfreundlich und ohne Cloud-Zwang dokumentieren möchten.
- Fahrten starten und beenden – mit Start-/Zielort, Kilometerstand, Kategorie, Geschäftspartner und Fahrzeug; neue Fahrten werden während der Fahrt erfasst, nicht nachträglich angelegt. Änderungen an abgeschlossenen Fahrten werden protokolliert; löschen lassen sie sich nicht, nur stornieren (mit Grund)
- GPS-Tracking – Gefahrene Strecke wird während der Fahrt per GPS mitgeschrieben (als Schätzung; maßgeblich ist der Km-Stand)
- Automatische Fahrterkennung – Verbindet sich das Handy mit dem Auto-Bluetooth, wird die Fahrt automatisch aufgezeichnet und kann später geprüft und übernommen werden
- Fahrzeugverwaltung – Mehrere Fahrzeuge verwalten
- Kategorien – Eigene Kategorien (beruflich, privat usw.) definieren
- Gespeicherte Orte – Häufig genutzte Orte speichern und wiederverwenden
- Kilometerstände – Km-Stand bei Start und Ende jeder Fahrt; das ausführliche PDF zeigt Lücken zwischen den Fahrten und nicht erfasste Kilometer
- Statistiken – Auswertungen und Übersichten über Fahrten und Kilometer, Rechner für die Entfernungspauschale (deutsches Steuerrecht, zur Orientierung)
- Export – CSV als Datenexport, PDF und ausführliches PDF je Fahrzeug (mit Km-Ständen, Änderungsprotokoll, Siegeln und Verlauf)
- Backup & Restore – Lokale Datensicherung und Wiederherstellung; Einspielen und „Alle Daten löschen“ werden im Verlauf vermerkt
- Erinnerungen – Benachrichtigungen zur Fahrtenerfassung
- Bearbeitungssperre – je Fahrzeug, nicht umkehrbar: abgeschlossene Fahrten lassen sich nur noch stornieren, die Fahrzeugdaten sind gesperrt; eine Hash-Kette prüft Backups beim Wiederherstellen
- Siegel, Signatur, Zeitstempel – jede Fahrt, die beendet, übernommen, geändert oder storniert wird, bekommt ein Siegel (SHA-256), optional signiert mit einem eigenen Schlüssel (ECDSA P-256) und bestätigt durch den Zeitstempel eines unabhängigen Dienstes (RFC 3161, standardmäßig aus); das ausführliche PDF und Backups lassen sich auf der Prüfseite im Browser prüfen
- Vorlagen – Wiederkehrende Fahrten als Vorlage speichern
- Material Design – Moderne Android-Oberfläche mit Material 3 Komponenten
- Offline-first – Alle Daten werden lokal auf dem Gerät gespeichert (Room-Datenbank)
- Keine Werbung, keine Analyse- oder Tracking-Dienste, keine Cloud – Volle Datenkontrolle
FOSStenbuch hilft, ein Fahrtenbuch ordentlich zu führen. Ob das Finanzamt es anerkennt, hängt davon ab, wie Sie es führen – eine Garantie gibt die App nicht, und dies ist keine Steuerberatung. Im Zweifel fragen Sie Ihre Steuerberaterin oder Ihren Steuerberater. Bewährt hat sich:
- Bearbeitungssperre vor der ersten Fahrt einschalten (Fahrzeug bearbeiten › „Bearbeitungssperre (nicht umkehrbar)“).
- Fahrten live erfassen: beim Losfahren starten, bei der Ankunft beenden – nicht erst abends oder am Monatsende.
- Km-Stand vom Tacho ablesen, bei Start und Ende. Die GPS-Strecke ist nur eine Schätzung.
- Alle Fahrten erfassen, auch private und die Wege zwischen Wohnung und erster Tätigkeitsstätte (eigene Kategorie, z. B. „Arbeitsweg“).
- Konkrete Kategorien und Geschäftspartner: Bei beruflichen Fahrten Geschäftspartner bzw. Kunde und Anlass angeben, bei Umwegen die Route.
- Automatisch erkannte Fahrten zeitnah übernehmen, spätestens nach 7 Tagen – als Unternehmer am besten am selben Tag.
- Nichts löschen: Fehler stornieren (mit Grund) bzw. bei Fahrzeugen ohne Sperre korrigieren – beides wird protokolliert.
- Netzwerkzeit einschalten (Android: Datum und Uhrzeit automatisch einstellen), denn alle Zeiten stammen von der Uhr des Geräts.
- Ausführliches PDF je Fahrzeug und Jahr exportieren („PDF (ausführlich, mit Änderungsprotokoll)“).
- Backups extern aufbewahren, nicht nur auf dem Handy – in Deutschland 10 Jahre, in Österreich 7 Jahre.
- Kostenbelege aufbewahren (Tanken, Werkstatt, Versicherung).
Optional: Zeitstempel einschalten und einen Signaturschlüssel erzeugen (und die Schlüsseldatei sicher aufbewahren). Dann zeigt die Prüfseite allein mit dem ausführlichen PDF, dass die Fahrten seit dem Siegeln unverändert sind und wann es die Siegel schon gab – Privatfahrten mit Notiz oder Geschäftspartner nur mit dem Backup, denn diese Angaben stehen nicht im PDF. Was diese Funktionen belegen und was nicht, steht in den Nutzungsbedingungen, Ziffer 4.
| Bereich | Technologie |
|---|---|
| Sprache | Kotlin |
| Min SDK | 26 (Android 8.0) |
| Target SDK | 36 (Android 16) |
| Architektur | Bewusst schlicht (KISS): Daten / Logik / UI |
| Datenbank | Room (SQLite), ein DAO |
| Navigation | Jetpack Navigation |
| Asynchronität | Kotlin Coroutines + Flow |
| UI | View Binding + Material 3 |
| Standort | Android LocationManager (AOSP, ohne Google-Dienste) |
| Einstellungen | DataStore Preferences |
| Kryptografie | Java-Standard-APIs (ECDSA P-256, AES-GCM, PBKDF2) und Android Keystore, keine Zusatzbibliothek |
| Testing | JUnit 4 |
| CI/CD | GitHub Actions |
| Build System | Gradle (Kotlin DSL) |
- JDK 17 oder neuer (getestet bis JDK 25)
- Android SDK mit API Level 36
- Gradle 9.x (wird über den Gradle Wrapper mitgeliefert)
- Optional: Android Studio (aktuelle Version mit AGP-9-Unterstützung)
git clone https://github.com/garske-systems/FOSStenbuch.git
cd FOSStenbuch./gradlew assembleDebugDie APK liegt anschließend unter app/build/outputs/apk/debug/app-debug.apk.
Debug-Builds haben die App-ID de.garsys.fosstenbuch.debug und lassen sich neben der Release-Version installieren.
./gradlew testapp/src/main/java/de/fosstenbuch/
├── App.kt # Application: Dunkelmodus, Erinnerung neu planen
├── data/ # Room-Entities, ein DAO, Datenbank + Migrationen, Einstellungen (DataStore)
├── logic/ # Geschäftslogik ohne UI
│ ├── Trips.kt # Fahrten speichern: Validierung, Sperre, Änderungsprotokoll, Siegel, Hash-Kette
│ ├── Seals.kt # Siegel abgeschlossener Fahrten (Format muss zu docs/pruefen.js passen)
│ ├── Keys.kt # Optionaler Signaturschlüssel, Schlüsseldatei, PDF-Signaturzeile
│ ├── Tsa.kt # Optionale Zeitstempel (RFC 3161)
│ ├── Backup.kt # Backup & Wiederherstellung (JSON), Verlauf
│ ├── Geo.kt # Entfernungen, Standort, Adresssuche (OpenStreetMap Nominatim)
│ ├── Mileage.kt # Kilometer- und Entfernungspauschale
│ ├── Fmt.kt # Deutsche Zahlen- und Datumsformate
│ └── export/ # CSV, PDF, ausführliches PDF mit Prüfdaten
├── tracking/ # GPS-Aufzeichnung, automatische Fahrterkennung (Bluetooth), Erinnerung
└── ui/ # MainActivity + ein Paket je Bildschirmgruppe, common/ = gemeinsame Helfer
docs/ # GitHub Pages: Rechtstexte und Prüfseite (pruefen.html, pruefen.js)
| Berechtigung | Verwendung |
|---|---|
ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION |
GPS-Strecke und Ortsvorschläge |
ACCESS_BACKGROUND_LOCATION |
GPS bei automatisch erkannten Fahrten (App nicht geöffnet) |
FOREGROUND_SERVICE / FOREGROUND_SERVICE_LOCATION |
Aufzeichnung als Vordergrunddienst mit Benachrichtigung |
BLUETOOTH_CONNECT (bzw. BLUETOOTH bis Android 11) |
Erkennen, wann sich das Auto-Bluetooth verbindet/trennt |
POST_NOTIFICATIONS |
Erinnerung und Aufzeichnungs-Benachrichtigung |
RECEIVE_BOOT_COMPLETED |
Erinnerung nach Neustart wieder planen; unterbrochene automatische Aufzeichnung abschließen |
INTERNET |
Adresssuche und Ortsnamen über OpenStreetMap; optional Zeitstempel (RFC 3161) |
Beiträge sind herzlich willkommen! So kannst du mitmachen:
- Fork des Repositories erstellen
- Feature-Branch anlegen:
git checkout -b feature/mein-feature - Änderungen committen:
git commit -m "feat: Beschreibung der Änderung" - Branch pushen:
git push origin feature/mein-feature - Pull Request öffnen
- Halte es einfach (KISS): so wenig Code wie möglich, keine unnötigen Schichten; Kommentare auf Deutsch
- Schreibe Unit Tests für neue Geschäftslogik
- Verwende Conventional Commits für Commit-Messages
- Stelle sicher, dass
./gradlew testerfolgreich durchläuft
- F-Droid Veröffentlichung
- Google Play Veröffentlichung
- PDF-Export im Fahrtenbuch-Format
- Dunkelmodus (Dark Theme)
- Widget für Schnellerfassung
- Automatische Fahrterkennung (Bluetooth)
- Multi-Language Support (Englisch)
- Datenschutzerklärung – alle Daten werden nur auf dem Gerät gespeichert; online gehen nur die Adresssuche und Ortsnamen automatisch erkannter Fahrten (OpenStreetMap Nominatim) und – falls eingeschaltet – Zeitstempel-Anfragen, bei denen nur ein SHA-256-Fingerabdruck an den gewählten Dienst geht
- Nutzungsbedingungen
- Prüfseite – prüft das ausführliche PDF und Backups, nur im Browser
- Impressum
Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe LICENSE für Details.
MIT License
Copyright (c) 2026 FOSStenbuch Contributors
- Icons: Material Icons von Google, Apache License 2.0.
- Adressdaten: Adresssuche und Ortsnamen kommen von OpenStreetMap über Nominatim – Daten © OpenStreetMap-Mitwirkende, Open Database License (ODbL). Die App zeigt diese Quellenangabe in der Adresssuche und im Seitenmenü, sendet einen eindeutigen User-Agent, stellt höchstens eine Anfrage pro Sekunde und sucht nur auf Knopfdruck (keine Autovervollständigung).
- Datenschutz: Für die Ortsnamen automatisch erkannter Fahrten sendet die App die Koordinaten von Fahrtbeginn und -ende (auf ca. 10 m gerundet) an nominatim.openstreetmap.org – außer ein gespeicherter Ort liegt in 500 m Nähe. Es gilt die Datenschutzerklärung der OSM Foundation.
- Zeitstempel: Nur wenn eingeschaltet (standardmäßig aus), holt die App Zeitstempel nach RFC 3161 bei einem wählbaren Dienst – vorgegeben sind FreeTSA, Sectigo Qualified (eIDAS) und Sectigo, eine eigene Adresse ist möglich. Übertragen werden je Siegel nur ein SHA-256-Fingerabdruck, eine Zufallszahl und die Kennung der App; höchstens eine Anfrage alle 15 Sekunden.
- Bibliotheken: AndroidX (u.a. Room, DataStore, Navigation), Material Components, Kotlin-Standardbibliothek und Kotlin Coroutines (Apache License 2.0); DataStore enthält Protocol Buffers von Google (BSD-3-Clause).
Dieses Projekt wird betreut und hauptsächlich entwickelt von:
- Website: garske-systems.de
- Issues: GitHub Issues
Made with ❤️ as Free Open Source Software. Dieses Projekt wurde mit KI-unterstützung entwickelt.


