1d010d0034
- NEW: Configurable sync triggers (onSave, onResume, WiFi, Periodic, Boot) - NEW: Offline mode toggle to disable all network features - Various fixes and UI improvements - Version bumped to 1.6.0 (code 14)
309 lines
11 KiB
Markdown
309 lines
11 KiB
Markdown
# Complete Feature List 📋
|
||
|
||
**🌍 Languages:** [Deutsch](FEATURES.de.md) · **English**
|
||
|
||
> All features of Simple Notes Sync in detail
|
||
|
||
---
|
||
|
||
## 📝 Note Management
|
||
|
||
### Note Types
|
||
- ✅ **Text notes** - Classic free-form notes
|
||
- ✅ **Checklists** _(NEW in v1.4.0)_ - Task lists with tap-to-check
|
||
- ➕ Add items via input field
|
||
- ☑️ Tap to check/uncheck
|
||
- 📌 Long-press for drag & drop sorting
|
||
- ~~Strikethrough~~ for completed entries
|
||
|
||
### Basic Features
|
||
- ✅ **Auto-save** - No manual saving needed
|
||
- ✅ **Title + content** - Clear structure for each note
|
||
- ✅ **Timestamps** - Creation and modification date automatically
|
||
- ✅ **Selection Mode** _(NEW in v1.5.0)_ - Long-press for multi-select and batch delete
|
||
- ✅ **Confirmation dialog** - Protection against accidental deletion
|
||
- ✅ **Jetpack Compose UI** _(NEW in v1.5.0)_ - Modern, performant user interface
|
||
- ✅ **Material Design 3** - Modern, clean UI
|
||
- ✅ **Dark mode** - Automatically based on system settings
|
||
- ✅ **Dynamic colors** - Adapts to your Android theme
|
||
|
||
### Editor
|
||
- ✅ **Minimalist editor** - No bells and whistles
|
||
- ✅ **Auto-focus** - Start writing immediately
|
||
- ✅ **Fullscreen mode** - Maximum writing space
|
||
- ✅ **Save button** - Manual confirmation possible
|
||
- ✅ **Back navigation** - Saves automatically
|
||
- ✅ **Slide animations** _(NEW in v1.5.0)_ - Smooth transitions
|
||
|
||
---
|
||
|
||
## 🌍 Multilingual Support _(NEW in v1.5.0)_
|
||
|
||
### Supported Languages
|
||
- ✅ **English** - Primary language (default)
|
||
- ✅ **German** - Fully translated
|
||
|
||
### Language Selection
|
||
- ✅ **Automatic detection** - Follows system language
|
||
- ✅ **Manual selection** - Switchable in settings
|
||
- ✅ **Per-App Language** - Android 13+ native language selection
|
||
- ✅ **locales_config.xml** - Complete Android integration
|
||
|
||
### Scope
|
||
- ✅ **400+ strings** - Fully translated
|
||
- ✅ **UI texts** - All buttons, dialogs, menus
|
||
- ✅ **Error messages** - Helpful localized hints
|
||
- ✅ **Settings** - 7 categorized screens
|
||
|
||
---
|
||
|
||
## 💾 Backup & Restore
|
||
|
||
### Local Backup System
|
||
- ✅ **JSON export** - All notes in one file
|
||
- ✅ **Free location choice** - Downloads, SD card, cloud folder
|
||
- ✅ **Filenames with timestamp** - `simplenotes_backup_YYYY-MM-DD_HHmmss.json`
|
||
- ✅ **Complete export** - Title, content, timestamps, IDs
|
||
- ✅ **Human-readable format** - JSON with formatting
|
||
- ✅ **Independent from server** - Works completely offline
|
||
|
||
### Restore Modes
|
||
- ✅ **Merge** - Add new notes, keep existing ones _(Default)_
|
||
- ✅ **Replace** - Delete all and import backup
|
||
- ✅ **Overwrite duplicates** - Backup wins on ID conflicts
|
||
- ✅ **Automatic safety backup** - Before every restore
|
||
- ✅ **Backup validation** - Checks format and version
|
||
- ✅ **Error handling** - Clear error messages on issues
|
||
|
||
---
|
||
|
||
## 🖥️ Desktop Integration
|
||
|
||
### Markdown Export
|
||
- ✅ **Automatic export** - Each note → `.md` file
|
||
- ✅ **Checklists as task lists** _(NEW)_ - `- [ ]` / `- [x]` format (GitHub-compatible)
|
||
- ✅ **Dual-format** - JSON (master) + Markdown (mirror)
|
||
- ✅ **Filename sanitization** - Safe filenames from titles
|
||
- ✅ **Duplicate handling** _(NEW)_ - ID suffix for same titles
|
||
- ✅ **Frontmatter metadata** - YAML with ID, timestamps, type
|
||
- ✅ **WebDAV sync** - Parallel to JSON sync
|
||
- ✅ **Optional** - Toggle in settings
|
||
- ✅ **Initial export** - All existing notes when activated
|
||
- ✅ **Progress indicator** - Shows X/Y during export
|
||
|
||
### Markdown Import
|
||
- ✅ **Desktop → App** - Import changes from desktop
|
||
- ✅ **Last-Write-Wins** - Conflict resolution via timestamp
|
||
- ✅ **Frontmatter parsing** - Reads metadata from `.md` files
|
||
- ✅ **Detect new notes** - Automatically adopt to app
|
||
- ✅ **Detect updates** - Only if desktop version is newer
|
||
- ✅ **Error tolerance** - Individual errors don't abort import
|
||
|
||
### WebDAV Access
|
||
- ✅ **Network drive mount** - Windows, macOS, Linux
|
||
- ✅ **Any Markdown editor** - VS Code, Typora, Notepad++, iA Writer
|
||
- ✅ **Live editing** - Direct access to `.md` files
|
||
- ✅ **Folder structure** - `/notes/` for JSON, `/notes-md/` for Markdown
|
||
- ✅ **Automatic folder creation** - On first sync
|
||
|
||
---
|
||
|
||
## 🔄 Synchronization
|
||
|
||
### Auto-Sync
|
||
- ✅ **Interval selection** - 15, 30 or 60 minutes
|
||
- ✅ **WiFi trigger** - Sync on WiFi connection _(no SSID restriction)_
|
||
- ✅ **Battery-friendly** - ~0.2-0.8% per day
|
||
- ✅ **Smart server check** - Sync only when server is reachable
|
||
- ✅ **WorkManager** - Reliable background execution
|
||
- ✅ **Battery optimization compatible** - Works even with Doze mode
|
||
|
||
### Sync Triggers (6 total)
|
||
1. ✅ **Periodic sync** - Automatically after interval
|
||
2. ✅ **App-start sync** - When opening the app
|
||
3. ✅ **WiFi-connect sync** - On any WiFi connection
|
||
4. ✅ **Manual sync** - Button in settings
|
||
5. ✅ **Pull-to-refresh** - Swipe gesture in notes list
|
||
6. ✅ **Settings-save sync** - After server configuration
|
||
|
||
### Sync Mechanism
|
||
- ✅ **Upload** - Local changes to server
|
||
- ✅ **Download** - Server changes to app
|
||
- ✅ **Conflict detection** - On simultaneous changes
|
||
- ✅ **Conflict-free merging** - Last-Write-Wins via timestamp
|
||
- ✅ **Sync status tracking** - LOCAL_ONLY, PENDING, SYNCED, CONFLICT
|
||
- ✅ **Error handling** - Retry on network issues
|
||
- ✅ **Offline-first** - App works without server
|
||
|
||
### Server Connection
|
||
- ✅ **WebDAV protocol** - Standard protocol
|
||
- ✅ **HTTP/HTTPS** - HTTP only local, HTTPS for external
|
||
- ✅ **Username/password** - Basic authentication
|
||
- ✅ **Connection test** - Test in settings
|
||
- ✅ **Server URL normalization** - Automatic `/notes/` and `/notes-md/` _(NEW in v1.2.1)_
|
||
- ✅ **Flexible URL input** - Both variants work: `http://server/` and `http://server/notes/`
|
||
|
||
---
|
||
|
||
## 🔒 Privacy & Security
|
||
|
||
### Self-Hosted
|
||
- ✅ **Own server** - Full control over data
|
||
- ✅ **No cloud** - No third parties
|
||
- ✅ **No tracking** - No analytics, no telemetry
|
||
- ✅ **No account** - Only server credentials
|
||
- ✅ **100% open source** - MIT License
|
||
|
||
### Data Security
|
||
- ✅ **Local storage** - App-private storage (Android)
|
||
- ✅ **WebDAV encryption** - HTTPS for external servers
|
||
- ✅ **Password storage** - Android SharedPreferences (encrypted)
|
||
- ✅ **No third-party libs** - Only Android SDK + Sardine (WebDAV)
|
||
|
||
### Developer Features
|
||
- ✅ **File logging** - Optional, only when enabled _(NEW in v1.3.2)_
|
||
- ✅ **Privacy notice** - Explicit warning on activation
|
||
- ✅ **Local logs** - Logs stay on device
|
||
|
||
---
|
||
|
||
## 🔋 Performance & Optimization
|
||
|
||
### Battery Efficiency (v1.6.0)
|
||
- ✅ **Configurable sync triggers** - Enable/disable each trigger individually
|
||
- ✅ **Smart defaults** - Only event-driven triggers active by default
|
||
- ✅ **Optimized periodic intervals** - 15/30/60 min (default: OFF)
|
||
- ✅ **WiFi-only** - No mobile data sync
|
||
- ✅ **Smart server check** - Sync only when server is reachable
|
||
- ✅ **WorkManager** - System-optimized execution
|
||
- ✅ **Doze mode compatible** - Sync runs even in standby
|
||
- ✅ **Measured consumption:**
|
||
- Default (event-driven only): ~0.2%/day (~6.5 mAh) ⭐ _Optimal_
|
||
- With periodic 15 min: ~1.0%/day (~30 mAh)
|
||
- With periodic 30 min: ~0.6%/day (~19 mAh)
|
||
- With periodic 60 min: ~0.4%/day (~13 mAh)
|
||
|
||
### App Performance
|
||
- ✅ **Offline-first** - Works without internet
|
||
- ✅ **Instant-load** - Notes load in <100ms
|
||
- ✅ **Smooth scrolling** - RecyclerView with ViewHolder
|
||
- ✅ **Material Design 3** - Native Android UI
|
||
- ✅ **Kotlin Coroutines** - Asynchronous operations
|
||
- ✅ **Minimal APK size** - ~2 MB
|
||
|
||
---
|
||
|
||
## 🛠️ Technical Details
|
||
|
||
### Platform
|
||
- ✅ **Android 8.0+** (API 26+)
|
||
- ✅ **Target SDK 36** (Android 15)
|
||
- ✅ **Kotlin** - Modern programming language
|
||
- ✅ **Material Design 3** - Latest design guidelines
|
||
- ✅ **ViewBinding** - Type-safe view references
|
||
|
||
### Architecture
|
||
- ✅ **MVVM-Light** - Simple architecture
|
||
- ✅ **Single Activity** - Modern navigation
|
||
- ✅ **Kotlin Coroutines** - Async/Await pattern
|
||
- ✅ **Dispatchers.IO** - Background operations
|
||
- ✅ **SharedPreferences** - Settings storage
|
||
- ✅ **File-based storage** - JSON files locally
|
||
- ✅ **Custom exceptions** - Dedicated SyncException for better error handling _(NEW in v1.3.2)_
|
||
|
||
### Dependencies
|
||
- ✅ **AndroidX** - Jetpack libraries
|
||
- ✅ **Material Components** - Material Design 3
|
||
- ✅ **Sardine** - WebDAV client (com.thegrizzlylabs)
|
||
- ✅ **Gson** - JSON serialization
|
||
- ✅ **WorkManager** - Background tasks
|
||
- ✅ **OkHttp** - HTTP client (via Sardine)
|
||
|
||
### Build Variants
|
||
- ✅ **Standard** - Universal APK (100% FOSS, no Google dependencies)
|
||
- ✅ **F-Droid** - Identical to Standard (100% FOSS)
|
||
- ✅ **Debug/Release** - Development and production
|
||
- ✅ **No Google Services** - Completely FOSS, no proprietary libraries
|
||
|
||
---
|
||
|
||
## 📦 Server Compatibility
|
||
|
||
### Tested WebDAV Servers
|
||
- ✅ **Docker WebDAV** (recommended for self-hosting)
|
||
- ✅ **Nextcloud** - Fully compatible
|
||
- ✅ **ownCloud** - Works perfectly
|
||
- ✅ **Apache mod_dav** - Standard WebDAV
|
||
- ✅ **nginx + WebDAV** - With correct configuration
|
||
|
||
### Server Features
|
||
- ✅ **Basic Auth** - Username/password
|
||
- ✅ **Directory listing** - For download
|
||
- ✅ **PUT/GET** - Upload/download
|
||
- ✅ **MKCOL** - Create folders
|
||
- ✅ **DELETE** - Delete notes (future)
|
||
|
||
---
|
||
|
||
## 🔮 Future Features
|
||
|
||
Planned for upcoming versions:
|
||
|
||
### v1.4.0 - Checklists
|
||
- ⏳ **Checklist notes** - New note type with checkboxes
|
||
- ⏳ **Completed items** - Strike-through/check off
|
||
- ⏳ **Drag & drop** - Reorder items
|
||
|
||
### v1.5.0 - Internationalization
|
||
- ⏳ **Multi-language** - German + English UI
|
||
- ⏳ **Language selection** - Selectable in settings
|
||
- ⏳ **Full translation** - All strings in both languages
|
||
|
||
### v1.6.0 - Modern APIs
|
||
- ⏳ **Replace LocalBroadcastManager** - Use SharedFlow instead
|
||
- ⏳ **PackageInfo Flags** - Use PackageInfoFlags.of()
|
||
- ⏳ **Complexity refactoring** - Split long functions
|
||
|
||
---
|
||
|
||
## 📊 Comparison with Other Apps
|
||
|
||
| Feature | Simple Notes Sync | Google Keep | Nextcloud Notes |
|
||
|---------|------------------|-------------|-----------------|
|
||
| Offline-first | ✅ | ⚠️ Limited | ⚠️ Limited |
|
||
| Self-hosted | ✅ | ❌ | ✅ |
|
||
| Auto-sync | ✅ | ✅ | ✅ |
|
||
| Markdown export | ✅ | ❌ | ✅ |
|
||
| Desktop access | ✅ (WebDAV) | ✅ (Web) | ✅ (Web + WebDAV) |
|
||
| Local backup | ✅ | ❌ | ⚠️ Server backup |
|
||
| No Google account | ✅ | ❌ | ✅ |
|
||
| Open source | ✅ MIT | ❌ | ✅ AGPL |
|
||
| APK size | ~2 MB | ~50 MB | ~8 MB |
|
||
| Battery usage | ~0.4%/day | ~1-2%/day | ~0.5%/day |
|
||
|
||
---
|
||
|
||
## ❓ FAQ
|
||
|
||
**Q: Do I need a server?**
|
||
A: No! The app works completely offline. The server is optional for sync.
|
||
|
||
**Q: Which server is best?**
|
||
A: For beginners: Docker WebDAV (simple, easy). For pros: Nextcloud (many features).
|
||
|
||
**Q: Does Markdown export work without Desktop Integration?**
|
||
A: No, you need to activate the feature in settings.
|
||
|
||
**Q: Will my data be lost if I switch servers?**
|
||
A: No! Create a local backup, switch servers, restore.
|
||
|
||
**Q: Why JSON + Markdown?**
|
||
A: JSON is reliable and fast (master). Markdown is human-readable (mirror for desktop).
|
||
|
||
**Q: Can I use the app without Google Play?**
|
||
A: Yes! Download the APK directly from GitHub or use F-Droid.
|
||
|
||
---
|
||
|
||
**Last update:** v1.3.2 (2026-01-10)
|