music-manager_skill

This skill helps you search, download, and organize music from YouTube or Bilibili into categorized MP3s on your local library.

Python

2.6k

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

3 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill music-manager

_meta.json282 B
SKILL.md1.6 KB

Overview

This skill is a universal music download manager that searches and downloads audio from YouTube and Bilibili, converts tracks to MP3, and stores them in a local categorized music library. It automates naming and organization so you get a tidy collection ready for listening. Setup requires yt-dlp and ffmpeg and optional cookie configuration for authenticated downloads.

How this skill works

The tool uses yt-dlp to search or fetch media from a URL, then uses ffmpeg to convert downloaded audio to MP3. Files are named using the pattern "title-artist-source.mp3" and moved into user-specified category folders under your configured MUSIC_DIR. Optional browser cookie extraction enables authenticated downloads for restricted content.

When to use it

You want to build or expand a local music library from YouTube or Bilibili sources.
You need batch downloads and automatic MP3 conversion for offline playback.
You prefer organized storage by category or artist for easy browsing.
You want AI-assisted search and selection before downloading.
You need a scriptable command-line tool for scheduled or automated downloads.

Best practices

Install and keep yt-dlp and ffmpeg up to date to avoid compatibility issues.
Set MUSIC_DIR to an absolute path and verify write permissions before running downloads.
Use browser cookie extraction when downloading account-restricted content to avoid failures.
Confirm search results before bulk downloading to avoid duplicates or unwanted tracks.
Organize by meaningful category names to make retrieval and backups easier.

Example use cases

Download a specific song by search term and save it to a "Chinese" folder: python3 scripts/download_music.py "Jay Chou 稻香" "Chinese".
Extract audio from a Bilibili video and store it under a game music category: python3 scripts/download_music.py "https://www.bilibili.com/video/BVxxx" "Game".
Use an AI agent to search, confirm results interactively, then download selected tracks into your local library.
Run the script in a scheduled job to aggregate weekly new music into a curated folder for offline listening.
Batch convert an existing set of downloaded sources to MP3 and apply the automated naming convention.

FAQ

Yes. Install yt-dlp for downloading and ffmpeg for audio conversion; both are required for full functionality.

How do I configure where music is saved?

Edit MUSIC_DIR in scripts/download_music.py and set it to your preferred absolute or home-relative path, then ensure the script can write to that directory.

Is login required for YouTube downloads?

Not always. Public content downloads without login, but for account-restricted content use the optional browser cookie extraction (set BROWSER to your browser) to enable authenticated downloads.