Dials

Dials

Your lights, mouse speed and fans in one window. Save a setup, and it switches by itself when your game starts.

Download for Linux Windows: planned

Version 0.1.0 · 78 KB · Python 3.10+ · no sudo to install
SHA-256 4927c532faf2faea344771a5bcd3b2c1579b4d0d2292743b9d14501ba77a3f89

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.

#ff375f

Mouse speed

A slider in plain words, from very slow to very fast, saved with your setup.

100–26000 DPI

Fans

Quiet, Balanced or Performance, following your CPU temperature. Automatic hands control back to the board.

30% floor

Game setups

Name a setup, add the game's program name, and Dials switches to it while the game runs.

eldenring.exe

What works today

Dials is early. These were tested on real hardware. Other devices don't show up yet; they aren't broken.

DeviceControlsStatus
Anything OpenRGB supportsColourWorks via OpenRGB
Razer Basilisk V3Mouse speedTested
Keychron V1 (QMK/VIA)Keyboard colourTested
Boards with the ITE IT8689E fan chipFan modesTested, needs setup
Any QMK/VIA keyboard, more Razer mice, AMD PCsAll of the abovePlanned
WindowsEverything except fans at firstPlanned

Install on Linux

About two minutes. Everything installs into your home folder; nothing needs root except the optional fan step.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

This is your responsibility.Too little cooling can overheat and damage your PC. Dials keeps fans at 30% or more and gives them back to the board when it closes. If Dials is killed, the PC crashes or you log out while a mode is on, the fans stay where they were until you reopen Dials.

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