Roadmap

Roadmap and status

Design principle: dofscroll complements the vendor driver instead of duplicating it, see Buttons.

Source of truth: docs/work-plan.md (the "Done" list below is brought up to date for 1.3.1). If this page and the work plan differ, the work plan wins.

Parity rule

Every user-visible feature must work on Linux, Windows and macOS. A feature is "done" only when all three have an implementation behind the same interface and the same tests (platform parts compile on their runner). Toolkit-free logic is shared; platform parts stay small. "Done" means built and tested in CI; behavior on real hardware is confirmed separately by a human.

Done

• Modes plugin system, ModeRunner, all keys and mouse buttons on X11 and uinput
• First-start seeding of the config and example modes
• Daemon split into a platform-independent core and a thin Linux main; platform interfaces with a fake for tests
• Tray with gettext (English source, German catalog) and a start-at-login switch (since 0.1.1 part of the Qt interface; the GTK tray was removed)
• Device database, HID descriptor parser, devices/*.conf, dofscroll-hidprobe
• 1-based BUTTON_<n> numbering everywhere
• CMake build, CPack packages (RPM, DEB, TGZ), CI with sanitizers, cppcheck, secret scan, release workflow
• Security review report and first fixes
• Qt6 interface dofscroll-ui: Overview, Profiles, Editor, Joystick modes, Button modes, User modes, Device, Axes and Settings pages, running-program picker, tray, start at login
• Linux packages include the Qt interface when Qt6 is available at build time (the GTK tray was removed in 0.1.1)
• Unsigned Windows installer and ZIP and macOS DMG built by CI
• Stuck-key safety net, --release-keys, and pausing output while the own session is not the active one
• One file per profile (devices/, apps/) with PRIORITY and an automatic, backed-up migration
• Lift as the sixth motion; a function on every motion; analog and digital keys (keys:, step:); mouse click and hold (step:click, hold:)
• Take over from other profiles, New profile, Import and Export of profiles; key picker as a tree in columns; axis assistant that starts and ends steps by your movement; device selector on the Axes page
• macOS binaries signed with the hardened runtime; release job with a gate, an approval and an immutable release

Implemented, CI-verified, hardware-unverified

• Windows port (W1): raw HID input, SendInput output, foreground-window provider, named-event reload, no-console daemon, per-user autostart script. Manual tests: port-windows-checklist.md.
• macOS port (W2): IOHID input, CGEvent output, NSWorkspace provider, LaunchAgent, permission handling. Manual tests: port-macos-checklist.md.

Not verified yet

• Windows beyond the first tests on one machine (SpaceMouse Pro, official driver): scrolling in both directions, the driver cleanup, backup and restore
• Everything on macOS (daemon, interface, installer) on real hardware; the macOS driver cleanup needs the survey of issue #184
• Packages on Debian, Ubuntu and Fedora on a real desktop (they are install-tested in CI containers); Wayland (one contributor report: Ubuntu 26.04, GNOME, services start and window renders; not tested by the maintainer)

Planned

Package	Content
W9	Verify device descriptors and factory button counts on real hardware
W7 / W8	Follow-up security fixes; keep documentation in sync
Motion functions, stages 7c to 7e (plan, issues #224, #225)	Taking over from a joystick mode into a function, named functions (FUNC_<name>) and a table of them, duplicating a function, TWIST_GUARD. Stages 1 to 7b (key engine, lift, clicks and holds, the pointer, tiles, macros, the New function window) are in 1.3.1.
Later	Signed installers

Decisions: version 0.1 is released without waiting for the Qt interface (Windows and macOS daemons configured by file at first); the Qt interface and unsigned installers shipped with 0.1.0-beta.1 after all. Installers are unsigned and not notarized. Known limitation: on Linux spacenavd reports one merged device, so two mice with different modes at once need direct HID access.

Pick up work through the claiming rules in the work plan; see Development.