hmalik144/simple-notes-sync
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c7d0f899e72ad5e56dc4b3030d63777cf41f8618
simple-notes-sync/QUICKSTART.md
inventory69 015b90d56e 🐛 v1.2.1: Markdown Initial Export Bugfix + URL Normalization + GitHub Workflow Fix 
## 🐛 Fixed
- Initial Markdown export: Existing notes now exported when Desktop Integration activated
- Markdown directory structure: Files now land correctly in /notes-md/
- JSON URL normalization: Smart detection for both Root-URL and /notes-URL
- GitHub release notes: Fixed language order (DE primary, EN collapsible) and emoji

## ✨ Improved
- Settings UI: Example URL shows /notes instead of /webdav
- Server config: Enter only base URL (app adds /notes/ and /notes-md/ automatically)
- Flexible URL input: Both http://server/ and http://server/notes/ work
- Changelogs: Shortened for F-Droid 500 char limit

## 🔧 Technical
- getNotesUrl() helper with smart /notes/ detection
- getMarkdownUrl() simplified to use getNotesUrl()
- All JSON operations updated to use normalized URLs
- exportAllNotesToMarkdown() with progress callback
- Workflow: Swapped CHANGELOG_DE/EN, replaced broken emoji with 🌍

versionCode: 6
versionName: 1.2.1
2026-01-05 11:46:25 +01:00

6.4 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)
    Gateway SSID Name deines WLAN-Netzwerks

    💡 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. Gleiche WLAN?

    • Smartphone und Server müssen im selben Netzwerk sein
    • Prüfe SSID in App-Einstellungen

  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. Im richtigen WLAN?

    • Sync funktioniert nur wenn SSID = Gateway SSID
    • Prüfe aktuelle SSID in Android-Einstellungen

  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