Skip to content
Version v0.35 ยท supported
[PRELIMINARY] Feature in development. Documented ahead of release and subject to change. [WIP] Pending copyedit and approval.

The desktop app

The desktop app is a graphical application for creating and managing profiles and commands without editing TOML by hand. It is a planned release, tracked across several milestones: the daemon-to-app connection, the application shell, the profile and command editor, and the visual scripting editor. The voice daemon ships and runs on its own today. The app will connect to it for editing, viewing the event log, and changing settings, and can be closed while the daemon keeps listening.

Two shells

The app has two shells over the same navigation and the same underlying data:

  • A desktop shell for pointer and keyboard, with a sidebar and a content pane.
  • A Controller Mode for a controller or touch, laid out for a screen viewed from across the room. See Controller Mode.

The running environment picks the starting shell, and one control switches between them.

The authoring ladder

Authoring is a ladder of three rungs, so a simple command stays simple and a complex one still has room. A structured command editor handles the common case: a spoken pattern, a response, synonyms, and a category. A block editor builds logic without writing Lua by hand, and generates the Lua for you. A text editor opens the raw profile files for full control. Each rung hands off to the next. See The editor.

Everything here is possible today

The app is a front end. It will not add capability that the profile format and the amri tool do not already provide. Anything the app will let you build, you can build now by writing a profile and running the daemon:

  • Install and set up the daemon with the steps in Setup.
  • Author commands, patterns, and responses in a TOML profile, described throughout the concept pages, starting with Triggers.

The app will make this authoring visual. It will not become a prerequisite for it.