Repository navigation
v0.0.1
Pre-release
Pre-release
ShelfSync v0.0.1 is the first public pre-release. It is early software: interfaces
and behavior may change between releases.
What is in this release
- OPDS catalog browsing with authenticated access (HTTP Basic Auth, scoped to
the configured server). - Verified downloads staged as
.partfiles, hash-checked, then renamed
atomically, with bounded-parallel bulk sync and live per-book progress. - Offline library state tracking (complete, downloading, failed, unavailable,
superseded) with explicit reconciliation against the catalog. Files are never
deleted automatically. - Credential handling: on Android the OPDS password is encrypted with a
non-exportable key held in the Android Keystore; on desktop credentials stay in
memory only. - E-Ink friendly UI: grouped browsing by series, author, tag, or date added,
keyboard accessible and screen-reader labeled.
Not an e-reader
ShelfSync gets verified books onto your device; it does not render them. Reading
belongs to a separate app, and Leafline is
recommended.
Downloads
Desktop:
ShelfSync_0.0.1_x64-setup.exe- Windows installer (NSIS)ShelfSync_0.0.1_x64_en-US.msi- Windows installer (MSI)ShelfSync_0.0.1_amd64.AppImage- Linux portable, no install requiredShelfSync_0.0.1_amd64.deb- Debian/Ubuntu package
Android:
app-universal-release.apk- universal APK for arm64-v8a, armeabi-v7a, x86,
and x86_64. Signed. You can sideload it directly, or add
https://github.com/jdluu/ShelfSyncin
Obtainium to receive future updates.
Verification for this tag
pnpm vitest run: 29 files, 310 tests passing- CI on the released commit (frontend, frontend-compile, rust): green
npx tsc -bclean;biome check .clean over 102 files- Secret scan over all 376 commits of history: no leaks
- Build workflow: desktop and Android jobs green, artifacts attached and read back
- APK inspected: APK Signature Scheme v2 signing block present, native libraries
for all four ABIs
Release history is recorded in
CHANGELOG.md.