Bgm Library

Installation

Before first use, install dependencies in the skill's scripts directory:

cd scripts && npm install

Commands

search [keywords...]

Search ccMixter for background music tracks.

Options:

• -l, --limit <n> — Max results (default: 10)
• -p, --preset <name> — Use a predefined tag preset
• --commercial-only / --no-commercial-only — License filter (default: on)
• --sort <field> — Sort by: date, name, score (default: score)

bgm search upbeat corporate --limit 5
bgm search --preset lofi

download <uploadId>

Download a track by ccMixter upload ID.

Options:

• -o, --output <dir> — Output directory (default: ./public)
• --force — Overwrite existing files

bgm download 70473 --output ./public/

pick <theme>

Auto-pick and download the best match for a video theme.

Options:

• -o, --output <dir> — Output directory (default: ./public)
• -l, --limit <n> — Candidates to evaluate (default: 5)
• --force — Overwrite existing files

bgm pick "chill lofi study" --output ./public/
bgm pick "energetic workout motivation" --output ./public/

presets

List predefined tag presets for common video scenarios.

bgm presets

info <uploadId>

Show detailed info about a track including license, BPM, duration, and files.

bgm info 70473

Presets

Output Files

Downloaded MP3

Saved to the specified output directory with the original filename.

music_manifest.json

Tracks metadata for programmatic access:

{
  "tracks": [
    {
      "upload_id": 70473,
      "title": "The Fade Out",
      "artist": "coruscate",
      "source_url": "https://ccmixter.org/files/Coruscate/70473",
      "license_name": "Attribution (3.0)",
      "license_url": "http://creativecommons.org/licenses/by/3.0/",
      "file_name": "Coruscate_-_The_Fade_Out.mp3",
      "bpm": 92,
      "duration": "3:05",
      "downloaded_at": "2026-02-09T12:00:00.000Z"
    }
  ]
}

ATTRIBUTION.txt

Auto-generated attribution in TASL format (Title/Author/Source/License):

=== Music Attribution ===
"The Fade Out" by coruscate
  Source: https://ccmixter.org/files/Coruscate/70473
  License: Attribution (3.0) (http://creativecommons.org/licenses/by/3.0/)

Remotion Usage

After downloading a track:

import { Audio } from '@remotion/media';
import { staticFile } from 'remotion';

// Use the downloaded BGM in your composition
<Audio src={staticFile('Coruscate_-_The_Fade_Out.mp3')} volume={0.3} loop />

License Filtering

By default, only commercially safe licenses are shown:

• Allowed: CC BY (Attribution), CC BY-SA (Attribution-ShareAlike)
• Blocked: Any license with NonCommercial (NC) or NoDerivs (ND)

This ensures all downloaded music can be freely used in commercial video projects.

Data Source

All music is sourced from ccMixter, a community remix site operated by ArtisTech Media, created by Creative Commons.

Troubleshooting

"Cannot find module" errors

Install dependencies first:

cd scripts && npm install

403 Forbidden on download

The skill automatically handles referer headers. If you still get 403, the track may have been removed from ccMixter.

No results for search

Try broader keywords, fewer tags, or use a preset. ccMixter's library is smaller than Pixabay but all tracks are properly licensed.