AudioShelf is a modern audiobook player designed for accessibility and ease of use. It helps users organize their listening library efficiently while supporting various audio formats.
Key Features:
Independent Progress Tracking: Remembers your exact listening position in every book, down to the second.
Smart Metadata Management: Automatically imports and manages book details, chapters, and file structures.
Professional Playback Controls: Includes features like A-B Loop for repeated sections, Variable Speed playback with pitch correction, and a 10-band equalizer for enhanced audio quality.
Accessibility Features: Built with native screen reader support and keyboard-driven controls for users who rely on assistive technologies.
Powerful Tools: Offers an auto-updater, sleep timer, and portable mode for flexible usage.
Audience & Benefit:
Ideal for audiobook enthusiasts seeking a seamless listening experience with precise organization and accessibility features. AudioShelf empowers users to manage their audiobook library efficiently while ensuring ease of use for all, including those with disabilities. It can be installed via winget for convenient setup on Windows systems.
README
🎧 AudioShelf
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.
🌟 Why AudioShelf?
Most players treat audio files equally. AudioShelf treats every book as a distinct entity.
📚 Book-Centric Management
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.
🎛️ Professional Playback Control
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.
🗣️ Accessibility First
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.
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
❤️ Support & Contributing
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!
📜 License
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.
This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
