immish/docs/settings.md

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 | Next: Error Handling