Repository navigation
Audiobookshelf+ v0.20.0-dev.2 — Contributor Testing
Pre-releaseAudiobookshelf+ 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· versionName0.20.0-dev.2· versionCode139 - Signed with the contributor testing certificate (SHA-256
25802304ac05945342c5266666d43933dd93313836553c1e064f26782a5490a7); the regular release key is not used. - Built from the
fix/dev2-audit-correctionsbranch on top of dev.1 (804e0835). Exact commit, APK hash and checks:BUILD-INFO.jsonandSHA256SUMS.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.debugwith development builds, which are signed
with a different key, so they could not update each other. dev.2 and later useapp.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.
- Download
audiobookshelfplus-v0.20.0-dev.2-contributor.apkandSHA256SUMS.txt; check the hash (e10e926802dc17411497171b8172fc468b46c0c29056dbc51e961b9ee2361bf7). - Install the APK (Android will warn about an unknown source; this is a signed testing build).
- Open Audiobookshelf+ Contributor, connect to your server, sign in, confirm your libraries and playback work.
- Re-set your options (theme, jump times, long jumps, download storage, auto download/delete); they don't carry over.
- 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.