Skip to content
Abbrio for Espanso

Abbrio documentation

Abbrio Help

Guidance for installing and using Abbrio, the native macOS interface for Espanso. Browse setup, editing, dynamic content, packages, and troubleshooting topics.

This help centre explains how to set up and use Abbrio with a separate Espanso installation. Choose a topic to find steps and notes about a particular part of the app.

Help topics

Topic pages use stable, unversioned URLs so they can be opened from Abbrio. Links stay the same when the guide text is updated.

Browse help topics

Getting started Prepare Espanso and macOS, connect Abbrio to your configuration, and try a first expansion with Quick Search. Editing abbreviations Create and edit triggers, expansions, case and matching options, previews, and YAML while understanding saves and external file changes. Sets Create, arrange, enable, and configure sets, including defaults, prefixes, Quick Search options, metadata, and backups. Dynamic content Add date, clipboard, cursor, field, choice, nested-abbreviation, command, script, Markdown, HTML, and picture content to an item. Quick Search and menu bar Find and insert items with Quick Search, create items with Quick Define, and use the menu-bar companion and its configurable shortcuts. Application-specific settings Use Abbrio's Apps window to review and adjust which sets and packages apply to individual macOS applications. Settings and engine controls Find Abbrio preferences, configure Espanso options and paths, record shortcuts, and understand the engine status and controls. Statistics Turn Espanso statistics on, choose a reporting period, read the trigger and set totals, and manage saved counts. Regular expressions Create regex sets, review Espanso compatibility warnings, use named groups, and understand the tester's approximation limits. Import and export Import comma- or tab-separated abbreviations, export a set as CSV, or create a folder for an Espanso package. Packages Browse the Hub, inspect package contents, install or update packages, copy items into your own sets, and review Git package risks. Troubleshooting Resolve missing engine or configuration, permission and status problems, unreadable files, external-edit conflicts, and package failures.