Media Downloader

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

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. Look for the line: `Saved to: <filepath>`.

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 (Manual)

Run the python script directly:

```bash

uv run --script ${baseDir}/dl.py <url>

```

The script auto-detects Video vs Music and Single vs Playlist.

Setup (User)

To enable TV playback:

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.