simple-notes-sync/docs/FEATURES.de.md

Vollständige Feature-Liste 📋

🌍 Sprachen: Deutsch · English

Alle Features von Simple Notes Sync im Detail

---

📝 Notiz-Verwaltung

Notiz-Typen

• ✅ Textnotizen - Klassische Freitext-Notizen
• ✅ Checklisten (NEU in v1.4.0) - Aufgabenlisten mit Tap-to-Check
  • ➕ Items hinzufügen über Eingabefeld
  • ☑️ Tap zum Abhaken/Wieder-Öffnen
  • 📌 Long-Press für Drag & Drop Sortierung
  • Durchstreichen bei erledigten Einträgen

Basis-Funktionen

• ✅ Automatisches Speichern - Kein manuelles Speichern nötig
• ✅ Titel + Inhalt - Klare Struktur für jede Notiz
• ✅ Zeitstempel - Erstellungs- und Änderungsdatum automatisch
• ✅ Auswahlmodus (NEU in v1.5.0) - Long-Press für Mehrfachauswahl und Batch-Löschen
• ✅ Bestätigungs-Dialog - Schutz vor versehentlichem Löschen
• ✅ Jetpack Compose UI (NEU in v1.5.0) - Moderne, performante Benutzeroberfläche
• ✅ Material Design 3 - Moderne, saubere UI
• ✅ Dark Mode - Automatisch je nach System-Einstellung
• ✅ Dynamic Colors - Passt sich deinem Android-Theme an

Editor

• ✅ Minimalistischer Editor - Kein Schnickschnack
• ✅ Auto-Fokus - Direkt losschreiben
• ✅ Vollbild-Modus - Maximale Schreibfläche
• ✅ Speichern-Button - Manuelle Bestätigung möglich
• ✅ Zurück-Navigation - Speichert automatisch
• ✅ Slide-Animationen (NEU in v1.5.0) - Flüssige Übergänge

---

📊 Ansichten & Layout (NEU in v1.7.0+)

Darstellungsmodi

• ✅ Listenansicht - Klassisches Listen-Layout
• ✅ Rasteransicht (NEU in v1.7.0) - Pinterest-artiges Staggered Grid mit dynamischen Vorschauzeilen
• ✅ Layout-Umschalter - Zwischen Listen- und Grid-Ansicht wechseln
• ✅ Adaptive Spalten - 2-3 Spalten basierend auf Bildschirmgröße
• ✅ Grid als Standard (v1.8.0) - Neue Installationen starten im Grid-Modus

Notiz-Sortierung (NEU in v1.8.0)

• ✅ Nach Änderungsdatum - Neueste oder älteste zuerst
• ✅ Nach Erstelldatum - Nach Erstellungszeitpunkt
• ✅ Nach Titel - A-Z oder Z-A
• ✅ Nach Typ - Textnotizen vs. Checklisten
• ✅ Persistente Einstellungen - Sortier-Option bleibt nach App-Neustart
• ✅ Sortier-Dialog - Richtungswahl im Hauptbildschirm

Checklisten-Sortierung (NEU in v1.8.0)

• ✅ Manuell - Eigene Drag & Drop Reihenfolge
• ✅ Alphabetisch - A-Z Sortierung
• ✅ Offene zuerst - Unerledigte Items oben
• ✅ Erledigte zuletzt - Abgehakte Items unten
• ✅ Visueller Trenner - Zwischen offenen/erledigten Gruppen mit Anzahl
• ✅ Auto-Sortierung - Neu sortieren beim Abhaken/Öffnen
• ✅ Drag über Grenzen - Items wechseln Status beim Überqueren des Trenners

---

📌 Homescreen-Widgets (NEU in v1.8.0)

Widget-Features

• ✅ Textnotiz-Widget - Beliebige Notiz auf dem Homescreen anzeigen
• ✅ Checklisten-Widget - Interaktive Checkboxen mit Sync zum Server
• ✅ 5 Größenklassen - SMALL, NARROW_MED, NARROW_TALL, WIDE_MED, WIDE_TALL
• ✅ Material You Farben - Dynamische Farben passend zum System-Theme
• ✅ Einstellbare Transparenz - Hintergrund-Opazität (0-100%)
• ✅ Sperr-Umschalter - Versehentliche Bearbeitungen verhindern
• ✅ Auto-Aktualisierung - Updates nach Sync-Abschluss
• ✅ Konfigurations-Activity - Notiz-Auswahl und Einstellungen
• ✅ Checklisten-Sortierung (v1.8.1) - Widgets übernehmen Sortier-Option
• ✅ Visuelle Trenner (v1.8.1) - Zwischen offenen/erledigten Items

