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 support for screen readers (including NVDA and JAWS) 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.
Install securely via Windows Package Manager. Just open Terminal (CMD or PowerShell) and type:
winget install AudioShelfBenefit: You can easily update later by typing
winget upgrade AudioShelf.
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 -r requirements.txt
-
Run the application:
python AudioShelf.py
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!
AudioShelf aims to be accessible to everyone. We are currently looking for contributors to help translate the app into more languages!
If you would like to help:
- Download the template:
locale/AudioShelf.pot. - Translate it using Poedit.
- Submit a Pull Request or contact the maintainer.
Copyright (c) 2025-2026 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.