FFcuesplitter - FFmpeg-based audio splitter for CDDA images associated with .cue 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 (via charset-normalizer) 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. It can be used either as a Python module or from the command line.

Features

• Supports many input formats, due to FFmpeg.
• 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 files and directories.
• Ability to perform recursive searches.
• Ability to generate audio collection directories (Artist/Album/TrackNumber - Title)
• Auto-tag from CUE file data.
• Features automatic character set detection for CUE files (via python3-charset-normalizer).
• Ability to remove original file after conversion.
• Works on Linux, MacOs, FreeBSD, Windows.
• It can be used either as a Python module or from the command line.

Requires

• Python >=3.9
• python3-charset-normalizer
• tqdm
• FFmpeg (including ffprobe)

Using Command Line

ffcuesplitter -i FILENAMES DIRNAMES [FILENAMES DIRNAMES ...]
              [-r]
              [-f {wav,flac,mp3,ogg,opus}]
              [-o OUTPUTDIR]
              [-del]
              [-c {author+album,author,album}]
              [-ow {ask,never,always}]
              [-ce CHARACTERS_ENCODING]
              [--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 directory.

For further information and other examples visit the wiki page

Using Python

>>> from ffcuesplitter.cuesplitter import FFCueSplitter
>>> getdata = FFCueSplitter(**kwargs)
>>> tracks = getdata.audiotracks  # get all tracks data
>>> getdata.commandargs(tracks)  # get FFmpeg command/arguments recipes.

Getting additionals data

>>> getdata.probedata  # ffprobe data of the sources audio files.
>>> getdata.cue.meta.data  # get CD info.

For further information and other examples visit the wiki page

Installation

python3 -m pip install ffcuesplitter

License and Copyright

Copyleft: (C) 2025 Gianluca Pernigotto Author and Developer: Gianluca Pernigotto Mail: jeanlucperni@gmail.com License: GPL3 (see LICENSE file in the source directory)