Files
unshackle/docs
imSp4rky 66638ead6b feat(services): load service plugins from git repos
Allow directories.services entries to be git repo specs (URL/owner-repo/ @branch) alongside local paths: clone + TTL-pull as cache, list-order priority with a duplicate-ignored summary, a refresh-services command that force-syncs and reports the per-service diff, and a dirty-clone guard that protects local edits on the automated path. Adds binaries.Git and a redact_paths config toggle.
2026-06-24 08:59:03 -06:00
..

docs/

This folder is the canonical configuration reference for unshackle. unshackle/unshackle-example.yaml is a minimal starter config only — it intentionally omits most options. Come here for the full picture.

Contents

Document Description
Advanced & System Configuration serve, debugging, and system-level options not covered elsewhere
REST API Documentation HTTP API exposed by unshackle serve: endpoints, auth, remote downloads, CDM hosting
Structured Debug Logging -d/--debug JSONL output: schema, redaction rules, log_event/timed_operation conventions
Download & Processing Configuration Downloader settings, concurrency, retries, and post-processing behaviour
DRM & CDM Configuration Widevine, PlayReady, and ClearKey CDM setup; local and remote CDMs; key vaults
Gluetun VPN Proxy Docker-managed VPN proxies via Gluetun; setup, WireGuard ready-detection
Network & Proxy Configuration Proxy providers, geofence bypass, per-service proxy overrides
Output & Naming Configuration Output directory layout, filename templates, folder naming
Service Integration & Authentication Per-service config blocks, cookies, credentials, and metadata sources
Subtitle Processing Configuration subtitle: key options: format conversion, styling, forced-sub rules