simple-notes-sync/CHANGELOG.de.md

Changelog

Alle wichtigen Änderungen an Simple Notes Sync werden in dieser Datei dokumentiert.

Das Format basiert auf Keep a Changelog.

🌍 Sprachen: Deutsch · English

---

[1.8.0] - 2026-02-10

🎉 Major: Widgets, Sortierung & Erweiterte Sync-Features

Komplettes Widget-System mit interaktiven Checklisten, Notiz-Sortierung und umfangreiche Sync-Verbesserungen!

🆕 Homescreen-Widgets

Vollständiges Jetpack Glance Widget-Framework (539987f)

• 5 responsive Größenklassen (SMALL, NARROW_MED, NARROW_TALL, WIDE_MED, WIDE_TALL)
• Interaktive Checklist-Checkboxen die sofort zum Server synchronisieren
• Material You Dynamic Colors mit konfigurierbarer Hintergrund-Transparenz (0-100%)
• Widget-Sperre-Toggle zum Verhindern versehentlicher Änderungen
• Read-Only-Modus mit permanenter Options-Leiste für gesperrte Widgets
• Widget-Konfigurations-Activity mit Notiz-Auswahl und Einstellungen
• Auto-Refresh nach Sync-Abschluss
• Tippen auf Inhalt öffnet Editor (entsperrt) oder zeigt Optionen (gesperrt)
• Vollständige Resource-Cleanup-Fixes für Connection Leaks

Widget State Management:

• NoteWidgetState Keys für pro-Instanz-Persistierung via DataStore
• Fünf Top-Level ActionCallbacks (Toggle Checkbox, Lock, Options, Refresh, Config)
• Type-Safe Parameter-Übergabe mit NoteWidgetActionKeys

📊 Notiz- & Checklisten-Sortierung

Notiz-Sortierung (96c819b)

• Sortieren nach: Aktualisiert (neueste/älteste), Erstellt, Titel (A-Z/Z-A), Typ
• Persistente Sortierungs-Präferenzen (gespeichert in SharedPreferences)
• Sortierungs-Dialog im Hauptbildschirm mit Richtungs-Toggle
• Kombinierte sortedNotes StateFlow im MainViewModel

Checklisten-Sortierung (96c819b, 900dad7)

• Sortieren nach: Manual, Alphabetisch, Offen zuerst, Erledigt zuletzt
• Visueller Separator zwischen offenen/erledigten Items mit Anzahl-Anzeige
• Auto-Sort bei Item-Toggle und Neuordnung
• Drag nur innerhalb gleicher Gruppe (offen/erledigt)
• Sanfte Fade/Slide-Animationen für Item-Übergänge
• Unit-getestet mit 9 Testfällen für Sortierungs-Logik-Validierung

🔄 Sync-Verbesserungen

Server-Löschungs-Erkennung (40d7c83, bf7a74e)

• Neuer DELETED_ON_SERVER Sync-Status für Multi-Device-Szenarien
• Erkennt wenn Notizen auf anderen Clients gelöscht wurden
• Zero Performance-Impact (nutzt existierende PROPFIND-Daten)
• Löschungs-Anzahl im Sync-Banner: "3 synchronisiert · 2 auf Server gelöscht"
• Bearbeitete gelöschte Notizen werden automatisch zum Server hochgeladen (Status → PENDING)

Sync-Status-Legende (07607fc)

• Hilfe-Button (?) in Hauptbildschirm TopAppBar
• Dialog erklärt alle 5 Sync-Status-Icons mit Beschreibungen
• Nur sichtbar wenn Sync konfiguriert ist

Live-Sync-Fortschritts-UI (df37d2a)

• Echtzeit-Phasen-Indikatoren: PREPARING, UPLOADING, DOWNLOADING, IMPORTING_MARKDOWN
• Upload-Fortschritt zeigt x/y Counter (bekannte Gesamtzahl)
• Download-Fortschritt zeigt Anzahl (unbekannte Gesamtzahl)
• Einheitliches SyncProgressBanner (ersetzt Dual-System)
• Auto-Hide: COMPLETED (2s), ERROR (4s)
• Keine irreführenden Counter wenn nichts zu synchronisieren ist
• Stiller Auto-Sync bleibt still, Fehler werden immer angezeigt

Parallele Downloads (bdfc0bf)

• Konfigurierbare gleichzeitige Downloads (Standard: 3 simultan)
• Kotlin Coroutines async/awaitAll Pattern
• Individuelle Download-Timeout-Behandlung
• Graceful sequentieller Fallback bei gleichzeitigen Fehlern
• Optimierte Netzwerk-Auslastung für schnelleren Sync

✨ UX-Verbesserungen

Checklisten-Verbesserungen:

• Überlauf-Verlauf für lange Text-Items (3462f93)
• Auto-Expand bei Fokus, Collapse auf 5 Zeilen bei Fokus-Verlust
• Drag & Drop Flackern-Fix mit Straddle-Target-Center-Erkennung (538a705)
• Adjacency-Filter verhindert Item-Sprünge bei schnellem Drag
• Race-Condition-Fix für Scroll + Move-Operationen

Einstellungs-UI-Polish:

