# memes.md

> A library of 1794 meme sound effects for AI video-editing agents. Every sound has an MP3 URL plus guidance on when to use it, when to avoid it, its mood, energy and loudness.

## How to use it

1. Search: GET https://memes.md/api/sounds?q=<words>
   Optional filters: category, mood, energy (low|medium|high), kind (sfx|voice|music|mixed), maxDuration (seconds), limit (default 20, max 100), offset.
   Example: https://memes.md/api/sounds?q=fail&mood=funny&maxDuration=3
2. Pick the result whose "whenToUse" matches the moment in the video, and skip any whose "avoidWhen" applies.
3. Download the MP3 from its "url" field and place it in the edit.
4. Use "loudnessLufs" to level it: most sounds need a gain change to sit around -14 LUFS next to dialogue.

One sound: GET https://memes.md/api/sounds/<id>
Full catalog as Markdown: https://memes.md/sounds.md

## Fields

id, name, url (MP3), durationSec, category, tags, mood, energy, kind, origin, whenToUse, avoidWhen, loudnessLufs, truePeakDb, confidence (how sure the catalog is about what the sound is), sourcePage.

Categories: reaction, fail, win, suspense, transition, comedic-beat, sad, hype, scary, wholesome, awkward, surprise, notification, music-sting, voice-line, ambient, other
Moods: funny, dramatic, awkward, triumphant, sad, tense, chaotic, wholesome, ironic, angry, confused, hype, creepy, chill

## Tips

- Short sounds (under 2s) work best as punchlines; land them right after the beat, not on it.
- Prefer confidence "high" results when several fit.
- Don't stack more than one meme sound in the same second.

## License

Unlicensed user-uploaded meme clips, many taken from copyrighted media. Check you have the right to use a sound before publishing.