2026-01-05 22:46:05 +01:00
2026-01-05 22:46:05 +01:00
2025-12-04 09:41:17 +01:00
2025-11-14 23:39:36 +01:00
2025-12-20 22:53:00 +01:00
2026-01-05 22:33:56 +01:00
2025-12-14 09:34:53 +01:00

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.

Description
TUI client for Audible
Readme GPL-3.0 731 KiB
Languages
Python 100%