OpenParable
Skip to content
← Back to skills

Audiobook Ingest

Documents
audiobook-ingest

Audiobook Ingest is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Process audiobooks from the inbox: transcribe to text and organize audio for voice training.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/ai-ml/audiobook-ingest/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/audiobook-ingest, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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.