hmalik144/simple-notes-sync
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
2a56dd812816fee0ff414daa97222eb3d2bf276d
simple-notes-sync/QUICKSTART.en.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

5.9 KiB
Raw Blame History

Quick Start Guide - Simple Notes Sync 📝

Step-by-step installation and setup guide

🌍 Languages: Deutsch · English

Prerequisites

  • ✅ Android 8.0+ smartphone/tablet
  • ✅ WiFi connection
  • ✅ Own server with Docker (optional - for self-hosting)

Option 1: With own server (Self-Hosted) 🏠

Step 1: Setup WebDAV Server

On your server (e.g. Raspberry Pi, NAS, VPS):

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

# Configure environment variables
cp .env.example .env
nano .env

Adjust in .env:

WEBDAV_PASSWORD=your-secure-password-here

Start server:

docker compose up -d

Find IP address:

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

➡️ Note down: http://YOUR-SERVER-IP:8080/

Step 2: Install App

  1. Download APK: Latest version

    • Choose: simple-notes-sync-vX.X.X-standard-universal.apk

  2. Allow installation:

    • Android: Settings → Security → Enable "Unknown sources" for your browser

  3. Open and install APK

Step 3: Configure App

  1. Open app

  2. Open settings (⚙️ icon top right)

  3. Configure server settings:

    Field Value
    WebDAV Server URL http://YOUR-SERVER-IP:8080/
    Username noteuser
    Password (your password from .env)
    Gateway SSID Name of your WiFi network

    💡 Note: Enter only the base URL (without /notes). The app automatically creates /notes/ for JSON files and /notes-md/ for Markdown export.

  4. Press "Test connection"**

  5. Enable auto-sync (toggle switch)

  6. Choose sync interval:

    • 15 min - Maximum currency (~0.8% battery/day)
    • 30 min - Recommended (~0.4% battery/day) ⭐
    • 60 min - Maximum battery life (~0.2% battery/day)

Step 4: Create First Note

  1. Back to main view (← arrow)

  2. "Add note" (+ icon)

  3. Enter title and text

  4. Save (💾 icon)

  5. Wait for auto-sync (or manually: ⚙️ → "Sync now")

🎉 Done! Your notes will be automatically synchronized!

Option 2: Local notes only (no server) 📱

You can also use Simple Notes without a server:

  1. Install app (see step 2 above)

  2. Use without server configuration:

    • Notes are only stored locally
    • No auto-sync
    • Perfect for offline-only use

🔋 Disable Battery Optimization

For reliable auto-sync:

  1. Settings → Apps → Simple Notes Sync

  2. Battery → Battery usage

  3. Select: "Don't optimize" or "Unrestricted"

💡 Note: Android Doze Mode may still delay sync in standby (~60 min). This is normal and affects all apps.

📊 Sync Intervals in Detail

Interval Syncs/day Battery/day Battery/sync Use case
15 min ~96 ~0.8% (~23 mAh) ~0.008% ⚡ Maximum currency (multiple devices)
30 min ~48 ~0.4% (~12 mAh) ~0.008% ✓ Recommended - balanced
60 min ~24 ~0.2% (~6 mAh) ~0.008% 🔋 Maximum battery life

🐛 Troubleshooting

Connection test fails

Problem: "Connection failed" during test

Solutions:

  1. Server running?

    docker compose ps
# Should show "Up"

  2. Same WiFi?

    • Smartphone and server must be on same network
    • Check SSID in app settings

  3. IP address correct?

    ip addr show | grep "inet "
# Check if IP in URL matches

  4. Firewall?

    # Open port 8080 (if firewall active)
sudo ufw allow 8080/tcp

  5. Check server logs:

    docker compose logs -f

Auto-sync not working

Problem: Notes are not automatically synchronized

Solutions:

  1. Auto-sync enabled?

    • ⚙️ Settings → Toggle "Auto-sync" must be ON

  2. Battery optimization disabled?

  3. On correct WiFi?

    • Sync only works when SSID = Gateway SSID
    • Check current SSID in Android settings

  4. Test manually:

    • ⚙️ Settings → "Sync now"
    • Works? → Auto-sync should work too

Notes not showing up

Problem: After installation, no notes visible even though they exist on server

Solution:

  1. Manually sync once:

    • ⚙️ Settings → "Sync now"

  2. Check server data:

    docker compose exec webdav ls -la /data/
# Should show .json files

Sync errors

Problem: Error message during sync

Solutions:

  1. "401 Unauthorized" → Wrong password

    • Check password in app settings
    • Compare with .env on server

  2. "404 Not Found" → Wrong URL

    • Should end with / (e.g. http://192.168.1.100:8080/)

  3. "Network error" → No connection

📱 Updates

Automatic with Obtainium (recommended)

  1. Install Obtainium

  2. Add app:

    • URL: https://github.com/inventory69/simple-notes-sync
    • Enable auto-update

  3. Done! Obtainium notifies you of new versions

Manual

  1. Download new APK from Releases

  2. Install (overwrites old version)

  3. All data remains intact!

🆘 Further Help

Version: 1.1.0 · Created: December 2025