---

🌍 Mehrsprachigkeit (NEU in v1.5.0)

Unterstützte Sprachen

• ✅ Englisch - Primäre Sprache (Standard)
• ✅ Deutsch - Vollständige Übersetzung

Sprachauswahl

• ✅ Automatische Erkennung - Folgt der System-Sprache
• ✅ Manuelle Auswahl - In den Einstellungen umschaltbar
• ✅ Per-App Language - Android 13+ native Sprachauswahl
• ✅ locales_config.xml - Vollständige Android-Integration

Umfang

• ✅ 400+ Strings - Komplett übersetzt
• ✅ UI-Texte - Alle Buttons, Dialoge, Menüs
• ✅ Fehlermeldungen - Hilfreiche lokalisierte Hinweise
• ✅ Einstellungen - 7 kategorisierte Screens

---

💾 Backup & Wiederherstellung

Lokales Backup System

• ✅ JSON-Export - Alle Notizen in einer Datei
• ✅ Freie Speicherort-Wahl - Downloads, SD-Karte, Cloud-Ordner
• ✅ Dateinamen mit Zeitstempel - simplenotes_backup_YYYY-MM-DD_HHmmss.json
• ✅ Vollständiger Export - Titel, Inhalt, Timestamps, IDs
• ✅ Menschenlesbares Format - JSON mit Formatierung
• ✅ Unabhängig vom Server - Funktioniert komplett offline

Wiederherstellungs-Modi

• ✅ Zusammenführen (Merge) - Neue Notizen hinzufügen, bestehende behalten (Standard)
• ✅ Ersetzen (Replace) - Alle löschen und Backup importieren
• ✅ Duplikate überschreiben (Overwrite) - Backup gewinnt bei ID-Konflikten
• ✅ Automatisches Sicherheits-Backup - Vor jeder Wiederherstellung
• ✅ Backup-Validierung - Prüft Format und Version
• ✅ Fehlerbehandlung - Klare Fehlermeldungen bei Problemen

---

🖥️ Desktop-Integration

Markdown-Export

• ✅ Automatischer Export - Jede Notiz → .md Datei
• ✅ Checklisten als Task-Listen (NEU) - - [ ] / - [x] Format (GitHub-kompatibel)
• ✅ Dual-Format - JSON (Master) + Markdown (Mirror)
• ✅ Dateinamen-Sanitization - Sichere Dateinamen aus Titeln
• ✅ Duplikat-Handling (NEU) - ID-Suffix bei gleichen Titeln
• ✅ Frontmatter-Metadata - YAML mit ID, Timestamps, Type
• ✅ WebDAV-Sync - Parallel zum JSON-Sync
• ✅ Optional - In Einstellungen ein/ausschaltbar
• ✅ Initial Export - Alle bestehenden Notizen beim Aktivieren
• ✅ Progress-Anzeige - Zeigt X/Y beim Export

Markdown-Import

• ✅ Desktop → App - Änderungen vom Desktop importieren
• ✅ Last-Write-Wins - Konfliktauflösung via Timestamp
• ✅ Frontmatter-Parsing - Liest Metadata aus .md Dateien
• ✅ Neue Notizen erkennen - Automatisch in App übernehmen
• ✅ Updates erkennen - Nur wenn Desktop-Version neuer ist
• ✅ Fehlertoleranz - Einzelne Fehler brechen Import nicht ab

WebDAV-Zugriff

• ✅ Network Drive Mount - Windows, macOS, Linux
• ✅ Jeder Markdown-Editor - VS Code, Typora, Notepad++, iA Writer
• ✅ Live-Bearbeitung - Direkter Zugriff auf .md Dateien
• ✅ Ordner-Struktur - /notes/ für JSON, /notes-md/ für Markdown
• ✅ Automatische Ordner-Erstellung - Beim ersten Sync

---

🔄 Synchronisation

Auto-Sync

• ✅ Intervall-Auswahl - 15, 30 oder 60 Minuten
• ✅ WiFi-Trigger - Sync bei WiFi-Verbindung (keine SSID-Einschränkung)
• ✅ Akkuschonend - ~0.2-0.8% pro Tag
• ✅ Smart Server-Check - Sync nur wenn Server erreichbar
• ✅ WorkManager - Zuverlässige Background-Ausführung
• ✅ Battery-Optimierung kompatibel - Funktioniert auch mit Doze Mode

Sync-Trigger (6 Stück)

