Window scopes
Diatom/User guide/Window scopes

Window scopes and application groups

Use the same gesture for different actions in different applications. Begin with the process name shown in the activity log.

ini
[notepad_r+r]
type=f
code='''
SendText("Hello")
'''

last is the general fallback scope. More specific application rules can take precedence.

Group applications

Merge entries into the existing section in conf/default/naming.toml.

ini
[exe]
notepad=["edit4"]
notepad3=["edit4"]

The trailing 4 selects a naming tier. Use edit as the command prefix, for example edit_r+r. Arrays follow JSON syntax. Repeating a whole section replaces its previous contents in the global parser.

Match titles and other fields

Common naming sections include exe, class, exe+class, title and path.

ini
[exe]
notepad=[["work2","title","@","Work"]]

@ means contains, < means starts with, > means ends with and ~ means regular expression.

Priority

The normal path checks highest/up and tier 1, composite window information, tier 2/mid, title/path/exe, tier 3/class/tail, then tier 4 and last. Tier 0 follows a special path. Use explicit scopes instead of relying on file line order.

The package builder groups browsers as wb4. Its wb_e+r tab-close command therefore wins over a matching last-scope window action.

User guide

Loading the guide…