PlaySoundFile

Main Menu
WoW API Lua API FrameXML util Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

Plays the specified sound by FileDataID or addon file path.

willPlay, soundHandle = PlaySoundFile(sound [, channel])

Arguments

sound

number|string - Either a FileDataID, or the path to a sound file from an addon.

• The file must exist prior to logging in or reloading. Both .ogg and .mp3 formats are accepted.

channel

string? = SFX - The sound channel.

Channel	Toggle CVar	Volume CVar[1]
Master	Sound_EnableAllSoundSound_EnableAllSound (Sound) Default: 1	Sound_MasterVolumeSound_MasterVolume (Sound) Default: 1.0 master volume (0.0 to 1.0)
Music	Sound_EnableMusicSound_EnableMusic (Sound) Default: 1 Enables music	Sound_MusicVolumeSound_MusicVolume Default: 0.4
SFX (Effects)	Sound_EnableSFXSound_EnableSFX (Sound) Default: 1	Sound_SFXVolumeSound_SFXVolume (Sound) Default: 1.0 sound volume (0.0 to 1.0)
Ambience	Sound_EnableAmbienceSound_EnableAmbience (Sound) Default: 1 Enable Ambience	Sound_AmbienceVolumeSound_AmbienceVolume Default: 0.6
Dialog	Sound_EnableDialogSound_EnableDialog (Sound) Default: 1 all dialog	Sound_DialogVolumeSound_DialogVolume (Sound) Default: 1.0 Dialog Volume (0.0 to 1.0)
Talking Head[2]

Volume sliders in the interface options

Returns

willPlay

boolean - true if the sound will be played, nil otherwise (prevented by a muted sound channel, for instance).

soundHandle

number - identifier for the queued playback.

Example

Plays a sound file included with your addon and ignores any sound setting except the master volume slider:

• Both slash / or escaped backslashes \\ can be used as file separators.

PlaySoundFile("Interface\\AddOns\\MyAddOn\\mysound.ogg", "Master")

Plays the level up sound:

-- by file path (dropped in 8.2.0)
PlaySoundFile("Sound/Spells/LevelUp.ogg")

-- by FileDataID 569593 (added support in 8.2.0)
PlaySoundFile(569593)

-- by SoundKitID 888 (SoundKitName LEVELUP)
PlaySound(888)

Finding Sound IDs

File Data IDs

• By file name/path, e.g. Spells/LevelUp,type:ogg in wow.tools
• By SoundKitID, e.g. skit:888 in wow.tools
• By sound kit name with https://wow.tools/files/sounds.php

Sound Kit Names/IDs

• From the sounds tab for an NPC, for example https://www.wowhead.com/npc=154304/waveblade-shaman#sounds
• By sound kit name with https://www.wowhead.com/sounds and SoundKitName.db2
• IDs used by the FrameXML are defined in the SOUNDKIT table
• The full list of IDs can be found in SoundKitEntry.db2

Patch changes

Patch 8.2.0 (2019-06-25): Updated to accept FileDataIDs due to the removal of file paths.^[3]

See also

• PlaySound - Plays a sound by SoundKitID
• StopSound
• MuteSoundFile - Mutes a sound
• UnmuteSoundFile
• PlaySoundFile macros - Listing of audio files shipped with the game