bgm-library

Search and download royalty-free background music from ccMixter with automatic TASL attribution.

8.5k|1.4k|Updated Apr 24, 2024
One-click install
npx skills add https://github.com/TeamWiseFlow/wiseflow --skill bgm-library
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bgm-library
Source: https://github.com/TeamWiseFlow/wiseflow/tree/main/skills/bgm-library
Command: npx skills add https://github.com/TeamWiseFlow/wiseflow --skill bgm-library

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires axios, commander, and includes scripts (resource) components.

What problem does it solve?

Finding commercially safe background music for videos usually means navigating confusing license terms or paying for stock music subscriptions. This Skill searches the ccMixter library, filters out any track with NonCommercial or NoDerivs restrictions, downloads the MP3, and auto-generates the legally required attribution file.

Core Features & Use Cases

  • License-safe search and download: Queries the ccMixter API by keywords or five scene presets (travel, tech, lofi, food, workout) and only allows CC BY / CC BY-SA tracks, blocking NC/ND licenses by default.
  • Theme-based auto-pick: The pick command searches by a video theme, ranks candidates by score, and downloads the best match with a broad-search fallback.
  • Automatic attribution and manifest: Every download writes a music_manifest.json for programmatic use and an ATTRIBUTION.txt in TASL format (Title/Author/Source/License) that must be included when publishing.
  • Use Case: While producing a product demo video, run bgm-library pick "tech product upbeat" to get a commercially safe track, then hand the MP3 to a video editing step for mixing at low volume under the voiceover.

Quick Start

Ask the agent to pick and download a royalty-free background track matching your video theme into the project's audio folder, for example by saying: find a chill lofi track for my study vlog and save it with its attribution file.

Frequently Asked Questions about bgm-library

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find royalty-free music for YouTube videos?

Use the search command with keywords or a preset like travel, tech, lofi, food, or workout to query ccMixter. Results are filtered to CC BY and CC BY-SA licenses only, so every returned track is safe for commercial use with attribution.

How to automatically pick background music for a video theme?

Run the pick command with a theme phrase such as "energetic workout motivation". It searches ccMixter by derived tags, ranks candidates by score, downloads the best match, and falls back to a broader keyword search if no exact match exists.

Does ccMixter music require an API key or account?

No API key or account is required. The tool queries the public ccMixter API directly as a pure client, and all music on the platform already carries Creative Commons licenses.

Can I use ccMixter tracks in commercial videos?

Yes, but only tracks under CC BY or CC BY-SA licenses, which this tool enforces by default by blocking any license containing NonCommercial or NoDerivs. You must include the generated ATTRIBUTION.txt content in your video description when publishing.

Why does a ccMixter download return 403 Forbidden?

A 403 usually means the track has been removed from ccMixter, since the downloader already sends the required referer header automatically. The workaround is to search again and choose a different track.

What should I do when a music search returns no results?

ccMixter's catalog is smaller than large stock libraries, so narrow queries often fail. Broaden your keywords, reduce the number of tags, or use one of the five built-in presets to widen the search.