🎵 FLAC Detective
A lossy file renamed to .flac looks lossless, weighs lossless, and fools every player you own. It can't fool the arithmetic the encoder left behind — and this reads it for you.
MP3, AAC, Vorbis and — partially — Opus, through three independent kinds of evidence. A conviction needs two of them to agree.
Find the fake FLACs in your music library.
A lossy codec throws away the top of the spectrum and never gives it back. FLAC Detective reads each file, spots the fingerprints that loss leaves behind, and tells you which files are real and which are fakes.
pip install flac-detective # needs Python 3.10+
flac-detective /path/to/music # scan a file or a whole folder
Every file gets a verdict, like a traffic light:
✅ AUTHENTIC real lossless → keep it
❓ WARNING borderline → give it a listen
⚠️ SUSPICIOUS probably a transcode → likely a fake
❌ FAKE_CERTAIN definitely a fake → replace it
The scan only reads your files — it never changes anything.
🟢 New to all this? → Start Here — the 5-minute beginner's guide No command line, no jargon. From "what is this?" to "I checked my music".
📚 More
- 📕 Reference — how it works, the three kinds of evidence, full usage, the ML case study
- 📖 Full documentation site — getting started, user guide, technical details, API
- 🚀 Getting Started — install, first analysis, accuracy & file-safety notes
- 📋 Changelog · 🤝 Contributing · 🔒 Security
- 💬 Issues
Licensed under the MIT License.
1 maintainer
Release files for flac-detective 1.17.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| flac_detective-1.17.0.tar.gz | 15.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| flac_detective-1.17.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 31.4 MB
Release files / flac_detective-1.17.0.tar.gz
| Download URL | flac_detective-1.17.0.tar.gz |
|---|---|
| Size | 15.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
55e7345b250cb6fc125b3332510afa076af7aca17793ca82d83bec9559d64d7c
|
|
BLAKE2b-256 checksum How to use checksums |
e2f16b2b7cd5401ee39231631d155f10994ed0b9178ce9394e9d39a2be48a6cc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency logRelease files / flac_detective-1.17.0-py3-none-any.whl
| Download URL | flac_detective-1.17.0-py3-none-any.whl |
|---|---|
| Size | 15.6 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fe57273386808c5fa243d8f4e7d9897d56170a1c9c671c76bcf4d554bc8889f1
|
|
BLAKE2b-256 checksum How to use checksums |
044abd4b1860a3639a7e13c1dbb1352f2cae09524f5b7f7da5b615d0dfa49240
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency log
