Changelog

0.1.2 (2026-10-29)

A new look for the desktop app, after Nothing OS in Material You colors, and a window that no longer lags.

budctl-gui has a new look, after Nothing OS in Material You colors, like the owner's Aurora shell: dot-matrix page names and battery figures (Doto), LED battery rings, dotted sliders for the bass level and the EQ bands (drag, or the mouse wheel), pill switches, tracks and chips, Space Grotesk and Space Mono text. The fonts are built in (SIL OFL 1.1, OFL-fonts.txt in the release archive).
The palette file takes Aurora's Material 3 keys (primary, tertiary, surfaceLow, outline…), so ~/.cache/matugen/aurora.json works as it is. bg and fg are still read; surface and secondary are no longer used.
budctl-gui no longer lags. It repainted most of the window many times over for each hover, click or scroll step; now it repaints only what changed, and a scroll paints each card once. On the Overview, a hover went from about 25 ms of drawing to 2, a scroll step from about 50 to at most 12, and the list of keys from 35 to almost nothing.
The keys that need Shift work in budctl-gui: ? (the list of keys), G, J, K and gT. The window used to see them without Shift (/, g, j, k, gt).
Built from source, debug builds (cargo run) optimize the dependencies, so the desktop app runs smoothly there too.

The first release, with builds for x86_64 and aarch64 Linux and an install script.

Supported buds: realme Buds T310.

budctl, the command line: list, status, noise control and its levels, game mode, EQ presets and custom EQ presets (create, edit, rename, delete), switches (bass boost, 3D sound, wind, dual connection), bass level, find (ring the buds), touch controls, the hold cycle, and the devices dual connection keeps. --json for scripts and status bars, --debug for hex dumps.
budctl-gui, the desktop app (Wayland): the same features on five pages, mouse first with vim-like keys on top, colors from a matugen palette.
~/.config/budctl/config.json: a default device, and the desktop app's idle time and start page. Created with the defaults when missing.
The desktop app writes its built-in colors to ~/.config/budctl/theme.json when there is no such file, and logs errors and session events to ~/.local/state/budctl/gui.log.