One place for the things you keep tweaking
Dials talks to your devices directly. It doesn't run in the background unless it's open, and it never sends anything anywhere.
Lights
Pick a colour for the board, mouse and keyboard, and match how white looks on each one.
#ff375fMouse speed
A slider in plain words, from very slow to very fast, saved with your setup.
100–26000 DPIFans
Quiet, Balanced or Performance, following your CPU temperature. Automatic hands control back to the board.
30% floorGame setups
Name a setup, add the game's program name, and Dials switches to it while the game runs.
eldenring.exeWhat works today
Dials is early. These were tested on real hardware. Other devices don't show up yet; they aren't broken.
| Device | Controls | Status |
|---|---|---|
| Anything OpenRGB supports | Colour | Works via OpenRGB |
| Razer Basilisk V3 | Mouse speed | Tested |
| Keychron V1 (QMK/VIA) | Keyboard colour | Tested |
| Boards with the ITE IT8689E fan chip | Fan modes | Tested, needs setup |
| Any QMK/VIA keyboard, more Razer mice, AMD PCs | All of the above | Planned |
| Windows | Everything except fans at first | Planned |
Install on Linux
About two minutes. Everything installs into your home folder; nothing needs root except the optional fan step.
Install Python's window toolkit
Skip this if you already have it. Use the line for your distro:
- Fedora, Nobara
- sudo dnf install python3-tkinter
- Ubuntu, Debian, Mint
- sudo apt install python3-tk
- Arch
- sudo pacman -S tk
For motherboard and mouse lights, also install OpenRGB. Dials starts it in the background by itself.
Download and check it
Download the file above, open a terminal in your Downloads folder, and check it arrived intact:
echo "4927c532faf2faea344771a5bcd3b2c1579b4d0d2292743b9d14501ba77a3f89 dials-0.1.0-linux.tar.gz" | sha256sum -c tar -xzf dials-0.1.0-linux.tar.gz
The first line should end in
OK.Run the installer
sh dials-0.1.0-linux/install.sh
This adds Dials to your app menu. Run it again with a newer version to update; your setups are kept.
Open Dials
Find it in your app menu. Pick colours, set mouse speed, then save the result as a setup. Only one Dials window runs at a time.
Optional: fan modes
Without this step the Fans card stays on Automatic, and your motherboard stays in charge.
Fan modes work only on boards with the ITE IT8689E chip, using its out-of-tree driver. The Fans card shows the exact one-time command with a Copy button. It looks like this:
sudo sh ~/.local/share/dials/app/dials/data/install-fans.sh
Read the script before you run it; it is short and says what it changes. Add --remove to undo it.
If something's missing
“Colour needs OpenRGB running”
Install OpenRGB. If it's already installed, close Dials and open it again; Dials starts OpenRGB when it opens.
Mouse speed doesn't appear
Only the Razer Basilisk V3 is supported so far. If you have one, allow access to it once and replug it:
sudo sh ~/.local/share/dials/app/dials/data/setup-devices.sh
White looks different on each device
Open Match colours in Dials. Every light turns white, and you turn down the colour that looks off on each device. Dials corrects every colour from then on.
Fans stay loud after closing Dials
Open Dials and choose Automatic, or restart the PC. Then let us know what happened.
Nothing opens from the menu
Run dials-app in a terminal; the error it prints says what's wrong.
Uninstall
If you set up fan or device access, run those scripts with --remove first. Your setups stay in ~/.config/dials unless you add --purge.
sh ~/.local/share/dials/uninstall.sh