kemitix/just-audible: Audiobook library archiver

Audiobook library archiver

Find a file

Paul Campbell 86b8807249 Initial commit Add initial files.		2024-10-20 16:51:12 +01:00
.mise.toml	Initial commit	2024-10-20 16:51:12 +01:00
justfile	Initial commit	2024-10-20 16:51:12 +01:00
README.md	Initial commit	2024-10-20 16:51:12 +01:00

README.md

A justfile containing recipes to help download, convert, rename, file and archive your audiobook collection.

The use of these recipes in intended for the sole purpose of maintaining a PERSONAL archive, and the resulting .m4b files should not be redistributed where doing so would violate your contract with the supplier of the original .aax and .aaxc files.

Requirements

mise-en-place

Mise will be used to install the other dependencies. If you don't want to use mise, then you need to install the following:

just
audible-cli (recommended installation instuctions below)
fzf
jq
ffmpeg
refile-m4b

Transitive Dependencies

For refile-m4b you will also need these libraries (or the equivalent for your OS):

libtag1-dev
libtagc0-dev

Debian

sudo apt install libtag1-dev libtagc0-dev

Install `mise`

curl https://mise.run | sh
~/.local/bin/mise --version

Install dependencies with `mise`

mise install

This will use the .mise.toml file to install all the required dependencies.

Note on Installing `audible-cli` Manually

If you aren't using mise to install the audible-cli then note that the latest version (v0.3.1) doesn't work (at least for me), so I recommend using the latest version in the master branch.

Usage

Check prerequisites

Run the doctor recipe to verify prerequisites:

just doctor

e.g.:

Verify required executables are on the path:
-   OKAY  : audible => ~/.local/share/mise/installs/pipx-mkb79-audible-cli/master/bin/audible
-   OKAY  : just => ~/.local/share/mise/installs/just/latest/bin/just
-   OKAY  : fzf => ~/.local/share/mise/installs/go-github-com-junegunn-fzf/latest/bin/fzf
-   OKAY  : jq => ~/.local/share/mise/installs/jq/latest/bin/jq
-   OKAY  : ffmpeg => ~/.local/share/mise/installs/ffmpeg/latest/bin/ffmpeg
-   OKAY  : refile-m4b => ~/.local/share/mise/installs/cargo-refile-m4b/latest/bin/refile-m4b

Authenticate & Register

When prompted to name your profile, use the default: 'audible'. We use that name to locate the file ~/.audible/audible.json when converting AAX files.

audible quickstart
audible activation-bytes

This will log in to you account, register a pseudo device in your account and store the details in ~/.audible/.

Fetch Library

Once you have bought a title or otherwise added to your account's library, you need to fetch a copy of the latest library list.

just fetch-library

This will create a new file library-{date}.txt, that contains a list of everything available in your account.

Select, download and convert

The recommended workflow is to run the default recipe which will present you with a searchable list of your library. From here you can select items to download by pressing TAB (for selecting mutliple titles), or ENTER to select just the one.

Once you have made your selection, the .aax and/or .aaxc/.voucher files will be downloaded, via a ./TEMP/ directory, before being moved to either the ./AAX/ or ./AAXC/ directories.

Once downloaded they will be automatically converted to DRM free .m4b files in the ./M4B/ directory.

NOTE: After being converted the source files in the ./AAX/ and ./AAXC/ directories are deleted.

The files in ./M4B/ will then be refiled, by refile-m4b, into directories based on the author, series and title.

Review

You are now free to rename and/or move the files to more closely fit your own prefered archival needs.