# Libation: Liberate your Library

## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)

### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PayPal.me](https://paypal.me/MBucari?locale.x=en_us)
...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.

# Table of Contents

- [Audible audiobook manager](#audible-audiobook-manager)
    - [The good](#the-good)
    - [The bad](#the-bad)
    - [The ugly](#the-ugly)
- [Getting started](Documentation/GettingStarted.md)
    - [Download Libation](Documentation/GettingStarted.md#download-libation-1)
    - [Installation](Documentation/GettingStarted.md#installation)
    - [Create Accounts](Documentation/GettingStarted.md#create-accounts)
    - [Import your library](Documentation/GettingStarted.md#import-your-library)
    - [Download your books -- DRM-free!](Documentation/GettingStarted.md#download-your-books----drm-free)
    - [Download PDF attachments](Documentation/GettingStarted.md#download-pdf-attachments)
    - [Details of downloaded files](Documentation/GettingStarted.md#details-of-downloaded-files)
    - [Export your library](Documentation/GettingStarted.md#export-your-library)
- [Searching and filtering](Documentation/SearchingAndFiltering.md)
    - [Tags](Documentation/SearchingAndFiltering.md#tags)
    - [Searches](Documentation/SearchingAndFiltering.md#searches)
    - [Search examples](Documentation/SearchingAndFiltering.md#search-examples)
    - [Filters](Documentation/SearchingAndFiltering.md#filters)
- [Advanced](Documentation/Advanced.md)
    - [Files and folders](Documentation/Advanced.md#files-and-folders)
    - [Settings](Documentation/Advanced.md#settings)
    - [Custom File Naming](Documentation/NamingTemplates.md)
    - [Command Line Interface](Documentation/Advanced.md#command-line-interface)
- [Docker](Documentation/Docker.md)

## Getting started

* [Download](https://github.com/rmcrackan/Libation/releases/latest)
* [Step-by-step walk-through](Documentation/GettingStarted.md)

## Audible audiobook manager

### The good

* Import library from audible, including cover art
* Download and remove DRM from all books
* Download accompanying PDFs
* Add tags to books for better organization
* Powerful advanced search built on the Lucene search engine
* Customizable saved filters for common searches
* Open source
* Supports most regions: US, UK, Canada, Germany, France, Australia, Japan, India, and Spain

<a name="theBad"/>

### The bad

* Only fully supported in Windows. (Mac and Linux are in beta)
* Large file size
* Made by a programmer, not a designer so the goals are function rather than beauty. And it shows

### The ugly

* Documentation? Yer lookin' at it
* This is a single-developer personal passion project. Support, response, updates, enhancements, bug fixes etc are as my free time allows
* I have a full-time job, a life, and a finite attention span. Therefore a lot of time can potentially go by with no improvements of any kind

Disclaimer: I've made every good-faith effort to include nothing insecure, malicious, anti-privacy, or destructive. That said: use at your own risk.

I made this for myself and I want to share it with the great programming and audible/audiobook communities which have been so generous with their time and help.
