---
name: "btnx-config"
section: "8x"
platform: "linux"
package: "btnx-config"
version: "0.4.9-4"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/btnx-config"
---

# btnx-config(8x)

GUI configuration tool for btnx

## NAME

btnx-config - GUI configuration tool for btnx

## SYNOPSIS

**btnx-config (needs to be run as root)**

## DESCRIPTION

btnx-config is a GUI configuration tool for btnx. For example, you can configure an extra mouse button to send a Ctrl+Alt+Right command to switch workspaces. This is especially useful for mice with more buttons than Gnome or KDE can properly handle, or mice that need evdev and a 100 step howto to register button events at all.

When using btnx-config, remember to set the buttons you want to use to "enabled" and restart btnx after configuration changes. For commands to be run, you have to set the full path.

btnx-config is required by btnx to work, because btnx-config also detects your mouse and its buttons. This combination should work for just about any mouse.

You need to run btnx-config and use it to configure btnx at least once, before the btnx-daemon can successfully start.

For further information see the help of btnx-config itself.

## AUTHOR

btnx-config was written by Olli Salonen \<oasalonen@gmail.com\>.

This manual page was created by Philipp Huebner \<debalance@arcor.de\> for the Debian project (but may be used by others).

## SEE ALSO

**[btnx(8)](/btnx/8.md)**