This program is for Linux and allows you to change the pointer speed (mouse or touchpad cursor) graphically for use in X11 Window Managers such as: Openbox, JWM, iceWM, Fluxbox, and other minimalist window managers where there's no GUI program to do this, without having to type complicated commands. It's ideal if you use external keyboards that come with integrated touchpad keyboard, like the Logitech K400, or even for your laptop's touchpad if you feel the cursor moves too slowly.
- ✅ Increase or decrease mouse or touchpad speed.
- ✅ Save configuration so it doesn't get lost when restarting.
- ✅ Works with devices like:
- Keyboards with touchpad (e.g.: Logitech K400)
- USB mice
- Laptop touchpads
Before using it, make sure you have the following installed on your Linux computer:
sudo apt install xinput libinput-tools python3-pyqt6 python3-pyqt6.qtsvg⚠️ This program only works on X11, not on Wayland.- It's only for X11 WM like Openbox, JWM, iceWM, Fluxbox, Xubuntu, etc
- In 2025, for example in GNOME, KDE, before logging in you can select X11 to enter instead of Wayland.
At:
https://github.com/wachin/xinput-plus
click on the arrow-like dropdown in Code:
<> Code ▼
and click on:
Download ZIP
decompress it, and there inside the folder is the xinput-plus.py file.
or you can clone it:
1.- Since we already have git installed, enter in a terminal in a folder where you have Linux programs:
git clone https://github.com/wachin/xinput-plus2.- Give it execution permissions
It can be done by right-clicking in the file manager and in the "Permissions" tab verify that it's marked as executable
or from the terminal with:
chmod +x xinput-plus.pyMake sure the Launcher.sh script is executable, in the file manager right-click on it and in the "Permissions" tab make sure "is executable" is checked
Double-click the Launcher.sh script and click Execute
👉 A window will open:
1.- Open a terminal
2.- Go to the folder where the xinput-plus.py file is, or open a terminal there from your file manager
3.- Run the program with this command:
python3 xinput-plus.pyand it will open:
💡 On some Linux distributions you can right-click on the
xinput-plus.pyfile and open with python.
- When opening the program.
- In the left list, click on your device (for example: "Logitech K400").
- Use the slider to change the speed:
- ← Slower (down to -1.0)
- → Faster (up to 1.0 by default; up to 2.0 in extended CTM mode)
- Enable extra speed (optional): Check the box labeled "Extra speed (for slow devices)" to allow the slider to go up to 2.0, which provides significantly faster cursor movement for devices like the Logitech K400. This mode uses the
Coordinate Transformation Matrixto scale pointer movement beyond the standard range. - The configuration saves automatically as you move the slider — no button press needed.
✅ Done! The change applies instantly and saves automatically. After restarting your computer, open the program and the saved settings (including extended speed mode) will be applied automatically.
The program saves your settings in this file (don't delete it if you don't want to lose the configuration):
~/.config/xinput-plus.json
xinput-plus is a PyQt6 app, so it follows your Qt6 theme. To use a dark theme system-wide via Kvantum:
- Install Qt6 theming tools
sudo apt install qt6ct qt6-style-kvantum- Select the style in Qt6 Settings
- Open qt6ct → Appearance / Style → choose Kvantum.
- (Optional) Open Kvantum Manager and pick your favorite dark theme.
- Restart xinput-plus No app changes are required—xinput-plus will automatically adopt the system dark theme.
Note (LXQt on Debian 12): As you observed, no environment variables were needed—LXQt already exposes the Qt6 platform theme correctly.
Some environments don’t expose the Qt6 platform theme by default. If the dark theme doesn’t apply after the steps above, set these environment variables (pick one place, e.g. your Launcher.sh, ~/.profile, or the app’s .desktop file):
export QT_QPA_PLATFORMTHEME=qt6ct
export QT_STYLE_OVERRIDE=kvantumThen log out/in or restart the app.
Heads-up:
qt5ctonly affects Qt5 applications. For PyQt6/Qt6 apps like xinput-plus, you need qt6ct (andqt6-style-kvantum).
It uses Linux commands with xinput to change the device speed in real time. For standard speed adjustments, it modifies the libinput Accel Speed property. For extended speed mode (up to 2.0), it uses the Coordinate Transformation Matrix to scale pointer movement, allowing higher sensitivity for devices that need it. The interface does everything for you!
pbuilder builds the package inside a clean, minimal Debian unstable chroot —
the same way Debian's build servers do. If the build passes here, you can be
confident no build dependency is missing from debian/control.
sudo apt install pbuilderRun these commands from inside the project directory
(~/Dev/xinput-plus-dev/xinput-plus):
# 1. Create the pbuilder unstable chroot (only needed once)
sudo pbuilder create --distribution unstable
# 2. Create the upstream orig tarball (required by the 3.0 (quilt) source format)
tar --exclude=./debian --exclude=./.git -czf ../xinput-plus_6.6.4.orig.tar.gz .
# 3. Build the source package
debuild -us -uc -S
# 4. Build the binary package inside the clean chroot
sudo pbuilder build --distribution unstable ../xinput-plus_6.6.4-1.dscAfter a successful build the parent directory (~/Dev/xinput-plus-dev/) will
contain:
xinput-plus/ ← source tree
xinput-plus_6.6.4-1.dsc
xinput-plus_6.6.4-1.debian.tar.xz
xinput-plus_6.6.4-1_source.build
xinput-plus_6.6.4-1_source.buildinfo
xinput-plus_6.6.4-1_source.changes
xinput-plus_6.6.4.orig.tar.gz
The built .deb and related files are placed under pbuilder's result
directory:
/var/cache/pbuilder/result/xinput-plus_6.6.4-1.dsc
/var/cache/pbuilder/result/xinput-plus_6.6.4-1_all.deb
/var/cache/pbuilder/result/xinput-plus_6.6.4-1_amd64.buildinfo
/var/cache/pbuilder/result/xinput-plus_6.6.4-1_amd64.changes
/var/cache/pbuilder/result/xinput-plus_6.6.4-1.debian.tar.xz
/var/cache/pbuilder/result/xinput-plus_6.6.4-1_source.changes
/var/cache/pbuilder/result/xinput-plus_6.6.4.orig.tar.gz
sudo apt install /var/cache/pbuilder/result/xinput-plus_6.6.4-1_all.debRun the program:
xinput-plusForce a specific language (e.g. Spanish):
xinput-plus --lang=esRead the man page:
man xinput-plusUninstall:
sudo apt purge xinput-plusThe docs/debian/ folder contains guides for developers who want to build,
test, or publish this package:
| Guide | Language | Description |
|---|---|---|
| compile-and-test-deb.md | English | How to build the .deb locally and test it on your machine |
| compilar-y-probar-deb_ES.md | Español | Cómo compilar el .deb localmente y probarlo en tu ordenador |
| how-to-publish-on-debian.md | English | Full guide to getting the package accepted into packages.debian.org |
| como-publicar-en-debian.md | Español | Guía completa para publicar el paquete en packages.debian.org |
This code is made in Python with PyQt6, perfect for students who want to learn about:
- Graphical interfaces
- Linux automation
- Hardware control
Feel free to modify it, improve it, or use it in your projects!
If the program not working when running from terminal you see errors like:
Failed to open /dev/input/eventX (Permission denied)
when running xinput-plus.py, it means your user lacks permission to access input devices. This is common in minimal Linux installations (e.g., Debian netinstall). To fix it:
- Add your user to the
inputgroup:
sudo usermod -aG input $USERLog out and back in, or reboot, to apply the change.
- Verify permissions:
Check that
/dev/input/event*files are accessible:
ls -l /dev/input/event*They should have group input and permissions like
Restart
This app supports translations with Qt .ts → .qm files. Follow these steps to add any language (Spanish shown as example).
- Qt Creator installed on your Linux OS
- PyQt6 dev tools (provides
pylupdate6)
sudo apt install pyqt6-dev-tools- Qt Linguist & lrelease from Qt5 (work fine for app translations):
sudo apt install qttools5-dev-tools- Create the translations folder:
mkdir -p i18nThe app loads compiled files from
./i18n/(same directory asxinput-plus.py), e.g.i18n/xinput-plus_es.qm.
pylupdate6 --ts i18n/xinput-plus_es.ts xinput-plus.py-
From Qt Creator: right-click
xinput-plus_es.ts→ open with Linguist → translate → mark entries as Finished → Save. -
From terminal:
linguist i18n/xinput-plus_es.ts
You can do this from the "Qt Linguist" tool from Qt Creator by clicking on "File - Distribute As" and saving as .qm, or from terminal.
On Debian/MX Linux, lrelease-qt6 is not installed by default. The package
qttools5-dev-tools installs it simply as lrelease, which works perfectly
for both Qt5 and Qt6 .ts files:
sudo apt install qttools5-dev-toolsThen compile:
lrelease i18n/xinput-plus_es.ts -qm i18n/xinput-plus_es.qmYou should see output like:
Updating 'i18n/xinput-plus_es.qm'...
Generated 21 translation(s) (21 finished and 0 unfinished)
If for some reason lrelease is not found, this fallback finds whichever
variant is available on your system:
LREL=$(command -v lrelease-qt6 || command -v lrelease || echo /usr/lib/qt5/bin/lrelease)
$LREL i18n/xinput-plus_es.ts -qm i18n/xinput-plus_es.qmpython3 xinput-plus.py --lang=esReplace the language code:
# French (fr)
pylupdate6 --ts i18n/xinput-plus_fr.ts xinput-plus.py
linguist i18n/xinput-plus_fr.ts
$LREL i18n/xinput-plus_fr.ts -qm i18n/xinput-plus_fr.qm
python3 xinput-plus.py --lang=fr
# Brazilian Portuguese (pt_BR)
pylupdate6 --ts i18n/xinput-plus_pt_BR.ts xinput-plus.py
linguist i18n/xinput-plus_pt_BR.ts
$LREL i18n/xinput-plus_pt_BR.ts -qm i18n/xinput-plus_pt_BR.qm
python3 xinput-plus.py --lang=pt_BRFile naming: the loader tries common patterns like xinput-plus_es.qm, xinput-plus_es_ES.qm, and xinput-plus_es-ES.qm. Putting xinput-plus_<lang>.qm inside ./i18n is sufficient.
The extraction command assumes your main file is named xinput-plus.py:
pylupdate6 --ts i18n/xinput-plus_es.ts xinput-plus.py- Do NOT change
xinput-plus.pyto another filename while developing the program. During development, new UI strings are added frequently; if you pointpylupdate6at some other file, those new strings won’t be picked up and won’t appear in the.tsfor translation. - If you really want to experiment with a differently named file (e.g., a versioned copy), do it in a separate folder and treat it as a separate exercise—not the one you use to develop and extract strings from.
If you must use multiple source files, pass all of them to pylupdate6:
pylupdate6 --ts i18n/xinput-plus_es.ts xinput-plus.py other_module.py optional_extras.pyThis ensures every translatable string is included in the .ts.
When you open the .ts in Qt Linguist (Qt 5 Linguist), be careful with strings that include placeholders. You may translate only the normal words, not the placeholders inside braces.
Examples:
-
Source:
Device: {name} (id {id})✅ Correct Spanish:
Dispositivo: {name} (id {id})
(translate only “Device” → “Dispositivo”; keep {name} and {id} exactly as they are)
-
Source:
Device: {name}✅ Correct Spanish:
Dispositivo: {name} -
Source:
Speed: {val:.2f}✅ Correct Spanish:
Velocidad: {val:.2f}
Never change the content inside
{ ... }(names, formats, punctuation). If you alter{name},{id}, or{val:.2f}, the program won’t work correctly at runtime.
After updating translations in Linguist (and marking them as Finished),
compile to .qm. On Debian/MX Linux, use lrelease from qttools5-dev-tools
(it handles Qt6 .ts files just fine — lrelease-qt6 is not needed):
lrelease i18n/xinput-plus_es.ts -qm i18n/xinput-plus_es.qmIf lrelease is not found, install it first:
sudo apt install qttools5-dev-toolsIf you need a fallback that works across different systems:
LREL=$(command -v lrelease-qt6 || command -v lrelease || echo /usr/lib/qt5/bin/lrelease)
$LREL i18n/xinput-plus_es.ts -qm i18n/xinput-plus_es.qmor you can compile from Qt 5 Linguist
File - Distribute as...
and save example to: xinput-plus_es.qm
Then run the app:
python3 xinput-plus.py --lang=esalso you can launch in other languages, example:
python3 xinput-plus.py --lang=enYou should see Spanish UI and, on recent versions, a console line like:
[i18n] Loaded app translation: xinput-plus_es.qm
Whenever you rename, remove, or reword a UI string in xinput-plus.py,
the old string becomes obsolete in the .ts file. Qt Linguist marks
it as vanished but cannot delete it — you have to do that from the
command line.
Step 1 — Regenerate the .ts and discard obsolete entries:
pylupdate6 --no-obsolete --ts i18n/xinput-plus_es.ts xinput-plus.pyThe --no-obsolete flag removes any string that no longer exists in the
source. Without it, pylupdate6 keeps old entries forever.
You will see a summary like:
Summary of changes to i18n/xinput-plus_es.ts:
21 existing messages were found
3 obsolete messages were discarded
Step 2 — Translate any new strings that appeared:
After regenerating, open the .ts in Linguist and look for entries marked
as unfinished (shown in yellow). These are strings that were added or
changed in the source and have no translation yet. Translate them and mark
them as Finished.
Alternatively, you can add translations directly in the .ts file by
changing:
<translation type="unfinished" />to:
<translation>Your translation here</translation>Step 3 — Recompile:
lrelease i18n/xinput-plus_es.ts -qm i18n/xinput-plus_es.qmThe output should show 0 unfinished:
Updating 'i18n/xinput-plus_es.qm'...
Generated 20 translation(s) (20 finished and 0 unfinished)
When to do this: run
pylupdate6 --no-obsoletebefore every release, or any time you change a UI string in the Python source.
- Source strings in
xinput-plus.pyare wrapped inself.tr("…")sopylupdate6can extract them. - The app’s i18n loader keeps
QTranslatorreferences alive to avoid Python GC, ensuring translations apply from startup.
Created by: Washington Indacochea Delgado License: GNU GPL3 (free and open source)
✨ Thanks for using xinput-plus!
For those who love X11 and minimalist window managers. 👀💙
🌟 If it helped you, give it a star ⭐ on GitHub. It helps a lot!
God bless you