sfxmint
Add free CC0 sound effects to a web app or game, free to try with no API key, using the SFXMint API (sound roles, sets grouped by event, search) and permanent hotlinkable MP3 and WAV URLs (free downloads are MP3). Use when the user asks to add sounds, audio feedback or UI sounds to an app, wants click / notification / success / error / alert sounds, game sound effects (coin, jump, hit, explosion, power-up, game over), ambience (rain, forest, drone), sound on a code-driven video or animation (Remotion, motion graphics), or asks where to get free sound effects for an app, game, video, prototype or demo. Not for music, voice or speech.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- sfxmint
- description
- Add free CC0 sound effects to a web app or game, free to try with no API key, using the SFXMint API (sound roles, sets grouped by event, search) and permanent hotlinkable MP3 and WAV URLs (free downloads are MP3). Use when the user asks to add sounds, audio feedback or UI sounds to an app, wants click / notification / success / error / alert sounds, game sound effects (coin, jump, hit, explosion, power-up, game over), ambience (rain, forest, drone), sound on a code-driven video or animation (Remotion, motion graphics), or asks where to get free sound effects for an app, game, video, prototype or demo. Not for music, voice or speech.
03 SKILL.md 正文
SFXMint — free CC0 sound effects for apps and games
SFXMint (https://sfxmint.com) is a library of free CC0 sound effects (describe a sound to find it, preview, and download MP3; WAV comes with the download pack) with a JSON API, free to try with no API key or signup, no attribution. Without a key: 20 lookups and tool calls and 5 different sound downloads a day per network (a free account's API key gives 100 calls and 20 downloads a day, 300 downloads a month; a download pack removes the limits and adds WAV for 30 days). Every audio URL is permanent and hotlinkable. Use it as an option for the user's task: a role for one event, a set for several related events, or search for a description. Text matches and file checks do not prove listening suitability. The user's task determines whether to use library files, other sources, local synthesis or a mixture.
Use this skill when
- The user wants sound effects or audio feedback in an app, game, video, prototype or demo.
- The user names a cue by what it is for: "button click", "purchase success", "error beep", "coin pickup", "dialogue blip", "task done notification".
- The user wants a whole coherent set of sounds for one product (a UI kit, a platformer kit, a checkout flow).
- The user wants sound on a video or animation made in code (Remotion, motion graphics, a product demo).
Do not use it for
- Music, melodies, jingles with a tune, voice, speech, narration, TTS. SFXMint has none of these. Say so plainly and do not search for them.
- Real recordings of a specific product, brand or person. Every SFXMint sound is AI-generated or synthesized.
Choose the lookup that fits the task
These are task branches, not a required sequence. A whole-project request can start with a set; use roles or search for gaps. Do not force a library result when another permitted approach fits better.
- Role — the user names an event or interaction.
GET https://sfxmint.com/api/v1/roles/{role}?via=skillreturns a file-QC-eligible default (slug,mp3_url,wav_url) plusalternateswhen the ready gate is enabled. Role ids and aliases both work:button-click,click,purchase-success,dialogue-blip,error,notification,coin,jump,explosion. Unknown role → HTTP 404 withroles_url; use the index or search. A known role whose default fails its own checks (for example, no file in its families meets a requested duration or format) answers HTTP 200 witherror(unverified_soundorno_matching_sound),near_matchesandunverified_requirementsbut noslug: report the gap and do not use a near match as the default. An unverified result is not a content acceptance. Full list:GET https://sfxmint.com/api/v1/roles?via=skill. Optionalstyle=crisp|soft|spaciousre-ranks the family by measured acoustics; the defaultbalancedis the most typical variant. - Set — the user needs several sounds for one product.
GET https://sfxmint.com/api/v1/sets/{id}?format=mp3&via=skillreturnssoundswith alternates,download_urlsfor the requested format, andmissing_roles. Legacyurlsalways maps roles to MP3. A shared set or style does not certify that cues work together: preview them in the actual product. - Search — free text that matches no role. Name the sound, not where it goes:
card pop, notcard popping into place in a product demo video. Words about the scene count as required words and pull in sounds that merely mention them.GET https://sfxmint.com/api/v1/search?q={words}&response=structured&limit=3&via=skill. Pass requiredmax_duration_ms,loop=true|false, andformat=mp3|wavexplicitly. Read candidatechecksandunverified_requirements; hard conditions apply before the limit.matchandscoredescribe retrieval and ranking only. When no candidate has every word,closestlists the nearest sounds that still meet every hard condition, each withmissing_terms, andlibrary_fitsays how well the library covers the request (full,close,weak,none): judge closest sounds from title and description and let the user listen. Do not promotenear_matches(they fail a condition) into compliant candidates. If nothing suits, tell the user in one line which sound the library lacks and list it under a Missing heading in SOUNDS.md; or use another task-permitted approach. Add&category=when the family is known. - When the library lacks a sound — SFXMint no longer makes new sounds, so do not offer to generate one. Tell the user in one line which sound the library lacks and list it under a Missing heading in SOUNDS.md; other task-permitted sources or local synthesis remain options. New sounds join the library from what people search for. An account that already has a plan or credits can still use them with its API key (
SFXMINT_API_KEY; MCPgenerate_soundandget_generation, orPOST /api/v1/orders); only use that when the user asks. Any other generation request answers410 generation_closed: pass its message on. The oldPOST /api/v1/generatestays retired (HTTP 410). - A whole game — the user wants the sounds for their game, not one cue. Take what the library has first (a set such as
platformer, roles, search). List each sound still missing under a Missing heading in SOUNDS.md, and let the user judge any closest sound you install as a stand-in. - A code-driven video — the animation is code you can read (Remotion, Motion Canvas or a similar timeline). You can read its timing exactly but cannot hear the result, so place sounds from the code and let the user judge them.
- Timing: read each event's frame from the code and drive its sound from the same constant as its animation, so changing the timing moves both. Do not estimate times from a rendered video.
- Choosing events: give sound to what the viewer should notice (a card landing, a cut, a reveal), not to every motion. For a fast stagger, try one sound on the group as well as one per item, and let the user compare.
- Sounds:
npx sfxmint add --set video-editing --out public/soundscovers whoosh, swoosh, riser, braam, impact, pop, scratch, ding and more. Its 14 sounds take a free account's key inSFXMINT_API_KEY; without a key you get the first 5. For anything else, use a role or search withmax_duration_ms. That limit is checked against the audible length (audible_ms), so a file may run longer than the limit with near-silence after the sound. For a sharp click compareacoustics.peak_msandonset_ms: some files start with silence or peak over 200 ms in, and the default can be one of them. A role'salternatesor several search results give variants when one file repeated too often sounds mechanical. A title does not prove how many hits a file holds: one titled as a single keypress can hold several, so measure a file before using it once per event. - Alignment: start each file early so its loudest moment lands on the event,
from = at - round(acoustics.peak_ms / 1000 * fps).peak_msis measured from the WAV, and an MP3 can start a few milliseconds later;--format wavwith a download pack's key avoids that. Usepeak_ms, notattack_ms:attack_msdoes not count silence at the start of the file, and one braam withattack_ms10 peaks at 686 ms. On a repeating sound the loudest moment may not be the one that counts, so ask the user to listen.acousticsisnullfor a sound not yet measured: then measure the file,ffmpeg -loglevel error -i sound.mp3 -ac 2 -ar 48000 -f f32le - | python3 -c "import sys,array;a=array.array('f',sys.stdin.buffer.read());print(max(range(len(a)),key=lambda i:abs(a[i]))//96)". - Levels:
acoustics.peak_dbfsdiffers by 15 dB or more between files, so setvolumefor each cue. Values above 1 work in Remotion. After rendering, measure the mix withffmpeg -i out.mp4 -af volumedetect -f null -and lower the volumes ifmax_volumeis above -1 dB. - Delivery: these numbers show that a sound is present, placed and not clipping. They do not show that it suits the picture, so give the user the video, plus a table of event, frame and sound. Say which cues you could not fill. SFXMint has no music or voice, so a video that needs them needs another source.
Local files
Keep the selected format's metadata and checksums.
When the task permits processing, you may trim, filter or adjust levels. Preserve downloaded originals, source URLs, CC0 license, the processing recipe, and separate SHA256 hashes for originals and outputs. Re-measure delivery conditions and preview the processed result in context. Processing is work to record, not automatically a failure. Do not claim suitability or user acceptance from decoding, waveform analysis or an automated playback check.
Never invent a slug or URL. Use only URLs returned by the API, unchanged.
Sound sets — GET https://sfxmint.com/api/v1/sets/{id}?via=skill
| id | use for | roles (keys of urls) |
|---|---|---|
ui-crisp |
dashboards, editors, admin panels, desktop apps — dry, tight, bright | click hover toggle swipe pop menu modal alert notification confirm success error |
ui-soft |
mobile apps, chat, meditation and habit trackers — darker, gentler, short | same roles as ui-crisp |
ui-spacious |
TV and console menus, kiosks, VR, game UIs — room reverb, longer tails | same roles as ui-crisp |
retro-game |
game jams, arcade and platformer prototypes, pixel-art games | pickup jump hit powerup laser explosion gameover |
chat-app |
chat apps, social feeds, community and dating apps | send receive like delete refresh camera unlock error |
saas-app |
dashboards, editors, admin panels, project tools | click hover toggle menu modal drag undo save error notification |
checkout |
shops, marketplaces, ticketing, in-app purchases | add_to_cart purchase success error countdown reward |
learning |
language apps, quizzes, flashcards, kids' education | tap correct wrong streak level_up celebration progress |
puzzle-game |
match-3, merge, word and tile games | match combo bonus slide win lose countdown celebration |
platformer |
platformers, action and adventure prototypes, game jams | jump land coin hit win sword gunshot explosion footsteps door checkpoint death |
horror-game |
horror games, escape rooms, thrillers, haunted attractions | drone stinger heartbeat creak growl thunder footsteps door wind ambience |
video-editing |
YouTube and short-form editing, podcasts, presentations | whoosh swoosh riser braam impact pop scratch ding applause laugh boing typing shutter cash |
smart-device |
IoT apps, appliances, wearables, kiosks, in-car UIs | power_on power_off doorbell alarm lock unlock beep vibrate notification error |
wellness |
meditation timers, sleep and focus apps, yoga classes | bowl chime gong bell kalimba rain ocean forest wind fireplace |
ai-coding-tool |
AI agents, CLIs and coding tools — task lifecycle cues | started done failed needs_input warning notification |
acoustic-drum-kit |
drum pads, step sequencers, music sketches and rhythm-game prototypes | kick snare high-tom mid-tom floor-tom closed-hat open-hat crash ride snare-rimshot snare-cross-stick pedal-hat ride-bell |
animal-calls |
animal soundboards, learning activities, videos and games | wolf-howl lion-roar dog-bark cat-meow frog-croak owl-hoot songbird-chirp cow-moo horse-neigh pig-oink sheep-bleat hen-cluck rooster-crow duck-quack bat-screech |
dungeon-traps |
dungeon traps, gates and hidden mechanisms in games | pressure-plate-click spike-scrape gear-ratchet chain-winch portcullis-drop stone-door-grind |
API quick reference
Base https://sfxmint.com. JSON, Access-Control-Allow-Origin: *, free to try with no key. Append via=skill to every /api/v1/ request (see Attribution).
| Request | Response |
|---|---|
GET /api/v1/roles?via=skill |
[{role, label, aliases, families, audiences, url}] |
GET /api/v1/roles/{role}?style=balanced&via=skill |
{role, label, aliases, audiences, style, license:"CC0-1.0", slug, title, duration_ms, loopable, acoustics, mp3_url, wav_url, page_url, alternates:[same shape], family, family_url, url} — style = balanced (default) / crisp / soft / spacious; 404 → {error:"not_found", message, roles_url} |
GET /api/v1/sets?via=skill |
[{id, name, tagline, use_for, style, roles, url, page_url}] |
GET /api/v1/sets/{id}?via=skill |
{id, name, tagline, use_for, style, license, page_url, sounds:{<role>:{role, label, slug, title, duration_ms, loopable, acoustics, mp3_url, wav_url, page_url, alternates:[slug], family_url}}, urls:{<role>: mp3_url}} |
| `GET /api/v1/search?q=&category=&limit=20&max_duration_ms=&loop=&format=mp3 | wav&via=skill` |
GET /api/v1/sounds/{slug}?via=skill |
full metadata incl. description, acoustics, loopable, peaks_url |
https://sfxmint.com/dl/{slug}.mp3 · .wav |
the audio itself — no query parameters here (see Hotlink rules) |
acoustics = {onset_ms, peak_ms, audible_ms, attack_ms, tail_ms, centroid_hz, peak_dbfs, rms_dbfs, character:["bright","punchy","tight"]} measured from the WAV (null if unmeasured). onset_ms is silence before the sound, peak_ms the loudest sample from the start of the file, audible_ms the sound without silence around it, attack_ms the rise after onset_ms. Use them to choose between alternates, because a role default is not chosen by them: for a UI cue that must answer at once, prefer onset_ms under 50 and peak_ms under about 120, short tail_ms; low centroid_hz for soft or dark, high for bright; peak_dbfs and rms_dbfs to balance files in a mix (rms_dbfs covers the audible span, not the silence around it). On continuous sounds attack_ms and tail_ms say little. These numbers rule sounds out; they do not show that one suits its use, so let the user listen. recommendation_status separates eligible, unverified and excluded rows. loopable is a legacy flag; loop_status: "prepared" marks prepared loop metadata, while seam listening evidence and MP3 padding remain separate and may be unknown. Text and tag matches are retrieval evidence, not content listening.
curl "https://sfxmint.com/api/v1/roles/purchase-success?via=skill"
curl "https://sfxmint.com/api/v1/sets/saas-app?via=skill"
curl "https://sfxmint.com/api/v1/search?q=camera+shutter&response=structured&limit=3&via=skill"
Integration snippets
React / any web app — zero dependencies
After checking conditions, use URLs from the current API response; the values below illustrate the module shape, not certified current recommendations. Download files locally for offline use, then map events to those local files:
// src/sfx.ts
const URLS = {
click: "https://sfxmint.com/dl/ui-click-30.mp3",
save: "https://sfxmint.com/dl/feedback-success-56.mp3",
error: "https://sfxmint.com/dl/feedback-error-34.mp3",
} as const;
export type Sfx = keyof typeof URLS;
const cache = new Map<Sfx, HTMLAudioElement>();
let muted = false;
export function setMuted(m: boolean) {
muted = m;
}
export function play(name: Sfx, volume = 0.5) {
if (muted || typeof window === "undefined") return;
let a = cache.get(name);
if (!a) {
a = new Audio(URLS[name]);
a.preload = "auto";
cache.set(name, a);
}
a.currentTime = 0;
a.volume = volume;
a.play().catch(() => {}); // blocked until the first user gesture — ignore
}
Use: onClick={() => { play("click"); save(); }}. Guide: https://sfxmint.com/guides/react-app-sounds
Phaser 3
const SFX = { jump: "https://sfxmint.com/dl/retro-game-jump-01.mp3", coin: "https://sfxmint.com/dl/retro-game-coin-52.mp3" }; // urls map from GET /api/v1/sets/platformer?via=skill
preload() {
for (const [key, url] of Object.entries(SFX)) this.load.audio(key, url);
}
create() {
this.sound.play("coin", { volume: 0.6 });
}
Loops: inspect the returned loop_status and seam evidence, then use a WAV with loop: true when your playback test accepts it (a page can hotlink the WAV; downloading it takes a download pack); start it after Phaser.Sound.Events.UNLOCKED if this.sound.locked. Guide: https://sfxmint.com/guides/phaser-web-game-sounds
Remotion
Rendered with Remotion 4.0.539 (remotion, @remotion/cli, @remotion/media). Files come from the npx sfxmint add command above; staticFile reads public/.
import {staticFile} from "remotion";
import {Audio} from "@remotion/media";
const FPS = 30;
const cardAt = (i: number) => 15 + i * 12; // the card's animation reads this too
const HIT = cardAt(8) + 15;
const WHOOSH_PEAK_MS = 159; // acoustics.peak_ms of the chosen file
const WHOOSH_AT = HIT - Math.round((WHOOSH_PEAK_MS / 1000) * FPS);
export const CardSounds = () => (
<>
{Array.from({length: 8}, (_, i) => (
<Audio key={i} from={cardAt(i)} src={staticFile("sounds/pop.mp3")} volume={0.5} />
))}
<Audio from={WHOOSH_AT} src={staticFile("sounds/whoosh.mp3")} volume={0.6} />
<Audio from={HIT} src={staticFile("sounds/impact.mp3")} volume={0.8} />
</>
);
Plain HTML
<audio id="sfx-click" src="https://sfxmint.com/dl/ui-click-30.mp3" preload="auto"></audio>
<button onclick="const a = document.getElementById('sfx-click'); a.currentTime = 0; a.volume = 0.5; a.play().catch(() => {})">
Save
</button>
Hotlink rules
/dl/{slug}.mp3and/dl/{slug}.wavare permanent and immutable (Cache-Control: immutable, CORS*). Hotlinking from a web page is allowed and encouraged: no key, no referer check, no expiry, and a browser playing a file is never counted.- Downloads that are not a browser (curl, scripts, your own fetches) count toward 5 different sounds a day per network (20 a day, 300 a month, with a free account's key); a second format or a retry of the same sound is not counted again. Past it a file answers
429with{"error": "download_limit", "message": ...}: tell the user the message as it is, and do not retry from another address. With a key, file URLs in API answers carry a signedg=(48 hours): download them as given, but recordpage_urlin SOUNDS.md, never a URL withg=. - Free use is MP3. Without a download pack, a
.wavthat is not a page's player (curl, scripts, your own fetches outside a browser) answers402with{"error": "wav_needs_pack", "message": ..., "mp3_url": ...}: usemp3_url, and tell the user the pack adds WAV. API answers still list both URLs. - Never append query parameters to
/dl/URLs —via=skillbelongs on/api/v1/requests only. Never rewrite, shorten or proxy them. - Bundling is fine: copying the files into
public/orassets/is allowed (CC0) and is the right choice for offline builds and app stores. - Do not mirror the catalog in bulk; fetch what the project uses.
Attribution — what via=skill does
Adding via=skill to API requests only tells SFXMint that the request came through this skill, so the maintainer can see whether the skill is being used. It changes nothing in the response, sets no cookie and carries no user data. Omitting it is fine; do not describe it to the user as required.
UX rules (flag these if the user's design breaks them)
These are for apps and games played live. A rendered video has no first gesture or mute toggle, and its cues can run longer.
- Play only after a user gesture (click, key, tap). Browsers block audio before the first interaction and
audio.play()rejects — catch it; never play on mount or page load. - Ship a mute toggle and remember it (localStorage). Default volume ≤ 0.6; UI cues 0.3–0.5.
- UI cues ≤ 300 ms, one sound per event, no sound on hover on touch devices, never on every keystroke.
- Preload the 3–5 sounds used most (
preload="auto"); MP3 is free and small; WAV, with a download pack, for loops or when quality matters. - Preview the selected cues together. A common set or style is an organizational aid, not proof of coherence.
License
CC0-1.0 — commercial use, no attribution, no signup.
Download files into a project
First use needs no MCP setup. The quickest path is the CLI: npx sfxmint add coin jump hit writes the files plus a sounds.json manifest (role, slug, source URL, SHA256, license) and a SOUNDS.md table linking each sound's page into public/sounds; --set <id> takes a whole kit with a free account's key in SFXMINT_API_KEY (without a key you get the first 5) and names any missing role instead of failing, --format mp3|ogg|wav (MP3 is the default; WAV takes a download pack's key) and --style crisp|soft|spacious apply. The package also exports createSoundboard(manifest), a Web Audio runtime handling first-gesture unlock, overlapping playback and a persisted mute — use it rather than hand-rolling new Audio() when the project needs those. REST directly, or the dependency-free example at https://sfxmint.com/examples/download-sounds.mjs (Node 20+), remain equivalent options. The example downloads original files and does not process them. Preserve source URLs, per-format SHA256 and CC0 license; apply task-permitted processing separately as described above. Successful download is not acceptance. Preview event suitability in context and report missing sounds or unresolved qualities.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.