ingest-audiobook

> STOP. READ THIS ENTIRE SKILL.MD BEFORE CALLING ANY ENDPOINT. # 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: ```bash uvx --from audible-cli audible quickstart ``` Follow the prompts to authorize. 2. **Download Your Books**: ```bash # 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.