modbender Free Resource
Search and download royalty-free images, videos, sound effects, and music from Pixabay, Freesound, and Jamendo.
Quick Start
# 1. Copy config template and fill in your API keys
cp config.example.json config.json
# 2. Edit config.json with your API keys
# 3. Use without passing API keys
bun ./scripts/jamendo.ts search --query "background" --limit 5
bun ./scripts/freesound.ts search --query "piano"
bun ./scripts/pixabay.ts search-images --query "nature"
Configuration
API keys are stored in config.json. Copy config.example.json and fill in your keys:
{
"pixabay": {
"api_key": "YOUR_PIXABAY_API_KEY"
},
"freesound": {
"api_token": "YOUR_FREESOUND_TOKEN"
},
"jamendo": {
"client_id": "YOUR_JAMENDO_CLIENT_ID"
}
}
Get API Keys
| Platform | Type | Get API Key |
|---|---|---|
| Pixabay | Images/Videos | https://pixabay.com/accounts/register/ |
| Freesound | Audio Effects | https://freesound.org/apiv2/apply |
| Jamendo | Music/BGM | https://devportal.jamendo.com/ |
API Key Priority
- CLI flag:
--key,--token, or--client-id - Environment variable:
PIXABAY_API_KEY,FREESOUND_API_TOKEN,JAMENDO_CLIENT_ID - Config file:
config.json
Pixabay (Images & Videos)
Search Images
bun ./scripts/pixabay.ts search-images --query "yellow flowers" --image-type photo --orientation horizontal --per-page 5
Flags: --query, --id, --lang, --image-type (all|photo|illustration|vector), --orientation (all|horizontal|vertical), --category, --colors (comma-separated), --min-width, --min-height, --editors-choice, --safesearch, --order (popular|latest), --page, --per-page (5-200), --output (save to file).
Search Videos
bun ./scripts/pixabay.ts search-videos --query "ocean waves" --video-type film --per-page 5
Download
bun ./scripts/pixabay.ts download --url "https://pixabay.com/get/..." --output "/path/to/save.jpg"
Freesound (Audio Effects)
Search Sounds
bun ./scripts/freesound.ts search --query "piano note" --page-size 10
Flags: --query, --filter, --sort, --fields, --page, --page-size (max 150), --group-by-pack, --output.
Filter Examples
bun ./scripts/freesound.ts search --query "drum" --filter "duration:[0 TO 2]"
bun ./scripts/freesound.ts search --query "ambient" --filter "type:wav"
bun ./scripts/freesound.ts search --query "explosion" --sort downloads_desc
Get Sound Details
bun ./scripts/freesound.ts get --id 12345 --fields id,name,previews,duration
Download Preview
bun ./scripts/freesound.ts download --id 12345 --output ./sound.mp3
Jamendo (Music & BGM)
Search Music
bun ./scripts/jamendo.ts search --query "rock" --limit 10
Flags: --query, --tags, --fuzzytags, --artist-name, --album-name, --order, --limit (max 200), --offset, --output.
Music Attribute Filters
# Instrumental background music
bun ./scripts/jamendo.ts search --query "background" --vocalinstrumental instrumental
# Search by tags (AND logic)
bun ./scripts/jamendo.ts search --tags "electronic+chill" --order popularity_total_desc
# Search by speed
bun ./scripts/jamendo.ts search --query "energetic" --speed high+veryhigh
Get Track Details
bun ./scripts/jamendo.ts track --id 12345 --include musicinfo,stats
Download Track
bun ./scripts/jamendo.ts download --id 12345 --output ./music.mp3
API Reference
For full parameter tables, response field descriptions, and rate limit details, see ./references/api_reference.md.