auditui
A terminal-based user interface (TUI) client for Audible, written in Python 3 : listen to your audiobooks (even offline), browse and manage your library, and more!
Currently, the only available theme is Catppuccin Mocha, following their style guide, as it's my preferred theme across most of my tools.
Look at the roadmap for more details.
It's still a work in progress, so expect bugs and missing features.
How to run
This project uses uv for dependency management.
# install dependencies (creates .venv)
$ uv sync
# run the TUI
$ uv run python -m auditui.cli
Please also note that as of now, you need to have ffmpeg installed to play audio files.
Bindings
| Key | Action |
|---|---|
? |
Show help screen |
n |
Sort by name |
p |
Sort by progress |
a |
Show all/unfinished |
enter |
Play the selected book |
space |
Pause/resume the playback |
left |
Seek backward 30 seconds |
right |
Seek forward 30 seconds |
ctrl+left |
Go to the previous chapter |
ctrl+right |
Go to the next chapter |
up |
Increase playback speed |
down |
Decrease playback speed |
f |
Mark as finished |
d |
Download/delete from cache |
s |
Show stats screen |
/ |
Filter library |
q |
Quit the application |
Roadmap
- list your library
- list your unfinished books with progress information
- play/pause a book
- catppuccin mocha theme
- print chapter and progress in the footer of the app while a book is playing
- chapter progress bar in footer
- add a control to jump 30s earlier/later
- add control to go to the previous/next chapter
- save/resume playback of a book from the last position, regardless of which device was used previously
- download/remove a book in the cache without having to play it
- add a help screen with all the keybindings
- increase/decrease reading speed
- mark a book as finished
- make ui responsive
- get your stats in a separated pane
- search/filter within your library
- installation setup
Auth / credentials
Login is handled and credentials are stored in ~/.config/auditui/auth.json.
OTP is supported if you use a two-factor authentication device.
License
This project is licensed under the GPLv3+ License. See the LICENSE file for details.