Downloads & Offline
Download audiobooks for offline listening, configure Smart Downloads, manage storage, and understand offline capabilities in FableFrog.
Downloading Books
Offline downloads are a Premium feature. With Premium, you can download any audiobook from your library to your device and listen without a network connection. All playback controls (speed, volume boost, bookmarks, sleep timer, chapter navigation) work identically whether you're streaming or playing a downloaded book.
Downloaded books default to local-first playback — FableFrog plays the file from local storage instead of opening a server session, so play starts instantly and the book stays reliable when your network drops. If a local file is ever corrupted (rare, but possible), the player falls back to streaming automatically and surfaces a banner inside the player with a one-tap Re-download button so you can replace the bad file without leaving the screen.
How to Download
Open any book's detail page and tap the download button. FableFrog begins downloading all audio files for that book from your Audiobookshelf server. You can continue browsing or listening to other content while the download runs in the background.
Monitoring Progress
Active downloads show a progress indicator on the book's cover throughout the app, including in the library grid, on the detail page, and in the downloads manager. You can see the percentage complete and estimated time remaining.
Managing Downloads
The Downloads section in Settings provides a dedicated view of all your downloaded content. From here you can:
- Browse your downloaded library with the same search and sort options as the main library
- View file sizes for each downloaded book
- Delete individual downloads to free up space
- Sort by title, size, date downloaded, or last listened
Every book row in Downloads is tappable and plays straight from local storage, so it works the same whether you're online or off.
Downloads as Its Own Tab
If you want your offline library one tap away, you can promote Downloads to a top-level tab. Open the tab bar's customize menu and add Downloads. This is opt-in — Downloads is never placed on your tab bar by default.
Queue Downloads on Your Reading List
If your download queue is effectively your to-read queue, turn on Add Downloads You Start in Settings → Reading List. Every book that finishes downloading is added to your Reading List for you, at the top or bottom depending on your add-position preference. Smart Downloads follow the same setting. This is off by default.
The toggle was called Add Downloads Automatically through 1.12. It was renamed in 1.13 to say what it actually covers, because Download New Releases adds its books to the Reading List whether the toggle is on or off.
Failed Downloads Retry on Their Own
As of 1.17, a failed download is still wanted, and FableFrog tries it again by itself. This holds for every download, whether you tapped Download or Smart Downloads or Download New Releases started it.
FableFrog retries a failed download:
- When the network comes back (Wi-Fi, if Wi-Fi Only is on)
- When you open the app
- On a timer while the app runs
- When you tap Play on the book
While it waits, the download shows Will retry - waiting for network, Will retry - waiting for Wi-Fi or Will retry soon. Tap the retry button on the row to try now.
Needs Attention
Some failures can't fix themselves, for example when the device is out of storage or you must sign in again. These downloads show Download Needs Attention with the cause and the one action that fits it, such as Manage Storage or Sign In. Retry and Remove Download are always there. A download also needs attention when it keeps failing for 48 hours and at least five tries made while you were online.
- A badge counts these downloads. It shows on the Downloads tab, or on Settings, Storage & Cache and Manage Downloads when Downloads is not a tab. The badge clears only as you resolve each download, not when you look at it.
- A notification tells you. FableFrog sends a notification when a download needs your help. Several at once arrive as one notification. Turn it off with Download Needs Attention in Settings → Notifications. It is on by default.
Downloads and Accounts
If you have more than one account, all the accounts that download a book share one copy of its files. Each account sees only the downloads it uses, in Downloads, the library, CarPlay and Storage settings.
- Delete a download and FableFrog takes it off this account. The files go only when no account uses them anymore.
- Storage settings count and clear only the downloads of the account you are signed in to.
- A failed download retries only for the account that started it. Another account's failed download says Belongs to another account and waits until that account is active again.
Smart Downloads
Smart Downloads automate the process of downloading and cleaning up audiobooks, so you always have something to listen to offline without manual management. This is a Premium feature.
Setting Up Smart Downloads
Enable Smart Downloads in Settings → Storage & Cache. Once enabled, FableFrog monitors your listening activity and automatically downloads books based on your behavior.
Listening Threshold
Configure a listening threshold between 5 and 30 minutes. When you've streamed a book for at least that long, FableFrog assumes you're committed to it and starts downloading it automatically. This prevents downloading books you only sampled briefly.
Auto-Remove When Finished
When you finish a downloaded book, Smart Downloads can automatically remove it from your device to reclaim storage. This keeps your downloads lean and relevant. Only books you're actively listening to stay on your device. Auto-remove waits until playback truly ends, so finishing the last chapter doesn't pull the file out from under you while the player is still wrapping up.
Download New Releases
Smart Downloads react to what you're listening to. Download New Releases reacts to what you're waiting for: turn it on and a book from a series you follow downloads itself as it lands in your library, so the first you hear about it is that it's already on your phone.
The toggle is in Settings → Storage & Cache, under Followed Series. A few things worth knowing before you turn it on:
- It starts from the day you turn it on. Books already sitting in your library are left where they are. It won't try to download years of back catalog behind you. Books that arrived shortly before you flipped the switch can be included.
- It adds what it downloads to your Reading List. A book you removed from the list by hand stays removed - it's still downloaded, it just isn't put back.
- It obeys Wi-Fi Only. These downloads can use cellular data like any other. Turn on Wi-Fi Only in the same screen to keep them on Wi-Fi.
- A failure doesn't block the queue. A book that can't be fetched right now is set aside and retried later rather than holding up everything behind it. Its download retries on its own like any other - see Failed Downloads Retry on Their Own.
Storage Considerations
Smart Downloads and Download New Releases respect your Wi-Fi only setting (see below). They won't trigger cellular downloads unless you've explicitly allowed cellular data usage. Keep an eye on available device storage if you listen to many books concurrently, as automatic downloads can accumulate content quickly.
Offline Mode
FableFrog is designed to work gracefully when you lose connectivity.
What Works Offline
- Playback of any downloaded audiobook, with full controls
- Browsing your cached library metadata, including covers, descriptions, chapter lists, and progress for books you've previously viewed
- Bookmarks can be created offline and will sync when you reconnect
- Playback progress is tracked locally and synced to the server when connectivity returns
What Requires a Connection
- Streaming books that aren't downloaded
- Syncing progress, bookmarks, and listening sessions to the server
- Downloading new books
- Library updates: new books added to the server won't appear until you reconnect
- Statistics: viewing and updating your listening stats requires server communication
Reconnecting and Syncing
When FableFrog regains a network connection, it automatically syncs any locally accumulated progress, bookmarks, and session data to your Audiobookshelf server. This happens transparently, and you don't need to trigger it manually. If there are conflicts (e.g., you listened on another device while offline), the server reconciles the positions.
Limited Access Mode
If your session can't be renewed — you're offline in airplane mode, out at sea, deep in a subway tunnel, or your server has rejected the session and there's no way to complete a sign-in right now — FableFrog switches into Limited Access Mode rather than leaving you stuck on empty, server-dependent screens behind a login sheet you can't finish.
Limited Access Mode is a focused two-tab experience — Downloads and Settings — where your downloaded books stay fully browsable and playable, with the mini player, full player, and ebook reader all available. When you're back within reach of the server, FableFrog restores the normal tabs automatically; if the session simply needs a fresh sign-in, the reauth sheet reappears once you're online.
This is different from an ordinary session hiccup. If the app can still reach your server and just needs you to sign back in, you get the usual inline reauth sheet over your current screen and keep all your tabs. Limited Access Mode only kicks in when there's no path back to a full session at that moment.
Wi-Fi Only Mode
Enable Wi-Fi Only in Settings to restrict all downloads (both manual and Smart Downloads) to Wi-Fi connections. When this mode is active and you're on cellular data:
- New downloads will not start
- In-progress downloads pause until Wi-Fi is available
- Streaming playback continues to work over cellular (Wi-Fi Only applies to downloads, not streaming)
This gives you control over cellular data usage, especially useful if you have a limited data plan.
Storage Management
Viewing Download Sizes
The downloads manager shows the file size of each downloaded audiobook and the total storage used by all downloads. This helps you make informed decisions about what to keep on your device.
Clearing Downloads
You can delete individual downloads by swiping on them in the downloads manager, or delete from a book's detail page. Settings → Storage & Cache also has Clear Downloads, which removes the downloaded audio files of the account you are signed in to, and Clear Everything, which removes those downloads and the cached library data together. Both ask for confirmation first.
Clearing Cache
FableFrog caches library metadata (cover images, book details, chapter lists) to improve performance and enable limited offline browsing. You can clear this cache from Settings if you need to reclaim storage or force a fresh sync from the server. Note that clearing the cache does not affect your downloaded audiobook files.