b1a5f8f37f
Server-side: - Add server_cdm mode: server handles full CDM licensing using its own devices, returns KID:KEY pairs instead of raw license bytes - Support batch license resolution for multiple tracks in one request - Extract DRM from manifest ContentProtection when track.drm is empty - Serialize DASH/ISM manifest XML as base64 in /tracks response - Include session cookies/headers and server_cdm_type in /tracks response - Detect server CDM type from actual track DRM + configured devices - Check server region against client_region to skip unnecessary proxy - Support decrypt_labs and custom_api remote CDMs for both WV and PR Client-side: - Re-parse DASH/ISM manifests locally from base64 to populate track.data - Match remote tracks to re-parsed tracks by ID with attribute fallback - Copy DRM objects from re-parsed manifests to remote tracks - Pre-fetch keys via resolve_server_keys() before downloads start - Fallback per-track licensing via _proxy_license during download - Apply session cookies/headers from server for CDN access - Apply downloader/decryption config directly for remote services - Preserve pre-injected content_keys during DASH DRM override - Skip redundant CDM calls when all KIDs already have keys Docs: - Add comprehensive remote-services-flow.md with Mermaid diagrams covering proxy mode, server-CDM mode, manifest transfer, and config
unshackle
Movie, TV, and Music Archival Software
What is unshackle?
unshackle is a fork of Devine, a powerful archival tool for downloading movies, TV shows, and music from streaming services. Built with a focus on modularity and extensibility, it provides a robust framework for content acquisition with support for DRM-protected content.
Key Features
- 🚀 Easy Installation - Simple UV installation
- 🎥 Multi-Media Support - Movies, TV episodes, and music
- 🛠️ Built-in Parsers - DASH/HLS and ISM manifest support
- 🔒 DRM Support - Widevine and PlayReady integration
- 🌈 HDR10+DV Hybrid - Hybrid Dolby Vision injection via dovi_tool
- 💾 Flexible Storage - Local and remote key vaults
- 👥 Multi-Profile Auth - Support for cookies and credentials
- 🤖 Smart Naming - Automatic P2P-style filename structure
- ⚙️ Configurable - YAML-based configuration
- ❤️ Open Source - Fully open-source with community contributions welcome
Quick Start
Installation
This installs the latest version directly from the GitHub repository:
git clone https://github.com/unshackle-dl/unshackle.git
cd unshackle
uv sync
uv run unshackle --help
Install unshackle as a global (per-user) tool
uv tool install git+https://github.com/unshackle-dl/unshackle.git
# Then run:
uvx unshackle --help # or just `unshackle` once PATH updated
Note
After installation, you may need to add the installation path to your PATH environment variable if prompted.
Recommended: Use
uv run unshackleinstead of direct command execution to ensure proper virtual environment activation.
Planned Features
- 🖥️ Web UI Access & Control - Manage and control unshackle from a modern web interface.
- 🔄 Sonarr/Radarr Interactivity - Direct integration for automated personal downloads.
- ⚙️ Better ISM Support - Improve on ISM support for multiple services
- 🔉 ATMOS - Better Atmos Support/Selection
- 🎵 Music - Cleanup Audio Tagging using the tags.py for artist/track name etc.
Basic Usage
# Check available commands
uv run unshackle --help
# Configure your settings
git clone https://github.com/unshackle-dl/unshackle.git
cd unshackle
uv sync
uv run unshackle --help
# Download content (requires configured services)
uv run unshackle dl SERVICE_NAME CONTENT_ID
Documentation
For comprehensive setup guides, configuration options, and advanced usage:
The WIKI contains detailed information on:
- Service configuration
- DRM configuration
- Advanced features and troubleshooting
For guidance on creating services, see our WIKI documentation.
End User License Agreement
unshackle and it's community pages should be treated with the same kindness as other projects. Please refrain from spam or asking for questions that infringe upon a Service's End User License Agreement.
- Do not use unshackle for any purposes of which you do not have the rights to do so.
- Do not share or request infringing content; this includes widevine Provision Keys, Content Encryption Keys, or Service API Calls or Code.
- The Core codebase is meant to stay Free and Open-Source while the Service code should be kept private.
- Do not sell any part of this project, neither alone nor as part of a bundle. If you paid for this software or received it as part of a bundle following payment, you should demand your money back immediately.
- Be kind to one another and do not single anyone out.
Licensing
This software is licensed under the terms of GNU General Public License, Version 3.0.
You can find a copy of the license in the LICENSE file in the root folder.