Skip to content
Rattlehead80 edited this page Oct 31, 2026 · 1 revision

Windows warns me that the program is unsafe. Why?

Bootleg Toolbox is not code-signed yet, so Windows SmartScreen doesn't know it and shows "Windows protected your PC" the first time. Click More info, then Run anyway. You can check that your download is genuine with its SHA-256 checksum or its build attestation: see Getting started.

On Linux, nothing happens when I click the file.

The file must be made executable first: chmod +x bootleg-toolbox, then run it.

Do I need flac, shntool, ffmpeg or LAME?

No. Every decoder and encoder is built into the program.

Will it change my files?

Checks, analyses, torrents and checksum creation only read your audio. Conversions write new files; after a verified conversion to FLAC, you are asked whether to move the originals to the trash. Tag and rename changes tags and file names only, after you have checked them, and can be undone for 30 days. See Conversions and Tag and rename.

Does it send anything over the internet?

Not unless you ask: the update check is optional, and setlist.fm is only contacted when you request a setlist, with your own API key.

Why do so many verdicts end with a question mark?

Because they are estimates, and the program says so. "Likely lossless", "Lossy?" or "1.8 % slow?" mean the measurements point that way but can't prove it. Open the report to see the measurements and the reasoning, and judge for yourself. See Lossless analysis and Speed analysis.

Lossless? says "Unclear". Is something wrong?

No. Many audience and analog-tape recordings have almost no content above 15 kHz, which is where an encoder leaves its marks. With too little treble, encoder traces cannot be seen either way, and the program says so rather than guessing.

The FFP check passes, but a file won't play. How?

An FFP line only compares the MD5 signature stored in the FLAC header. It tells you the file is the one that was fingerprinted, not that its audio decodes. Run a Decode test (F7) to find damaged or truncated files. See Checks.

How do I report a bug or ask for a feature?

Open an issue on GitHub. Shows that confuse Lossless?, or info files the tagger misreads, help the most.

Clone this wiki locally