Media Downloader

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:

     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:

     {
       "action": "send",
       "filePath": "<filepath>",
       "caption": "Here is your music."
     }
     

Usage

Run

dl.py

as a uv script:

# 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 to setup Universal Media Server on Mac.