media-downloaderlisted
Install: claude install-skill devttyac/reel-notes
# media-downloader
Download any video from 1,000+ sites via yt-dlp with optional ffmpeg compression. Designed as a companion step to `/sumtube` for non-YouTube sources and offline workflows.
---
## Setup preflight
Before invoking the skill, run the setup script to verify all required tools are present:
```
python scripts/setup.py --check
```
Exit codes:
| Code | Meaning | Fix |
|---|---|---|
| 0 | All dependencies present | Proceed |
| 2 | `yt-dlp` missing | `pip install yt-dlp` |
| 3 | `ffmpeg` missing | `brew install ffmpeg` |
| 4 | Both missing | Install both |
No API keys are required.
---
## When to use
Use this skill:
- Before `/sumtube` when the video is not directly accessible by URL from within sumtube (non-YouTube sources, age-gated content, or platforms requiring a local file input).
- For offline workflows where you want the file available locally before summarising.
- Standalone, when you want to save video content to disk without summarising.
If you are summarising a standard public YouTube video, `/sumtube` can handle the URL directly — `media-downloader` is not required.
---
## How to invoke
**Step 1 — Run setup preflight**
```
python scripts/setup.py --check
```
Confirm exit code 0 before continuing. If non-zero, install the missing dependency and re-run.
**Step 2 — Download the video**
```
python scripts/download.py <url> [--output <dir>] [--no-compress] [--quality <format>]
```
Example:
```
python scripts/download.py https://www.tiktok