unshackle
^{Movie, TV, and Music Archival Software}

Install  ·  Wiki  ·  Docs  ·  Discord

---

A modular archival tool for movies, TV, and music. Fork of Devine with DASH/HLS/ISM parsing, Widevine & PlayReady DRM, and a REST API.

Install

uv tool install git+https://github.com/unshackle-dl/unshackle.git
unshackle --help

Tip

Prefer uv run unshackle ... inside a clone to keep the virtual environment active.

Requirements

External tools on your PATH (recommended versions):

• Python - 3.10 - 3.12
• uv - ≥ 0.5
• FFmpeg - ≥ 6.0
• MKVToolNix - ≥ 80
• shaka-packager - 2.6.1
• Bento4 - ≥ 1.6.0-639
• dovi_tool - ≥ 2.1

Optional:

• SubtitleEdit - ≥ 5.0 (SeConv CLI)

License

GPL-3.0. Do not use unshackle for content you lack the rights to. Keep the core free and open; keep service code private. Be kind.