sound-fx

Generate any sound effect from a text description — footsteps, explosions, cartoon boings, ambient rain, or whatever you can imagine.

Triggers

• sound effect / sfx / foley
• generate sound / make a sound / create audio
• ambient sound / background noise
• what does X sound like / make the sound of X
• 音效 / 声音 / 音频效果

Quick Start

# Animals
python3 skills/sound-fx/scripts/sfx.py "a cat purring contentedly, deep rumbling vibration" -d 8
python3 skills/sound-fx/scripts/sfx.py "dog sneezing three times in a row" -d 3
python3 skills/sound-fx/scripts/sfx.py "dog eating food really fast, chomping and gulping" -d 4

# Funny
python3 skills/sound-fx/scripts/sfx.py "cartoon character getting spanked, exaggerated squeaky yelp" -d 2
python3 skills/sound-fx/scripts/sfx.py "someone sitting on a whoopee cushion mid-meeting" -d 2

# Ambient (save to file)
python3 skills/sound-fx/scripts/sfx.py "heavy rain on a tin roof" -d 15 -o rain.wav
python3 skills/sound-fx/scripts/sfx.py "campfire crackling at night, crickets in background" -d 15 -o campfire.wav

Arguments

Argument	Default	Description
prompt	required	Text description of the sound to generate
--duration / -d	auto	Length in seconds (1–30). Omit to let the model decide.
--format / -f	wav	Output format: wav, mp3, flac
--output / -o	output.wav	Path to save the generated audio
--api-key	from env/config	Noiz API key (overrides stored key)

Configuration

# Save your API key once
python3 skills/sound-fx/scripts/sfx.py config --set-api-key YOUR_KEY

# Or set via environment variable
export NOIZ_API_KEY=YOUR_KEY

Get your API key at developers.noiz.ai.

Fun Example Prompts

🐾 Animals

Prompt	Suggested Duration
"a cat purring contentedly, deep rumbling vibration"	8s
"cat hissing and yowling aggressively"	3s
"cat knocking a glass off the table, crash"	2s
"dog sneezing three times in a row"	3s
"small dog barking excitedly at a doorbell"	4s
"dog howling dramatically at the moon"	5s
"dog eating food really fast, chomping and gulping"	4s
"hamster running furiously on a squeaky wheel"	6s
"parrot perfectly mimicking a phone ringing"	3s
"frog croaking in a pond at night"	8s

😂 Funny & Expressive

Prompt	Suggested Duration
"cartoon character getting spanked, exaggerated squeaky yelp"	2s
"dramatic fail horn (wah wah wah wah)"	3s
"someone sitting on a whoopee cushion mid-meeting"	2s
"anime power-up charging sound"	5s
"someone slipping on a banana peel, cartoon slide and crash"	3s
"dramatic chipmunk stare — suspenseful strings"	3s
"rubber duck squeak three times"	2s
"evil villain laugh echoing in a dungeon"	5s
"crowd gasping in disbelief"	3s
"a notification sound that sounds passive-aggressive"	2s
"someone aggressively typing on a mechanical keyboard"	5s

🌍 Ambient & Atmosphere

Prompt	Suggested Duration
"heavy rain and thunder on a metal roof"	15s
"busy coffee shop, background chatter and espresso machine"	15s
"old dial-up modem connecting to the internet"	10s
"campfire crackling at night, crickets in background"	15s
"ocean waves gently crashing on a beach"	15s

🎮 Action & Sci-Fi

Prompt	Suggested Duration
"spaceship laser blaster"	2s
"monster truck engine revving"	5s
"sword being unsheathed from scabbard"	2s
"video game level-up fanfare"	3s

Output

On success, the audio file is saved to the output path and the URL is printed:

✓ Saved to output.wav (3.2s, 282 KB)
  URL: https://storage.googleapis.com/...

Third-Party Integration

To send generated sound effects to Discord, Telegram, Feishu, or mix them into videos with ffmpeg, see ref_3rd_party.md.

Requirements

• Python 3.6+
• requests package: pip install requests
• Noiz API key from developers.noiz.ai

Security & Data Disclosure

• API key: Stored in ~/.config/noiz/api_key (permissions 0600) or via NOIZ_API_KEY env variable.
• Network: The text prompt is sent to https://noiz.ai/v1/text-to-sound for generation. No other data is transmitted.
• Output: Generated audio is downloaded from a Noiz GCS URL and saved locally.