How to use command line to change volume?

Question

I am trying to control the volume using my programming script. How can I do the following in Fedora 15, Ubuntu linux?

Mute/ Unmute
Volume up and volume down

Note: Please note that I use a web USB microphone/speaker and also Analogue microphone/speaker. I want to apply to all to be sure.

If anyone's coming here from lubuntu to fix their volume control buttons, putting `amixer -D pulse sset Master 3%+ unmute` in the relevant keybind of `~/.config/openbox/lubuntu-rc.xml` and then running `openbox --reconfigure` fixed it for me — rhombidodecahedron, Sep 07 '16 at 19:49
This link is currently first one that google offers on the subject. However, I consider following QA as listing more options: https://askubuntu.com/questions/97936/terminal-command-to-set-audio-volume — Martian2020, Sep 03 '21 at 05:04

Dario Seidl · Accepted Answer · 2022-09-19T15:56:00.510

124

You can use amixer. It's in the alsa-utils package on Ubuntu and Debian.

Run amixer without parameters to get an overview about your controls for the default device.

You can also use alsamixer without parameters (from the same package) to get a more visual overview. Use F6 to see and switch between devices. Commonly, you might have PulseAudio and a hardware sound card to select from.

Then use amixer with the set command to set the volume. For example, to set the master channel to 50%:

amixer set Master 50%

Master is the control name and should match one that you see when running without parameters.

Note the % sign, without it, it will treat the value as a 0 - 65536 level.

If PulseAudio is not your default device, you can use the -D switch:

amixer -D pulse set Master 50%

Other useful commands pointed out in the comments:

To increase/decrease the volume use +/- after the number, use

amixer set Master 10%+
amixer set Master 10%-

To mute, unmute or toggle between muted/unmuted state, use

amixer set Master mute
amixer set Master unmute
amixer set Master toggle

Also note that there might be two different percentage scales, the default raw and for some devices a more natural scale based on decibel, which is also used by alsamixer. Use -M to use the latter.

Finally, if you're interested only in PulseAudio, you might want to check out pactl (see one of the other answers).

edited Sep 19 '22 at 15:56

answered Sep 20 '11 at 10:33

Dario Seidl

2,346
1
20
21

5

Thanks! there are two ways to do this 1. As your excellent example: amixer set Master mute; amixer set Master unmute; 2. yum -y install xdotool; xdotool key XF86AudioRaiseVolume; xdotool key XF86AudioLowerVolume; – Sep 20 '11 at 11:05
@89899.3K Thanks for the info, xdotool looks interesting. – Dario Seidl Sep 20 '11 at 11:14
17

And as an addition, you can increase or decrease the volume by `amixer set Master 10%+` and `amixer set Master 10%-` – user Apr 07 '12 at 21:25
2

This does not work in Ubuntu. – Cerin May 24 '12 at 14:37
1. Use option -M for intuitive numbers 2. Maybe Ubutu uses PulseAudio 3. Ubuntu su*** – ManuelSchneid3r Aug 09 '13 at 12:39
2

I disagree @Cerin. This works on Ubuntu LTS 12 right now. Note that the `M` in master is **case sensitive** (must be uppercase). – ashes999 Apr 09 '14 at 16:35
7

Cerin is right. This does not work. What works is : `amixer -D pulse sset Master 50%` – shivams May 07 '15 at 11:22
1

To toggle un/mute: `amixer set Master toggle`. – Stephen Niedzielski Aug 02 '16 at 04:40
You might need to replace "Master" with the device "amixer" tells you, for me it was "Speaker" – piegames May 30 '17 at 17:00
I'm curious, where is the volume setting actually stored - does a kernel module have ways to persist data that is hidden for the user? – Morten Aug 10 '17 at 06:25
@Morten It used to be done via an init script named `/etc/init.d/alsa-utils` which saved the mixer settings on shutdown and restored them on boot. Some distros (eg. Raspbian) still do it that way. I'm still preparing to upgrade my main machine off Kubuntu 14.04 LTS, so I can't tell you the paths under systemd, but upstart handles it via `/etc/init/alsa-store.conf` and `/etc/init/alsa-restore.conf`. – ssokolow Dec 18 '18 at 06:56
If I try to set the volume > 41%, it always sets it to 1% higher than I requested... any idea why? – Michael May 03 '19 at 20:03
@Michael, try with the `-M` switch. I edited the answer for an explanation. – Dario Seidl May 04 '19 at 08:27
You can also use `db` unit : `amixer set Master 3db+` – gruvw Sep 19 '22 at 14:30

score 39 · Answer 2 · edited Jan 05 '20 at 00:43

39

To mute:

amixer -D pulse sset Master mute

To unmute:

amixer -D pulse sset Master unmute

To turn volume up 5%:

amixer -D pulse sset Master 5%+

To turn volume down 5%:

amixer -D pulse sset Master 5%-

edited Jan 05 '20 at 00:43

Pablo A

2,307
1
22
34

answered Nov 03 '15 at 04:28

Eric Terry

491
4
4

2

