109

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

  1. Mute/ Unmute
  2. 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.

2
  • 1
    If anyone's coming here from lubuntu to fix their volume control buttons, putting <command>amixer -D pulse sset Master 3%+ unmute</command> in the relevant keybind of ~/.config/openbox/lubuntu-rc.xml and then running openbox --reconfigure fixed it for me Commented Sep 7, 2016 at 19:49
  • This link is currently first one that google offers on the subject. However, I consider following QA as listing more options: askubuntu.com/questions/97936/… Commented Sep 3, 2021 at 5:04

7 Answers 7

131

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).

14
  • 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;
    – user11085
    Commented Sep 20, 2011 at 11:05
  • 17
    And as an addition, you can increase or decrease the volume by amixer set Master 10%+ and amixer set Master 10%-
    – user
    Commented Apr 7, 2012 at 21:25
  • 2
    This does not work in Ubuntu.
    – Cerin
    Commented May 24, 2012 at 14:37
  • 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
    Commented Apr 9, 2014 at 16:35
  • 8
    Cerin is right. This does not work. What works is : amixer -D pulse sset Master 50%
    – shivams
    Commented May 7, 2015 at 11:22
41

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%-
1
  • 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%+ Commented Oct 6, 2018 at 23:06
30

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.

3
  • Does anyone know the difference to amixer here, as to why amixer does not allow more than 100%?
    – shevy
    Commented Feb 24, 2020 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
    Commented Jul 22, 2020 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
    Commented Jul 22, 2020 at 10:26
8

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%-
1
  • amixer set Headphone toggle can also be useful
    – Alexander
    Commented Dec 4, 2020 at 16:29
4

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
4

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.

1
  • 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) Commented Aug 31, 2017 at 0:08
3

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

You must log in to answer this question.