Your first commands in ten minutes

Start by using existing commands. You can then change one message and attach a gesture.

Install the starter commands

If your package already includes the shortcuts below, continue to the next step. Otherwise download starter_commands.toml, place it in <Diatom>\src\user, and restart Diatom. Use your actual src_dir if it differs.

The package needs a running def_hotkey host. Keep the host supplied with an existing setup. The starter examples include a minimal host for a new package.

Try the shortcuts

Press Ctrl+Alt+F8, dismiss the message, then press Ctrl+Alt+F9. Close Notepad when finished.

Change one message

Open the copied command file. Find the MsgBox call under [starter_ready] and change its message to My first command. Keep the quotation marks and parentheses. Save, restart diatom.exe, and press Ctrl+Alt+F8 again.

MsgBox("My first command", "Diatom")

Add a gesture

Read gestures and triggers, confirm the configured trigger button, and inspect a gesture's recorded name. Add that name as an alias to a command you have already tested.

The gesture reference lists copy, search, editing and browser commands.

If nothing happens

Check the complete runtime, .toml extension, actual command folder and restart. If every shortcut fails, check def_hotkey. If only one fails, check conflicts and conditions. Keep the full error report and use troubleshooting.