Audiobook Ingest (The Black Library)

Process and organize your audiobook collection. This skill uses uvx to run its tools, making it self-contained and portable.

Workflow

1. Sync/Download: Use uvx audible-cli to download books.
2. Decrypt: AAX/AAXC files are automatically decrypted using your Audible activation bytes.
3. Transcribe: Use uvx openai-whisper (Whisper CLI) to convert audio to text.
4. Organize: Moves files to ~/clawd/library/books/<Title>/.

Commands

list-warhammer

List all Warhammer 40k books in your Audible library (searches for Warhammer, Horus, Gaunt, Siege of Terra, etc.).

download-warhammer

Download ONLY your Warhammer 40k books. Perfect for building the Horus Lupercal voice model.

1. Exports your library
2. Finds all Warhammer-related books
3. Downloads each one in AAX format to the inbox (Audible's native format)

download-all

Download all books from your Audible library.

1. Downloads in AAX format (Audible's native encrypted format)

ingest <filename>

Process a single file from ~/clawd/library/inbox/.

1. Check if ~/clawd/library/inbox/<filename> exists.
2. Create directory ~/clawd/library/books/<filename_no_ext>.
3. If AAX/AAXC: Fetch activation bytes and decrypt to M4B using ffmpeg.
4. Run uvx --from openai-whisper whisper "<audio_file>" --model turbo --output_format txt --output_dir "~/clawd/library/books/<filename_no_ext>"
5. Move the audio file to ~/clawd/library/books/<filename_no_ext>/audio.<ext> (decrypted version for AAX/AAXC).
6. Rename output: mv "~/clawd/library/books/<filename_no_ext>/<filename>.txt" "~/clawd/library/books/<filename_no_ext>/text.md"

ingest-all

Process all audio files found in ~/clawd/library/inbox/.

1. List all .mp3, .m4a, .m4b, .wav, .aax, and .aaxc files in the inbox.
2. For each file, run the ingest workflow.

Setup & First Run

1. Audible Login: Ask Horus: "Help me log in to Audible" or run this manually:

   uvx --from audible-cli audible quickstart
   

   Follow the prompts to authorize.

2. Download Your Books:

   # Download all Warhammer 40k books
   ./run.sh download-warhammer
   
   # Or download everything
   ./run.sh download-all
   

3. Transcribe: Ask Horus: "Ingest all audiobooks" or "Process my library inbox".

Tips

• Portable: Since this uses uvx, you don't need to manually install whisper or audible-cli. uv will download and cache them on first use.
• Character Names: Whisper's turbo model is specifically great for the complex names found in Warhammer legends.