https://github.com/idlesign/deflacue

Cue Sheet driven FLAC audio splitter
https://github.com/idlesign/deflacue

cue cuesheet flac python sox wrapper

Last synced: 11 months ago
JSON representation

Cue Sheet driven FLAC audio splitter

• Host: GitHub
• URL: https://github.com/idlesign/deflacue
• Owner: idlesign
• License: bsd-3-clause
• Created: 2012-12-18T15:45:58.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2022-02-04T13:00:31.000Z (over 4 years ago)
• Last Synced: 2025-07-03T00:57:42.624Z (11 months ago)
• Topics: cue, cuesheet, flac, python, sox, wrapper
• Language: Python
• Homepage: https://github.com/idlesign/deflacue
• Size: 43 KB
• Stars: 35
• Watchers: 5
• Forks: 13
• Open Issues: 5
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG
  • License: LICENSE

Awesome Lists containing this project

README

          
deflacue

========

http://github.com/idlesign/deflacue

|release| |lic| |ci| |coverage|

.. |release| image:: https://img.shields.io/pypi/v/deflacue.svg

    :target: https://pypi.python.org/pypi/deflacue

.. |lic| image:: https://img.shields.io/pypi/l/deflacue.svg

    :target: https://pypi.python.org/pypi/deflacue

.. |ci| image:: https://img.shields.io/travis/idlesign/deflacue/master.svg

    :target: https://travis-ci.org/idlesign/deflacue

.. |coverage| image:: https://img.shields.io/coveralls/idlesign/deflacue/master.svg

    :target: 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.6+

* 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:

.. code-block::

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