1. ✅ Periodic Sync - Automatisch nach Intervall
2. ✅ App-Start Sync - Beim Öffnen der App
3. ✅ WiFi-Connect Sync - Bei jeder WiFi-Verbindung
4. ✅ Manual Sync - Button in Einstellungen
5. ✅ Pull-to-Refresh - Wisch-Geste in Notizliste
6. ✅ Settings-Save Sync - Nach Server-Konfiguration

Sync-Mechanismus

• ✅ Upload - Lokale Änderungen zum Server
• ✅ Download - Server-Änderungen in App
• ✅ Parallele Downloads (NEU in v1.8.0) - Bis zu 5 gleichzeitige Downloads
• ✅ Konflikt-Erkennung - Bei gleichzeitigen Änderungen
• ✅ Konfliktfreies Merging - Last-Write-Wins via Timestamp
• ✅ Server-Löschungs-Erkennung (NEU in v1.8.0) - Erkennt auf anderen Geräten gelöschte Notizen
• ✅ Sync-Status Tracking - LOCAL_ONLY, PENDING, SYNCED, CONFLICT, DELETED_ON_SERVER
• ✅ Live Fortschritts-UI (NEU in v1.8.0) - Phasen-Anzeige mit Upload/Download-Zählern
• ✅ Fehlerbehandlung - Retry bei Netzwerkproblemen
• ✅ Offline-First - App funktioniert ohne Server

Server-Verbindung

• ✅ WebDAV-Protokoll - Standard-Protokoll
• ✅ HTTP/HTTPS - HTTP nur lokal, HTTPS für extern
• ✅ Username/Password - Basic Authentication
• ✅ Connection Test - In Einstellungen testen
• ✅ WiFi-Only Sync (NEU in v1.7.0) - Option nur über WiFi zu synchronisieren
• ✅ VPN-Unterstützung (NEU in v1.7.0) - Sync funktioniert korrekt über VPN-Tunnels
• ✅ Self-Signed SSL (NEU in v1.7.0) - Unterstützung für selbstsignierte Zertifikate
• ✅ Server-URL Normalisierung - Automatisches /notes/ und /notes-md/ (NEU in v1.2.1)
• ✅ Flexible URL-Eingabe - Beide Varianten funktionieren: http://server/ und http://server/notes/

---

🔒 Privacy & Sicherheit

Self-Hosted

• ✅ Eigener Server - Volle Kontrolle über Daten
• ✅ Keine Cloud - Keine Drittanbieter
• ✅ Kein Tracking - Keine Analytik, keine Telemetrie
• ✅ Kein Account - Nur Server-Zugangsdaten
• ✅ 100% Open Source - MIT Lizenz

Daten-Sicherheit

• ✅ Lokale Speicherung - App-Private Storage (Android)
• ✅ WebDAV-Verschlüsselung - HTTPS für externe Server
• ✅ Passwort-Speicherung - Android SharedPreferences (verschlüsselt)
• ✅ Keine Drittanbieter-Libs - Nur Android SDK + Sardine (WebDAV)

Entwickler-Features

• ✅ Datei-Logging - Optional, nur bei Aktivierung (NEU in v1.3.2)
• ✅ Datenschutz-Hinweis - Explizite Warnung bei Aktivierung
• ✅ Lokale Logs - Logs bleiben auf dem Gerät

---

🔋 Performance & Optimierung

Akku-Effizienz (v1.6.0)

• ✅ Konfigurierbare Sync-Trigger - Jeden Trigger einzeln aktivieren/deaktivieren
• ✅ Smarte Defaults - Nur ereignisbasierte Trigger standardmäßig aktiv
• ✅ Optimierte Periodische Intervalle - 15/30/60 Min (Standard: AUS)
• ✅ WiFi-Only - Kein Mobile Data Sync
• ✅ Smart Server-Check - Sync nur wenn Server erreichbar
• ✅ WorkManager - System-optimierte Ausführung
• ✅ Doze Mode kompatibel - Sync läuft auch im Standby
• ✅ Gemessener Verbrauch:
  • Standard (nur ereignisbasiert): ~0.2%/Tag (~6.5 mAh) ⭐ Optimal
  • Mit Periodic 15 Min: ~1.0%/Tag (~30 mAh)
  • Mit Periodic 30 Min: ~0.6%/Tag (~19 mAh)
  • Mit Periodic 60 Min: ~0.4%/Tag (~13 mAh)

App-Performance

• ✅ Offline-First - Funktioniert ohne Internet
• ✅ Instant-Load - Notizen laden in <100ms
• ✅ Smooth Scrolling - RecyclerView mit ViewHolder
• ✅ Material Design 3 - Native Android UI
• ✅ Kotlin Coroutines - Asynchrone Operationen
• ✅ Minimale APK-Größe - ~2 MB

