Sound effects for Pygame

1. Put the files next to your code

From the folder with your game's .py file:

npx sfxmint add --set retro-game --format wav --out assets/sounds

That writes pickup.wav, jump.wav, hit.wav, powerup.wav, laser.wav, explosion.wav and gameover.wav, plus a SOUNDS.md with each sound's page and license. WAV comes with the download pack ($9.90 for 30 days, one payment), so this command takes a pack's key in SFXMINT_API_KEY. A puzzle or platformer game may fit the puzzle or platformer set better; the command takes their names too.

No pack? pygame.mixer.Sound documents OGG as well as WAV, and this set comes as free OGG:

npx sfxmint add --set retro-game --format ogg --out assets/sounds

Then change .wav to .ogg in the code below. We ran that code with WAV, and a library MP3, WAV and OGG each load and play in pygame.mixer.Sound on pygame 2.6.1; the pygame-arcade example's test also checks that its OGG files load. A whole set takes a free account's API key in SFXMINT_API_KEY; without a key you get the first 5 sounds. No Node.js? Use the download buttons in the table and rename the files the same way.

2. Load once, play by name

from pathlib import Path
import pygame

pygame.mixer.pre_init(44100, -16, 2, 512)  # before init; matters on pygame 1.9
pygame.init()
pygame.mixer.set_num_channels(16)          # see "pitfalls" below

SOUND_DIR = Path(__file__).parent / "assets" / "sounds"
SOUNDS = {
    name: pygame.mixer.Sound(SOUND_DIR / f"{name}.wav")
    for name in ("jump", "pickup", "hit", "powerup", "explosion", "gameover")
}

def play(name):
    SOUNDS[name].play()

# In the game loop:
#   if event.type == pygame.KEYDOWN and event.key == pygame.K_SPACE:
#       player.jump(); play("jump")
#   if player.rect.colliderect(coin.rect):
#       play("pickup")

Loading the six files took under a millisecond in our run, so doing it at startup costs nothing; doing it inside the loop reads the disk every frame. The path is built from the script's folder, so the game also runs when started from somewhere else.

3. Looping music or ambience

npx sfxmint add rain --format ogg --out assets/sounds

pygame.mixer.music.load(SOUND_DIR / "rain.ogg")
pygame.mixer.music.set_volume(0.5)
pygame.mixer.music.play(-1)   # -1 loops forever

# Later: pygame.mixer.music.fadeout(1500)

pygame.mixer.music streams one long file and does not use the effect channels. Other loops: forest, wind, dark ambience.

4. A volume setting

def set_sfx_volume(value):          # 0.0 to 1.0, from your settings menu
    for sound in SOUNDS.values():
        sound.set_volume(value)

def set_music_volume(value):
    pygame.mixer.music.set_volume(value)

5. Pitfalls we hit while testing

• Sounds are dropped, silently. With the default 8 channels, ten pickups played in the same frame started only 7; the other calls returned None and made no sound and no error. That is why the code raises the count to 16. To keep one important sound from being dropped, reserve a channel for it: pygame.mixer.set_reserved(1) and play it with pygame.mixer.Channel(0).play(sound).
• get_length() is the file, not the sound. It returned 1.00 s for the jump, whose page says 0.35 s of sound in a 1 s file; the rest is silence. Do not time animations or cooldowns from get_length(): use the length of sound each page lists.
• The browser needs OGG. pygbag's wiki asks for every audio file in OGG, not WAV or MP3. Download the set again with --format ogg, or keep WAV on desktop and switch by platform:

import sys

EXT = "ogg" if sys.platform == "emscripten" else "wav"
SOUNDS = {name: pygame.mixer.Sound(SOUND_DIR / f"{name}.{EXT}") for name in ("jump", "pickup")}

In the browser, like every web game, sound starts only after the player's first click or key.

6. If ChatGPT or Claude wrote your game

Put the files in assets/sounds first, then give it this:

Add sound effects to my Pygame game using the sound files in assets/sounds
(jump, pickup, hit, powerup, explosion, gameover). Load each file once at startup into a dict,
call pygame.mixer.set_num_channels(16) after pygame.init(), and play the right sound at each
event in the game loop. Add a volume setting for effects and one for music.

With Claude Code, Cursor or Codex, the assistant can fetch the files itself: see add sound effects with a coding assistant.

Questions