Triggers

Overview

Triggers are the core of trigr. Each trigger has an abbreviation (the shortcut you type) and a replacement (the text it expands to).

Creating a Trigger

1. Click Add Trigger in the Trigger Manager
2. Fill in the fields:

• Abbreviation: The shortcut text (e.g., ;;sig)
• Replacement: The text to expand to
• Category: Optional grouping (e.g., "Email", "Code")
• Argument Mode: Toggle to enable argument parsing

3. Click Save

Trigger Modes

Plain Text

The simplest mode. Type the abbreviation and it's replaced verbatim.

Variable Substitution

Use {{name}} syntax to reference global variables or built-in values like {{date}}, {{time}}, {{year}}.

Abbreviation: ;;sig
Replacement: Best regards,\n{{fullname}}

Trill Expressions

Use {{expression}} syntax for dynamic text generation. Everything inside {{...}} is evaluated as a Trill expression:

Abbreviation: ;;greet
Replacement: {{if to_num(now("%H")) < 12 then "Morning" else "Afternoon"}}

Argument Mode

When enabled, you can pass arguments after the abbreviation. Arguments are available as args[0], args[1], etc.:

Abbreviation: ;;email
Replacement: {{args[0]}}@example.com
Type: ;;email john  →  john@example.com

Managing Triggers

• Search: Use the search bar to filter triggers
• Toggle: Disable individual triggers without deleting them
• Categories: Organize triggers into custom categories
• Export/Import: Backup your triggers to a JSON file

Best Practices

• Use a consistent prefix like ;; to avoid accidental expansions
• Group related triggers into categories
• Test new triggers before relying on them
• Use Trill scripting for dynamic or conditional content