Skip to content

Releases

Audiobookshelf+ v0.20.0

Choose a tag to compare

@ADD-OCD ADD-OCD released this 21 Oct 17:24

Audiobookshelf+ v0.20.0, based on upstream Audiobookshelf v0.14.2-beta. Production package app.absplus.android (versionCode 138).

Highlights

  • Automatic deletion of finished downloads and a download budget (Stanislav Markin, PR #32). Optional, Off by default; you choose the delay (right away, 1, 3 or 7 days). Turning it on asks for confirmation first, because the first check can remove files that are already eligible. Listening progress, bookmarks and completion history are kept; the budget is best-effort, not a hard limit; storage that can't be verified is left alone.
  • Safer listening history: startup storage checks keep your books' identities, progress, completion history and bookmarks even when files or storage are unavailable.
  • Playback progress fixes: when one book ends and the next starts by itself (queue, playlist, podcast, Android Auto, media buttons or widget), the new item's start is no longer saved into the previous item's progress. An explicit seek while paused is saved.
  • Optional long jumps (Stanislav Markin, PR #35): a second, longer jump in each direction (15 s to 30 min) in the full player, Off by default. The full player's jump keys are now chevrons centered on Play.
  • Downloads at Android 15's time limit (Stanislav Markin, PR #34): downloads pause instead of crashing when Android's daily background limit is used up, and continue when you open the app.
  • Android Auto without a reachable server: the menu opens at once with Downloads instead of waiting for server connection attempts; the rest appears when the server answers. (Needs confirmation in a real car or head unit.)
  • Download folders: clearer folder selection, "Choose folder" then an explicit Retry after folder access is lost, and a download into a taken file name is saved under its own name instead of failing.
  • Clearer delete messages: deleting a download that can't be deleted now says why; Android 8-9 can delete in a chosen folder; Android 7 explains to use the file manager.
  • New app icon: a dry-brush purple disc with the headphones-and-books emblem and the outlined plus.

Upgrading

Install over v0.19.0 (or use Settings -> Updates once published). Your server, sign-in, settings, downloads and listening position are kept. New options start Off. Downgrading to v0.19.0 is not supported.

Validation

  • Controlled tests: a genuine production v0.19.0 was upgraded in place to v0.20.0 on an Android emulator (same signing certificate; server, downloaded media, playback position and settings kept; startup and local playback fine). On a Samsung Galaxy S22 Ultra (SM-S908U1, Android 16) the official APK was installed over production v0.19.0 (versionCode 137 to 138) with adb install -r, no data cleared: the saved server connection, the downloaded audiobook, listening progress and settings were kept, playback and background playback worked, the optional five-minute long jump worked and the new icon showed. The built-in updater on that phone detected v0.20.0, downloaded and verified the APK and opened Android's installer, but its final install confirmation was not performed there; it reports v0.20.0 as current afterwards.
  • Owner-confirmed: the owner reports that the built-in update path worked on a Galaxy S26 Ultra (not separately logged).
  • No reproducible defects were found in these tests.

Known limitations

Not yet tested: removable SD cards, Android 7-9 hardware, a real Android Auto head unit, and the full six-hour Android 15 background quota. Testing covered one Samsung phone on Android 16 plus the owner's S26 update, so this is not a certification of every Android 16 or Samsung configuration. Some storage providers may refuse delete operations; test automatic deletion with disposable media first. Existing HTTP resume/integrity and server progress-ordering limits remain. This release does not include the offline-first architecture proposed in PR #37.

Thank you @stasmarkin for PRs #32, #34 and #35 and for testing.

Install and verify

Download audiobookshelf-plus-v0.20.0-release.apk and install it over your existing app, or use Settings -> Updates. Do not uninstall first. Android or Google Play Protect may show "App scan recommended" for a newly published APK. SHA-256: d4be258aad68582f82d1e00d642bc9f62ea8e48856ffa9ca5a3bd7c28f964e68 (checksum file attached).

Audiobookshelf+ v0.20.0-dev.2 — Contributor Testing

Choose a tag to compare

@ADD-OCD ADD-OCD released this 20 Oct 18:50

Audiobookshelf+ Contributor v0.20.0-dev.2 — experimental prerelease

Experimental contributor testing build. Not a stable release, not merged into plus, and not for your only copy of
anything important. It installs as its own app next to your regular Audiobookshelf+ and next to dev.1.

  • Package app.absplus.android.contributor · versionName 0.20.0-dev.2 · versionCode 139
  • Signed with the contributor testing certificate (SHA-256 25802304ac05945342c5266666d43933dd93313836553c1e064f26782a5490a7); the regular release key is not used.
  • Built from the fix/dev2-audit-corrections branch on top of dev.1 (804e0835). Exact commit, APK hash and checks: BUILD-INFO.json and SHA256SUMS.txt.

What dev.2 is

dev.1 consolidated PRs #32, #34 and #35 and the startup/storage fixes. An independent audit of dev.1 found one serious and
several smaller problems; dev.2 fixes them and gives the contributor channel its own package.

Fixes since dev.1

  • Wrong item's progress after an automatic switch (audit F1, high). When one book ended and the next one started by
    itself (queue, playlist, podcast, Android Auto or a media button), the new item's starting position could be written into
    the previous item's progress, leaving it unfinished at the wrong place. Seeks are now saved only for the item that is
    actually being synced. Seven regression tests; the dev.1 code fails five of them.
  • Re-downloading into a name that is already taken (audit F2). If a file of the same name already exists in your
    download folder, the existing file is kept and the new download is saved under its own alternative name (numbered if
    needed). Nothing is deleted to make room, and the app records the name the folder actually used.
  • Clearer delete messages (audit F5). Failed deletes in a folder you picked now say why: access to the folder was lost,
    the folder or SD card can't be found, a folder is where a file should be, the files couldn't be checked, the storage
    refused the delete, or only some files were deleted. If access is lost after some files were already deleted, the message
    says so. Deleting in a picked folder now also works on Android 8–9; on Android 7 the app says it can't delete there
    (nothing is deleted and the download stays in the app).
  • Own package for contributor builds. dev.1 shared app.absplus.android.debug with development builds, which are signed
    with a different key, so they could not update each other. dev.2 and later use app.absplus.android.contributor
    and the same signer, so dev.3 will install over dev.2.
  • New app icon. A dry-brush purple disc with the white headphones-and-books emblem and the original outlined plus.
    Release builds will have a purple plus; contributor/debug builds are identical with a red plus.
  • Seek synchronisation (F6): reviewed and deliberately left unchanged.

Included from dev.1 (unchanged scope)

  • PR #32 — automatic eviction and space cap (@stasmarkin): finished books are removed automatically within a space budget;
    listening position, bookmarks, completion history and the book's identity are kept.
  • PR #34 — foreground-service handling (@stasmarkin): downloads pause at Android 15's data-sync time limit instead of crashing.
  • PR #35 — optional long jumps (@stasmarkin): separate backward/forward long jumps in the full player (both Off by default).
  • Startup history preservation, SAF folder recovery (reselect the folder, explicit Retry), bounded SAF finalisation, and paused-seek persistence.

Thanks to @stasmarkin for PRs #32, #34 and #35 and the earlier contributions this builds on.

Known limitations (not resolved in this build)

  • Android 16 runtime is unvalidated. Verified only on an Android 15 emulator and by unit tests.
  • Real Samsung storage-access (SAF) and removable SD-card behavior are not fully certified; some storage providers may refuse operations.
  • The full elapsed six-hour foreground-service quota has not been validated.
  • Android 7–9 physical runtime behavior is incompletely validated (Android 8–9 deletion is unit-tested; Android 7 reports "unsupported").
  • Existing HTTP range/resume integrity limitations remain, and some scanner/server progress-ordering limitations remain.
  • Automatic deletion: test with disposable media first. Storage budgets are best-effort, not strict caps.
  • dev.1, dev.2 and your regular app share the custom URL/OAuth scheme, so a sign-in link can open any of them.
  • On devices with themed (monochrome) icons the purple-versus-red difference is not visible.

Report problems at #36 (include the in-app log if asked).

Installing — dev.1 and dev.2 are different apps

Build Package
dev.1 app.absplus.android.debug
dev.2 app.absplus.android.contributor

dev.2 installs alongside dev.1; it does not update dev.1 in place, and local data does not migrate automatically.

  1. Download audiobookshelfplus-v0.20.0-dev.2-contributor.apk and SHA256SUMS.txt; check the hash (e10e926802dc17411497171b8172fc468b46c0c29056dbc51e961b9ee2361bf7).
  2. Install the APK (Android will warn about an unknown source; this is a signed testing build).
  3. Open Audiobookshelf+ Contributor, connect to your server, sign in, confirm your libraries and playback work.
  4. Re-set your options (theme, jump times, long jumps, download storage, auto download/delete); they don't carry over.
  5. Preserve anything important in dev.1 first (offline downloads, bookmarks, settings, unsynchronized progress — open dev.1 online so it syncs). Remove dev.1 only when you no longer need it. Don't uninstall it just to install dev.2.

Future contributor builds keep the package app.absplus.android.contributor, the same signing certificate and a rising versionCode, so they will install over dev.2.

This is an experimental testing build, not a stable release, and not merged into plus.

Audiobookshelf+ v0.20.0-dev.1 — contributor testing (experimental)

Choose a tag to compare

@ADD-OCD ADD-OCD released this 18 Oct 21:40

Audiobookshelf+ v0.20.0-dev.1 — experimental contributor testing

PRERELEASE — disposable-media testing only. This is not a stable production release and has not been merged into plus. Independent review and wider device/provider testing remain pending.

This single contributor build combines the preserved original histories of PR #32, PR #34 and PR #35, plus the recent bounded safety and playback corrections.

Exact source: 804e08356490b7dbb7007ddcad63b7f86ac09ded, branch testing/v0.20.0-dev.1, preserving consolidated parent a4e21157.

Included changes

  • Startup history preservation: missing or inaccessible storage no longer causes startup cleanup to delete logical audiobook/podcast records or listening history.
  • Bounded SAF downloader safety: safer finalization, without automatic provider deletion during publication or recursive directory deletion when a file was intended. An unsupported operation may fail and leave a temporary file.
  • Paused seeks persist: explicit seek positions are saved while paused and survive restart.
  • Direct folder recovery: failed downloads that lose folder access offer Reselect Folder, using Android's folder picker. Renewing permission does not automatically retry; choose Retry explicitly.
  • PR32: automatic completed-audiobook eviction and best-effort download budgets, with account revalidation, storage-unavailable/partial-deletion handling, worker outcome and size-estimate corrections. Automatic eviction removes downloaded bytes while retaining logical identity and listening history. Podcast retention remains its separate workflow.
  • PR34: pause downloads at Android dataSync foreground-service timeouts, preserve pending pause state across replacement-service races, and resume when Android permits.
  • PR35: independently configurable optional long backward/forward jumps in the full-screen player, both Off by default. Short jumps and mini-player/native media controls retain their existing behavior. Integration fixes cover seek boundaries and narrow/scaled transport layouts.

Install and update

  1. Download audiobookshelfplus-v0.20.0-dev.1-contributor.apk from this prerelease and verify SHA256SUMS.txt.
  2. Install it through Android's package installer; allow installation from your chosen source only if requested.
  3. Open Audiobookshelf+ Contributor. Package ID is app.absplus.android.debug, versionName 0.20.0-dev.1, versionCode 138. Despite the package suffix, this distributed variant is not debuggable and explicitly disables app-requested WebView debugging and updater fixture-source overrides.
  4. The regular app.absplus.android installation is separate. This APK does not replace it or carry its production signing key.
  5. The contributor certificate differs from the previous local synthetic debug certificate. An old debug installation cannot upgrade in place. Uninstalling it removes its local app data; retain/export anything needed before deciding to uninstall. A fresh installation is recommended for testing.
  6. Future contributor APKs will keep this package and persistent contributor signer and use a higher versionCode, allowing contributor-to-contributor upgrades. Install these updates manually from their named prereleases; this variant does not download production-channel in-app updates.

Contributor signer SHA-256:
25802304ac05945342c5266666d43933dd93313836553c1e064f26782a5490a7

Use a dedicated app-managed download folder. Audiobookshelf+ may manage downloaded and temporary files there. Do not select a folder with unrelated or irreplaceable content. Initially test automatic deletion only with disposable media. The download budget is best-effort, not a strict physical storage cap.

Validation and limitations

The consolidated application candidate passed 711 Kotlin / 504 JavaScript tests and Android15 emulator acceptance. This contributor artifact additionally passed 168 focused Kotlin tests, compilation and lint (0 errors / 146 warnings), plus signed-APK Android15 smoke tests for download/local playback, paused long jumps and persisted restart position, production eviction/history retention, and built-in SAF folder selection/reselection with explicit Retry and verified file readback. Eligibility and failure inputs were synthetic test fixtures. Exact source and final artifact checks are recorded in BUILD-INFO.json.

  • Android16 runtime is not validated. Compiling/targeting SDK36 is not Android16 runtime acceptance.
  • Physical Samsung/My Files and real SD-card removal/reconnection are not certified. Android15 emulator, built-in DocumentsUI and synthetic fixtures do not certify every provider or device.
  • The full elapsed six-hour foreground-service quota is not validated. Prior Android15 testing exercised the actual framework timeout using a shortened duration, background restart refusal and foreground recovery.
  • Existing HTTP integrity limitations remain: resume/range handling does not provide a comprehensive cryptographic version/prefix-integrity guarantee. Filename or equal length alone is not proof of integrity. This prerelease does not implement the proposed unified verification/downloader redesign.
  • Existing scanner-progress ordering limitations remain: the narrow stale-server-progress rescan writer issue was deliberately outside these bounded patches. Startup preservation is not a claim that every scanner/synchronization race has been corrected.
  • Generic/cloud SAF providers can refuse operations. Failed or unsupported operations should be reported and leave records intact; leftover temporary files may require user-directed file-manager cleanup.
  • GitHub reports existing dependency-security advisories on the repository's default branch. This testing prerelease is not a dependency-security remediation or security certification.
  • User-requested sanitized in-app diagnostics remain available. Developer Android images (userdebug/eng) can force WebView debugging independently of the app's explicit false setting; do not use such images for private production data.

What to test and how to report problems

  • PR32 contributors: eviction with disposable completed audiobooks, progress/bookmark/history retention, best-effort budgets, account switches and unavailable storage.
  • PR34 contributors: pause/resume, queue recovery and foreground-service lifecycle behavior.
  • PR35 contributors: Off/one/both long directions, paused seeks and restart, short-control isolation, chapter/episode boundaries, LLAMA and narrow/scaled screens.
  • Everyone: normal download/local playback, SAF folder selection, permission renewal and explicit Retry.

Report results in Issue #36 or the relevant PR. Include this exact version, device/Android version, storage/provider type, reproduction steps, expected/actual behavior and whether downloaded bytes or listening history were affected. Attach a sanitized in-app diagnostic export if helpful; do not post credentials, tokens, private server URLs or personal media.

Thanks to Stanislav Markin (@stasmarkin) for the contributor work. Original contributor commits/authorship and the existing remediation history are preserved. Publishing this testing artifact does not approve, close or merge any contributor PR.

Audiobookshelf+ v0.19.0 (upstream v0.14.2-beta)

Choose a tag to compare

@ADD-OCD ADD-OCD released this 16 Oct 03:03

Audiobookshelf+ v0.19.0 adds automatic podcast downloads, download storage on an SD card, downloads that continue after interruptions, a choice of what Bluetooth Next and Previous do, an E-ink theme and reduced motion.

This is a pre-1.0 Audiobookshelf+ release, built on the official Audiobookshelf app v0.14.2-beta. Please read Known limitations before installing, especially no downgrades.

Install or update

  • Already using Audiobookshelf+ v0.17.0 or newer: Settings → Updates → Check for updates → Download update → Install update, then confirm in Android's installer. Your server connections, settings, downloads and listening progress are kept.
  • New install or older version: download audiobookshelf-plus-v0.19.0-release.apk below and open it. Android asks you to allow installing apps from your browser or file manager. It installs alongside the official Audiobookshelf app (different package, app.absplus.android).
  • Google Play Protect may say it hasn't seen this app before, because the release is new. Choose Scan app (Google checks it) or More details → Install without scanning. The APK is signed with the same key as every earlier release (below).
  • Checksum: SHA-256 7e90010718045616151ff10e0d5c67a078dd1f945f342b6dcde3f707615e0ad8 (also in the .sha256 file). Signed with the same Audiobookshelf+ release key as every earlier release (certificate SHA-256 C5:40:04:6A:10:FE:8A:97:DD:75:AD:BA:1D:7D:60:E6:9D:69:6B:10:49:2F:F3:81:E1:3F:62:DF:70:2E:B9:D4).

New

Podcasts

  • Automatic podcast downloads (contributed by Stanislav Markin): new episodes download on their own. Turn it on in Settings → Auto Download Settings, which also sets the defaults: all podcasts or chosen ones, how many of the latest episodes, how often to check, Only on Wi-Fi and Only while charging. Override them for one podcast from its ⋮ menu → Auto download….
  • Managed or Keep all, per podcast: Automatically manage downloads (the default) removes older automatic downloads once you've finished them or they fall outside your episode limit, unless you've started them. Keep all downloads keeps every episode until you delete it. Episodes you download yourself are never removed automatically.
  • Automatically downloaded episodes are marked Auto download in the episode list, and a waiting episode says why.
  • Per-podcast episode order (contributed by Stanislav Markin): each podcast keeps its own sort, and Next Episode follows it.
  • Podcast library tabs show both icon and label.

Downloads and storage

  • SD card storage (contributed by Stanislav Markin): Settings → Download storage → Internal or SD card. Moves are journaled and checked file by file. The old copy is removed only after the new one is verified again after a restart. While the card is missing, work that needs it waits, and everything returns when the card is back. Files on the SD card are removed if you uninstall the app.
  • Interrupted downloads continue where they stopped after Android closes the app or the phone restarts, as long as the file on the server hasn't changed.
  • The Downloads screen says what a download is waiting for: Wi-Fi, charging, a network, the SD card, or the app being opened. A download held because its server sign-in changed says so, and Retry is safe.
  • Downloading an episode again no longer creates a duplicate. Deleting a download removes its on-device progress right away; your listening history on the server is untouched.
  • Empty or cut-short transfers are never kept as downloaded files, and one download can never overwrite or delete another one's file.
  • Long download queues use far less memory (contributed by Stanislav Markin).

Playback

  • Bluetooth / external media controls (Settings → Playback Settings): choose what Next and Previous do from headsets, watches, cars, the notification and the lock screen:

    • Skip by time (default; uses your jump intervals);
    • Navigate chapters (Previous restarts the current chapter after 4 seconds);
    • Navigate audio files.

    Navigation stays within the current book or episode. Fast Forward and Rewind always use your jump intervals. Requested in Discussion #27.

  • Update once a minute (contributed by Stanislav Markin): a player-menu option for e-paper screens. It shows times as H:MM and redraws once a minute; seeking still redraws at once.

Appearance

  • E-ink theme (contributed by Stanislav Markin): Settings → Theme → E-ink: paper and ink with no shadows, gradients or tints.
  • Reduced motion (contributed by Stanislav Markin): with Android's Remove animations on, the app stops sliding, pulsing and scrolling text in every theme.
  • The sort arrow and multi-select check marks are now readable on Light and light custom themes.

Security and maintenance

  • Download links are validated, and download credentials are sent only to the server a download belongs to. Refresh tokens are never sent through redirects.
  • The PDF reader no longer evaluates scripts inside PDF files.
  • Updated Capacitor 7.6.9, Android Gradle Plugin 8.9.1 (Android 16 / API 36) and socket.io-parser 4.2.7.
  • Contributor guide, issue forms and a private security reporting policy.

Known limitations

  • No downgrades. Once v0.19.0 is installed, don't install an earlier version over it. Earlier versions can't read the device data this one saves and close at start; installing v0.19.0 again fixes it. The in-app updater never offers an older version. Never downgrade after moving downloads to an SD card.
  • SD card: the contributor, @stasmarkin, tested moving downloads to a real 128 GB SD card and back on a Boox e-ink tablet and reported playback progress unchanged. Our own testing used automated tests and virtual or emulated cards. Still unverified: removing the card or losing power during an active move, and behavior across the wide range of Android devices with removable storage. Some moves keep both copies until the next restart, using extra space for a while. Keep backups of downloaded media that matters to you.
  • Automatic downloads run in Android's background windows. A large episode may finish over several windows, or when you open the app.
  • Bluetooth controls were tested with Android media keys, media-session commands, the notification and the lock screen. Particular headsets, watches and cars may behave differently; please tell us how yours does.
  • While an audiobook is playing, progress updates from another device aren't applied (unchanged).

Feedback

Report problems with Issues and discuss in Discussions. We'd especially like reports on:

  • real SD cards;
  • automatic downloads over a few days;
  • specific Bluetooth headsets, watches and cars;
  • E-ink devices.

A diagnostic log (Settings → Diagnostics) helps; please look it over before posting it publicly. Security problems: please report them privately as described in SECURITY.md.

Thanks

  • Stanislav Markin (@stasmarkin) contributed automatic podcast downloads, SD card storage, the E-ink theme, reduced motion, the once-a-minute player, per-podcast episode order and the download queue memory fix (PRs #22, #23, #24, #25, #29).
  • The Bluetooth controls build on the upstream investigation in advplyr/audiobookshelf-app#352 and doofmars's proposal #1812.
  • Audiobookshelf+ is built on Audiobookshelf by advplyr and its contributors.

Full list: CHANGELOG.md.

Audiobookshelf+ v0.18.2 (upstream v0.14.2-beta)

Choose a tag to compare

@ADD-OCD ADD-OCD released this 13 Oct 14:44

Audiobookshelf+ v0.18.2 (upstream v0.14.2-beta) — LLAMA landscape cover frame fix

A maintenance release for Audiobookshelf+ v0.18.1.

Install or update: in Audiobookshelf+, open Settings → Updates and tap Check for updates; or download audiobookshelf-plus-v0.18.2-release.apk below and open it on your phone. It updates an existing Audiobookshelf+ install in place; your server login, downloads, settings and listening progress are kept. Requires Android 7.0 or newer. Package app.absplus.android, signed with the Audiobookshelf+ release key.

Checksum: audiobookshelf-plus-v0.18.2-release.apk.sha256 (SHA-256 b99e202d0ef1652b196c42abe9120440104bbe09fc52884629706fc23a1c470f).

Fixed

  • LLAMA full player in landscape: the cover's frame now fits the cover itself, with no empty space beside it. It sits on the bottom edge of the screen, stays below the top buttons and is centered in the left half. Square, tall and wide covers keep their shape and are never cropped. Portrait and the Dark, Black and Light themes are unchanged.

Testing

  • Automated checks: 389 JavaScript and 283 Kotlin tests, including new layout tests for this fix across screen sizes, cover shapes and system insets; debug and release builds; lint with no errors.
  • On a phone (Samsung Galaxy S22 Ultra): measured before and after in landscape with square, tall and wide covers, larger text and a larger display size; portrait and the other themes checked unchanged.
  • This release APK carries the same release signing key as v0.18.1.

See CHANGELOG.md for details and known limitations.

Not affiliated with or endorsed by the official Audiobookshelf project.

Audiobookshelf+ v0.18.1 (upstream v0.14.2-beta)

Choose a tag to compare

@ADD-OCD ADD-OCD released this 12 Oct 17:31

Audiobookshelf+ v0.18.1 (upstream v0.14.2-beta) — Up Next restoration fix

A maintenance release for Audiobookshelf+ v0.18.0.

Install or update: in Audiobookshelf+, open Settings → Updates and tap Check for updates; or download audiobookshelf-plus-v0.18.1-release.apk below and open it on your phone. It updates an existing Audiobookshelf+ install in place; your server login, downloads, settings and listening progress are kept. Requires Android 7.0 or newer. Package app.absplus.android, signed with the Audiobookshelf+ release key.

Checksum: audiobookshelf-plus-v0.18.1-release.apk.sha256 (SHA-256 766d982a5befc59ea55cd270136d91779741a5774c61d59ca86988eb4b0f2eec).

Fixed

  • Up Next after resuming: when Android had closed the app (for example after a long break, or after updating the app) and you resumed your book with Play on the widget, notification or headset, the book continued but Up Next was empty. The queue now appears again with the same books, in the same order, at the right position. A queue you cleared or closed stays cleared.

Testing

  • Automated checks: 385 JavaScript and 283 Kotlin tests, including 21 new tests for this case; debug and release builds; lint with no errors.
  • On a phone (Samsung Galaxy S22 Ultra): the problem was reproduced with the previous version and is fixed in this one, after the app was closed by Android, after an app update, and after the app's screen was recreated.
  • This release APK carries the same release signing key as v0.18.0.

See CHANGELOG.md for details and known limitations.

Not affiliated with or endorsed by the official Audiobookshelf project.

Audiobookshelf+ v0.18.0 (upstream v0.14.2-beta)

Choose a tag to compare

@ADD-OCD ADD-OCD released this 12 Oct 16:29

Audiobookshelf+ v0.18.0 (upstream v0.14.2-beta) — RICE customization and sign-in reliability

An unofficial Android fork of the Audiobookshelf app. This release adds optional RICE customization of the app's colors and makes signing in more reliable.

Install or update: in Audiobookshelf+ v0.17.0, open Settings → Updates and tap Check for updates; or download audiobookshelf-plus-v0.18.0-release.apk below and open it on your phone. It updates an existing Audiobookshelf+ install in place; your server login, downloads, settings and listening progress are kept. Requires Android 7.0 or newer. Package app.absplus.android, signed with the Audiobookshelf+ release key; it installs alongside the official Audiobookshelf app.

Checksum: audiobookshelf-plus-v0.18.0-release.apk.sha256 (SHA-256 1a184aa743200dc9897f46d3fa44c24b812672ca4f6d896f23464a61954a7bca).

RICE customization (Settings → Appearance)

RICE is off until you turn it on with Enable RICE customization. The Dark, Black, Light and LLAMA themes are unchanged, and turning RICE off returns to your theme.

  • Starter palettes: ten palettes adapted from Catppuccin (Mocha, Latte), Dracula, Nord, Gruvbox, Tokyo Night, Rosé Pine, Solarized (Dark, Light) and Everforest. Their licences and sources are listed under "Starter palette sources".
  • Your own presets: start from a starter, a built-in theme or the device colors, then adjust colors and a few style options with a live preview. Apply, Cancel and Reset work as you'd expect, and colors that would be hard to read are flagged before you save. Keep up to 32 presets.
  • Device colors: on Android 12 and newer, "Follow device" uses the phone's system color palette, including the one Samsung One UI sets from your wallpaper, and follows system light and dark.
  • Home-screen widget: takes your RICE colors on Android 12 and newer.
  • Import from GitHub: paste a link to a public GitHub Linux theme project and import its palette colors. Supported: pywal color files, Kitty color themes, Base16/Base24 schemes and plain lists of hex colors. You review the colors before anything is saved.
  • Safe storage: if saved appearance data is ever damaged, the app falls back to the last good copy or your built-in theme.

Sign-in reliability

  • When several requests find your sign-in expired at once, the app renews it once and retries them all. Overlapping renewals could previously sign you out.
  • Being offline, a server error, or an unrelated request failure while renewing no longer signs you out. You're signed out only when the server refuses the sign-in.
  • Signing out or switching server or account while a renewal is still running can't affect the new session.

Testing

  • Automated checks: JavaScript 364, Kotlin 283 tests; debug and release builds; lint with no errors.
  • On a phone (Samsung Galaxy S22 Ultra, One UI 8): the system color palette matched what the app and widget showed in light and dark, light/dark switching while running and in the background, widget controls, and returning to the built-in themes. Two readability fixes for light appearances came from this testing.
  • This release APK: verified to carry the same release signing key as v0.17.0.

Known limitations

  • Linux theme import reads only the four formats above, from public GitHub repositories. GTK, Rofi, Polybar and other config files, other sites, and images are not supported.
  • Image palettes: creating a palette from an image or wallpaper is not included.
  • Samsung themes: RICE follows the system color palette that One UI sets; it can't import Samsung Galaxy Themes or Theme Park themes.
  • Not themed: the media notification, launcher icon and Android's own dialogs keep their standard look, and a few older colors (such as the yellow progress bar on book covers) stay the same in every appearance.
  • Progress from another device: while an audiobook is playing, progress updates from another device are not applied. The next progress save from this device may overwrite those updates. However, when you return to a paused audiobook, progress changes from another device are recognized and applied.
  • Google Play Protect may show an "App scan recommended" prompt before Android's installer. Dismissing it cancels the installation.

Going back: Android doesn't install an older version over a newer one. To return to v0.17.0, uninstall Audiobookshelf+ (this removes its downloads and settings; your server keeps your progress) and install the v0.17.0 APK from its release page.

See CHANGELOG.md for details.

Not affiliated with or endorsed by the official Audiobookshelf project.

Audiobookshelf+ v0.17.0 (upstream v0.14.2-beta)

Choose a tag to compare

@ADD-OCD ADD-OCD released this 12 Oct 02:35

Audiobookshelf+ v0.17.0 (upstream v0.14.2-beta) — In-app GitHub updates

An unofficial Android fork of the Audiobookshelf app. This release adds in-app update checks for the GitHub-distributed app: Audiobookshelf+ can find a newer stable release, download and verify it, and hand it to Android's installer for you to confirm.

Install: download audiobookshelf-plus-v0.17.0-release.apk below and open it on your phone. It updates an existing Audiobookshelf+ install in place; your server login, downloads, settings and listening progress are kept. Requires Android 7.0 or newer. Package app.absplus.android, signed with the Audiobookshelf+ release key; it installs alongside the official Audiobookshelf app.

Checksum: audiobookshelf-plus-v0.17.0-release.apk.sha256 (SHA-256 e11b9bbc353e7fea30b1e32c94c556b4c3758ce8d0aa6ab1c887331528396415).

In-app updates (Settings → Updates)

  • Check for updates looks up the latest stable Audiobookshelf+ release on GitHub and shows its version, date, size and a short summary, with a link to the release notes.
  • Download update downloads it with progress; Cancel download stops it, and Retry download tries again.
  • Before it can be installed, the download is verified: its size and published SHA-256 must match, and it must be the Audiobookshelf+ app, newer than the one installed, not a debug build, and signed with the Audiobookshelf+ release key. A file that fails any check is deleted.
  • Install update opens Android's own installer, which asks you to confirm. Nothing is ever checked, downloaded or installed without you tapping the button, and nothing installs silently.
  • Permission: the first time, Android may ask you to allow Audiobookshelf+ to "Install unknown apps". The app asks only when you tap Install update and offers a button to the right settings page.
  • While installing: Android may close and restart Audiobookshelf+, and playback stops if a book is playing (the app asks first). An update keeps the app's data (login, downloads, settings, progress), as with any update of the same app signed with the same key.
  • If you cancel Android's installer, the verified download is kept, so you can install it later without downloading it again. Open installer shows Android's confirmation again if you left it.
  • For the GitHub app: the updater is for the Audiobookshelf+ app installed from these GitHub releases. A copy installed from Google Play would get its updates from the store.

Testing

  • Automated checks: release selection, download, verification and installer steps.
  • On a phone: the installer path was tested end to end with a disposable test app signed with test keys. It covered real downloads, Android's real installer confirmation and cancel, data kept across updates, and wrong-signature, wrong-package, corrupted and older files being rejected.
  • This release APK: verified to carry the same release signing key as v0.16.0, and it updated a signed v0.16.0 install in place on a test phone.
  • Not yet tested: updating an existing production Audiobookshelf+ installation through the in-app updater (see Known limitations).

Known limitations

  • The in-app updater has been tested with signed test applications. Updating an existing production Audiobookshelf+ installation through the updater will be verified with a subsequent release.
  • While an audiobook is playing, progress updates from another device are not applied. The next progress save from this device may overwrite those updates. However, when you return to a paused audiobook, progress changes from another device are recognized and applied.
  • Google Play Protect may show an "App scan recommended" prompt before Android's installer. Dismissing it cancels the installation (the verified download is kept).

See CHANGELOG.md for other known limitations.

Not affiliated with or endorsed by the official Audiobookshelf project.

Audiobookshelf+ v0.16.0 (upstream v0.14.2-beta)

Choose a tag to compare

@ADD-OCD ADD-OCD released this 11 Oct 19:23

Audiobookshelf+ v0.16.0 (upstream v0.14.2-beta) — LLAMA visual refresh and stability fixes

An unofficial Android fork of the Audiobookshelf app. This release refreshes the optional LLAMA theme and fixes several playback-position and layout problems in every theme.

Install: download audiobookshelf-plus-v0.16.0-release.apk below and open it on your phone. It updates an existing Audiobookshelf+ install in place; your server login, downloads, settings and listening progress are kept. Requires Android 7.0 or newer. Package app.absplus.android, signed with the Audiobookshelf+ release key; it installs alongside the official Audiobookshelf app.

Checksum: audiobookshelf-plus-v0.16.0-release.apk.sha256 (SHA-256 5db2ed02ecabbd3a119094e12cb2b944aa97981d83b0bda77adcd35886dde5a8).

LLAMA theme

Settings → Theme → LLAMA. Black, Dark and Light are unchanged by these.

  • A more faithful finish:
    • brushed-steel panels and keys;
    • steel cover frames;
    • green readouts;
    • amber key labels;
    • a near-black page with a faint line texture.
  • Home screen widget: steel keys with amber labels in a steel housing, at every size.
  • Dialogs and actions:
    • dialogs (sleep timer, Auto Rewind, bookmarks, speed, filter, sort and others) are black panels in a steel frame;
    • main actions such as Play, Stream, Create and Update are steel keys with amber labels.
  • Play buttons in series, lists, collections, playlists, podcast episodes and downloaded books use the amber label. Green stays for selected, focused and active items and for readouts.
  • Home covers: cover frames on the Home shelves are complete instead of cut off at the top.
  • Collapsed player: slimmer, with no empty strip under its progress bar. Pages, downloaded-media screens and reader toolbars line up with it.

Fixes in every theme

  • Bookmark button: the full player's bookmark button stays available when the app can't reach your server, and your saved bookmarks can be viewed offline.
  • Paused position: a paused book shows its real position when you come back to the app.
    • A downloaded book no longer shows an older saved position (which a new bookmark could also have used).
    • A streamed book you moved from the notification, widget or a headset while paused no longer jumps back.
    • Progress saved on another device is picked up when you come back to a paused book, however soon after this phone's last save it was made.
  • Large text (Android font size):
    • book titles in the Library, series and Home grids sit below the covers instead of over them;
    • long series names wrap in the series toolbar without covering the navigation;
    • the downloaded-books screens no longer run under the player.
  • Readers: the PDF reader's page counter is visible above the page again.
  • Collapsed player: swiping up on page content just above it no longer opens the full player by accident.
  • Media buttons: a headset's Play or call button and a Bluetooth Play restore a paused book reliably after Android closed the player in the background. Before, they could do nothing or, rarely, make the app close.
  • Broken covers: a downloaded book with a missing or damaged cover image keeps playing instead of making the app close.
  • System log privacy: Android's system log (what bug reports show) no longer receives sign-in tokens, server details or your username.

Known limitations

  • Two devices at once: while this phone is playing, progress saved on another device is not picked up, and this phone's next save replaces it (as in earlier releases). It is picked up when you come back to the app with the book paused.
  • Formats not tested on a device: comic CBR files, compressed or AZW3 MOBI books and real podcast feeds were not tested on a device for this release. EPUB, MOBI, CBZ, PDF and local podcasts were.

Not affiliated with or endorsed by the official Audiobookshelf project.

Audiobookshelf+ v0.15.1 (upstream v0.14.2-beta)

Choose a tag to compare

@ADD-OCD ADD-OCD released this 06 Oct 20:55

Audiobookshelf+ v0.15.1: hotfix

Based on the official Audiobookshelf app v0.14.2-beta. Installs over v0.15.0 without clearing app data; your downloads, local books and settings are kept.

Fixed

  • Series showing only one or two books. In v0.15.0, opening a series could work out the visible area of the list wrongly. Only the first one or two books appeared, and the other rows stayed blank while scrolling. Every row now shows its book, in list and grid view.

Still included from v0.15.0

  • Download controls (Retry, Cancel, Clear) with each download's state shown in words. Retry keeps the files that already finished and starts the unfinished ones again from the beginning.
  • The device-folder download and Local Folders permission fixes, Rescan Folder across libraries, playback restoration, the LLAMA theme and the widget layouts.

Install

Package app.absplus.android, signed with the Audiobookshelf+ release key, so it installs over earlier Audiobookshelf+ releases. It installs alongside the official Audiobookshelf app.