---
name: "volumeicon"
section: "5"
platform: "linux"
package: "volumeicon-alsa"
version: "0.5.1+git20230228-1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/volumeicon/5"
---

# volumeicon(5)

configuration file for volumeicon(1)

## NAME

volumeicon - configuration file for [volumeicon(1)](/volumeicon/1.md)

## SYNOPSIS

**~/.config/volumeicon/volumeicon**

## DESCRIPTION

[**volumeicon**(1)](/volumeicon/1.md) obtains configuration information from **~/.config/volumeicon/volumeicon**. This configuration file can be overridden on runtime via **--config** switch.

The configuration syntax is similar of those .ini files.

- **\[Alsa\]**

  This section holds alsa sound card configuration.

  - **card**

    Specify which sound card to control. The default value is **default**.

  - **channel**

    Specify the channel to control. This defaults to the first channel of the selected card/device.

  - **logarithmic\_scale**

    Use logarithmic volume scale which mimics how humans perceive changes in volume. The default value is **false**.

- **\[Notification\]**

  This section holds notification configuration.

  - **show\_notification**

    The value can be either **true** to enable notification or **false** to disable notification.

  - **notification\_type**

    The value can be either **1** for libnotify based notification or **0** for GTK+ popup notification.

- **\[StatusIcon\]**

  This section holds status icon configuration. The configuration items are as follows.

  - **stepsize**

    Configure how many steps when changing volume. Takes an integer value. The default is **5**.

  - **onclick**

    Configure the command executed when clicking **[volumeicon(1)](/volumeicon/1.md)** applet. The default is **xterm -e 'alsamixer'**.

  - **theme**

    Icon theme to use. The default is **tango**

  - **use\_panel\_specific\_icons**

    Whether to use panel-provided icon. The default is **false**.

  - **lmb\_slider**

    Whether to show volume slider. The default is **false**.

  - **mmb\_mute**

    whether to use middle mouse button to toggle mute. The default is **false**.

  - **use\_horizontal\_slider**

    Whether to use horizontal slider. The default is **true**.

  - **show\_sound\_level**

    Whether to show sound level. The default is **false**.

  - **use\_transparent\_background**

    Whether to use transparent background. The default is **false**.

- **\[Hotkeys\]**

  This section holds the hotkey configuration for volume manipulation.

  - **up\_enabled**

    Whether to enable volume up hotkey. The default is **false**.

  - **down\_enabled**

    whether to enable volume down hotkey. The default is **false**.

  - **mute\_enabled**

    Whether to enable volume mute hotkey. The default is **false**.

  - **up**

    Hotkey to increase volume. The default is **XF86AudioRaiseVolume**.

  - **down**

    Hotkey to decrease volume. The default is **XF86AudioLowerVolume**.

  - **mute**

    Hotkey to toggle mute. The default is **XF86AudioMute**.

## BUGS

Submit bug reports and pull requests to Github \<https://github.com/Maato/volumeicon\>

## LICENSE

This program is licensed under GNU General Public License version 3. See **COPYING** in the distribution for detailed license text.

## SEE ALSO

[**volumeicon**(1)](/volumeicon/1.md), [**alsamixer**(1)](/alsamixer/1.md), [**xev**(1)](/xev/1.md)