327 lines
9.0 KiB
Markdown
327 lines
9.0 KiB
Markdown
# Settings
|
||
|
||
The app provides extensive customization through the settings page.
|
||
|
||
## Settings Structure
|
||
|
||
```
|
||
Settings
|
||
├── Preferences
|
||
├── Timeline Display
|
||
├── Asset Viewer
|
||
├── Backup
|
||
├── Free Up Space
|
||
├── Networking
|
||
├── Notifications
|
||
├── Language
|
||
├── Advanced
|
||
└── Sync Status (Beta)
|
||
```
|
||
|
||
## Settings Page Layout
|
||
|
||
**Mobile Layout:**
|
||
List of settings cards, each navigates to a sub-page.
|
||
|
||
**Tablet Layout:**
|
||
Split view with category list on left, selected settings on right.
|
||
|
||
```
|
||
┌──────────────────────────────────────────┐
|
||
│ Settings │
|
||
├──────────────┬───────────────────────────┤
|
||
│ │ │
|
||
│ Preferences │ [Selected Category │
|
||
│ Timeline │ Settings Content] │
|
||
│ Asset Viewer │ │
|
||
│ Backup │ │
|
||
│ ... │ │
|
||
│ │ │
|
||
└──────────────┴───────────────────────────┘
|
||
```
|
||
|
||
## Preferences
|
||
|
||
General app behavior settings.
|
||
|
||
### Theme Settings
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Theme Mode | Light / Dark / System | System | App color scheme |
|
||
| Primary Color | Color presets | Default | Accent color |
|
||
| Dynamic Theme | On / Off | Off | Use system dynamic colors |
|
||
| Colorful Interface | On / Off | On | Apply color to more UI elements |
|
||
|
||
### Interaction Settings
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Haptic Feedback | On / Off | On | Vibration on interactions |
|
||
|
||
### Read-Only Mode
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Enable Read-Only | On / Off | Off | Disable modifications |
|
||
|
||
When enabled:
|
||
- Cannot edit assets
|
||
- Cannot delete assets
|
||
- Cannot create albums
|
||
- Can still browse and view
|
||
|
||
## Timeline Display
|
||
|
||
Customize how photos appear in the timeline.
|
||
|
||
### Grid Layout
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Tiles Per Row | 2-6 | 4 | Number of columns |
|
||
| Dynamic Layout | On / Off | Off | Variable tile sizes |
|
||
| Show Storage Indicator | On / Off | On | Show local/remote icon |
|
||
|
||
### Grouping
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Group Assets By | None / Day / Month | Day | How to group photos |
|
||
|
||
### Album Sort
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Album Sort Order | Title / Created / Modified | Modified | Sort albums by |
|
||
| Sort Direction | Ascending / Descending | Descending | Sort order |
|
||
| Album View | List / Grid | List | Album display style |
|
||
|
||
## Asset Viewer
|
||
|
||
Settings for the full-screen photo/video viewer.
|
||
|
||
### Image Loading
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Load Preview | On / Off | On | Load preview quality |
|
||
| Load Original | On / Off | Off | Load full resolution |
|
||
| Prefer Remote | On / Off | Off | Prefer server image |
|
||
|
||
### Video Settings
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Auto Play | On / Off | On | Play video automatically |
|
||
| Loop Video | On / Off | On | Repeat video |
|
||
| Load Original Video | On / Off | Off | Load full quality video |
|
||
|
||
### Navigation
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Tap to Navigate | On / Off | Off | Tap sides to go prev/next |
|
||
|
||
## Backup Settings
|
||
|
||
Control automatic photo backup.
|
||
|
||
### Foreground Backup
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Enable Backup | On / Off | Off | Upload photos to server |
|
||
| Use Cellular (Photos) | On / Off | Off | Upload photos on cellular |
|
||
| Use Cellular (Videos) | On / Off | Off | Upload videos on cellular |
|
||
|
||
### Background Backup
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Background Backup | On / Off | Off | Upload when app closed |
|
||
| Require WiFi | On / Off | On | Only on WiFi |
|
||
| Require Charging | On / Off | Off | Only when charging |
|
||
| Trigger Delay | Minutes | 30 | Wait before starting |
|
||
|
||
### Notification Settings
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Total Progress | On / Off | On | Show overall progress |
|
||
| Single Progress | On / Off | Off | Show per-file progress |
|
||
| Error Grace Period | Number | 2 | Errors before notification |
|
||
|
||
### Album Selection
|
||
|
||
Select which device albums to back up:
|
||
|
||
```
|
||
┌─────────────────────────────────┐
|
||
│ Backup Albums │
|
||
├─────────────────────────────────┤
|
||
│ [✓] Camera Roll │
|
||
│ [✓] Screenshots │
|
||
│ [ ] Downloads │
|
||
│ [ ] WhatsApp Images │
|
||
│ [−] Excluded Album │
|
||
└─────────────────────────────────┘
|
||
|
||
[✓] = Include in backup
|
||
[ ] = Not selected
|
||
[−] = Explicitly excluded
|
||
```
|
||
|
||
## Free Up Space
|
||
|
||
Remove local copies of backed-up assets.
|
||
|
||
### Filter Options
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Keep Favorites | On / Off | On | Don't remove favorites |
|
||
| Keep Media Type | All / Photos / Videos | All | Which to keep |
|
||
| Keep in Albums | Album list | None | Keep assets in albums |
|
||
| Cutoff Days | Number | All | Only remove older than |
|
||
|
||
### Cleanup Process
|
||
|
||
1. Calculate removable assets
|
||
2. Show preview of space to be freed
|
||
3. Confirm with user
|
||
4. Remove local files
|
||
5. Keep server copies intact
|
||
|
||
## Networking
|
||
|
||
Network and connection settings.
|
||
|
||
### Server Configuration
|
||
|
||
| Setting | Description |
|
||
|---------|-------------|
|
||
| Server URL | Primary server address |
|
||
| Local Endpoint | LAN server address |
|
||
| Preferred WiFi | WiFi name for local endpoint |
|
||
| External Endpoints | List of external addresses |
|
||
|
||
### Auto Endpoint Switching
|
||
|
||
When enabled:
|
||
1. Check current WiFi name
|
||
2. If matches preferred WiFi → use local endpoint
|
||
3. Otherwise → use external endpoint
|
||
4. Fall back on connection failure
|
||
|
||
### SSL/TLS Settings
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Allow Self-Signed | On / Off | Off | Accept self-signed certs |
|
||
| Client Certificate | File | None | mTLS client certificate |
|
||
|
||
### Custom Headers
|
||
|
||
Add custom HTTP headers for proxy authentication:
|
||
|
||
```
|
||
Header Name: X-Custom-Auth
|
||
Header Value: token123
|
||
```
|
||
|
||
## Notifications
|
||
|
||
Control app notifications.
|
||
|
||
| Setting | Description |
|
||
|---------|-------------|
|
||
| Backup Progress | Show backup progress notifications |
|
||
| Backup Complete | Notify when backup finishes |
|
||
| Backup Errors | Notify on upload failures |
|
||
|
||
## Language
|
||
|
||
Change app display language.
|
||
|
||
- System default
|
||
- Manual language selection
|
||
- List of supported languages
|
||
|
||
## Advanced
|
||
|
||
Developer and troubleshooting options.
|
||
|
||
### Troubleshooting
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Advanced Logging | On / Off | Off | Detailed debug logs |
|
||
| Log Level | Info-Severe | Info | Minimum log level |
|
||
|
||
### Platform-Specific
|
||
|
||
**Android:**
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Manage Local Media | On / Off | Off | Request full media access |
|
||
| Photo Manager Filter | On / Off | On | Custom media filtering |
|
||
|
||
**iOS:**
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Ignore iCloud Assets | On / Off | Off | Skip iCloud-only photos |
|
||
|
||
### Experimental
|
||
|
||
| Setting | Options | Default | Description |
|
||
|---------|---------|---------|-------------|
|
||
| Beta Timeline | On / Off | On | Use new timeline sync |
|
||
| Sync Albums | On / Off | Off | Sync device albums |
|
||
|
||
### Cache Management
|
||
|
||
- Clear thumbnail cache
|
||
- Clear preview cache
|
||
- View cache size
|
||
- Reset all caches
|
||
|
||
### Data Management
|
||
|
||
- Export logs
|
||
- Reset settings
|
||
- Clear local data
|
||
- Sign out and clear
|
||
|
||
## Sync Status (Beta)
|
||
|
||
When beta timeline is enabled, shows sync status:
|
||
|
||
### Status Information
|
||
|
||
- Last sync time
|
||
- Sync state (idle/syncing/error)
|
||
- Number of synced assets
|
||
- Pending changes
|
||
|
||
### Actions
|
||
|
||
- Force full sync
|
||
- Reset sync state
|
||
- View sync logs
|
||
|
||
## Settings Persistence
|
||
|
||
Settings are saved to local storage immediately on change:
|
||
|
||
1. User changes setting
|
||
2. Update in-memory state
|
||
3. Persist to Store
|
||
4. Reflect in UI
|
||
|
||
Settings sync is local-only - each device maintains its own settings.
|
||
|
||
---
|
||
|
||
[Previous: Local Storage](local-storage.md) | [Next: Error Handling](error-handling.md)
|