caesura 𝄓

A versatile command line tool for fully automated transcoding of FLAC sources.

caesura will crunch through your torrent directory and automatically transcode any suitable FLAC sources.

Features

• RED and OPS fully supported.
• Runs on Linux and macOS. Windows via WSL or Docker.
• Fully configurable, if there's something hard coded that you think should be configurable then open a discussion on GitHub.
• Install via Docker, Homebrew, Nix and standalone binaries.
• Minimal CLI tools required. Only FLAC, LAME and SoX. Image resizing, torrent creation and audio metadata inspection are handled natively.

Source Verification

Each source is verified to ensure:

• A lossless FLAC
• Not a scene, lossy, unconfirmed or trumpable release
• Files match the torrent hash
• Audio tags for artist, album, title and track number are set
• Classical sources have a composer tag
• Vinyl track numbering is converted to numeric
• Sample rate and channels are suitable

Inspect

• Display audio properties, tags and embedded pictures for every track in a directory
• Supports FLAC and MP3

Spectrogram Generation

• Full and zoomed spectrograms generated for review

Transcoding

• Multi-threaded transcoding with optional CPU limit
• FLAC and FLAC 24 bit sources are supported
• FLAC, MP3 320 (CBR) and MP3 V0 (VBR) target formats
• Existing formats are skipped
• Nested sub directories are fully supported (i.e. CD1 and CD2 etc)
• Automatic naming following established conventions, with decoding of HTML entities
• Automatic torrent file creation
• Images in the root and first nested directory are included and all other files ignored
• Images larger than 750 KB are reduced to less than 1280 px, converted to JPG and compressed
• Optional track renaming to standardized filenames
• Optional stripping of Vorbis comments from transcoded output

Upload

• Copy transcodes to content directory
• Inject transcoded torrents directly into qBittorrent or qui
• Autoadd directory support for other clients (Deluge, Transmission, rTorrent)

Batch / Queue

• Verify, transcode and upload with one command for every torrent file in a directory
• Source torrents are added to a queue to track their progress, reducing duplicate work and speeding up subsequent runs
• Discover source torrents from qBittorrent or qui via API or load .torrent files from a state directory

Documentation

Releases and Changes

Releases and a full changelog are available via GitHub Releases.

History

DevYukine completed the initial work and released it as red_oxide under an MIT license.

RogueOneEcho forked the project to make small iterative improvements that evolved into a complete rewrite. The fork is released as caesura under an AGPL license.

See also the list of contributors who participated in this project.

Next: Installation