Skip to main content

CUE sheet Splitter, based on shntool and cuetools libraries.

Project description

Pysplitcue - CUE sheet splitter, based on shntool and cuetools libraries.

Pysplitcue is a stupid wrapper for the shntool and cuetools libraries. It splits big audio tracks using informations contained in the associated "CUE" sheet file and can automatically handle files encoded other than UTF-8 and ASCII encodings without modifying the source files.

Note: there are also other alternatives to pysplitcue:


  • Supported input formats: WAV, FLAC, APE, WavPack
  • Supported output formats: FLAC, APE, WAV, WavPack, OGG or MP3
  • Auto-tag is supported only for FLAC, MP3, OGG formats


  • Python >=3.6
  • chardet (The Universal Character Encoding Detector)
  • shntool (includes shnsplit)
  • cuetools (includes cuebreakpoints, cueconvert, cueprint, cuetag)


  • flac
  • lame
  • vorbis-tools (includes oggenc, oggdec)
  • monkeys-audio (to convert APE audio format, name depends to your O.S.)
  • wavpack

Ubuntu users can install required and optional dependencies like this:
sudo apt install shntool cuetools flac lame vorbis-tools wavpack monkeys-audio


From Command Line

pysplitcue -i IMPUTFILE
             [-f {wav, wv, flac, ape, mp3, ogg}] 
             [-o OUTPUTDIR] 
             [-ow {ask,never,always}] 

From Python Interpreter

>>> from pysplitcue.splitcue import PySplitCue
>>> kwargs = {'filename': '/home/user/my_file.cue',
              'outputdir': '/home/user/some_other_dir',
              'suffix': 'flac',
              'overwrite': 'ask'
>>> split = PySplitCue(**kwargs)
>>> split.open_cuefile()
>>> split.do_operations()
>>> split.cuefile.close()


pysplitcue -i 'inputfile.cue'

To split and convert several audio formats into the relative individual flac format audio tracks.

pysplitcue -i '/User/music/collection/inputfile.cue' -f wav -o 'my-awesome-tracklist'

This command splits the individual audio tracks into wav format and saves them in the 'my-awesome-tracklist' folder.


python3 -m pip install pysplitcue

License and Copyright

Copyright © 2010 - 2022 Gianluca Pernigotto
Author and Developer: Gianluca Pernigotto
License: GPL3 (see LICENSE file in the docs folder)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pysplitcue-2.1.5.tar.gz (61.1 kB view hashes)

Uploaded Source

Built Distribution

pysplitcue-2.1.5-py3-none-any.whl (42.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page