---
name: Bug report
about: Create a report to help us improve
title: ""
labels: ""
assignees: Sp5rky
---

**Describe the bug**
A clear and concise description of what the bug is.

**To Reproduce**
Steps to reproduce the behavior:

1. Run command `uv run unshackle [...]`
2. See error

**Expected behavior**
A clear and concise description of what you expected to happen.

**System Details**

- OS: [e.g. Windows 11, Ubuntu 22.04, macOS 14]
- unshackle Version: [e.g. 1.0.1]

**Dependency Versions** (if relevant)

- Shaka-packager: [e.g. 2.6.1]
- n_m3u8dl-re: [e.g. 0.3.0-beta]
- aria2c: [e.g. 1.36.0]
- ffmpeg: [e.g. 6.0]
- Other: [e.g. ccextractor, subby]

**Logs/Error Output**

<details>
<summary>Click to expand logs</summary>

```
Paste relevant error messages or stack traces here
```

</details>

**Configuration** (if relevant)
Please describe relevant configuration settings (DO NOT paste credentials or API keys):

- Downloader used: [e.g. requests, aria2c, n_m3u8dl_re]
- Proxy provider: [e.g. NordVPN, none]
- Other relevant config options

**Screenshots**
If applicable, add screenshots to help explain your problem.

**Additional context**
Add any other context about the problem here.

---

**⚠️ Important:**

- **DO NOT include service-specific implementation code** unless you have explicit rights to share it
- **DO NOT share credentials, API keys, WVD files, or authentication tokens**
- For service-specific issues, describe the behavior without revealing proprietary implementation details
- Focus on core framework issues (downloads, DRM, track handling, CLI, configuration, etc.)