Metadata-Version: 2.5
Name: deflacue
Version: 2.1.0
Summary: SoX based audio splitter to split audio CD images incorporated with .cue files
Project-URL: Homepage, https://github.com/idlesign/deflacue
Author-email: Igor Starikov <idlesign@yandex.ru>
License-Expression: BSD-3-Clause
License-File: LICENSE
Keywords: audio,cue,flac,sox
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# deflacue

<https://github.com/idlesign/deflacue>

[![release](https://img.shields.io/pypi/v/deflacue.svg)](https://pypi.python.org/pypi/deflacue)
[![lic](https://img.shields.io/pypi/l/deflacue.svg)](https://pypi.python.org/pypi/deflacue)
[![coverage](https://img.shields.io/coveralls/idlesign/deflacue/master.svg)](https://coveralls.io/r/idlesign/deflacue)

## What's that

*deflacue is a SoX based audio splitter appropriate to split audio CD images incorporated with .cue files.*

It is able to function both as a Python module and in command line mode.

## Features

- Large variety of supported lossless input audio formats FLAC, WAV, etc. (due to SoX).
- Batch audio files processing (including recursive path traversing).
- Automatic audio collection hierarchy building (Artist/Year-Album/Tracknum-Title).
- Automatic track metadata copying from .cue.

## Requirements

* Python 3.10+
* SoX command line utility — <http://sox.sourceforge.net>.

  Ubuntu users may install the following SoX packages: `sox`, `libsox-fmt-all`.

## Usage

### From Python

`from deflacue import deflacue` — if you want to use it as module.

Use `Deflacue` class for SoX interaction.

Use `CueParser` class for .cue parsing.

### From Command Line

`deflacue --help` in command line — to get help on utility usage.

In the following example we create audio collection in `/home/idle/audio_collection/` from audio CD images
stored under `/home/idle/audio_raw/` processing Cue Sheet files created using `windows-1251` encoding:

```shell
$ deflacue -e windows-1251 /home/idle/audio_raw/ -d /home/idle/audio_collection/
```
