Keydial Commander 1.3.0a3 — Ubuntu package preview

Keydial Commander 1.3.0a3 — Ubuntu package preview

An easier installation path for Ubuntu 26.04: download one package, let APT
resolve runtime dependencies, then explicitly open Commander to start remapping.
This remains a prerelease while physical-device and graphical-session checks
are outstanding.
Clean Ubuntu installation remains unqualified: the rootfs harness failed
while configuring Ubuntu's systemd. Archive, extracted runtime and foreign-root
package transactions passed; those are narrower checks.

Download	Use
huion-keydial-mini-driver_1.3.0a3-1_all.deb	Ubuntu 26.04 package, built UI and desktop window. Start here.
huion_keydial_mini_driver-1.3.0a3-py3-none-any.whl	Managed Python environments; does not install system access rules or GTK.
SHA256SUMS	Verify downloaded artifacts.
Automatic source archives	Development; build the frontend first.

Installation, startup and migration guide
· Verification record
· All releases

sudo apt install './huion-keydial-mini-driver_1.3.0a3-1_all.deb'
keydial-commander --start-service

Installation never starts or enables remapping. Closing the window leaves
remapping active; keydial-commander --stop-service stops it. Login startup is
an explicit systemctl --user enable huion-keydial-mini-user.service choice.
Upgrades/removal stop active vendor-managed instances before changing files,
and preserve profiles and user-local overrides. Existing manual installations
need the migration steps in the guide.

The package retains the previous preview's output ownership, macro cancellation,
neutral recovery and validation behavior. New checks cover native archive paths,
installed metadata/UI, lifecycle stop failures and explicit startup failures.
The exact measured installation and regression results appear in the verification
record. No host service or physical device is used for those checks.

Clean-rootfs evidence does not establish graphical window/login behavior, udev
permissions or Bluetooth/USB operation. Other distributions remain unqualified;
the 1.3.0a1 manual Linux bundle
remains available. Earl's existing project and commit identity is preserved.

Verified source: 44ae287f1b25d5a12bf51554e8a424b2319660b3.

Checks: 221 Python passed (one capture case excluded), 15 isolated browser tests passed, build/lint passed. See the verification record for the failed clean-install gate and narrower passing checks.

SHA-256:

b75d44f5f8b69b9fd7a03d9c1ad5d3d53cc30a5444d1c1a3ab705689a70a3d14  huion-keydial-mini-driver_1.3.0a3-1_all.deb
45fd5a661dbd7e2a1d60b425930eccc4637fbf4aedd6d05ca67869ab2d2878a6  huion_keydial_mini_driver-1.3.0a3-py3-none-any.whl

Keydial Commander 1.3.0a1 — recovery preview

A Linux preview for configuring the Huion Keydial Mini K20. This release adds
owned-key cleanup, cancellable macros, safer profile changes and recovery that
waits for released controls before accepting fresh input.

Download

File	Use it for
Linux preview bundle	Start here. Includes the built UI, Python wheel, installation guide, device rule, user-service template and optional desktop files.
Python wheel	Existing Python setups that already manage device permissions and service integration.
SHA256SUMS	Checksums for the two downloadable artifacts.

Unpack the Linux bundle and open INSTALL.md. Python is required; Node and
the source checkout are not required to run the bundle. The guide covers
Ubuntu prerequisites, user-local installation, initial device access and the
optional desktop window. After setup, open http://127.0.0.1:8137.

GitHub's automatic “Source code” downloads are for developers. They need a
frontend build; choose the Linux bundle for the prebuilt UI.

What changed

• Held actions release their original keys after binding edits or profile
  switches. Overlapping shortcuts preserve another action's held modifiers.
• Macros run without blocking input, with eight concurrent macro slots and no
  backlog. Disconnects, profile changes and shutdown cancel obsolete work.
• Node failures and lost-event frames enter recovery. Already-held controls and
  buffered recovery gestures cannot create fresh actions.
• Aborting a GUI/API macro preview cancels its remaining work.
• Complete action validation occurs before active-map persistence/publication.
• Local status distinguishes connection, readiness and unavailable output.
• Shortcut capture and action drafts support natural editing and explicit Save.

Normal release-triggered buttons, button chords, physical sticky holds and dial
pulses remain the same. Profiles remain YAML under
~/.config/huion-keydial-mini/profiles/.

Qualification and limits

This is a prerelease, not a qualified Ubuntu installer release. Bluetooth
has historical K20 evidence from July 2026 on Ubuntu 24.04. Fresh recovery and
USB/data-cable checks remain open. Other distribution builders are unqualified.

The recovery baseline passed 192 Python tests with hardware capture
excluded and 15 isolated browser regressions, plus frontend build and lint.
Artifact installation checks are recorded with the release evidence. These
checks do not establish physical transport support.

Source and artifact evidence

Versioned source
· Artifact verification record

The published release body records the full commit SHA after the version tag is
created. The evidence record separates wheel installation and isolated API
checks from unperformed hardware, installed-service and clean Ubuntu checks.

Saved dial sensitivity is not yet applied by the input path. Battery reporting,
tray support and automatic application-based profile switching remain roadmap
items. A failed output backend requires resolving the cause and restarting the
user service; desktop receipt of cleanup after such a failure is not guaranteed.

Feedback

Report an issue with the
release version, Linux distribution/version, Bluetooth or USB connection, what
you expected and the shortest reproduction steps. Preview any log excerpts and
omit personal data and unrelated input.

Source commit: 2a93011439bbc55466a13bbbc658086f22ff88d6.

The wheel was checked against all 26 packaged source/UI files and the README metadata from this source tree. The uploaded bundle contains that same wheel.