Skip to content
Related Articles

Related Articles

Python winsound module

View Discussion
Improve Article
Save Article
Like Article
  • Difficulty Level : Medium
  • Last Updated : 03 Nov, 2019

Maybe you have just begun coding in Python. Maybe the entire outset seems inconclusive since you have been working with regular IDEs and would like to obtain a bit more out of what your code does on the respective console and maybe a little music or tune might just liven it up.

This article serves the purpose of introducing to you the winsound module, an object or file with a set of attributes or functions, specific to the task of generating or playing sound or a sound file.

Note: The winsound module is defined only for execution on a Windows Platform, hence the name WINsound.

Since, the winsound module is a builtin, there is no need for you to install it prior to executing it.
The basic action would be to

import winsound

and then based upon the kind of output you would like, type out the following functions:

  • winsound.Beep( )

    The functionality devoted to this method is to generate a ‘Beep’ sound. However, the user is required to input the frequency value and the duration of the sound (these are parameters that shall be passed while calling the function).

    Note: The frequency must be in the range 37 through 32,767 hertz.

    import winsound 
    # frequency is set to 500Hz
    freq = 500 
    # duration is set to 100 milliseconds             
    dur = 100
    winsound.Beep(freq, dur)


    Windows system will produce a ‘Beep’ sound with the given frequency for the given duration of time.

    Building further on the code above, things can be taken to another level by implementing a ‘for’ loop to increment the frequency and duration. This has been done in the code below:

    import winsound
    freq = 100
    dur = 50
    # loop iterates 5 times i.e, 5 beeps will be produced.
    for i in range(0, 5):    
        winsound.Beep(freq, dur)    
        freq+= 100
        dur+= 50


    Consecutive notes with frequency differences of 100Hz and time duration 50 milliseconds greater
    than the the previous time duration are produced.

  • winsound.PlaySound( )
    With the PlaySound function, things can get slightly advanced, not to mention interesting. Keep in mind that this function is only compatible with .wav files. Two parameters are passed in the function: ‘filename’ and the flag – winsound.SND_FILENAME, which is required for the Platform API to refer to the output file. The flags are as defined below:

    SND_FILENAMEThe sound parameter is the name of a WAV file.
    SND_LOOPPlay the sound repeatedly
    SND_MEMORYThe sound parameter to PlaySound() is a memory image of a WAV file, as a bytes-like object.
    SND_ASYNCReturn immediately, allowing sounds to play asynchronously.
    SND_NODEFAULTIf the specified sound cannot be found, do not play the system default sound.
    SND_NOSTOPDo not interrupt sounds currently playing.


    import winsound
    print("Playing the file 'Welcome.wav'")
    # winsound.PlaySound('filename', flag)
    winsound.PlaySound('Welcome.wav', winsound.SND_FILENAME)       


    The respective audio file named 'Welcome.wav' is executed.
    The sound parameter should be interpreted as a control panel sound association name. The Windows registry keys are associated with sound names. If the registry contains no such name, play the system default sound unless SND_NODEFAULT. All Win32 systems support the following:

    PlaySound() nameControl panel sound name
    SystemExitExit Windows
    SystemHandCritical Stop


    import winsound
    # Play Windows question sound
    winsound.PlaySound("SystemQuestion", winsound.SND_ALIAS) 


    Play Windows question sound

There are various other winsound functions, most of which are particular to specific tasks, some of which deal with runtime parameters. Nonetheless, the functions mentioned above should suffice as long as the idea is to play around to get an idea of what can be accomplished using this module.

My Personal Notes arrow_drop_up
Recommended Articles
Page :

Start Your Coding Journey Now!