mediatheque-agent

Local agent for Médiathèque — the media library service that finds duplicate files and recompresses video so your libraries take only the space they deserve.

The agent runs where your media lives (your machine, NAS, or server) and does all the heavy work locally: scanning, fingerprinting, duplicate detection, and video compression. Your files never leave your equipment — only metadata and small thumbnails travel to the control plane.

Install

pip install mediatheque-agent

ffmpeg must be on PATH (video fingerprints, thumbnails, compression).

Quick start

mediatheque-agent init        # writes ./mediatheque.toml
# edit libraries + add server_url / agent_id / device_token from the dashboard
mediatheque-agent scan        # index your libraries
mediatheque-agent dedupe      # report duplicate groups
mediatheque-agent daemon      # connect to the control plane (review + compress)

What it finds

• Exact duplicates — byte-identical images (BLAKE2b)
• Re-encoded duplicates — videos matched by 3-frame perceptual fingerprints, so a HEVC/AV1 copy of the same clip still matches
• Compression wins — HEVC/AV1 (CPU or VAAPI) or quality-targeted ab-av1 encoding, with a per-file "no worthwhile encode" verdict cache

Removals are always trash-first with a JSONL audit log — nothing is ever unlinked outright.

Compression policy

Disabled by default; opt in globally or per library:

[compress]
enabled = true
codec = "hevc"       # hevc | av1
encoder = "cpu"      # cpu | gpu | abav1
min_duration = 60

License

FSL-1.1-MIT — free for nearly all use; converts to MIT two years after each release. See LICENSE.