Install on Linux

Espanso Dynamic Forms offers two installation methods for Linux. Choose the one that best fits your distribution.

Method	Best For	Pros
.deb package	Debian, Ubuntu, Linux Mint, Pop!_OS	System integration, automatic updates via apt
.AppImage	Any Linux distribution	Universal, no installation required, portable

Option 1: Using the .deb Package

This method is recommended for Debian-based distributions. The package installs the executable to /usr/bin/edf.

Download

Open a terminal and run:

wget https://github.com/lumetrium/espanso-dynamic-forms/releases/latest/download/Espanso-Dynamic-Forms-Linux.deb

Need a specific version?

Visit the Releases page on GitHub to download older versions.

Install

Run the following command to install:

sudo apt install ./Espanso-Dynamic-Forms-Linux.deb

Verify Installation

Confirm the installation succeeded:

which edf

This should output /usr/bin/edf. If you see this path, you're ready to continue.

Option 2: Using the .AppImage

AppImages are portable executables that work on most Linux distributions without installation.

Download

Open a terminal and run:

wget https://github.com/lumetrium/espanso-dynamic-forms/releases/latest/download/Espanso-Dynamic-Forms-Linux.AppImage

Make It Executable

Before you can run the AppImage, you need to make it executable:

chmod +x Espanso-Dynamic-Forms-Linux.AppImage

Run the Application

You can now run the application directly:

./Espanso-Dynamic-Forms-Linux.AppImage --help

Optional: Move to a Permanent Location

For easier access, move the AppImage to a location in your PATH:

mkdir -p ~/.local/bin
mv Espanso-Dynamic-Forms-Linux.AppImage ~/.local/bin/edf

Make sure ~/.local/bin is in your PATH. You can then reference edf in your Espanso triggers.

What's Next?

The application does not start automatically. Espanso Dynamic Forms is designed to be launched by Espanso triggers. Follow the Getting Started guide to create your first trigger and test your installation.