rmcrackan/Libation
Libation
Libation is a comprehensive audiobook management system designed to download, decrypt, and organize Audible audiobooks. It integrates account authentication, library synchronization, DRM removal, and format transcoding into a single desktop application with a plugin-free graphical interface and a built-in theme editor.
The project distinguishes itself through a batch library synchronization engine that scans all configured Audible accounts in one pass, a metadata tag rewriting system that corrects chapter markers and cover art after decryption, and a template-based file naming engine that constructs output file and folder names from audiobook metadata. It also includes a wildcard and range search engine for querying the library, and Snap-aware configuration persistence that survives package updates.
Beyond its core decryption and downloading capabilities, Libation supports multi-format audio conversion to AAC-LC, xHE-AAC, MP3, or original format preservation, and can handle Widevine-protected audiobooks for higher-quality stereo output. The application provides a command-line interface for automation, account management via JSON import or browser-based OAuth login, and library metadata export to Excel, CSV, or JSON. A template engine with conditional content inclusion and formatting for date, language, list, name, number, region, series, text, and duration properties enables detailed customization of file naming.
The application is distributed as a desktop GUI with a color theme editor, and its configuration system includes audio codec selection, file naming rules, and system integration settings for non-US Audible accounts and database path correction after Snap updates.
Features
- Audible Notifications - Downloads and decrypts Audible audiobooks, removing DRM to produce playable local files in multiple formats.
- File Naming and Destination Templates - Constructs output file and folder names from audiobook metadata using user-defined templates.
- Metadata-Driven File Naming Templates - Provides a template engine that constructs file names from audiobook metadata fields with conditional formatting.
- DRM Removal Utilities - Downloads and decrypts Audible audiobooks, removing DRM for permanent offline ownership.
- Audiobook Downloads - Downloads audiobooks from Audible accounts for permanent offline access.
- Audible DRM Downloaders - Downloads and decrypts Audible audiobooks, removing DRM for permanent ownership.
- DRM Decryption Suites - Removes digital rights management from downloaded audiobooks for playback on any device.
- AAX Decryptors - Decrypts AAX-format audiobooks and removes DRM to produce playable audio files.
- Audiobook Library Managers - Scans, searches, filters, and organizes a personal collection of Audible audiobooks with metadata and cover art.
- Library Collection Management - Organizes, searches, and filters a local collection of Audible audiobooks with metadata and cover art.
- Audiobook Metadata Correctors - Corrects chapter markers, cover art, and metadata tags in decrypted audiobook files for proper playback.
- Batch Synchronization Engines - Ships a batch engine that scans all configured Audible accounts and reconciles local files in one pass.
- Audiobook Metadata Tracking - Corrects chapter markers, cover art, and metadata tags after decryption to improve the listening experience.
- Audio Format Converters - Transforms audiobook files between supported audio formats for compatibility with different players.
- Audible API Clients - Provides a client library that directly interfaces with Audible's internal API for account and library operations.
- Audiobook Library Imports - Scans linked Audible accounts to populate the local library with all owned titles.
- Multi-Format Audiobook Decryptors - Decrypts AAX and Widevine-protected audiobooks and transcodes to multiple output formats.
- Metadata-Based File Naming - Builds output file and folder names from audiobook metadata using a flexible tag-based template engine.
- Audible Account Importers - Imports Audible accounts from JSON exports, validates them, and refreshes tokens for local use.
- Existing Audiobook Imports - Imports existing audiobook files with cover art into the application.
- Widevine Decryptors - Downloads audiobooks protected by Google's Widevine DRM for higher-quality stereo tracks.
- Chapter Editors - Corrects chapter markers, cover art, and metadata tags in downloaded Audible audiobooks.
- Personal Library Managers - Lets users search, filter, and tag their audiobook collection for easy management.
- Library Filters - Queries and filters the local audiobook collection by various criteria to quickly find specific titles.
- Format Export for Device Compatibility - Exports audiobooks as widely supported m4b or mp3 files playable on any media player or self-hosted server.
- CLI Library Scanners - Scans all configured Audible accounts and imports library metadata from the command line.
- OAuth Browser Login Flows - Performs OAuth login by printing a sign-in URL and completing the flow with the browser's redirect URL.
- Audiobook Transcoders - Transcodes audiobooks from multiple formats to MP3 for broader player compatibility.
- Audiobook Search Filters - Queries and organizes the audiobook library using search terms and filter criteria.
- Audiobook Format Converters - Transforms audiobook files between supported audio formats for compatibility with different media players.
- Multi-Format Audiobook Downloads - Downloads audiobooks in multiple audio formats based on user configuration.
- Media Management CLI Tools - Controls download, library scanning, and account management operations from the command line for automation.
- Audiobook Management CLIs - Controls download and library operations for audiobooks through a command-line interface.
- Conditional Content Blocks - Includes or excludes template content based on property existence or comparison checks within naming templates.
- CLI Task Managers - Runs download and management tasks from the command line for automation and scripting.
- Audiobook Codec Selectors - Lets users choose between xHE-AAC and AAC-LC codecs to balance audio quality with media player support.
- Single Book Downloaders - Re-downloads a specific audiobook by its ASIN, even if the file already exists locally.
- Audible Account Configurations - Imports Audible accounts via JSON export and performs OAuth login through an external browser.
- Widevine DRM Configurators - Enables Widevine DRM and requests the xHE-AAC codec to obtain higher-quality stereo audio from Audible.
- Audiobook Metadata Search Engines - Implements a query parser with prefix wildcards, Boolean operators, and range filters for audiobook metadata.
- Custom Color Theme Definitions - Adjusts the application's color scheme through a built-in theme editor for a personalized interface.
