Playing a Beep Sound in Python: winsound Module

The Python winsound module is a simple way to play audio files and generate beep sounds on Windows machines. It provides a straightforward interface for playing sound files, generating system beeps, and working with MIDI devices using just a few lines of code.

The winsound module is part of the Python standard library, so you don't need to install it separately. While it has some limitations such as only supporting a limited number of audio file formats and being Windows-specific, it can be a useful tool for simple audio tasks in Python.

In this tutorial, we'll explore how to use the winsound module to play sounds and generate beep sounds in Python.

Installing and Importing winsound

The winsound module is part of the Python standard library, so you don't need to install it separately. To use it in your code, simply import it ?

import winsound

Generating Beep Sounds

The Beep() function generates a simple beep sound using the system speaker. It takes two arguments: the frequency of the beep in Hertz, and the duration of the beep in milliseconds.

Basic Beep Example

Here's how to generate a single beep sound ?

import winsound

# Generate a beep at 440 Hz for 500 milliseconds
winsound.Beep(440, 500)
print("Beep sound played!")

Beep sound played!

Multiple Beeps at Different Frequencies

You can create a sequence of beeps at different frequencies ?

import winsound
import time

frequencies = [440, 880, 1760, 3520]  # Different frequencies in Hz
duration = 300  # Duration in milliseconds

for freq in frequencies:
    print(f"Playing beep at {freq} Hz")
    winsound.Beep(freq, duration)
    time.sleep(0.2)  # Small pause between beeps

print("All beeps completed!")

Playing beep at 440 Hz
Playing beep at 880 Hz  
Playing beep at 1760 Hz
Playing beep at 3520 Hz
All beeps completed!

Playing System Message Beeps

The MessageBeep() function plays predefined Windows system sounds. You can use constants to specify different types of system beeps ?

import winsound

# Play different system sounds
print("Playing exclamation sound...")
winsound.MessageBeep(winsound.MB_ICONEXCLAMATION)

print("Playing error sound...")  
winsound.MessageBeep(winsound.MB_ICONERROR)

print("Playing warning sound...")
winsound.MessageBeep(winsound.MB_ICONWARNING)

print("Playing question sound...")
winsound.MessageBeep(winsound.MB_ICONQUESTION)

Playing exclamation sound...
Playing error sound...
Playing warning sound...
Playing question sound...

Playing Sound Files

The PlaySound() function can play sound files in WAV format. Here's how to play a sound file ?

import winsound

# Play a sound file
winsound.PlaySound("alert.wav", winsound.SND_FILENAME)

# Play sound asynchronously (non-blocking)
winsound.PlaySound("background.wav", winsound.SND_FILENAME | winsound.SND_ASYNC)

# Stop any currently playing sound
winsound.PlaySound(None, winsound.SND_PURGE)

Common winsound Constants

Practical Example: Simple Alarm

Here's a practical example that creates a simple alarm with beep sounds ?

import winsound
import time

def create_alarm(beeps=3, frequency=1000, duration=500):
    """Create an alarm with specified number of beeps"""
    print(f"ALARM! Playing {beeps} beeps...")
    
    for i in range(beeps):
        print(f"Beep {i+1}/{beeps}")
        winsound.Beep(frequency, duration)
        if i < beeps - 1:  # Don't pause after last beep
            time.sleep(0.3)
    
    print("Alarm finished!")

# Create a 3-beep alarm
create_alarm(3, 1200, 400)

ALARM! Playing 3 beeps...
Beep 1/3
Beep 2/3
Beep 3/3
Alarm finished!

Limitations

The winsound module has several limitations ?

• Windows-only: Works only on Windows operating systems
• Limited formats: Supports only WAV, MIDI, and RMI files
• Basic functionality: No volume control or advanced audio features
• Simple beeps: Beep function produces only sine wave sounds

For more advanced audio capabilities, consider using modules like pygame, pyaudio, or sounddevice.

Conclusion

The winsound module provides a simple way to generate beep sounds and play basic audio files on Windows. Use Beep() for custom frequency beeps and MessageBeep() for system sounds. While limited in functionality, it's perfect for simple audio notifications and alerts.