---

🛠️ Technische Details

Plattform

• ✅ Android 7.0+ (API 24+)
• ✅ Target SDK 36 (Android 15)
• ✅ Kotlin - Moderne Programmiersprache
• ✅ Jetpack Compose - Deklaratives UI-Framework
• ✅ Material Design 3 - Neueste Design-Richtlinien
• ✅ Jetpack Glance (v1.8.0) - Widget-Framework

Architektur

• ✅ MVVM-Light - Einfache Architektur
• ✅ Single Activity - Moderne Navigation
• ✅ Kotlin Coroutines - Async/Await Pattern
• ✅ Dispatchers.IO - Background-Operationen
• ✅ SharedPreferences - Settings-Speicherung
• ✅ File-Based Storage - JSON-Dateien lokal
• ✅ Custom Exceptions - Dedizierte SyncException für bessere Fehlerbehandlung (NEU in v1.3.2)

Abhängigkeiten

• ✅ AndroidX - Jetpack Libraries
• ✅ Material Components - Material Design 3
• ✅ Sardine - WebDAV Client (com.thegrizzlylabs)
• ✅ Gson - JSON Serialization
• ✅ WorkManager - Background Tasks
• ✅ OkHttp - HTTP Client (via Sardine)
• ✅ Glance (v1.8.0) - Widget-Framework

Build-Varianten

• ✅ Standard - Universal APK (100% FOSS, keine Google-Dependencies)
• ✅ F-Droid - Identisch mit Standard (100% FOSS)
• ✅ Debug/Release - Entwicklung und Production
• ✅ Keine Google Services - Komplett FOSS, keine proprietären Bibliotheken

---

📦 Server-Kompatibilität

Getestete WebDAV-Server

• ✅ Docker WebDAV (empfohlen für Self-Hosting)
• ✅ Nextcloud - Vollständig kompatibel
• ✅ ownCloud - Funktioniert einwandfrei
• ✅ Apache mod_dav - Standard WebDAV
• ✅ nginx + WebDAV - Mit korrekter Konfiguration

Server-Features

• ✅ Basic Auth - Username/Password
• ✅ Directory Listing - Für Download
• ✅ PUT/GET - Upload/Download
• ✅ MKCOL - Ordner erstellen
• ✅ DELETE - Notizen löschen (zukünftig)

---

🔮 Zukünftige Features

Geplant für kommende Versionen – siehe UPCOMING.md für die vollständige Roadmap.

v2.0.0 - Legacy Cleanup

• ⏳ Veraltete Activities entfernen - Durch Compose-Varianten ersetzen
• ⏳ LocalBroadcastManager → SharedFlow - Moderne Event-Architektur
• ⏳ WebDavSyncService aufteilen - SyncOrchestrator, NoteUploader, NoteDownloader

---

📊 Vergleich mit anderen Apps

Feature	Simple Notes Sync	Google Keep	Nextcloud Notes
Offline-First	✅	⚠️ Eingeschränkt	⚠️ Eingeschränkt
Self-Hosted	✅	❌	✅
Auto-Sync	✅	✅	✅
Markdown-Export	✅	❌	✅
Desktop-Zugriff	✅ (WebDAV)	✅ (Web)	✅ (Web + WebDAV)
Lokales Backup	✅	❌	⚠️ Server-Backup
Kein Google-Account	✅	❌	✅
Open Source	✅ MIT	❌	✅ AGPL
APK-Größe	~2 MB	~50 MB	~8 MB
Akku-Verbrauch	~0.4%/Tag	~1-2%/Tag	~0.5%/Tag

---

❓ FAQ

Q: Brauche ich einen Server?
A: Nein! Die App funktioniert auch komplett offline. Der Server ist optional für Sync.

Q: Welcher Server ist am besten?
A: Für Einstieg: Docker WebDAV (einfach, leicht). Für Profis: Nextcloud (viele Features).

Q: Funktioniert Markdown-Export ohne Desktop-Integration?
A: Nein, du musst das Feature in den Einstellungen aktivieren.

Q: Gehen meine Daten verloren wenn ich den Server wechsle?
A: Nein! Erstelle ein lokales Backup, wechsle Server, stelle wieder her.

Q: Warum JSON + Markdown?
A: JSON ist zuverlässig und schnell (Master). Markdown ist menschenlesbar (Mirror für Desktop).

Q: Kann ich die App ohne Google Play nutzen?
A: Ja! Lade die APK direkt von GitHub oder nutze F-Droid.

---

Letzte Aktualisierung: v1.8.1 (2026-02-11)