Add sound to your Python game | Opensource.com

Add sound to your Python game

Hear what happens when your hero fights, jumps, collects loot, and more by adding sounds to your game. Learn how in the 13th article in this series on creating a platformer in Pygame.

Colorful sound wave graph
Image by : 
Pixabay. Modified by Opensource.com. CC BY-SA 4.0.
x

Subscribe now

Get the highlights in your inbox every week.

This is part 13 in an ongoing series about creating video games in Python 3 using the Pygame module. Previous articles are:

  1. Learn how to program in Python by building a simple dice game
  2. Build a game framework with Python using the Pygame module
  3. How to add a player to your Python game
  4. Using Pygame to move your game character around
  5. What's a hero without a villain? How to add one to your Python game
  6. Add platforms to your game
  7. Simulate gravity in your Python game
  8. Add jumping to your Python platformer game
  9. Enable your Python game player to run forward and backward
  10. Using Python to set up loot in Pygame
  11. Add scorekeeping to your Python game
  12. Add throwing mechanics to your Python game

Pygame provides an easy way to integrate sounds into your Python video game. Pygame's mixer module can play one or more sounds on command, and by mixing those sounds together, you can have, for instance, background music playing at the same time you hear the sounds of your hero collecting loot or jumping over enemies.

It is easy to integrate the mixer module into an existing game, so—rather than giving you code samples showing you exactly where to put them—this article explains the four steps required to get sound in your application.

Start the mixer

First, in your code's setup section, start the mixer process. Your code already starts Pygame and Pygame fonts, so grouping it together with these is a good idea:

pygame.init()
pygame.font.init()
pygame.mixer.init() # add this line

Define the sounds

Next, you must define the sounds you want to use. This requires that you have the sounds on your computer, just as using fonts requires you to have fonts, and using graphics requires you to have graphics.

You also must bundle those sounds with your game so that anyone playing your game has the sound files.

To bundle a sound with your game, first create a new directory in your game folder, right along with the directory you created for your images and fonts. Call it sound:

s = 'sound'

Even though there are plenty of sounds on the internet, it's not necessarily legal to download them and give them away with your game. It seems strange because so many sounds from famous video games are such a part of popular culture, but that's how the law works. If you want to ship a sound with your game, you must find an open source or Creative Commons sound that gives you permission to give the sound away with your game.

There are several sites that specialize in free and legal sounds, including:

Some sound files are free to use only if you give the composer or sound designer credit. Read the conditions of use carefully before bundling any with your game! Musicians and sound designers work just as hard on their sounds as you work on your code, so it's nice to give them credit even when they don't require it.

To give your sound sources credit, list the sounds that you use in a text file called CREDIT, and place the text file in your game folder.

You might also try making your own music. The excellent LMMS audio workstation is easy to use and ships with lots of interesting sounds. It's available on all major platforms and exports to Ogg Vorbis (OGG) audio format.

Add sound to Pygame

When you find a sound that you like, download it. If it comes in a ZIP or TAR file, extract it and move the sounds into the sound folder in your game directory.

If the sound file has a complicated name with spaces or special characters, rename it. The filename is completely arbitrary, and the simpler it is, the easier it is for you to type into your code.

Most video games use OGG sound files because the format provides high quality in small file sizes. When you download a sound file, it might be an MP3, WAVE, FLAC, or another audio format. To keep your compatibility high and your download size low, convert these to Ogg Vorbis with a tool like fre:ac or Miro.

For example, assume you have downloaded a sound file called ouch.ogg.

In your code's setup section, create a variable representing the sound file you want to use:

ouch = pygame.mixer.Sound(os.path.join(s, 'ouch.ogg'))

Trigger a sound

To use a sound, all you have to do is call the variable when you want to trigger it. For instance, to trigger the OUCH sound effect when your player hits an enemy:

for enemy in enemy_hit_list:
    pygame.mixer.Sound.play(ouch)
    score -= 1

You can create sounds for all kinds of actions, such as jumping, collecting loot, throwing, colliding, and whatever else you can imagine.

Add background music

If you have music or atmospheric sound effects you want to play in your game's background, you can use the music function of Pygame's mixer module. In your setup section, load the music file:

music = pygame.mixer.music.load(os.path.join(s, 'music.ogg'))

And start the music:

pygame.mixer.music.play(-1)

The -1 value tells Pygame to loop the music file infinitely. You can set it to anything from 0 and beyond to define how many times the music should loop before stopping.

Enjoy the soundscapes

Music and sound can add a lot of flavor to your game. Try adding some to your Pygame project!

Topics

About the author

Seth Kenlon
Seth Kenlon - Seth Kenlon is a UNIX geek, free culture advocate, independent multimedia artist, and D&D nerd. He has worked in the film and computing industry, often at the same time. He is one of the maintainers of the Slackware-based multimedia production project Slackermedia.

Contributors