# The &kmix; Handbook

Gaurav
Chaturvedi

    gaurav.p.chaturvedi@gmail.com

Christian
Esken

    esken@kde.org

Developer
Helio
Chissini de Castro

    helio@kde.org

Developer
Brian
Hanson

    bhanson@hotmail.com

Developer
1996
2005
Christian Esken & &Matt.Johnston;
&FDLNotice;
2020-10-04
Applications 20.12

&kmix; is an application that allows you to change the volume of your sound card.

KDE
KMix
kdemultimedia
sound
volume
mixer

## Introduction

&kmix; supports several platforms and sound drivers.

If you have both ALSA and Open Sound System drivers installed, &kmix; will use the ALSA driver.

Screenshot of &kmix; Screenshot of &kmix;

## Main Window

Overview of &kmix; Main Window

Screenshot of &kmix;
Screenshot of &kmix;

### File Options

&kmix; File options
&kmix; File options

&Esc; File Hide Mixer Window

  Hide Mixer Window

### Settings

&kmix; Settings
&kmix; Settings

Settings Audio Setup

  Open &phonon; &systemsettings; module to configure the sound and video device preference and the backends used by &kde; multimedia API, &phonon;.

#### Select Master Channel

&kmix; Master Channel
&kmix; Master Channel

Select your &kmix; master channel.

#### Configure &kmix;

##### General configuration

General configuration of &kmix;
General configuration of &kmix;

Configure general &kmix; parameters.

Behavior Volume Overdrive

  Check this box to allow volume to be more than recommended value (sometimes PulseAudio maximal volume exceeds the normal value). &kmix; restart is needed for this setting to take effect.

  Uncheck this item if there are audible sound distortions at the maximal volume.

Behavior Volume Feedback

  Check this box to enable audible feedback on volume change.

Behavior Volume step

  Set the volume step as a percentage of the volume range.

  This affects changing the volume via hot keys, with the mouse wheel over the system tray icon, or moving sliders by a page step.

  &kmix; must be restarted for this change to take effect.

Visual Show slider tickmarks

  Check this box to show tickmarks on the sliders.

Visual Show control labels

  Check this box to show labels of controls.

Visual Show On Screen Display (OSD)

  Check this box to enable OSD show on hovering &kmix; tray widget.

Slider orientation (main window) Horizontal

  Check this radio button to orientate the control slider horizontally.

Slider orientation (main window) Vertical

  Check this radio button to orientate the control slider vertically.

Slider orientation (system tray popup) Horizontal/Vertical

  Same as the previous two radio buttons but for the system tray volume control (the panel that is shown after &LMB; click on &kmix; tray icon).

##### Start configuration

Start configuration of &kmix;
Start configuration of &kmix;

This page allows you to configure various &kmix; start parameters.

Startup Start KMix on desktop startup

  Check this box to enable &kmix; autostart with desktop environment.

Startup Restore previous volume settings on desktop startup

  Check this box to enable volume levels and switches restoration to their last used settings on desktop start.

  The volume of PulseAudio or MPRIS2 dynamic controls will not be restored.

##### Volume control configuration

Volume control configuration of &kmix;
Volume control configuration of &kmix;

This page allows you to configure various &kmix; popup volume control parameters.

Dock in system tray

  Check this box to dock &kmix; in system tray.

It is possible to select mixers that will be shown in the volume control using the corresponding list on this page.

## Advanced usage

### Remote controlling and scripting via &DBus;

You can control &kmix; via &DBus;. This is for advanced users who want to achieve special tasks, like muting the PC every day at 10 pm, or for any other scripting task.

List all &kmix; related &DBus; methods and properties

    qdbus org.kde.kmix

Getting volume level (0-100%):

    qdbus org.kde.kmix /Mixers/0/Master_0 org.freedesktop.DBus.Properties.Get org.kde.KMix.Control volume

Setting volume level (0-100%):

    qdbus org.kde.kmix /Mixers/0/Master_0 org.freedesktop.DBus.Properties.Set org.kde.KMix.Control volume 70

## Credits and License

&kmix;

Documentation copyright © 2010 Gaurav Chaturvedi gaurav.p.chaturvedi@gmail.com

Thanks to:

&Matt.Johnston; &Matt.Johnston.mail; (copy and pasted a lot of things from his old &kmix; documentation)

&underFDL; &underGPL;

&documentation.index;