ffcuesplitter 1.0.20

FFmpeg based audio splitter for audio CD images supplied with CUE sheet files.

FFcuesplitter - FFmpeg based audio splitter for audio CD images supplied with .cue sheet files.

FFcuesplitter is a multi-platform CUE sheet splitter entirely based on FFmpeg. Splits big audio tracks and automatically embeds tags using the information contained in the associated "CUE" sheet. It supports multiple CUE sheet encodings and many input formats (due to FFmpeg), including APE format, without need installing extra audio libs and packages. It has the ability to accept both files and directories as input while also working in recursive mode. Can be used both as a Python module and from command line.

Features

• Supports many input formats.
• Convert to Wav, Flac, Ogg, Opus, and Mp3 formats.
• Ability to copy source codec and format without re-encoding.
• Batch mode processing is also available.
• Accepts both multiple CUE file names and multiple folder path names.
• Ability to activate the recursive option to search for CUE files in all subfolders.
• Optionally auto-generate audio collection folders (Artist/Album/TrackNumber - Title)
• Auto-tag from CUE file data.
• Features automatic character set detection for CUE files (via chardet).
• Works on Linux, MacOs, FreeBSD, Windows.
• Can be used both as a Python module and in command line mode.

Requires

• Python >=3.7
• deflacue
• chardet
• tqdm
• FFmpeg (including ffprobe)

Usage

Using Command Line

ffcuesplitter -i FILENAMES DIRNAMES [FILENAMES DIRNAMES ...]
              [-r]
              [-f {wav,flac,mp3,ogg,opus,copy}]
              [-o OUTPUTDIR]
              [-c {artist+album,artist,album}]
              [-ow {ask,never,always}]
              [--ffmpeg-cmd URL]
              [--ffmpeg-loglevel {error,warning,info,verbose,debug}]
              [--ffmpeg-add-params 'parameters']
              [-p {tqdm,standard}]
              [--ffprobe-cmd URL]
              [--dry]
              [--prg-loglevel {error,warning,info,debug}]
              [-h]
              [--version]

Examples

ffcuesplitter -i 'inputfile_1.cue' 'inputfile_2.cue' 'inputfile_3.cue'

Batch file processing to split and convert to default audio flac format.

ffcuesplitter -i '/User/music/collection/inputfile.cue' -f ogg -o 'my_awesome_tracklist'

To splits the individual audio tracks into ogg format and saves them in the my_awesome_tracklist folder.

For further information and other examples visit the wiki page

---

Using Python

>>> from ffcuesplitter.cuesplitter import FFCueSplitter
>>> getdata = FFCueSplitter("tests/Three Samples_ASCII.cue", dry=True)
>>> getdata.open_cuefile()  # you need to open the cue file first.
>>> getdata.audiotracks  # get processed audio tracks list taken from the cue file.
>>> getdata.cue.meta.data  # get CD info.
>>> getdata.commandargs()  # get FFmpeg command/arguments recipes.

For further information and other examples visit the wiki page

---

Installation

python3 -m pip install ffcuesplitter

License and Copyright

Copyright (C) 2023 Gianluca Pernigotto
Author and Developer: Gianluca Pernigotto
Mail: [e-mail]
License: GPL3 (see LICENSE file in the source folder)