Offline Mode

Offline Mode

Finamp allows you to download tracks/playlist/etc. to your device to Playback without a connection to your jellyfin server. You can manually toggle this mode, or let Finamp decide when to use it.

Caveat

1. Some features are not available while in Offline Mode as they require an active Jellyfin connection to work. This is expected behavior and not a bug. Here a short list of affected features:

   • Liking or Adding to playlist
   • Delete from Server
   • Some Home-Tab sections
   • Some Radio Modes
   • Quick Connect Authorization
   • and more.

2. The Queue needs to be reloaded once Offline Mode got toggled due to the way Finamp handles playback. An in-app notification will present to you with a Button to do so.

Tip

Or you enable automated Queue Reloading at Settings > Audio Service > Automatically Reload Queue , be aware that this might interrupt playback for a short moment, but will resume shortly

3. Only Tracks which are downloaded are visible and available for playback

4. Downloaded Tracks are ALWAYS preferred for playback, even when the streamed source has higher quality. Follow this umbrella issue for updates.

Automation

Automation allows you to get a certain behaviour to define when Offline Mode should enable or disable itself.

Important

Every Automation mode only ever triggers when Finamp detects a change in connected networks.

i.e. Cellular, LAN, Wifi and VPN.

Automation will not trigger when a connected network looses internet access.

To enable automation you can navigate to Settings > Network. There you can select between a few automation behaviors:

1. Disabled: Automation is disabled. You need to toggle offline mode manually.

Useful when you think automation doesn't act correctly.

2. Local Network: Offline Mode will be enabled when no Wifi or Ethernet connection is available.

Good to minimize Finamp's cellular usage.

3. Disconnected: Enabled Offline Mode when no connection is available.

Might come in handy some time.

4. Unreachable: Offline Mode will be enabled when your Jellyfin server cant be reached.

Practical when your Jellyfin is only available in your home network.

Note

Don't worry when automation doesn't kick in instantly!

There is a ~10 second delay during which Automation wont change the Offline mode. This is Because of reliability issues on iOS stated by the library we use.

"We noticed that this observer can give multiple or unreliable results"

This delay even exists on Android as we target a uniform behavior across all devices which also reduces code complexity.