You can also add unmute to latter commands to automatically unmute when you change volume (for convenience): `amixer -D pulse sset Master unmute 5%+` – Roman Golyshev Oct 06 '18 at 23:06

score 28 · Answer 3 · edited Jan 05 '20 at 00:43

28

pactl/pacmd (unlike amixer) allows increasing volume over 100% :-).

pactl set-sink-mute 0 toggle  # toggle mute, also you have true/false
pactl set-sink-volume 0 0     # mute (force)
pactl set-sink-volume 0 100%  # max
pactl set-sink-volume 0 +5%   # +5% (up)
pactl set-sink-volume 0 -5%   # -5% (down)

Manual settings over 100% is possible in pavucontrol (unlike alsamixer).

Note: If you want to share the same commands on different hosts with different sinks, you can use @DEFAULT_SINK@ as a sink instead of number 0:

pactl set-sink-volume @DEFAULT_SINK@ +5%

You set your default sink with pactl set-default-sink my-sink-name (list names with pactl list short sinks).

Source: askubuntu.com, wiki.archlinux.org.

edited Jan 05 '20 at 00:43

Pablo A

2,307
1
22
34

answered Sep 01 '16 at 19:05

pevik

1,397
15
27

Does anyone know the difference to amixer here, as to why amixer does not allow more than 100%? – shevy Feb 24 '20 at 17:42
2

This may not work, as the `0` index sink is not always the currently active sink (e.g., bluetooth headphones tend to be index `1`), and for whatever reason `@DEFAULT_SINK@` didn't always work to return the active sink. You can find the active sink manually through the following: `pactl list short sinks | awk '/RUNNING$/{print $1}` – Nick Bull Jul 22 '20 at 10:25
3

For e.g., `pactl set-sink-mute 0 toggle`, that becomes `pactl set-sink-mute "$(pactl list short sinks | awk '/RUNNING$/{print $1})" toggle` – Nick Bull Jul 22 '20 at 10:26

score 7 · Answer 4 · answered Feb 25 '18 at 19:24

7

Higher volume:

amixer set Master 3%+

Lower volume:

amixer set Master 3%-

Mute toggle:

amixer set Master toggle

Example keybindings for i3/sway, the commands are after exec:

bindsym XF86AudioRaiseVolume exec amixer set Master 3%+
bindsym XF86AudioLowerVolume exec amixer set Master 3%-
bindsym XF86AudioMute exec amixer set Master toggle
bindsym Ctrl+$alt+Up  exec amixer set Master 3%+
bindsym Ctrl+$alt+Down exec amixer set Master 3%-

answered Feb 25 '18 at 19:24

Alexander

9,607
3
40
59

`amixer set Headphone toggle` can also be useful – Alexander Dec 04 '20 at 16:29

Don Joe · Answer 5 · 2018-02-25T19:14:14.087

pevik's answer is almost correct for PulseAudio, with two things to mention:

the negative volume change command will generate an error because the minus-something portion of it will be interpreted as a separate (unrecognized) option; you need to turn off option parsing with a double-minus somewhere before the negative number, e.g. " -- -5%"
the true mute state is something that should be possible to toggle with the same key, which won't work if you're just setting the volume to a fixed value of 0, so the right command for that would be:

pactl set-sink-mute @DEFAULT_SINK@ toggle

LE: Whether the first hint is applicable may depend on the version of PulseAudio you're running or on something else in the distro - I notice that on Ubuntu 16 it works without the "--" and fails if I add "--" in front of the negative percentage.

very good thx, that makes it perfect when we change window managers a lot on the fly for better gaming fps, so I use `xbindkeys-config` and I dont even have to restart X :) (lol the smile... no pun intended lol) — Aquarius Power, Aug 31 '17 at 00:08

score 3 · Answer 6 · answered Feb 04 '17 at 12:29

3

if the user has muted the device you have to 'unmute' it. otherwise setting the percentage will work but the sound is still off

amixer set 'Master' 100% unmute
/usr/bin/amixer set 'PCM' 100% unmute

answered Feb 04 '17 at 12:29

Guest

31
1

score 3 · Answer 7 · answered Oct 26 '17 at 13:17

amixer worked for me but I didn't get the nice animation that I get when I press the volume up button on my keyboard.

I decided to use xte to directly press that key from the command line:

Volume up: xte 'key 0x1008ff13'

Volume down: xte 'key 0x1008ff11'

Mute: xte 'key 0x1008ff12'

I figured out the keysym (that hex number) by using xev.

sudo apt-get install xbindkeys xautomation
xev

and then press the volume up button on your keyboard to get the keysym. The key sym may vary from system to system so finding it from xev will be the most reliable way.

The result looks like this for me:

KeyRelease event, serial 37, synthetic NO, window 0x2c00001, root 0xef, subw 0x0, time 6660080, (566,573), root:(664,651), state 0x0, keycode 123 (keysym 0x1008ff13, XF86AudioRaiseVolume), same_screen YES, XLookupString gives 0 bytes: XFilterEvent returns: False

How to use command line to change volume?

7 Answers7

Linked