Metadata-Version: 2.1
Name: flackup
Version: 0.7.4
Summary: FLAC CD Backup Manager
Author-email: Alexander Dietrich <alexander@dietrich.cx>
Project-URL: Homepage, https://codeberg.org/alxndr42/flackup
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Sound/Audio :: CD Audio
Classifier: Topic :: Multimedia :: Sound/Audio :: Conversion
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click~=8.1
Requires-Dist: musicbrainzngs~=0.7
Requires-Dist: mutagen~=1.47
Requires-Dist: pillow~=10.3

# Flackup

Flackup manages audio CD backups as single FLAC files with [embedded cue
sheets][cuesheet], adds metadata from [MusicBrainz][] and converts albums to
individual [Ogg Vorbis][] tracks.

[cuesheet]: https://xiph.org/flac/format.html#format_overview
[musicbrainz]: https://musicbrainz.org/
[ogg vorbis]: https://xiph.org/vorbis/

## Requirements

- FLAC files with embedded cue sheets
- `flac`, `oggenc` and `vorbisgain`
- Python 3.8

## Installation

Using pip (or [pipx][]):

```bash
pip install flackup
```

[pipx]: https://pypa.github.io/pipx/

## Usage

You can get help for all commands with the `--help` parameter.

To tag a number of FLAC files with embedded cue sheets:

```bash
flackup tag *.flac
```

If there are multiple releases matching the cue sheet (and there probably will
be), Flackup will show you some release details, including the barcode, and let
you pick the correct one.

To add cover images to a number of tagged FLAC files:

```bash
flackup cover *.flac
```

To convert a number of tagged FLAC files to Ogg Vorbis in the `$HOME/Music`
directory:

```bash
flackup convert -d $HOME/Music *.flac
```
