Backup & Restore

Backup & Restore

JellyWatch offers two independent backup systems to protect your settings and configurations.

Backup Types

1. Cloud Backup (Google Authentication)

Online backup stored on JellyWatch servers, authenticated via your Google account.

Advantages:

• Automatic cloud backup
• Accessible from any device using the same Google account
• Easy restoration when switching devices
• Secure authentication via Google

Requirements:

• Sign in with a Google account
• Internet connection

2. Local Backup (File)

Manual export of your settings into a JSON file stored on your device.

Advantages:

• No Google account required
• Full control over your backup files
• Configuration sharing possible
• Local storage or on your own cloud

Accessing Backup & Restore

Two ways to access it:

1. Settings Menu: Settings → Backup & Restore
2. Dedicated Screen: Via the menu during first launch or from Settings → Backup & Restore

Cloud Backup (Google Authentication)

Create a Cloud Backup

1. Go to Settings → Backup & Restore
2. If you are not signed in, tap "Connect Google Account"
3. Sign in with your Google account
4. Tap "Save to Cloud" or "Backup Settings"
5. Your settings are saved on JellyWatch servers

Restore from Cloud

1. Go to Settings → Backup & Restore
2. Sign in with your Google account (if required)
3. If a backup is available, you will see:
   • A "Backup Available" indicator
   • The date of the last backup
   • The user mode of the backup (Admin/Personal)
4. Tap "Restore Settings"
5. Confirm the restoration in the dialog box
6. The app redirects to the Dashboard after restoration

Important:

• In strict mode (from Settings), only backups from the same user mode (Admin/Personal) can be restored
• In onboarding mode (first launch), both Admin and Personal backups are accepted

Local Backup (File)

Export a Local Backup

1. Go to Settings → Backup & Restore
2. In the "Local Backup" section, tap "Export to File"
3. Choose the save location:
   • Downloads folder
   • Google Drive
   • Any other accessible location
4. A .json file is created containing all your settings

Suggested filename: jellywatch_backup_[date].json

Import a Local Backup

1. Go to Settings → Backup & Restore
2. In the "Local Backup" section, tap "Import from File"
3. Select the previously exported backup file
4. A confirmation dialog appears warning that your current settings will be replaced
5. Tap "Confirm" to restore
6. After restoration, the app automatically restarts

Backup Content

Both systems (Cloud and Local) save exactly the same data:

General Settings

• Refresh interval
• Theme (Light/Dark/OLED/System)
• App language
• Custom primary color
• Analytics enabled/disabled
• Animated background

Notification Settings

• Notifications enabled/disabled
• Sound, vibration, grouping
• Notification priority
• Popup notifications
• Event-based notifications (play, pause, new content, etc.)
• Check interval

Server Configurations

• Jellyfin server URLs
• Login credentials (encrypted)
• Authentication tokens (encrypted)
• Dual URL configuration (local/external URL)
• Self-signed certificates
• Custom headers
• Note: QuickConnect servers are not included

External Services

• Tautulli, Overseerr, Radarr, Sonarr configurations, etc.
• URLs and API keys (encrypted)
• Dual URL settings
• Server associations

Menu Preferences (Admin Mode Only)

• Bottom menu order
• "More" screen order
• Default page
• Dashboard section order and visibility

Metadata

• User mode (Admin/Personal)
• Backup date
• App version
• Device ID

Use Cases

Cloud Backup

• Device migration — Automatically recover your settings on a new device
• Secure online storage — Backup stored on JellyWatch servers
• Multi-device — Synchronize the same configuration across multiple devices

Local Backup

• Without Google account — Use JellyWatch without Google sign-in
• Configuration sharing — Share your setup with other users
• Manual backup — Create snapshots before modifying settings
• Full control — Store your backups wherever you want

Security

⚠️ Important: Backup files contain your server credentials and API keys in encrypted form. Even though encrypted, store them in a secure location.

Encryption

• Passwords and tokens are encrypted using AES
• The encryption key is based on the device’s unique ID
• Local backups use the same encryption level as Cloud backups

Best Practices

• Do not share your backup files publicly
• Store local backups in a secure location
• Use Cloud backup for automatic protection
• Create a local backup before major updates

Disconnect Google Account

To disconnect your Google account:

1. Go to Settings → Backup & Restore
2. Tap "Disconnect" next to your email address
3. You can still use local backups

Differences Between Modes

Admin Mode

• Saves custom menu preferences
• Saves all notification configurations
• Requires restoration from an Admin backup (in strict mode)

Personal Mode

• Does not save menu preferences
• Notification settings disabled by default
• Refresh interval fixed at 30 seconds

Note: In onboarding mode (first launch), you can restore either an Admin or Personal backup. From Settings, only a backup from the same mode is accepted.