Forms Library

The Forms Library is a collection of ready-to-use form configurations bundled with Espanso Dynamic Forms. Use them as-is, customize them, or study them to learn how to build your own forms.

What's Included

The library is organized into three sections:

Section	Purpose
Ready-Made Forms	Complete, working forms for common tasks like code assistance, email drafting, and file handling
Boilerplate Snippets	Copy-paste building blocks for creating your own forms
Form Factory	AI-powered form generator: describe what you need, get a prompt that generates a complete config

Using Library Forms

All bundled forms are located in the EDF_FORMS directory, which you can reference using the {{env.EDF_FORMS}} variable in your Espanso triggers.

Quick Start

Add this trigger to your Espanso config to try the demo form:

matches:
  - trigger: ':demo'
    replace: '{{output}}'
    force_mode: clipboard
    vars:
      - name: output
        type: script
        params:
          args:
            - C:/Program Files/Espanso Dynamic Forms/EDF.exe
            - --form-config
            - \{\{env.EDF_FORMS}}/demo.yml

Try different forms

Replace demo.yml with any form name from the Ready-Made Forms section (e.g., code.yml, email.yml, files.yml).

Available Forms

Form	Best For
Demo	Testing your installation
Code Assistance	Getting help with code from AI
Email	Drafting follow-up emails
Reply	Composing message replies
Date Picker	Inserting formatted dates
Checkbox	Multi-select checklists
File Upload	Processing file contents
Files (Advanced)	Batch file processing with templates
Code Generator	Generating C# event code

Customizing Forms

You can customize any library form by:

1. Copying the form file to your own location
2. Editing the YAML to match your needs
3. Updating your trigger to point to your custom copy

# Point to your customized version
- --form-config
- C:/my-forms/custom-email.yml

See Form Config for documentation on all available options.