• Sanfter Sprachwechsel ohne Activity-Recreate (881c0fd)
• Raster-Ansicht als Standard für Neu-Installationen (6858446)
• Sync-Einstellungen umstrukturiert in klare Sektionen: Auslöser & Performance (eaac5a0)
• Changelog-Link zum About-Screen hinzugefügt (49810ff)

Post-Update Changelog-Dialog (661d9e0)

• Zeigt lokalisierten Changelog beim ersten Start nach Update
• Material 3 ModalBottomSheet mit Slide-up-Animation
• Lädt F-Droid Changelogs via Assets (Single Source of Truth)
• Einmalige Anzeige pro versionCode (gespeichert in SharedPreferences)
• Klickbarer GitHub-Link für vollständigen Changelog
• Durch Button oder Swipe-Geste schließbar
• Test-Modus in Debug-Einstellungen mit Reset-Option

Backup-Einstellungs-Verbesserungen (3e946ed)

• Neue BackupProgressCard mit LinearProgressIndicator
• 3-Phasen-Status-System: In Progress → Abschluss → Löschen
• Erfolgs-Status für 2s angezeigt, Fehler für 3s
• Redundante Toast-Nachrichten entfernt
• Buttons bleiben sichtbar und deaktiviert während Operationen
• Exception-Logging für besseres Error-Tracking

🐛 Fehlerbehebungen

Widget-Text-Anzeige (d045d4d)

• Text-Notizen zeigen nicht mehr nur 3 Zeilen in Widgets
• Von Absatz-basiert zu Zeilen-basiertem Rendering geändert
• LazyColumn scrollt jetzt korrekt durch gesamten Inhalt
• Leere Zeilen als 8dp Spacer beibehalten
• Vorschau-Limits erhöht: compact 100→120, full 200→300 Zeichen

🔧 Code-Qualität

Detekt-Cleanup (1da1a63)

• Alle 22 Detekt-Warnungen behoben
• 7 ungenutzte Imports entfernt
• Konstanten für 5 Magic Numbers definiert
• State-Reads mit derivedStateOf optimiert
• Build: 0 Lint-Fehler + 0 Detekt-Warnungen

📚 Dokumentation

• Vollständige Implementierungs-Pläne für alle 23 v1.8.0 Features
• Widget-System-Architektur und State-Management-Docs
• Sortierungs-Logik Unit-Tests mit Edge-Case-Coverage
• F-Droid Changelogs (Englisch + Deutsch)

---

[1.7.2] - 2026-02-04

🐛 Kritische Fehlerbehebungen

JSON/Markdown Timestamp-Synchronisation

Problem: Externe Editoren (Obsidian, Typora, VS Code, eigene Editoren) aktualisieren Markdown-Inhalt, aber nicht den YAML updated: Timestamp, wodurch die Android-App Änderungen überspringt.

Lösung:

• Server-Datei Änderungszeit (mtime) wird jetzt als Source of Truth statt YAML-Timestamp verwendet
• Inhaltsänderungen werden via Hash-Vergleich erkannt
• Notizen nach Markdown-Import als PENDING markiert → JSON automatisch beim nächsten Sync hochgeladen
• Behebt Sortierungsprobleme nach externen Bearbeitungen

SyncStatus auf Server immer PENDING

Problem: Alle JSON-Dateien auf dem Server enthielten "syncStatus": "PENDING" auch nach erfolgreichem Sync, was externe Clients verwirrte.

Lösung:

• Status wird jetzt auf SYNCED gesetzt vor JSON-Serialisierung
• Server- und lokale Kopien sind jetzt konsistent
• Externe Web/Tauri-Editoren können Sync-Status korrekt interpretieren

Deletion Tracker Race Condition

Problem: Batch-Löschungen konnten Lösch-Einträge verlieren durch konkurrierenden Dateizugriff.

Lösung:

• Mutex-basierte Synchronisation für Deletion Tracking
• Neue trackDeletionSafe() Funktion verhindert Race Conditions
• Garantiert Zombie-Note-Prevention auch bei schnellen Mehrfach-Löschungen

ISO8601 Timezone-Parsing

Problem: Markdown-Importe schlugen fehl mit Timezone-Offsets wie +01:00 oder -05:00.

Lösung:

• Multi-Format ISO8601 Parser mit Fallback-Kette
• Unterstützt UTC (Z), Timezone-Offsets (+01:00, +0100) und Millisekunden
• Kompatibel mit Obsidian, Typora, VS Code Timestamps

⚡ Performance-Verbesserungen

E-Tag Batch Caching

• E-Tags werden jetzt in einer einzigen Batch-Operation geschrieben statt N einzelner Schreibvorgänge
• Performance-Gewinn: ~50-100ms pro Sync mit mehreren Notizen
• Reduzierte Disk-I/O-Operationen

Memory Leak Prevention

• SafeSardineWrapper implementiert jetzt Closeable für explizites Resource-Cleanup
• HTTP Connection Pool wird nach Sync korrekt aufgeräumt
• Verhindert Socket-Exhaustion bei häufigen Syncs

🔧 Technische Details

• IMPL_001: kotlinx.coroutines.sync.Mutex für thread-sicheres Deletion Tracking
• IMPL_002: Pattern-basierter ISO8601 Parser mit 8 Format-Varianten
• IMPL_003: Connection Pool Eviction + Dispatcher Shutdown in close()
• IMPL_004: Batch SharedPreferences.Editor Updates
• IMPL_014: Server mtime Parameter in Note.fromMarkdown()
• IMPL_015: syncStatus vor toJson() Aufruf gesetzt

