Winsound — Sound-playing Interface For Windows — Python 3.10.5 ...

Theme Auto Light Dark

Table of Contents

• winsound — Sound-playing interface for Windows
  • Beep()
  • PlaySound()
  • MessageBeep()
  • SND_FILENAME
  • SND_ALIAS
  • SND_LOOP
  • SND_MEMORY
  • SND_PURGE
  • SND_ASYNC
  • SND_NODEFAULT
  • SND_NOSTOP
  • SND_NOWAIT
  • MB_ICONASTERISK
  • MB_ICONEXCLAMATION
  • MB_ICONHAND
  • MB_ICONQUESTION
  • MB_OK

Previous topic

winreg — Windows registry access

Next topic

Unix Specific Services

This Page

• Report a Bug
• Show Source

Navigation

• index
• modules |
• next |
• previous |
• 
• Python »
• 3.13.1 Documentation »
• The Python Standard Library »
• MS Windows Specific Services »
• winsound — Sound-playing interface for Windows
• |
• Theme Auto Light Dark |

winsound — Sound-playing interface for Windows¶

The winsound module provides access to the basic sound-playing machinery provided by Windows platforms. It includes functions and several constants.

winsound.Beep(frequency, duration)¶

Beep the PC’s speaker. The frequency parameter specifies frequency, in hertz, of the sound, and must be in the range 37 through 32,767. The duration parameter specifies the number of milliseconds the sound should last. If the system is not able to beep the speaker, RuntimeError is raised.

winsound.PlaySound(sound, flags)¶

Call the underlying PlaySound() function from the Platform API. The sound parameter may be a filename, a system sound alias, audio data as a bytes-like object, or None. Its interpretation depends on the value of flags, which can be a bitwise ORed combination of the constants described below. If the sound parameter is None, any currently playing waveform sound is stopped. If the system indicates an error, RuntimeError is raised.

winsound.MessageBeep(type=MB_OK)¶

Call the underlying MessageBeep() function from the Platform API. This plays a sound as specified in the registry. The type argument specifies which sound to play; possible values are -1, MB_ICONASTERISK, MB_ICONEXCLAMATION, MB_ICONHAND, MB_ICONQUESTION, and MB_OK, all described below. The value -1 produces a “simple beep”; this is the final fallback if a sound cannot be played otherwise. If the system indicates an error, RuntimeError is raised.

winsound.SND_FILENAME¶

The sound parameter is the name of a WAV file. Do not use with SND_ALIAS.

winsound.SND_ALIAS¶

The sound parameter is a sound association name from the registry. If the registry contains no such name, play the system default sound unless SND_NODEFAULT is also specified. If no default sound is registered, raise RuntimeError. Do not use with SND_FILENAME.

All Win32 systems support at least the following; most systems support many more:

PlaySound() name	Corresponding Control Panel Sound name
'SystemAsterisk'	Asterisk
'SystemExclamation'	Exclamation
'SystemExit'	Exit Windows
'SystemHand'	Critical Stop
'SystemQuestion'	Question

For example:

import winsound # Play Windows exit sound. winsound.PlaySound("SystemExit", winsound.SND_ALIAS) # Probably play Windows default sound, if any is registered (because # "*" probably isn't the registered name of any sound). winsound.PlaySound("*", winsound.SND_ALIAS) winsound.SND_LOOP¶

Play the sound repeatedly. The SND_ASYNC flag must also be used to avoid blocking. Cannot be used with SND_MEMORY.

winsound.SND_MEMORY¶

The sound parameter to PlaySound() is a memory image of a WAV file, as a bytes-like object.

Note

This module does not support playing from a memory image asynchronously, so a combination of this flag and SND_ASYNC will raise RuntimeError.

winsound.SND_PURGE¶

Stop playing all instances of the specified sound.

Note

This flag is not supported on modern Windows platforms.

winsound.SND_ASYNC¶

Return immediately, allowing sounds to play asynchronously.

winsound.SND_NODEFAULT¶

If the specified sound cannot be found, do not play the system default sound.

winsound.SND_NOSTOP¶

Do not interrupt sounds currently playing.

winsound.SND_NOWAIT¶

Return immediately if the sound driver is busy.

Note

This flag is not supported on modern Windows platforms.

winsound.MB_ICONASTERISK¶

Play the SystemDefault sound.

winsound.MB_ICONEXCLAMATION¶

Play the SystemExclamation sound.

winsound.MB_ICONHAND¶

Play the SystemHand sound.

winsound.MB_ICONQUESTION¶

Play the SystemQuestion sound.

winsound.MB_OK¶

Play the SystemDefault sound.

Table of Contents

• winsound — Sound-playing interface for Windows
  • Beep()
  • PlaySound()
  • MessageBeep()
  • SND_FILENAME
  • SND_ALIAS
  • SND_LOOP
  • SND_MEMORY
  • SND_PURGE
  • SND_ASYNC
  • SND_NODEFAULT
  • SND_NOSTOP
  • SND_NOWAIT
  • MB_ICONASTERISK
  • MB_ICONEXCLAMATION
  • MB_ICONHAND
  • MB_ICONQUESTION
  • MB_OK

Previous topic

winreg — Windows registry access

Next topic

Unix Specific Services

This Page

• Report a Bug
• Show Source

«

Navigation

• index
• modules |
• next |
• previous |
• 
• Python »
• 3.13.1 Documentation »
• The Python Standard Library »
• MS Windows Specific Services »
• winsound — Sound-playing interface for Windows
• |
• Theme Auto Light Dark |

© Copyright 2001-2024, Python Software Foundation. This page is licensed under the Python Software Foundation License Version 2. Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License. See History and License for more information. The Python Software Foundation is a non-profit corporation. Please donate. Last updated on Dec 25, 2024 (05:41 UTC). Found a bug? Created using Sphinx 8.1.3.