librofm

A Python client library for downloading audiobooks from Libro.fm.

Features

• Download audiobooks from your Libro.fm library
• Support for both MP3 and M4B formats (M4B preferred when available)
• Automatic file organization by author and title
• Command-line interface for batch downloads
• Python API for programmatic access

Installation

pip install librofm

Configuration

Set your Libro.fm credentials as environment variables:

export LIBROFM_USERNAME="your_username"
export LIBROFM_PASSWORD="your_password"

Alternatively, create a .env file in your working directory:

LIBROFM_USERNAME=your_username
LIBROFM_PASSWORD=your_password

Usage

Command Line

Download all audiobooks to the default directory (~/Audiobooks):

librofm-download

Download to a custom directory:

librofm-download /path/to/audiobooks

By default, it won't overrite existing files. You can force it to redownload:

librofm-download --force

Show help:

librofm-download --help

Python API

from librofm.client import LibroFMClient

# Create client (uses environment variables)
client = LibroFMClient.get_client()

# Or create with explicit credentials
client = LibroFMClient("username", "password")

# Get your library
page = client.get_library()
print(f"Found {len(page.audiobooks)} audiobooks")

# Download a specific audiobook
audiobook = page.audiobooks[0]
success = client.download(audiobook, "/path/to/downloads")

# Get download manifest for MP3 files
manifest = client.get_download_manifest(audiobook)
print(f"Audiobook has {len(manifest.parts)} parts")

# Get M4B package info
m4b_info = client.get_packaged_m4b_info(audiobook)
if m4b_info:
    print(f"M4B available at: {m4b_info.m4b_url}")

File Organization

Downloaded audiobooks are organized as:

base_path/
\x00\x00 Author Name/
   \x00\x00 Book Title/
       \x00\x00 part1.mp3
       \x00\x00 part2.mp3
       \x00\x00 ...
\x00\x00 Another Author/
    \x00\x00 Another Book/
        \x00\x00 book.m4b

Requirements

• Python 3.10+
• Active Libro.fm account with audiobooks in your library

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Disclaimer

This tool is for personal use only. Please respect Libro.fm's terms of service and only download audiobooks you have legally purchased.