An unofficial cross-platform app for Audiobookshelf
- Currently, access is invite‑only due to Google's restrictions for new apps. To join the closed testing, email me at fito0912(@)duck.com (or the mail at my GitHub profile) with the email address you use for the Play Store. After I add you to the closed testing, you can use the links above to access the app. Please also mention if you just want to access the normal, AAOS or both versions of the app.
If you don't want to do that, which is very understandable, you can also download the APK from the releases page, but you won't get automatic updates that way. These are exactly the same files that are uploaded to the Play Store. - Download the latest APK from the releases page. Note that
AAOSare only compatible with Android Automotive.
-
Use the Flatpak (recommended):
flatpak remote-add --if-not-exists yaabsa https://Vito0912.github.io/yaabsa/de.vito0912.yaabsa.flatpakrepo --user flatpak install yaabsa de.vito0912.yaabsa --user
-
The AUR package is maintained by @caitlynrw. Thanks!
-
For all other installation methods, please refer to the Platform hints section below and download them from the releases page.
- Join the beta via TestFlight using the button above.
- Alternatively, download the latest app bundle from the releases page.
- Join the beta via TestFlight using the button above.
- Alternatively, download the latest IPA from the releases page to use it with tools like AltStore.
- Download the latest installer from the releases page. (Microsoft Store availability will follow).
As I myself criticize the lack of disclosure about AI, which most ABS apps now use, I want to be clear that later in the making of the app, AI/LLMs were used in the development process. I still know the API endpoints used very well and have already helped a ton of people with API usage.
Below is a list of all features, but I want to highlight a few, as this client has features that are only and or very rarely found in other clients:
- First client that supports Android Automotive (AAOS) for Audiobookshelf (ABS)
- WIP (so basic) eBook/PDF support with syncable annotations
- subtitle support with karaoke-style highlighting support (later planned to be extended like Whispersync)
- Support for all platforms Linux, Android, Android Automotive, iOS, macOS, Windows with responsive design
- More actions directly via the notification player
- You can customize the player components and move them around
Note
Please note that this client is a mainly personal project I started because it lacks features
There are many options now, most of them just vibe-coded, and I do not want to add another app to the pile. This App by no means is AI-free, but not vibed
If you find this app or see me mention it in a thread because of one of its unique features, please note that, since it is a personal project, any changes are very personal/opiniated.
If you have better ideas for design, I am open to restructuring or redesigning the app
Note
- ✅: Feature is available and tested for the platform before the release on at least one personal device.
- ❓: Feature is available but not tested for the platform before the release. The features should work, but they are not guaranteed to work.
- ❌: Feature is not available for the platform, due to missing libraries. It does not mean that it will never be available
🅿️ : Feature is planned for the platform, but not yet implemented.
If a feature already has a
| Feature | Android | iOS | Windows | MacOS | Linux |
|---|---|---|---|---|---|
| Library (Book) | ✅ | ✅ | ✅ | ✅ | ✅ |
| Library (Podcast) | ✅ | ✅ | ✅ | ✅ | ✅ |
| Personalized/Shelf | ✅ | ✅ | ✅ | ✅ | ✅ |
| Series | ✅ | ✅ | ✅ | ✅ | ✅ |
| Collections | ✅ | ✅ | ✅ | ✅ | ✅ |
| Playlists | ✅ | ✅ | ✅ | ✅ | ✅ |
| Author | ✅ | ✅ | ✅ | ✅ | ✅ |
| Narrator | ✅ | ✅ | ✅ | ✅ | ✅ |
| Search | ✅ | ✅ | ✅ | ✅ | ✅ |
| Stats | ✅ | ✅ | ✅ | ✅ | ✅ |
| Feature | Android | iOS | Windows | MacOS | Linux |
|---|---|---|---|---|---|
| Play/Pause/Seeking/Speed/Volume | ✅ | ✅ | ❓ | ✅ | ✅ |
| Background Playback | ✅ | ✅ | ❓ | ✅ | ✅ |
| Device Controls | ✅ | ✅ | ❌ | ✅ | ❌ |
| (Auto)-Queue | ✅ | ✅ | ❓ | ✅ | ✅ |
| Gapless playback | ✅ | ✅ | ❓ | ✅ | ✅ |
| Buffering | ✅ | ✅ | ❓ | ✅ | ❓ |
| Volume Boost | ✅ | ❌ | ❌ | ❌ | ❌ |
| Audio ducking | ✅ | ❓ | ❌ | ❌ | ❌ |
| Sleep Timer | ✅ | ✅ | ❓ | ✅ | ✅ |
| Chapters | ✅ | ✅ | ❓ | ✅ | ✅ |
| Play History | ✅ | ✅ | ❓ | ✅ | ✅ |
| Shake to rewind | ✅ | ✅ | ❌ | ❌ | ❌ |
| Cast | ✅ | ❓ | ❌ | ❌ | ❌ |
| Auto-Download next in queue | |||||
| Auto-Resume | ✅ | ✅ | ✅ | ✅ | ✅ |
| Subtitles (karaoke-style) | ✅ | ✅ | ✅ | ✅ | ✅ |
| Feature | Android | iOS | Windows | MacOS | Linux |
|---|---|---|---|---|---|
| ePUB support | ✅ | ❓ | ❓ | ❓ | ❌ |
| MOBI support | ✅ | ❓ | ❓ | ❓ | ❌ |
| CBZ support | ✅ | ❓ | ❓ | ❓ | ❌ |
| KF8 (AZW3) support | ✅ | ❓ | ❓ | ❓ | ❌ |
| FB2 support | ✅ | ❓ | ❓ | ❓ | ❌ |
| PDF support | ✅ | ✅ | ✅ | ||
| Annotations | ✅ | ✅* | ✅ | ✅ | |
| Sync Annotations | ✅ | ✅ | ❓ | ✅ | ✅ |
| Media Overlays** |
* You can only load in annotations, but not create new ones for ePUBs
** Media Overlays allow a whispersync-like experience for eBooks. This allows you to read and listen to your book at the same time. Please note that the player support is way more limited than for normal audiobooks. Media Overlays need to be added manually before adding them to ABS. I do maintain a soft fork of ABS that will have the capabilities to embed the audiofile into the eBook.
| Feature | Android | iOS | Windows | MacOS | Linux |
|---|---|---|---|---|---|
| Sync | ✅ | ✅ | ✅ | ✅ | ✅ |
| Caching | ✅ | ✅ | ✅ | ✅ | ✅ |
| Downloads | ✅ | ✅ | ❓ | ✅* | ✅ |
| Headers | ✅ | ✅ | ✅ | ✅ | ✅ |
| Tray/Statusbar Icon | ❌ | ❌ | ❓ | ✅ | ✅ |
| Car | ✅ | ✅ | ❌ | ❌ | ❌ |
| Android Automotive | ✅ | ❌ | ❌ | ❌ | ❌ |
| Widgets | ✅ | ❌ | ❌ |
* Only supports the default download location, due to sandboxing limitations. Will be addressed in the future.\
| Feature | Android | iOS | Windows | MacOS | Linux |
|---|---|---|---|---|---|
| Manage Playlists | ✅ | ✅ | ✅ | ✅ | ✅ |
| Manage Collections | ✅ | ✅ | ✅ | ✅ | ✅ |
| Edit items | ✅ | ✅ | ✅ | ✅ | ✅ |
| Delete items | ✅ | ✅ | ✅ | ✅ | ✅ |
| Upload items | ✅ | ✅ | ✅ | ✅ | ✅ |
| Match items | ✅ | ✅ | ✅ | ✅ | ✅ |
| Bulk editing | |||||
| Embedding/Encoding | ✅ | ✅ | ✅ | ✅ | ✅ |
| Open RSS feeds | |||||
| Send to E-Reader |
| Feature | Android | iOS | Windows | MacOS | Linux |
|---|---|---|---|---|---|
| User management | ✅ | ✅ | ✅ | ✅ | ✅ |
| Metadata utils | ✅ | ✅ | ✅ | ✅ | ✅ |
| Listening Sessions* | ✅ | ✅ | ✅ | ✅ | ✅ |
| Server Settings | ✅ | ✅ | ✅ | ✅ | ✅ |
| Library Management | ✅ | ✅ | ✅ | ✅ | ✅ |
| API Key Management | ✅ | ✅ | ✅ | ✅ | ✅ |
| Manage Backups | ✅ | ✅ | ✅ | ✅ | ✅ |
| Server Logs | ✅ | ✅ | ✅ | ✅ | ✅ |
| Email/E-Reader | ✅ | ✅ | ✅ | ✅ | ✅ |
| RSS Feeds | ✅ | ✅ | ✅ | ✅ | ✅ |
| Authentication | ✅ | ✅ | ✅ | ✅ | ✅ |
* Also allows editing sessions
The releases are used daily on Android and Linux. Other OSes should not break, but they are not tested more deeply. Issues with iOS should be easy to catch since, while not used daily, it is still used.
For the best experience and security, please use the Flatpak. It includes everything you need and is easy to remove later.
The Snap package is currently broken and might be removed in the future.
For all other installation methods, you need to make sure that the correct dependencies are installed on your system. If the app starts with a black screen, please set the ENV YAABSA_RELEASE_CONSOLE_LOG=1, as this will log issues if you start the application from the terminal.
In general, you need the following dependencies:
- libmpv
- libsecret