WinAPI:winmm:PlaySound

From NSIS Wiki

Author: sag47 (talk, contrib)

Contents 1 PlaySound Function 1.1 Asynchronous Playing 1.1.1 Stopping the Sound 1.2 Synchronous Playing

[edit] PlaySound Function

References:

• http://msdn2.microsoft.com/en-us/library/ms712879.aspx
• NSIS Data Structures Examples

This will play a wav file. It is a function that is part of winmm.dll It is very easy to play the sound too.

[edit] Asynchronous Playing

The following code will start playing the wav file as your installer continues. This is good if you want a little entertainment with a long install.

Function .onInit
  InitPluginsDir
  File /oname=$PLUGINSDIR\sound.wav "batcave.wav"
 
; Play the sound or song
  StrCpy $0 "$PLUGINSDIR\sound.wav"  ; location of the wav file
  IntOp $1 "SND_ASYNC" || 1
  System::Call 'winmm::PlaySound(t r0, i 0, i r1) b'
FunctionEnd

[edit] Stopping the Sound

Simply call the following code anywhere in your installer (has to be within a function, macro, or section). The sound/music will immediately stop once it is called.

System::Call 'winmm::PlaySound(i, i, i) b'

[edit] Synchronous Playing

This will play the sound but the installer won't continue until the sound is finished playing.

Function .onInit
  InitPluginsDir
  File /oname=$PLUGINSDIR\sound.wav "batcave.wav"
 
; Play the sound or song
  StrCpy $0 "$PLUGINSDIR\sound.wav"
  System::Call 'winmm::PlaySound(t r0, i, i) b'
FunctionEnd

keyword "Play Sound"

WinAPI:winmm