FFCUESPLITTER(1)

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

SYNOPSIS
ffcuesplitter [-h] [--version] [-i IMPUTFILE] [-f {wav,flac,mp3,ogg,copy}] [-o OUTPUTDIR] [-ow {ask,never,always}] [--ffmpeg-url URL] [--ffmpeg-loglevel {error,warning,info,verbose,debug}] [--ffmpeg-add-params 'PARAMS ...'] [-p {tqdm,standard}] [--ffprobe-url URL] [--dry]

DESCRIPTION
FFcuesplitter is a multi-platform CUE sheet splitter entirely based on FFmpeg. Accurately splits big audio tracks and automatically tags them using the information contained in the associated CUE sheet. It supports many input formats (due to FFmpeg), including APE format without need installing third-party libs or packages. automatically support multiple CUE sheet encodings via chardet, deflacue libraries. Can be used both as a Python module (API) and in command line mode.

COMMAND LINE OPTIONS

--version
    Show the program version and exit.

-h, --help
    Show a short help and exit.

-i INPUTFILE, --input-cuefile INPUTFILE
    An absolute or relative INPUTFILE. This file must be a CUE sheet file, i.e. with `.cue` extension.

-f {wav, flac, mp3, ogg, copy}, --format-type {wav, flac, mp3, ogg, copy}
    Preferred output file format, default is `flac`. Using the `copy` option does not re-encode the output file speeding up the tracks extraction process, but often the result may not be very accurate.

-o OUTPUTDIR, --output-dir OUTPUTDIR
    Absolute or relative destination path for output files. If a specified destination folder does not exist, it will be created automatically. By default it is the same location as IMPUTFILE.

-ow {ask, never, always}, --overwrite {ask, never, always}
    Set an action in case there are already the same existing files on the output destination. Default is `ask` before proceeding; `never` will skip all files; `always` will proceed to overwrite all files if any.

--ffmpeg_url URL
    Specify a custom ffmpeg path, e.g. '/usr/bin/ffmpeg', Default is `ffmpeg`

--ffmpeg_loglevel {error, warning, info, verbose, debug}
    Specify a ffmpeg loglevel, Default is `warning`

--ffmpeg_add_params PARAMS ...
    Additionals ffmpeg parameters, as 'codec quality', etc. Note that additional parameters must be quoted.

-p {tqdm, standard}, --progress-meter {tqdm, standard}
    Progress bar mode. This takes effect during FFmpeg process loops. Using command line default is `tqdm`. Using API default is `standard`. Note that, not like `tqdm`, the `standard` option print output to console and does not write it to file log as it already allows you to view anything on the console.

--ffprobe_url URL
    Specify a custom ffprobe path, e.g. '/usr/bin/ffprobe', Default is `ffprobe`

--dry
    Perform the dry run with no changes done to filesystem. Only show what would be done.

EXAMPLES

ffcuesplitter -i 'INPUTFILE.cue'
    To split into the relative individual `flac` formats, in the same folder as IMPUTFILE.cue.

ffcuesplitter -i '/User/INPUTFILE.cue' -f wav -o 'my_awesome_tracklist'
    To splits the individual audio tracks into `wav` format and saves them in the 'my_awesome_tracklist' folder.

USING PYTHON MODULE
    >>> from ffcuesplitter.cuesplitter import FFCueSplitter
    >>> help(FFCueSplitter)

SEE ALSO
ffmpeg(1), ffprobe(1),

AUTHORS
Written by Gianluca Pernigotto, Alias: jeanslack <jeanlucperni@gmail.com> . Webpage: https://github.com/jeanslack/FFcuesplitter

COPYRIGHT
Copyright © 2022 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.