# .sound (client command)

Source: https://ref.dm-lang.org/skin/commands/dotsound
Added in BYOND 516.

### Format
- `.sound *file* *options*`
- `.sound none *options*`


Plays, stops, or modifies a sound. This command can be used for instance to play a click sound when using mouse macros, for instance, without waiting for the server to initiate the sound which would introduce a small delay.

```
.sound 'click.ogg'
```

The file can be `none` or `-` when updating or stopping a sound. Any options should be separated by spaces; most are in a `name=value` format, as seen below.

Supported options are:

- **update**: This action is updating a channel rather than playing a new sound. It corresponds to the [SOUND_UPDATE](https://ref.dm-lang.org/sound/var/status.md) status flag.
- **channel=*N***: Specifies a channel.
- **volume=*N***: Sets the volume.
- **mute  
mute=*T***: Mutes the sound; the `update` option is implied.
- **pause  
pause=*T***: Pauses the sound; the `update` option is implied.
- **wait**: The new sound will queue up in the specified channel, and play after the current sound is done.
- **repeat  
repeat=*T*  
repeat=once/infinite/rewind**: Specifies whether, and how, the sound repeats.
- **falloff=*N***: Sets the [falloff](https://ref.dm-lang.org/sound/var/falloff.md) value for 3D sound.
- **x=*N*  
y=*N*  
z=*N***: Sets the [x, y, or z](https://ref.dm-lang.org/sound/var/xyz.md) value for 3D sound.
- **atom=*ref***: Sets the atom for [atom-linked](https://ref.dm-lang.org/sound/var/atom.md) 3D sound. The reference is in a format such as `[0x200001b]` without quotes (see [ref() proc](https://ref.dm-lang.org/proc/ref.md)).
- **transform=*list***: Sets the [transform](https://ref.dm-lang.org/sound/var/transform.md) value for 3D sound. The list is up to 9 numbers, separated by commas without spaces.

\**T* represents a true/false value. True values include `true`, `on`, or 1. False would be `false`, `off`, or 0.

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