Installation and startup

Use Windows x64 with a CPU supporting AVX2, FMA and AES. Keep the complete runtime folder and its matching AHK_Z interpreter together.

Extract the complete package

Choose a writable location such as D:\Tools\Diatom. Extract the archive before running the program.

text

Diatom/
  diatom.exe
  conf.toml
  AutoHotkey.exe
  AutoHotkey.dll
  conf/base/
  conf/dll/
  conf/default/
  lib/
  src/

Keep additional DLLs and resources supplied with the package. The selected execution mode determines which runtime components are required.

Start, verify and exit

Run diatom.exe and follow quick start. The application primarily runs in the background. With starter commands installed, Ctrl+Alt+F8 displays a readiness message and Ctrl+Alt+F12 requests exit.

Running diatom.exe again replaces the previous instance and reloads configuration. Finish important work before restarting. Independent script processes can have their own lifetime. Task Manager provides a fallback way to end diatom.exe.

Personal files

Location	Purpose
src/user	Personal commands
conf.toml	Global settings
pc_*.toml	Machine overrides
conf/default/naming.toml	Application groups
conf/default/mouse.toml	Trigger-button rules
conf/default/data, gs.ini, view	Gesture samples and previews

Use the directory actually selected by src_dir. Back up the runtime folder before an update, including commands, custom libraries, configuration and samples.

Start with Windows

Open shell:startup from Win+R and add a shortcut to diatom.exe. Append boot to the target if you want boot-only commands to run.

text

"D:\Tools\Diatom\diatom.exe" boot

boot adds the [boot] commands while [dog] still runs. It is an explicit launch argument.