freebooks 0.1.0

Convert Audible AAX to common audio formats

FreeBooks

FreeBooks is a command-line tool for converting Audible AAX files into common audio formats (MP3, M4A, FLAC, WAV, Opus). It bundles all required tables and binaries (including rcrack) and exposes a simple freebooks CLI.

Features

• Decrypt and convert AAX files using your activation bytes
• Supports multiple output formats: mp3, m4a, flac, wav, opus
• Automatically overwrites existing files with -f/--force
• Verbose logging mode for debugging
• Self-contained package including native tables & binaries

Prerequisites

Before installing or running FreeBooks, ensure the following executables are installed under /usr/local/bin and are executable:

• /usr/local/bin/ffmpeg
• /usr/local/bin/awk
• /usr/local/bin/grep

You can verify each is on your $PATH and executable:

ls -l /usr/local/bin/ffmpeg /usr/local/bin/awk /usr/local/bin/grep

Installation

Install with pip:

pip install freebooks

Or, to build and install from source:

git clone https://github.com/leshawn-rice/freebooks.git
cd freebooks
python3 -m pip install --upgrade build
python3 -m build
pip install dist/freebooks-*.whl

Usage

freebooks INPUT_FILE.aax [options]

Arguments

• INPUT_FILE
  Path to the .aax file you wish to convert.

Options

• -o, --output-file OUTPUT_FILE
  Destination path for the converted file. Default: output.mp3.
• -t, --output-type FORMAT
  Output format: one of mp3, m4a, flac, wav, opus. Default: mp3.
• -f, --force
  Overwrite existing output file without prompting.
• -v, --verbose
  Enable verbose logging.

Examples

Convert book.aax to chapter1.mp3:

freebooks book.aax -o chapter1.mp3

Convert with overwrite and verbose logging:

freebooks book.aax -o chapter1.m4a -t m4a -f -v

Development

Clone the repo, install developer dependencies, and run tests:

git clone https://github.com/leshawn-rice/freebooks.git
cd freebooks
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade build
pip install -e .[dev]

License

MIT License. See LICENSE for details.