# The &kmix; Handbook

## 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;