Simple Notes Sync 📝
Minimalist offline notes with auto-sync to your own server
📱 APK Download · 📖 Documentation · 🚀 Quick Start
🌍 Languages: Deutsch · English
📱 Screenshots
Features
📝 Notes
- Simple text notes with auto-save
- Swipe-to-delete with confirmation
- Material Design 3 editor
💾 Backup & Restore NEW in v1.2.0
- Local backup - Export all notes as JSON file
- Flexible restore - 3 modes (Merge, Replace, Overwrite)
- Automatic safety net - Auto-backup before every restore
- Independent from server - Works completely offline
🖥️ Desktop Integration NEW in v1.2.0
- Markdown export - Notes are automatically exported as
.mdfiles - WebDAV access - Mount WebDAV as network drive for direct access
- Editor compatibility - VS Code, Typora, Notepad++, or any Markdown editor
- Last-Write-Wins - Intelligent conflict resolution via timestamps
- Dual-format - JSON sync remains master, Markdown is optional mirror
🔄 Synchronization
- Pull-to-refresh for manual sync
- Auto-sync (15/30/60 min) only on home WiFi
- Smart server check - No errors on foreign networks
- Conflict-free merging - Your changes are never lost
- 6 sync triggers - Periodic, app-start, WiFi, manual, pull-to-refresh, settings
🔒 Privacy & Self-Hosted
- WebDAV server (Nextcloud, ownCloud, etc.)
- Docker setup guide included in docs
- Your data stays with you - No tracking, no cloud
- HTTP only local - HTTPS for external servers
- 100% open source (MIT License)
🔋 Performance
- Battery-friendly (~0.2-0.8% per day)
- Offline-first - Works without internet
- Dark mode & dynamic colors
🚀 Quick Start
1. Server Setup
cd server
cp .env.example .env
# Set password in .env
docker compose up -d
➡️ Details: Server Setup Guide
2. App Installation
- Download APK
- Install & open
- ⚙️ Settings → Configure server
- Enable auto-sync
➡️ Details: Complete guide
<EFBFBD> Local Backup & Restore
Create Backup
- Settings → Backup & Restore
- Tap "📥 Create backup"
- Choose location (Downloads, SD card, cloud folder)
- Done! All notes are saved in a
.jsonfile
Filename: simplenotes_backup_YYYY-MM-DD_HHmmss.json
Restore
- Settings → "📤 Restore from file"
- Select backup file
- Choose restore mode:
- Merge (Default) - Add new notes, keep existing ones
- Replace - Delete all and import backup
- Overwrite duplicates - Backup wins on ID conflicts
- Confirm - Automatic safety backup is created!
💡 Tip: Before every restore, an automatic safety backup is created - your data is safe!
🖥️ Desktop Integration (WebDAV + Markdown)
Why Markdown?
The app automatically exports your notes as .md files so you can edit them on desktop:
- JSON remains master - Primary sync mechanism (reliable, fast)
- Markdown is mirror - Additional export for desktop access
- Dual-format - Both formats are always in sync
Setup: WebDAV as Network Drive
With WebDAV mount ANY Markdown editor works!
Windows:
- Open Explorer → Right-click on "This PC"
- "Map network drive"
- Enter WebDAV URL:
http://YOUR-SERVER:8080/notes-md/ - Enter username/password
- Done! - Folder appears as drive (e.g. Z:)
macOS:
- Finder → Menu "Go" → "Connect to Server" (⌘K)
- Server Address:
http://YOUR-SERVER:8080/notes-md/ - Enter username/password
- Done! - Folder appears under "Network"
Linux:
# Option 1: GNOME Files / Nautilus
Files → Other Locations → Connect to Server
Server Address: dav://YOUR-SERVER:8080/notes-md/
# Option 2: davfs2 (permanent mount)
sudo apt install davfs2
sudo mount -t davfs http://YOUR-SERVER:8080/notes-md/ /mnt/notes
Workflow:
- Enable Markdown export (App → Settings)
- Mount WebDAV (see above)
- Open editor (VS Code, Typora, Notepad++, etc.)
- Edit notes - Changes are saved directly
- "Import Markdown Changes" in app - Import desktop changes
Recommended Editors:
-
VS Code - Free, powerful, with Markdown preview
-
Typora - Minimalist, WYSIWYG Markdown
-
Notepad++ - Lightweight, fast
-
iA Writer - Focused writing
-
VS Code with WebDAV extension
-
Typora (local copy)
-
iA Writer (read/edit only, no auto-sync)
⚠️ Important:
- Markdown export is optional (toggle in settings)
- JSON sync always works - Markdown is additional
- All 6 sync triggers remain unchanged
<EFBFBD>📚 Documentation
- Quick Start Guide - Step-by-step guide for end users
- Server Setup - Configure WebDAV server
- Complete Docs - Features, troubleshooting, build instructions
🛠️ Development
cd android
./gradlew assembleStandardRelease
➡️ Details: Build instructions in DOCS.en.md
🤝 Contributing
Contributions are welcome! See CONTRIBUTING.md for details.
<EFBFBD> Changelog
All changes are documented in CHANGELOG.md.
<EFBFBD>📄 License
MIT License - see LICENSE
v1.2.0 · Built with Kotlin + Material Design 3


