The ultimate audiobook player that treats your books like books, not just files.
AudioShelf is a specialized desktop application designed for audiobook enthusiasts who need precision, organization, and accessibility. Unlike generic media players, AudioShelf understands that every book is a unique journey with its own progress, history, and settings.
Most players treat audio files equally. AudioShelf treats every book as a distinct entity.
- Independent Progress: Remembers exactly where you left off in every single book, down to the second.
- Smart Metadata: Automatically imports and manages book details, chapters, and file structures.
- Metadata Persistence: Saves your progress, bookmarks, and playback state directly alongside the book files (
.json). Move your library to another PC, and your listening history moves with it. - Dedicated History: Keep track of your recently played books in a dedicated history tab.
- Smart Resume: Intelligently rewinds a few seconds after long pauses so you never lose the context of the story.
- A-B Loop: Repeat specific sections of audio effortlessly—perfect for language learners.
- Variable Speed: Adjust playback speed without distorting the narrator's voice (Pitch-corrected).
- 10-Band Equalizer: Custom audio presets (e.g., Vocal Clarity) to enhance different narrators' voices.
- Screen Reader Optimized: Built from the ground up with native
nvdaControllerClient.dllintegration for precise semantic announcements. - Keyboard-Driven: Every single feature is accessible via customizable hotkeys for a mouse-free experience.
- Auto-Updater: Automatically checks for and installs the latest updates at startup.
- Sleep Timer: Configurable timer with system actions (Shutdown/Sleep/Hibernate).
- Portable Mode: Run AudioShelf directly from a USB drive without installation.
AudioShelf is designed to be keyboard-centric. Press F1 in the app for the full list.
| Action | Shortcut |
|---|---|
| Play / Pause | Space |
| Stop (Reset) | Shift + Space |
| Rewind / Forward | Left / Right Arrow |
| Volume Control | Up / Down Arrow |
| Speed Control | J (Faster) / H (Slower) / K (Reset) |
| Quick Bookmark | B |
| Sleep Timer | T |
| Play Last Book | Ctrl + L |
| Search Library | Ctrl + F |
Get the latest version directly using the links below:
Click here to Download Setup (.exe)
- Run the installer to set up AudioShelf on your PC.
Click here to Download Portable (.zip)
- Extract the zip file anywhere (e.g., on a USB stick) and run
AudioShelf.exe.
View full version history on the Releases Page.
AudioShelf is built using Python 3.14, but supports Python 3.10+.
-
Clone the repository:
git clone https://github.com/M-Rajabi-Dev/AudioShelf.git cd AudioShelf -
Install dependencies:
pip install wxpython python-mpv tinytag
-
External Dependencies:
- Ensure
libmpv-2.dllis placed in the root directory. - Ensure
nvdaControllerClient.dllis available for screen reader support.
- Ensure
-
Run the application:
python AudioShelf.py
AudioShelf is an example of AI-Assisted Development. The project was conceptualized to solve specific accessibility gaps in existing players. Modern AI tools were utilized to accelerate the coding process, allowing the focus to remain on user experience and solving edge cases for the visually impaired community. We believe in transparency and leveraging technology to bridge accessibility gaps.
AudioShelf is a free and open-source project developed with passion.
- Star this repository on GitHub ⭐
- Donate via the in-app support menu.
- Contribute: Pull Requests are welcome!
Copyright (c) 2025 Mehdi Rajabi. AudioShelf is Free Software: You can use, study, share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.