Skip to content

100nandoo/shelfdroid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

721 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ShelfDroid

ShelfDroid app icon

Audiobookshelf Android client with playback, downloads, and server management

latest release license downloads

Download β€’ Features β€’ Screenshots β€’ Acknowledgements β€’ Star History β€’ License

ShelfDroid is a third-party Android client for self-hosted Audiobookshelf servers. Use it to browse audiobook and podcast libraries, stream playback from your server, keep listening offline on your Android device, and handle common server management tasks from the same app.

Important

ShelfDroid does not provide media, hosting, or a managed server. You bring your own Audiobookshelf library and account.

Download

Get it on Google Play Download latest APK

Features

  • Browse audiobook and podcast libraries from your Audiobookshelf server
  • Stream audiobooks and podcast episodes with synced progress
  • Download books and episodes for durable offline playback
  • Use chapters, bookmarks, sleep timer, playback speed, and player controls
  • Manage backups, API keys, users, logs, and server settings when your account has permission
  • Review listening sessions and other admin screens available to your account
  • Customize sorting, display preferences, and playback settings

Screenshots

All screenshots below are sourced from fastlane/metadata/android/en-US/images.

Phone screenshots

Books home screen Podcasts home screen Book details screen

Podcast details screen Episode details screen Book player screen

Podcast player screen Settings screen Backups screen

Server settings screen Edit book screen

7-inch tablet screenshots

7-inch tablet podcast home screen 7-inch tablet settings screen

10-inch tablet screenshots

10-inch tablet books home screen 10-inch tablet book details screen

Requirements

  • An Audiobookshelf server you can sign in to
  • Android 10 or newer
  • JDK 17 for local builds

Roadmap

  • Implement core audiobook streaming functionality
  • Add offline downloading and playback
  • Improve search and filtering features
  • Introduce custom themes for personalization
  • Add in-app settings for customization
  • Integrate Google Assistant for voice control
  • Enhance playback controls with bookmarks and sleep timers
  • Develop a modern and user-friendly UI
  • Support audiobook chapters for easy navigation

See the issue tracker for current work and feature requests.

Documentation

Project documentation lives in docs/DOCS.md, including code style and architecture notes. Recent release notes are tracked in CHANGELOG.md.

Acknowledgements

Star History

Star History Chart

Contributing

  1. Fork the repository.
  2. Create a feature branch with git checkout -b feature/YourFeatureName.
  3. Make your changes, run formatting, and test the affected code.
  4. Commit your changes. If you use Commitizen, run cz c.
  5. Push your branch and open a pull request.

License

ShelfDroid is open source under the GNU Affero General Public License v3.0.


Copyright (c) 2026 100nandoo

About

πŸ“š A 3rd-party Android client for Audiobookshelf, bringing your audiobook collection to life with seamless streaming and intuitive controls.

Topics

Resources

License

Stars

Watchers

Forks

Contributors