simple-notes-sync/QUICKSTART.de.md

Quick Start Guide - Simple Notes Sync 📝

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

🌍 Sprachen: Deutsch · English

---

Voraussetzungen

• ✅ Android 7.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.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?

   • Siehe Akku-Optimierung

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

   • Siehe Verbindungstest schlägt fehl

---

📱 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

• GitHub Issues: Problem melden
• Vollständige Docs: DOCS.md
• Server Setup Details: server/README.md

---

Version: 1.1.0 · Erstellt: Dezember 2025