Changelog

0.1.6 (2026-11-02)

The Android app can keep itself up to date, if you let it.

The Android app can update itself. Switch on Check for updates on its App page, and once a day it asks GitHub for budctl's latest release and offers it, with its notes. Check now asks right away. Update downloads the APK, checks its SHA-256, and hands it to Android's installer. The check is off until you switch it on, sends nothing about you or your buds, and is the only thing in budctl that goes online; for it, the app now has the internet permission and may ask to install apps.

Bass boost works now: the buds hear which band each level is for.

Bass boost on the T310 has three bands: low, medium and high frequencies. budctl bass low|medium|high <level> sets each one, and the desktop and Android apps have a slider per band under Bass boost. The buds acknowledged the old single bass level but ignored it.

budctl comes to Android, and gets an icon.

An Android app: the desktop app's pages and look on a phone (Android 12 or newer), with the same Rust library inside, colors from your wallpaper, and no internet permission. Install budctl.apk from this release. It is signed with budctl's own key; the certificate's SHA-256 fingerprint is 45:6F:9B:93:AA:40:1D:57:AA:6C:75:0D:FF:13:FA:82:5A:7B:28:B6:3D:D0:40:99:80:6F:A9:7C:14:75:23:12.
budctl has an icon: the LED battery ring around a dot-matrix "b". The release archives carry it, and install.sh and the PKGBUILD install it for the launcher entry.
With --debug, budctl-gui also shows each command, connect and failure between the frames.

The desktop app moves, the Nothing way: short, eased out, fading rather than sliding.

Hovers, the chosen segment, the keyboard cursor and the current preset's circle fade instead of snapping. Switches stretch from the knob into the fill as they turn.
Pages fade in when opened, and when the buds are first read; dialogs fade in and out, as do the error above a page and the bands of a custom preset.
The battery rings light their dots one after the other, like the Glyph lights, when they first show and when a level changes.
While the app looks for the buds, a row of dots scans and the sidebar's light blinks; a light blinks beside Stop while the buds ring.
Nothing moves once a change has settled, so an idle window uses no CPU. "gui": {"motion": false} in the config turns the animations off.

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.