📚 Dokumentation

• External Editor Specification für Web/Tauri-Editor-Entwickler
• Detaillierte Implementierungs-Dokumentation für alle Bugfixes

---

[1.7.1] - 2026-02-02

🐛 Kritische Fehlerbehebungen

Android 9 App-Absturz Fix (#15)

Problem: App stürzte auf Android 9 (API 28) ab wenn WorkManager Expedited Work für Hintergrund-Sync verwendet wurde.

Root Cause: Wenn setExpedited() in WorkManager verwendet wird, muss die CoroutineWorker die Methode getForegroundInfo() implementieren um eine Foreground Service Notification zurückzugeben. Auf Android 9-11 ruft WorkManager diese Methode auf, aber die Standard-Implementierung wirft IllegalStateException: Not implemented.

Lösung: getForegroundInfo() in SyncWorker implementiert um eine korrekte ForegroundInfo mit Sync-Progress-Notification zurückzugeben.

Details:

• ForegroundInfo mit Sync-Progress-Notification für Android 9-11 hinzugefügt
• Android 10+: Setzt FOREGROUND_SERVICE_TYPE_DATA_SYNC für korrekte Service-Typisierung
• Foreground Service Permissions in AndroidManifest.xml hinzugefügt
• Notification zeigt Sync-Progress mit indeterminiertem Progress Bar
• Danke an @roughnecks für das detaillierte Debugging!

VPN-Kompatibilitäts-Fix (#11)

• WiFi Socket-Binding erkennt jetzt korrekt Wireguard VPN-Interfaces (tun*, wg*, -wg-)
• Traffic wird korrekt durch VPN-Tunnel geleitet statt direkt über WiFi
• Behebt "Verbindungs-Timeout" beim Sync zu externen Servern über VPN

🔧 Technische Änderungen

• Neue SafeSardineWrapper Klasse stellt korrektes HTTP-Connection-Cleanup sicher
• Weniger unnötige 401-Authentifizierungs-Challenges durch preemptive Auth-Header
• ProGuard-Regel hinzugefügt um harmlose TextInclusionStrategy-Warnungen zu unterdrücken
• VPN-Interface-Erkennung via NetworkInterface.getNetworkInterfaces() Pattern-Matching
• Foreground Service Erkennung und Notification-System für Hintergrund-Sync-Tasks

🌍 Lokalisierung

• Hardcodierte deutsche Fehlermeldungen behoben - jetzt String-Resources für korrekte Lokalisierung
• Deutsche und englische Strings für Sync-Progress-Notifications hinzugefügt

---

[1.7.0] - 2026-01-26

🎉 Major: Grid-Ansicht, Nur-WLAN Sync & VPN-Unterstützung

Pinterest-Style Grid, Nur-WLAN Sync-Modus und korrekte VPN-Unterstützung!

🎨 Grid-Layout

• Pinterest-Style Staggered Grid ohne Lücken
• Konsistente 12dp Abstände zwischen Cards
• Scroll-Position bleibt erhalten nach Einstellungen
• Neue einheitliche NoteCardGrid mit dynamischen Vorschauzeilen (3 klein, 6 groß)

📡 Sync-Verbesserungen

• Nur-WLAN Sync Toggle - Sync nur wenn WLAN verbunden
• VPN-Unterstützung - Sync funktioniert korrekt bei aktivem VPN (Traffic über VPN)
• Server-Wechsel Erkennung - Alle Notizen auf PENDING zurückgesetzt bei Server-URL Änderung
• Schnellere Server-Prüfung - Socket-Timeout von 2s auf 1s reduziert
• "Sync läuft bereits" Feedback - Zeigt Snackbar wenn Sync bereits läuft

🔒 Self-Signed SSL Unterstützung

• Dokumentation hinzugefügt - Anleitung für selbst-signierte Zertifikate
• Nutzt Android's eingebauten CA Trust Store
• Funktioniert mit ownCloud, Nextcloud, Synology, Home-Servern

🔧 Technisch

• NoteCardGrid Komponente mit dynamischen maxLines
• FullLine Spans entfernt für lückenloses Layout
• resetAllSyncStatusToPending() in NotesStorage
• VPN-Erkennung in getOrCacheWiFiAddress()

---

[1.6.1] - 2026-01-20

🧹 Code-Qualität & Build-Verbesserungen

• detekt: 0 Issues - Alle 29 Code-Qualitäts-Issues behoben

  • Triviale Fixes: Unused Imports, MaxLineLength
  • Datei umbenannt: DragDropState.kt → DragDropListState.kt
  • MagicNumbers → Constants (Dimensions.kt, SyncConstants.kt)
  • SwallowedException: Logger.w() für besseres Error-Tracking hinzugefügt
  • LongParameterList: ChecklistEditorCallbacks data class erstellt
  • LongMethod: ServerSettingsScreen in Komponenten aufgeteilt
  • @Suppress Annotationen für Legacy-Code (WebDavSyncService, SettingsActivity)

• Zero Build Warnings - Alle 21 Deprecation Warnings eliminiert

  • File-level @Suppress für deprecated Imports
  • ProgressDialog, LocalBroadcastManager, AbstractSavedStateViewModelFactory
  • onActivityResult, onRequestPermissionsResult
  • Gradle Compose Config bereinigt (StrongSkipping ist jetzt Standard)

• ktlint reaktiviert - Linting mit Compose-spezifischen Regeln wieder aktiviert

  • .editorconfig mit Compose Formatierungsregeln erstellt
  • Legacy-Dateien ausgeschlossen: WebDavSyncService.kt, build.gradle.kts
  • ignoreFailures=true für graduelle Migration

• CI/CD Verbesserungen - GitHub Actions Lint-Checks integriert

  • detekt + ktlint + Android Lint laufen vor Build in pr-build-check.yml
  • Stellt Code-Qualität bei jedem Pull Request sicher

🔧 Technische Verbesserungen

• Constants Refactoring - Bessere Code-Organisation

  • ui/theme/Dimensions.kt: UI-bezogene Konstanten
  • utils/SyncConstants.kt: Sync-Operations Konstanten

• Vorbereitung für v2.0.0 - Legacy-Code für Entfernung markiert

  • SettingsActivity und MainActivity (ersetzt durch Compose-Versionen)
  • Alle deprecated APIs mit Removal-Plan dokumentiert

---

[1.6.0] - 2026-01-19

🎉 Major: Konfigurierbare Sync-Trigger

Feingranulare Kontrolle darüber, wann deine Notizen synchronisiert werden - wähle die Trigger, die am besten zu deinem Workflow passen!

⚙️ Sync-Trigger System

• Individuelle Trigger-Kontrolle - Jeden Sync-Trigger einzeln in den Einstellungen aktivieren/deaktivieren

• 5 Unabhängige Trigger:

  • onSave Sync - Sync sofort nach dem Speichern einer Notiz (5s Throttle)
  • onResume Sync - Sync beim Öffnen der App (60s Throttle)
  • WiFi-Connect Sync - Sync bei WiFi-Verbindung
  • Periodischer Sync - Hintergrund-Sync alle 15/30/60 Minuten (konfigurierbar)
  • Boot Sync - Startet Hintergrund-Sync nach Geräteneustart

• Smarte Defaults - Nur ereignisbasierte Trigger standardmäßig aktiv (onSave, onResume, WiFi-Connect)

• Akku-optimiert - ~0.2%/Tag mit Defaults, bis zu ~1.0% mit aktiviertem periodischen Sync

• Offline-Modus UI - Ausgegraute Sync-Toggles wenn kein Server konfiguriert

• Dynamischer Settings-Subtitle - Zeigt Anzahl aktiver Trigger im Haupteinstellungs-Screen

🔧 Server-Konfiguration Verbesserungen

• Offline-Modus Toggle - Alle Netzwerkfunktionen mit einem Schalter deaktivieren
• Getrennte Protokoll & Host Eingabe - Protokoll (http/https) als nicht-editierbares Präfix angezeigt
• Klickbare Settings-Cards - Gesamte Card klickbar für bessere UX
• Klickbare Toggle-Zeilen - Text/Icon klicken um Switches zu bedienen (nicht nur der Switch selbst)

🐛 Bug Fixes

• Fix: Fehlender 5. Sync-Trigger (Boot) in der Haupteinstellungs-Screen Subtitle-Zählung
• Fix: Offline-Modus Status wird nicht aktualisiert beim Zurückkehren aus Einstellungen
• Fix: Pull-to-Refresh funktioniert auch im Offline-Modus

🔧 Technische Verbesserungen

• Reaktiver Offline-Modus Status - StateFlow stellt sicher, dass UI korrekt aktualisiert wird
• Getrennte Server-Config Checks - hasServerConfig() vs isServerConfigured() (offline-aware)
• Verbesserte Konstanten - Alle Sync-Trigger Keys und Defaults in Constants.kt
• Bessere Code-Organisation - Settings-Screens für Klarheit refactored

Looking Ahead

🚀 v1.7.0 wird Server-Ordner Prüfung und weitere Community-Features bringen. Feature-Requests sind willkommen als GitHub Issue.

---

[1.5.0] - 2026-01-15

🎉 Major: Jetpack Compose UI Redesign

Das komplette UI wurde von XML-Views auf Jetpack Compose migriert. Die App ist jetzt moderner, schneller und flüssiger.

🌍 New Feature: Internationalization (i18n)

• Englische Sprachunterstützung - Alle 400+ Strings übersetzt
• Automatische Spracherkennung - Folgt der System-Sprache
• Manuelle Sprachauswahl - In den Einstellungen umschaltbar
• Per-App Language (Android 13+) - Native Spracheinstellung über System-Settings
• locales_config.xml - Vollständige Android-Integration

⚙️ Modernized Settings

• 7 kategorisierte Settings-Screens - Übersichtlicher und intuitiver
• Compose Navigation - Flüssige Übergänge zwischen Screens
• Konsistentes Design - Material Design 3 durchgängig

✨ UI Improvements

• Selection Mode - Long-Press für Mehrfachauswahl statt Swipe-to-Delete
• Batch Delete - Mehrere Notizen gleichzeitig löschen
• Silent-Sync Mode - Kein Banner bei Auto-Sync (nur bei manuellem Sync)
• App Icon in About Screen - Hochwertige Darstellung
• App Icon in Empty State - Statt Emoji bei leerer Notizliste
• Splash Screen Update - Verwendet App-Foreground-Icon
• Slide Animations - Flüssige Animationen im NoteEditor

🔧 Technical Improvements

• Jetpack Compose - Komplette UI-Migration
• Compose ViewModel Integration - StateFlow für reactive UI
• Improved Code Quality - Detekt/Lint Warnings behoben
• Unused Imports Cleanup - Sauberer Codebase

Looking Ahead

🚀 v1.6.0 wird Server-Ordner Prüfung und weitere technische Modernisierungen bringen. Feature-Requests gerne als GitHub Issue einreichen.

---

[1.4.1] - 2026-01-11

Fixed

• 🗑️ Löschen älterer Notizen (v1.2.0 Kompatibilität)

  • Notizen aus App-Version v1.2.0 oder früher werden jetzt korrekt vom Server gelöscht
  • Behebt Problem bei Multi-Device-Nutzung mit älteren Notizen

• 🔄 Checklisten-Sync Abwärtskompatibilität

  • Checklisten werden jetzt auch als Text-Fallback im content-Feld gespeichert
  • Ältere App-Versionen (v1.3.x) zeigen Checklisten als lesbaren Text
  • Format: GitHub-Style Task-Listen ([ ] Item / [x] Item)
  • Recovery-Mode: Falls Checklisten-Items verloren gehen, werden sie aus dem Content wiederhergestellt

Improved

• 📝 Checklisten Auto-Zeilenumbruch
  • Lange Checklisten-Texte werden jetzt automatisch umgebrochen
  • Keine Begrenzung auf 3 Zeilen mehr
  • Enter-Taste erstellt weiterhin ein neues Item

Looking Ahead

🚀 v1.5.0 wird das nächste größere Release. Wir sammeln Ideen und Feedback!
Feature-Requests gerne als GitHub Issue einreichen.

---

[1.4.0] - 2026-01-10

🎉 New Feature: Checklists

• ✅ Checklist Notes

  • New note type: Checklists with tap-to-toggle items
  • Add items via dedicated input field with "+" button
  • Drag & drop reordering (long-press to activate)
  • Swipe-to-delete items
  • Visual distinction: Checked items get strikethrough styling
  • Type selector when creating new notes (Text or Checklist)

• 📝 Markdown Integration

  • Checklists export as GitHub-style task lists (- [ ] / - [x])
  • Compatible with Obsidian, Notion, and other Markdown editors
  • Full round-trip: Edit in Obsidian → Sync back to app
  • YAML frontmatter includes type: checklist for identification

Fixed

• <EFBFBD> Markdown Parsing Robustness

  • Fixed content extraction after title (was returning empty for some formats)
  • Now handles single newline after title (was requiring double newline)
  • Protection: Skips import if parsed content is empty but local has content

• 📂 Duplicate Filename Handling

  • Notes with identical titles now get unique Markdown filenames
  • Format: title_shortid.md (e.g., test_71540ca9.md)
  • Prevents data loss from filename collisions

• 🔔 Notification UX

  • No sync notifications when app is in foreground
  • User sees changes directly in UI - no redundant notification
  • Background syncs still show notifications as expected

Privacy Improvements

• 🔒 WiFi Permissions Removed
  • Removed ACCESS_WIFI_STATE permission
  • Removed CHANGE_WIFI_STATE permission
  • WiFi binding now works via IP detection instead of SSID matching
  • Cleaned up all SSID-related code from codebase and documentation

Technical Improvements

• 📦 New Data Model

  • NoteType enum: TEXT, CHECKLIST
  • ChecklistItem data class with id, text, isChecked, order
  • Note.kt extended with noteType and checklistItems fields

• 🔄 Sync Protocol v1.4.0

  • JSON format updated to include checklist fields
  • Full backward compatibility with v1.3.x notes
  • Robust JSON parsing with manual field extraction

---

[1.3.2] - 2026-01-10

Changed

• 🧹 Code-Qualität: "Clean Slate" Release
  • Alle einfachen Lint-Issues behoben (Phase 1-7 des Cleanup-Plans)
  • Unused Imports und Members entfernt
  • Magic Numbers durch benannte Konstanten ersetzt
  • SwallowedExceptions mit Logger.w() versehen
  • MaxLineLength-Verstöße reformatiert
  • ConstructorParameterNaming (snake_case → camelCase mit @SerializedName)
  • Custom Exceptions: SyncException.kt und ValidationException.kt erstellt

Added

• 📝 F-Droid Privacy Notice
  • Datenschutz-Hinweis für die Datei-Logging-Funktion
  • Erklärt dass Logs nur lokal gespeichert werden
  • Erfüllt F-Droid Opt-in Consent-Anforderungen

Technical Improvements

• ⚡ Neue Konstanten für bessere Wartbarkeit

  • SYNC_COMPLETED_DELAY_MS, ERROR_DISPLAY_DELAY_MS (MainActivity)
  • CONNECTION_TIMEOUT_MS (SettingsActivity)
  • SOCKET_TIMEOUT_MS, MAX_FILENAME_LENGTH, ETAG_PREVIEW_LENGTH (WebDavSyncService)
  • AUTO_CANCEL_TIMEOUT_MS (NotificationHelper)
  • RFC 1918 IP-Range Konstanten (UrlValidator)
  • DAYS_THRESHOLD, TRUNCATE_SUFFIX_LENGTH (Extensions)

• 🔒 @Suppress Annotations für legitime Patterns

  • ReturnCount: Frühe Returns für Validierung sind idiomatisch
  • LoopWithTooManyJumpStatements: Komplexe Sync-Logik dokumentiert

Notes

• Komplexe Refactorings (LargeClass, LongMethod) für v1.3.3+ geplant
• Deprecation-Warnungen (LocalBroadcastManager, ProgressDialog) bleiben bestehen

---

[1.3.1] - 2026-01-08

Fixed

• 🔧 Multi-Device JSON Sync (Danke an Thomas aus Bielefeld)
  • JSON-Dateien werden jetzt korrekt zwischen Geräten synchronisiert
  • Funktioniert auch ohne aktiviertes Markdown
  • Hybrid-Optimierung: Server-Timestamp (Primary) + E-Tag (Secondary) Checks
  • E-Tag wird nach Upload gecached um Re-Download zu vermeiden

Performance Improvements

• ⚡ JSON Sync Performance-Parität

  • JSON-Sync erreicht jetzt gleiche Performance wie Markdown (~2-3 Sekunden)
  • Timestamp-basierte Skip-Logik für unveränderte Dateien (~500ms pro Datei gespart)
  • E-Tag-Matching als Fallback für Dateien die seit letztem Sync modifiziert wurden
  • Beispiel: 24 Dateien von 12-14s auf ~2.7s reduziert (keine Änderungen)

• ⏭️ Skip unveränderte Dateien (Haupt-Performance-Fix!)

  • JSON-Dateien: Überspringt alle Notizen, die seit letztem Sync nicht geändert wurden
  • Markdown-Dateien: Überspringt unveränderte MD-Dateien basierend auf Server-Timestamp
  • Spart ~500ms pro Datei bei Nextcloud (~20 Dateien = 10 Sekunden gespart!)
  • Von 21 Sekunden Sync-Zeit auf 2-3 Sekunden reduziert

• ⚡ Session-Caching für WebDAV

  • Sardine-Client wird pro Sync-Session wiederverwendet (~600ms gespart)
  • WiFi-IP-Adresse wird gecacht statt bei jeder Anfrage neu ermittelt (~300ms gespart)
  • /notes/ Ordner-Existenz wird nur einmal pro Sync geprüft (~500ms gespart)
  • Gesamt: ~1.4 Sekunden zusätzlich gespart

• 📝 Content-basierte Markdown-Erkennung

  • Extern bearbeitete Markdown-Dateien werden auch erkannt wenn YAML-Timestamp nicht aktualisiert wurde
  • Löst das Problem: Obsidian/Texteditor-Änderungen wurden nicht importiert
  • Hybridansatz: Erst Timestamp-Check (schnell), dann Content-Vergleich (zuverlässig)

Added

• 🔄 Sync-Status-Anzeige (UI)
  • Sichtbares Banner "Synchronisiere..." mit ProgressBar während Sync läuft
  • Sync-Button und Pull-to-Refresh werden deaktiviert während Sync aktiv
  • Verhindert versehentliche Doppel-Syncs durch visuelle Rückmeldung
  • Auch in Einstellungen: "Jetzt synchronisieren" Button wird deaktiviert

Fixed

• 🔧 Sync-Mutex verhindert doppelte Syncs

  • Keine doppelten Toast-Nachrichten mehr bei schnellem Pull-to-Refresh
  • Concurrent Sync-Requests werden korrekt blockiert

• 🐛 Lint-Fehler behoben

  • View.generateViewId() statt hardcodierte IDs in RadioButtons
  • app:tint statt android:tint für AppCompat-Kompatibilität

Added

• 🔍 detekt Code-Analyse

  • Statische Code-Analyse mit detekt 1.23.4 integriert
  • Pragmatische Konfiguration für Sync-intensive Codebasis
  • 91 Issues identifiziert (als Baseline für v1.4.0)

• 🏗️ Debug Build mit separatem Package

  • Debug-APK kann parallel zur Release-Version installiert werden
  • Package: dev.dettmer.simplenotes.debug (Debug) vs dev.dettmer.simplenotes (Release)
  • App-Name zeigt "Simple Notes (Debug)" für einfache Unterscheidung

• 📊 Debug-Logging UI

  • Neuer "Debug Log" Button in Einstellungen → Erweitert
  • Zeigt letzte Sync-Logs mit Zeitstempeln
  • Export-Funktion für Fehlerberichte

Technical

• WebDavSyncService: Hybrid-Optimierung für JSON-Downloads (Timestamp PRIMARY, E-Tag SECONDARY)
• WebDavSyncService: E-Tag refresh nach Upload statt Invalidierung (verhindert Re-Download)
• E-Tag Caching: SharedPreferences mit Key-Pattern etag_json_{noteId}
• Skip-Logik: if (serverModified <= lastSync) skip → ~1ms pro Datei
• Fallback E-Tag: if (serverETag == cachedETag) skip → für Dateien modifiziert nach lastSync
• PROPFIND nach PUT: Fetch E-Tag nach Upload für korrektes Caching
• SyncStateManager: Neuer Singleton mit StateFlow<Boolean> für Sync-Status
• MainActivity: Observer auf SyncStateManager.isSyncing für UI-Updates
• Layout: sync_status_banner mit ProgressBar + TextView
• WebDavSyncService: Skip-Logik für unveränderte JSON/MD Dateien basierend auf lastSyncTimestamp
• WebDavSyncService: Neue Session-Cache-Variablen (sessionSardine, sessionWifiAddress, notesDirEnsured)
• getOrCreateSardine(): Cached Sardine-Client mit automatischer Credentials-Konfiguration
• getOrCacheWiFiAddress(): WiFi-Adresse wird nur einmal pro Sync ermittelt
• clearSessionCache(): Aufräumen am Ende jeder Sync-Session
• ensureNotesDirectoryExists(): Cached Directory-Check
• Content-basierter Import: Vergleicht MD-Content mit lokaler Note wenn Timestamps gleich
• Build-Tooling: detekt aktiviert, ktlint vorbereitet (deaktiviert wegen Parser-Problemen)
• Debug BuildType: applicationIdSuffix = ".debug", versionNameSuffix = "-debug"

---

[1.3.0] - 2026-01-07

Added

• 🚀 Multi-Device Sync (Thanks to Thomas from Bielefeld for reporting!)

  • Automatic download of new notes from other devices
  • Deletion tracking prevents "zombie notes" (deleted notes don't come back)
  • Smart cleanup: Re-created notes (newer timestamp) are downloaded
  • Works with all devices: v1.2.0, v1.2.1, v1.2.2, and v1.3.0

• 🗑️ Server Deletion via Swipe Gesture

  • Swipe left on notes to delete from server (requires confirmation)
  • Prevents duplicate notes on other devices
  • Works with deletion tracking system
  • Material Design confirmation dialog

• ⚡ E-Tag Performance Optimization

  • Smart server checking with E-Tag caching (~150ms vs 3000ms for "no changes")
  • 20x faster when server has no updates
  • E-Tag hybrid approach: E-Tag for JSON (fast), timestamp for Markdown (reliable)
  • Battery-friendly with minimal server requests

• 📥 Markdown Auto-Sync Toggle

  • NEW: Unified Auto-Sync toggle in Settings (replaces separate Export/Auto-Import toggles)
  • When enabled: Notes export to Markdown AND import changes automatically
  • When disabled: Manual sync button appears for on-demand synchronization
  • Performance: Auto-Sync OFF = 0ms overhead

• 🔘 Manual Markdown Sync Button

  • Manual sync button for performance-conscious users
  • Shows import/export counts after completion
  • Only visible when Auto-Sync is disabled
  • On-demand synchronization (~150-200ms only when triggered)

• ⚙️ Server-Restore Modes

  • MERGE: Keep local notes + add server notes
  • REPLACE: Delete all local + download from server
  • OVERWRITE: Update duplicates, keep non-duplicates
  • Restore modes now work correctly for WebDAV restore

Technical

• New DeletionTracker model with JSON persistence
• NotesStorage: Added deletion tracking methods
• WebDavSyncService.hasUnsyncedChanges(): Intelligent server checks with E-Tag caching
• WebDavSyncService.downloadRemoteNotes(): Deletion-aware downloads
• WebDavSyncService.restoreFromServer(): Support for restore modes
• WebDavSyncService.deleteNoteFromServer(): Server deletion with YAML frontmatter scanning
• WebDavSyncService.importMarkdownFiles(): Automatic Markdown import during sync
• WebDavSyncService.manualMarkdownSync(): Manual sync with result counts
• MainActivity.setupSwipeToDelete(): Two-stage swipe deletion with confirmation
• E-Tag caching in SharedPreferences for performance

---

[1.2.2] - 2026-01-06

Fixed

• Backward Compatibility for v1.2.0 Users (Critical)
  • App now reads BOTH old (Root) AND new (/notes/) folder structures
  • Users upgrading from v1.2.0 no longer lose their existing notes
  • Server-Restore now finds notes from v1.2.0 stored in Root folder
  • Automatic deduplication prevents loading the same note twice
  • Graceful error handling if Root folder is not accessible

Technical

• WebDavSyncService.downloadRemoteNotes() - Dual-mode download (Root + /notes/)
• WebDavSyncService.restoreFromServer() - Now uses dual-mode download
• Migration happens naturally: new uploads go to /notes/, old notes stay readable

---

[1.2.1] - 2026-01-05

Fixed

• Markdown Initial Export Bugfix

  • Existing notes are now exported as Markdown when Desktop Integration is activated
  • Previously, only new notes created after activation were exported
  • Progress dialog shows export status with current/total counter
  • Error handling for network issues during export
  • Individual note failures don't abort the entire export

• Markdown Directory Structure Fix

  • Markdown files now correctly land in /notes-md/ folder
  • Smart URL detection supports both Root-URL and /notes URL structures
  • Previously, MD files were incorrectly placed in the root directory
  • Markdown import now finds files correctly

• JSON URL Normalization

  • Simplified server configuration: enter only base URL (e.g., http://server:8080/)
  • App automatically creates /notes/ for JSON files and /notes-md/ for Markdown
  • Smart detection: both http://server:8080/ and http://server:8080/notes/ work correctly
  • Backward compatible: existing setups with /notes in URL continue to work
  • No migration required for existing users

Changed

• Markdown Directory Creation

  • notes-md/ folder is now created on first sync (regardless of Desktop Integration setting)
  • Prevents 404 errors when mounting WebDAV folder
  • Better user experience: folder is visible before enabling the feature

• Settings UI Improvements

  • Updated example URL from /webdav to /notes to match app behavior
  • Example now shows: http://192.168.0.188:8080/notes

Technical

• WebDavSyncService.ensureMarkdownDirectoryExists() - Creates MD folder early
• WebDavSyncService.getMarkdownUrl() - Smart URL detection for both structures
• WebDavSyncService.exportAllNotesToMarkdown() - Exports all local notes with progress callback
• SettingsActivity.onMarkdownExportToggled() - Triggers initial export with ProgressDialog

---

1.2.0 - 2026-01-04

Added

• Local Backup System

  • Export all notes as JSON file to any location (Downloads, SD card, cloud folder)
  • Import backup with 3 modes: Merge, Replace, or Overwrite duplicates
  • Automatic safety backup created before every restore
  • Backup validation (format and version check)

• Markdown Desktop Integration

  • Optional Markdown export parallel to JSON sync
  • .md files synced to notes-md/ folder on WebDAV
  • YAML frontmatter with id, created, updated, device
  • Manual import button to pull Markdown changes from server
  • Last-Write-Wins conflict resolution via timestamps

• Settings UI Extensions

  • New "Backup & Restore" section with local + server restore
  • New "Desktop Integration" section with Markdown toggle
  • Universal restore dialog with radio button mode selection

Changed

• Server Restore Behavior: Users now choose restore mode (Merge/Replace/Overwrite) instead of hard-coded replace-all

Technical

• BackupManager.kt - Complete backup/restore logic
• Note.toMarkdown() / Note.fromMarkdown() - Markdown conversion with YAML frontmatter
• WebDavSyncService - Extended for dual-format sync (JSON master + Markdown mirror)
• ISO8601 timestamp formatting for desktop compatibility
• Filename sanitization for safe Markdown file names

Documentation

• Added WebDAV mount instructions (Windows, macOS, Linux)
• Complete sync architecture documentation
• Desktop integration analysis

---

1.1.2 - 2025-12-28

Fixed

• "Job was cancelled" Error

  • Fixed coroutine cancellation in sync worker
  • Proper error handling for interrupted syncs

• UI Improvements

  • Back arrow instead of X in note editor (better UX)
  • Pull-to-refresh for manual sync trigger
  • HTTP/HTTPS protocol selection with radio buttons
  • Inline error display (no toast spam)

• Performance & Battery

  • Sync only on actual changes (saves battery)
  • Auto-save notifications removed
  • 24-hour server offline warning instead of instant error

Changed

• Settings grouped into "Auto-Sync" and "Sync Interval" sections
• HTTP only allowed for local networks (RFC 1918 IPs)
• Swipe-to-delete without UI flicker

---

1.1.1 - 2025-12-27

Fixed

• WiFi Connect Sync
  • No error notifications in foreign WiFi networks
  • Server reachability check before sync (2s timeout)
  • Silent abort when server offline
  • Pre-check waits until network is ready
  • No errors during network initialization

Changed

• Notifications
  • Old sync notifications cleared on app start
  • Error notifications auto-dismiss after 30 seconds

UI

• Sync icon only shown when sync is configured
• Swipe-to-delete without flicker
• Scroll to top after saving note

Technical

• Server check with 2-second timeout before sync attempts
• Network readiness check in WiFi connect trigger
• Notification cleanup on MainActivity.onCreate()

---

1.1.0 - 2025-12-26

Added

• Configurable Sync Intervals

  • User choice: 15, 30, or 60 minutes
  • Real-world battery impact displayed (15min: ~0.8%/day, 30min: ~0.4%/day, 60min: ~0.2%/day)
  • Radio button selection in settings
  • Doze Mode optimization (syncs batched in maintenance windows)

• About Section

  • App version from BuildConfig
  • Links to GitHub repository and developer profile
  • MIT license information
  • Material 3 card design

Changed

• Settings UI redesigned with grouped sections
• Periodic sync updated dynamically when interval changes
• WorkManager uses selected interval for background sync

Removed

• Debug/Logs section from settings (cleaner UI)

Technical

• PREF_SYNC_INTERVAL_MINUTES preference key
• NetworkMonitor reads interval from SharedPreferences
• ExistingPeriodicWorkPolicy.UPDATE for live interval changes

---

1.0.0 - 2025-12-25

Added

• Initial release
• WebDAV synchronization
• Note creation, editing, deletion
• 6 sync triggers:
  • Periodic sync (configurable interval)
  • App start sync
  • WiFi connect sync
  • Manual sync (menu button)
  • Pull-to-refresh
  • Settings "Sync Now" button
• Material 3 design
• Light/Dark theme support
• F-Droid compatible (100% FOSS)

---