hmalik144/simple-notes-sync
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0c8f21ef5822a08e108ccc5c6e7e3703d120d077
simple-notes-sync/QUICKSTART.de.md
inventory69 67b226a5c3 feat(v1.5.0): icons, batch delete toast, cursor fix, docs refactor 
FEATURES
========

Batch Delete Toast Aggregation:
- New deleteMultipleNotesFromServer() method
- Shows single aggregated toast instead of multiple ("3 notes deleted from server")
- Partial success handling ("3 of 5 notes deleted from server")
- Added string resources: snackbar_notes_deleted_from_server, snackbar_notes_deleted_from_server_partial

Text Editor Cursor Fix:
- Fixed cursor jumping to end after every keystroke when editing notes
- Added initialCursorSet flag to only set cursor position on first load
- Cursor now stays at user's position while editing
- Changed LaunchedEffect(content) to LaunchedEffect(Unit) to prevent repeated resets

DOCUMENTATION REFACTOR
======================

Breaking Change: English is now the default language
- README.md: Now English (was German)
- QUICKSTART.md: Now English (was German)
- CHANGELOG.md: Now English (was mixed EN/DE)
- docs/*.md: All English (was German)
- German versions: Use .de.md suffix (README.de.md, QUICKSTART.de.md, etc.)

Updated for v1.5.0:
- CHANGELOG.md: Fully translated to English with v1.5.0 release notes
- CHANGELOG.de.md: Created German version
- FEATURES.md: Added i18n section, Selection Mode, Jetpack Compose updates
- FEATURES.de.md: Updated with v1.5.0 features
- UPCOMING.md: v1.5.0 marked as released, v1.6.0/v1.7.0 roadmap
- UPCOMING.de.md: Updated German version

All language headers updated:
- English: [Deutsch](*.de.md) · **English**
- German: **Deutsch** · [English](*.md)

F-DROID METADATA
================

Changelogs (F-Droid):
- fastlane/metadata/android/en-US/changelogs/13.txt: Created
- fastlane/metadata/android/de-DE/changelogs/13.txt: Created

Descriptions:
- full_description.txt (EN/DE): Updated with v1.5.0 changes
  - Selection Mode instead of Swipe-to-Delete
  - i18n support highlighted
  - Jetpack Compose UI mentioned
  - Silent-Sync Mode added

OTHER FIXES
===========

Code Quality:
- Unused imports removed from multiple files
- maxLineLength fixes
- Detekt config optimized (increased thresholds for v1.5.0)
- AboutScreen: Uses app foreground icon directly
- EmptyState: Shows app icon instead of emoji
- themes.xml: Splash screen uses app foreground icon
2026-01-16 16:31:30 +01:00

6.3 KiB
Raw Blame History

Quick Start Guide - Simple Notes Sync 📝

Schritt-für-Schritt Anleitung zur Installation und Einrichtung

🌍 Sprachen: Deutsch · English

Voraussetzungen

  • ✅ Android 8.0+ Smartphone/Tablet
  • ✅ WLAN-Verbindung
  • ✅ Eigener Server mit Docker (optional - für Self-Hosting)

Option 1: Mit eigenem Server (Self-Hosted) 🏠

Schritt 1: WebDAV Server einrichten

Auf deinem Server (z.B. Raspberry Pi, NAS, VPS):

# Repository klonen
git clone https://github.com/inventory69/simple-notes-sync.git
cd simple-notes-sync/server

# Umgebungsvariablen konfigurieren
cp .env.example .env
nano .env

In .env anpassen:

WEBDAV_PASSWORD=dein-sicheres-passwort-hier

Server starten:

docker compose up -d

IP-Adresse finden:

ip addr show | grep "inet " | grep -v 127.0.0.1

➡️ Notiere dir: http://DEINE-SERVER-IP:8080/

Schritt 2: App installieren

  1. APK herunterladen: Neueste Version

    • Wähle: simple-notes-sync-vX.X.X-standard-universal.apk

  2. Installation erlauben:

    • Android: Einstellungen → Sicherheit → "Unbekannte Quellen" für deinen Browser aktivieren

  3. APK öffnen und installieren

Schritt 3: App konfigurieren

  1. App öffnen

  2. Einstellungen öffnen (⚙️ Icon oben rechts)

  3. Server-Einstellungen konfigurieren:

    Feld Wert
    WebDAV Server URL http://DEINE-SERVER-IP:8080/
    Benutzername noteuser
    Passwort (dein Passwort aus .env)

    💡 Hinweis: Gib nur die Base-URL ein (ohne /notes). Die App erstellt automatisch /notes/ für JSON-Dateien und /notes-md/ für Markdown-Export.

  4. "Verbindung testen" drücken

    • ✅ Erfolg? → Weiter zu Schritt 4
    • ❌ Fehler? → Siehe Troubleshooting

  5. Auto-Sync aktivieren (Toggle Switch)

  6. Sync-Intervall wählen:

    • 15 Min - Maximale Aktualität (~0.8% Akku/Tag)
    • 30 Min - Empfohlen (~0.4% Akku/Tag) ⭐
    • 60 Min - Maximale Akkulaufzeit (~0.2% Akku/Tag)

Schritt 4: Erste Notiz erstellen

  1. Zurück zur Hauptansicht (← Pfeil)

  2. "Notiz hinzufügen" (+ Icon)

  3. Titel und Text eingeben

  4. Speichern (💾 Icon)

  5. Warten auf Auto-Sync (oder manuell: ⚙️ → "Jetzt synchronisieren")

🎉 Fertig! Deine Notizen werden automatisch synchronisiert!

Option 2: Nur lokale Notizen (kein Server) 📱

Du kannst Simple Notes auch ohne Server nutzen:

  1. App installieren (siehe Schritt 2 oben)

  2. Ohne Server-Konfiguration verwenden:

    • Notizen werden nur lokal gespeichert
    • Kein Auto-Sync
    • Perfekt für reine Offline-Nutzung

🔋 Akku-Optimierung deaktivieren

Für zuverlässigen Auto-Sync:

  1. Einstellungen → Apps → Simple Notes Sync

  2. Akku → Akkuverbrauch

  3. Wähle: "Nicht optimieren" oder "Unbeschränkt"

💡 Hinweis: Android Doze Mode kann trotzdem Sync im Standby verzögern (~60 Min). Das ist normal und betrifft alle Apps.

📊 Sync-Intervalle im Detail

Intervall Syncs/Tag Akku/Tag Akku/Sync Anwendungsfall
15 Min ~96 ~0.8% (~23 mAh) ~0.008% ⚡ Maximal aktuell (mehrere Geräte)
30 Min ~48 ~0.4% (~12 mAh) ~0.008% ✓ Empfohlen - ausgewogen
60 Min ~24 ~0.2% (~6 mAh) ~0.008% 🔋 Maximale Akkulaufzeit

🐛 Troubleshooting

Verbindungstest schlägt fehl

Problem: "Verbindung fehlgeschlagen" beim Test

Lösungen:

  1. Server läuft?

    docker compose ps
# Sollte "Up" zeigen

  2. Gleiches Netzwerk?

    • Smartphone und Server müssen im selben Netzwerk sein

  3. IP-Adresse korrekt?

    ip addr show | grep "inet "
# Prüfe ob IP in URL stimmt

  4. Firewall?

    # Port 8080 öffnen (falls Firewall aktiv)
sudo ufw allow 8080/tcp

  5. Server-Logs prüfen:

    docker compose logs -f

Auto-Sync funktioniert nicht

Problem: Notizen werden nicht automatisch synchronisiert

Lösungen:

  1. Auto-Sync aktiviert?

    • ⚙️ Einstellungen → Toggle "Auto-Sync" muss AN sein

  2. Akku-Optimierung deaktiviert?

  3. Mit WiFi verbunden?

    • Auto-Sync triggert bei jeder WiFi-Verbindung
    • Prüfe, ob du mit einem WLAN verbunden bist

  4. Manuell testen:

    • ⚙️ Einstellungen → "Jetzt synchronisieren"
    • Funktioniert das? → Auto-Sync sollte auch funktionieren

Notizen werden nicht angezeigt

Problem: Nach Installation sind keine Notizen da, obwohl welche auf dem Server liegen

Lösung:

  1. Einmalig manuell synchronisieren:

    • ⚙️ Einstellungen → "Jetzt synchronisieren"

  2. Server-Daten prüfen:

    docker compose exec webdav ls -la /data/
# Sollte .json Dateien zeigen

Fehler beim Sync

Problem: Fehlermeldung beim Synchronisieren

Lösungen:

  1. "401 Unauthorized" → Passwort falsch

    • Prüfe Passwort in App-Einstellungen
    • Vergleiche mit .env auf Server

  2. "404 Not Found" → URL falsch

    • Sollte enden mit / (z.B. http://192.168.1.100:8080/)

  3. "Network error" → Keine Verbindung

📱 Updates

Automatisch mit Obtainium (empfohlen)

  1. Obtainium installieren

  2. App hinzufügen:

    • URL: https://github.com/inventory69/simple-notes-sync
    • Auto-Update aktivieren

  3. Fertig! Obtainium benachrichtigt dich bei neuen Versionen

Manuell

  1. Neue APK von Releases herunterladen

  2. Installieren (überschreibt alte Version)

  3. Alle Daten bleiben erhalten!

🆘 Weitere Hilfe

Version: 1.1.0 · Erstellt: Dezember 2025