pxt-common-packages/libs/mixer/docs/reference/music/set-volume.md

Microsoft MakeCode (PXT) common packages

# set Volume

Set the volume for the sound synthesizer.

The synthesizer volume controls the
level of the sound playing on current sound output of the board (speaker or pin).

```sig
music.setVolume(128)
```

## #simnote
### ~hint

#### Simulator

``||music:set volume||`` works on the @boardname@. It might not work in the simulator on every browser.

### ~

## Parameters

* ``volume``: the volume of of the sounds played to the sound output. The volume [number](/types/number) can be between `0` for silent and `255` for the loudest sound.

## Example #example

Set the synthesizer volume to something quieter.

```blocks
music.setVolume(50)
let freq = music.noteFrequency(Note.C);
music.playTone(freq, 1000)
```

## See also #seealso

[play tone](/reference/music/play-tone)