Installation

NOTE: This library has only been tested on Linux. It may not work on other operating systems.

Prerequisites

• Python 3.12 or higher

External Requirements

audiolibrarian uses a few command-line tools to run:

• cd-paranoia
• util-linux
• faad2
• fdkaac
• ffmpeg - optional
• flac
• lame
• mpg123
• libsndfile
• wavegain - optional

It also requires the libdiscid library.

Instructions for installing these required tools in commonly-used Linux distributions can be found below.

Installing with pip

The easiest way to install audiolibrarian is from PyPI:

pip install audiolibrarian

Verifying the installation

After installation, verify that audiolibrarian is installed correctly:

audiolibrarian --version

You should see the version number printed if the installation was successful.

Upgrading

To upgrade to the latest version:

pip install --upgrade audiolibrarian

Uninstalling

To uninstall audiolibrarian:

pip uninstall audiolibrarian

Installing External Requirements

Arch Linux

sudo pacman -S \
    faad2 \
    fdkaac \
    ffmpeg \
    flac \
    lame \
    libcdio-paranoia \
    libdiscid \
    libsndfile \
    mpg123 \
    python-pip \
    util-linux \
    wavegain

Fedora

Fedora Linux is not currently supported because fdkaac is not available.

Ubuntu

sudo apt update
sudo apt install -y \
    cdparanoia \
    eject \
    faad \
    fdkaac \
    ffmpeg \
    flac \
    lame \
    libdiscid0 \
    libsndfile1 \
    mpg123 \
    python3-pip