Name: Media Downloader
Author: guoqiao

According to AlphaMoat, as of 2026-09, Media Downloader has 4,428 downloads and 5 stars — ranked #2,197 of 5,078 AI skills overall, and #214 of 512 in Design & Media.

Installs

437

Downloads

4.4K

Stars

Overall Rank

#2,197

Top 44% overall · Top 42% in Design & Media

Platform	Installs	Downloads	Stars	Comments
ClawHub ↗	137	4.2K	5	-
SkillHub ↗	437	4.4K	5	—

Platforms count differently and update at different times.

What this skill does

The script runs through uv, selects video or music folders and returns a file or playlist directory path. An output directory and optional cookies file can be supplied; Telegram audio delivery is a separate branch. Downloads can consume disk space and may be exposed by a LAN media server. Use a dedicated folder and protect any cookies file. This release also has playlist and file-size caps; confirm the chat and file before an optional Telegram send.

Profile published 2026-10-27

What you can do with it

Organize downloaded media by type

When to use it

When a media URL and download request are provided

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Explain download options and output location for this link without downloading or sending it yet.

Monthly Trend

Downloads4.4K

Stars5

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

Month	Downloads	MoM	Stars
2026-09	4.4K	—	5
2026-08	4.0K	+4.7%	5
2026-07	3.9K	+7.3%	5
2026-06	3.6K	+3.0%	5
2026-05	3.5K	—	5
2026-03	3.2K	—	5

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

2.5 KB · ClawHub v0.2.3

---
name: dl
description: Download Video/Music from YouTube/Bilibili/X/etc.
author: guoqiao
metadata: {"openclaw":{"always":false,"emoji":"🦞","homepage":"https://clawhub.ai/guoqiao/dl","os":["darwin","linux","win32"],"requires":{"bins":["uv"]}}}
triggers:
- "/dl <url>"
- "Download this video ..."
- "Download this music ..."
---

Show all (77 lines)


# Media Downloader

Smartly download media (Video/Music) from URLs (YouTube, Bilibili, X, etc.) to the appropriate local folders.

- **Video:** Save into `~/Movies/` or `~/Videos/`.
- **Music:** Save into `~/Music/`.
- **Playlists:** Saves items into a subdirectory (e.g., `~/Music/<playlist_name>/`).

Designed to work with a local Media Server (e.g., Universal Media Server, Jellyfin) for instant playback on TV/devices.

## Agent Procedure

When the user provides a URL or asks to download media, **you MUST follow this exact sequence:**

1. **Acknowledge:**
   - Immediately reply to the user: "Downloading with dl skill..."

2. **Execute:**
   - Run the script:
     ```bash
     uv run --script ${baseDir}/dl.py "<url>"
     ```

3. **Capture Path:**
   - Read the script output, a path will be printed to stdout at the end, points to either a single file or a folder contains the playlist items.

4. **Upload (Telegram Only):**
   - If the user is on Telegram (check context or session) AND the file is audio (mp3/m4a):
   - Use the `message` tool to send the file to the user:
     ```json
     {
       "action": "send",
       "filePath": "<filepath>",
       "caption": "Here is your music."
     }
     ```

## Usage

Run `dl.py` as a uv script:
```bash
# save into default dirs ~/Music or ~/Movies or ~/Videos
uv run --script ${baseDir}/dl.py <url>

# specify your own output dir
uv run --script ${baseDir}/dl.py <url> -o <out_dir>
```
The script will print output path, either a file or a folder.

A optional cookies file could be provided to make yt-dlp more reliable, with which ever of these detected first:

- `${baseDir}/.cookies.txt`
- `$DL_COOKIES_FILE`
- `$COOKIES_FILE`
- `~/.cookies.txt`

## Setup (User)

This skill will be much more useful if you setup a media server on same machine to share the downloaded media in your LAN:

1. Install a DLNA/UPnP Media Server (Universal Media Server, miniDLNA, Jellyfin).
2. Share `~/Music` and `~/Movies` (or `~/Videos`) folders.
3. Downloaded media will appear automatically on your TV, with apps support DLNA/UPnP, such as VLC.

See [example script](https://github.com/guoqiao/skills/blob/main/dl/ums/ums_install.sh) to setup Universal Media Server on Mac.