# SoundQuery proc (client)

Source: https://ref.dm-lang.org/client/proc/SoundQuery
Added in BYOND 513.

### Format
> `SoundQuery()`

### Args
> none

### Returns
> A list of `/sound` datums with information about currently playing sounds.

This proc is used to ask a client about sounds that are playing. The `/sound` datums in the returned list have the following vars set:

* file: Sound/music file, or null if none
* channel: Channel of sound, if one was set when the sound was played
* repeat: The `repeat` value of the sound
* status: Status flags active for this channel; currently only `SOUND_PAUSED` is supported
* offset: Current time index, in seconds, of the sound at the current frequency
* len: Total duration, in seconds, of the sound at the current frequency
* wait: Total duration of sounds queued to play later on this channel (does not apply to channel 0)

Not all info about the sounds is retrieved, such as `volume`, `frequency`, etc. If those are needed, it should be a simple matter to keep track of them in your code. The main purpose of `SoundQuery()` is to ascertain the current status of playing sounds.

### See also
- [/sound datum](https://ref.dm-lang.org/sound/index.md)
- [sound proc](https://ref.dm-lang.org/proc/sound.md)