guides

Umstieg von Espansos YAML-Konfiguration auf einen GUI-Text-Expander

Trofin Sorin-IoanTrofin Sorin-IoanCTO, Lightning Assist26. Juli 20269 Min. Lesezeit
espansoyamlmigrationguitext-expanderlinuxwindowsmacos
Teilen:
Umstieg von Espansos YAML-Konfiguration auf einen GUI-Text-Expander

Kurzantwort: Espanso speichert jedes Snippet als trigger/replace-Paar in YAML-Match-Dateien (~/.config/espanso/match/*.yml) – das heißt, ein Snippet hinzuzufügen oder zu bearbeiten bedeutet: einen Texteditor öffnen, YAMLs Einrückungsregeln einhalten und den Dienst neu starten, um es zu testen. Der Umstieg auf einen GUI-Text-Expander wie Lightning Assist bedeutet, jeden Match als Snippet in einem visuellen Editor nachzubauen – derselbe Triggertext, dieselbe Ersetzung, aber ein Formularfeld statt einer Datei. Einen Massenimport aus YAML gibt es heute nicht, daher erfolgt die Migration manuell, ein Snippet nach dem anderen; die meisten Bibliotheken unter 50 Snippets dauern deutlich unter 15 Minuten.

Offenlegung: Wir entwickeln Lightning Assist, einen kostenpflichtigen Textbaustein-Manager, Espanso ist also ein Konkurrent von uns. Espanso ist kostenlos und quelloffen, und jede Lösung unten betrifft Espanso selbst — keine davon erfordert einen Wechsel.

Wenn Sie noch nie ~/.config/espanso/match/base.yml geöffnet haben, wird Ihnen das alles nichts sagen – und genau für dieses Publikum ist dieser Leitfaden gedacht: Menschen, die Espanso zum Laufen gebracht, ein Dutzend Snippets hinzugefügt haben und sich jetzt fragen, ob es eine Version davon gibt, bei der sie nicht ständig über YAML nachdenken müssen.

Warum Espansos YAML-Konfiguration zur Reibung wird

Espanso ist wirklich gut gebaut. Es ist kostenlos, Open Source, plattformübergreifend, und sein dateibasiertes Modell ist eine bewusste Design-Entscheidung, kein Versehen – YAML ist portabel, diff-fähig und skriptbar. Die Reibung zeigt sich erst später, wenn man es tatsächlich im Alltag nutzt:

Match-Dateien verteilt über das Dateisystem. Espanso organisiert die Konfiguration in einen match/-Ordner (was expandiert werden soll) und einen config/-Ordner (wie sich die Expansion verhält), ausgehend von match/base.yml. Mit wachsender Snippet-Zahl fügen Sie entweder weiter dieser einen Datei hinzu oder beginnen, in mehr .yml-Dateien aufzuteilen – so oder so bedeutet „die eine über Preise" sechs Monate später zu finden: Dateien öffnen und durchsuchen, denn ein Suchfeld gibt es nicht.

Einrückung ist die Syntax. Ein einfacher Match sieht so aus:

matches:
  - trigger: ":br"
    replace: "Best Regards,\nJon Snow"

Espansos eigene Dokumentation ist hier unmissverständlich: "Make sure to include the indentation, otherwise it won't be valid YAML syntax." Das ist für jemanden, der sich in einem Texteditor sicher fühlt, kein Problem – und genau die Art Fehler, die sich leise einschleicht, wenn Sie ein Snippet aus Slack einfügen oder einen mehrzeiligen Block kopieren und die Leerzeichen nicht mitkommen. Meist merkt man es daran, dass der Trigger einfach nicht expandiert – kein Dialog, keine rote Wellenlinie, nur ein Snippet, das still gar nichts tut, bis man auf die Suche nach dem verirrten Leerzeichen geht.

Keine Synchronisierung, kein Team. Espanso speichert alles bewusst lokal – aus Datenschutzsicht wirklich gut, bedeutet aber, dass die Snippets auf ein zweites Gerät zu bringen eine manuelle Dateikopie, ein Dropbox-Ordner oder ein selbst gepflegtes Git-Repo ist. Es gibt kein Konto, keine eingebaute Mehrgeräte-Synchronisierung und keine Möglichkeit, einem Kollegen die Snippet-Bibliothek zu übergeben, außer die .yml-Dateien zu verschicken und ihn zu bitten, sie in den richtigen Ordner zu legen.

Neu starten zum Testen. Eine Match-Datei zu bearbeiten und zu prüfen, ob es funktioniert hat, bedeutet meist: speichern, zurück zur getesteten App wechseln, den Trigger tippen und – wenn er nicht auslöst – zurück zur Datei, um nachzusehen. Das ist eine kurze Schleife, aber eine, die Sie bei jeder einzelnen Änderung wiederholen, auf unbestimmte Zeit.

Nichts davon macht Espanso zu schlechter Software. Es macht sie zu Software für Menschen, die Konfiguration gerne als Code behandeln. Wenn das nicht ist, wie Sie Ihre Zeit verbringen möchten, ist eine GUI die Lösung – nicht ein „besserer" YAML-Editor.

Wie das GUI-Äquivalent tatsächlich aussieht

In einem GUI-Text-Expander ist ein Snippet eine Zeile, keine Datei. Sie öffnen ein Panel (bei Lightning Assist heißt es „My Snippets"), klicken auf „Create Snippet", tippen den Trigger in ein Feld und die Expansion in ein anderes, und speichern. Es gibt keine Datei zu suchen, keinen Dienst neu zu starten und keine Einrückung zu treffen, weil es keine Einrückung gibt – Rich Text, HTML-Formatierung und mehrzeiliger Inhalt werden direkt in das Expansionsfeld getippt oder eingefügt, ganz ohne Escaping. Snippets werden in selbst benannten Ordnern organisiert, und Sie können die gesamte Bibliothek durchsuchen, statt Dateien zu durchforsten.

Der Kompromiss ist der erwartbare: Sie geben direkten Dateizugriff auf (kein Git-Diff Ihrer Snippet-Historie, kein Bearbeiten in Vim) im Austausch dafür, die YAML-Mechanik von vornherein gar nicht zu brauchen.

Espanso → Lightning Assist: Konzept-Zuordnung

Wenn Sie bereits in Espansos Begriffen denken, hier die Übersetzung jedes Elements:

Espanso-Konzept In YAML GUI-Äquivalent
Match Ein Eintrag unter matches: in einer .yml-Datei Ein Snippet – eine Zeile im Snippets-Panel
Trigger trigger: ":br" Das Trigger-Feld – dieselbe Abkürzung direkt eintippen, kein Doppelpunkt nötig, außer Sie möchten ihn beibehalten
Replace replace: "Best Regards,\nJon Snow" Der Expansionstext des Snippets – Rich Text, HTML und mehrzeiliger Inhalt nativ unterstützt
Vars / Extensions (Datum, Shell, Zwischenablage, Formular) Ein vars:-Block, der auf einen Variablentyp verweist Platzhalter, die in die Expansion eingefügt werden – [#Date#], [#Name#] und Zwischenablage-Variablen
Match-Dateien (base.yml, eigene .ymls) Dateien in ~/.config/espanso/match/ Ordner im Snippets-Panel – visuell statt nach Dateiname organisiert
Reload / espanso restart Manueller Dienst-Neustart, um Änderungen zu übernehmen Nichts zu tun – Snippets sind live, sobald Sie speichern
Regex-Trigger, Shell-Befehl-Matches YAML + Scripting, Espanso-spezifisch Nicht nachgebildet. Wenn das zentral für Ihren Workflow ist, bleiben Sie für diese Fälle bei Espanso

Diese letzte Zeile ist wichtig: Dies ist ein Migrationsleitfaden, keine Behauptung „Lightning Assist kann alles, was Espanso kann". Regex-Muster-Trigger und Shell-Befehl-gestützte Matches sind echte Stärken von Espanso, für die es hier kein GUI-Äquivalent gibt.

Schritt für Schritt: Ihre Snippets manuell migrieren

  1. Ihre bestehenden Matches finden. Öffnen Sie ~/.config/espanso/match/base.yml und alle weiteren eigenen .yml-Dateien, die Sie angelegt haben. Jedes trigger/replace-Paar ist eine Sache, die Sie nachbauen.
  2. Den GUI-Expander installieren und jede Konfigurationsdatei überspringen. Testen Sie Lightning Assist 14 Tage kostenlos – ohne Kreditkarte. Die App öffnet sich direkt im Snippet-Panel; es gibt keine Setup-Datei, die Sie zuerst schreiben müssten.
  3. Jeden Match als Snippet nachbauen. Klicken Sie auf New Snippet, fügen Sie den Triggertext in das Trigger-Feld ein (behalten Sie :br oder /addr genau so bei, wenn Ihnen diese Konvention gefällt – jeder Text ist ein gültiger Trigger) und fügen Sie den Replace-Text in das Expansionsfeld ein.
  4. Variablen als Platzhalter nachbauen. Eine Datumsvariable wird zum Platzhalter [#Date#]; eine Zwischenablage-Variable wird zum Zwischenablage-Platzhalter; reiner Text bleibt reiner Text. Shell-Befehl-Variablen und Regex-Trigger haben kein direktes Äquivalent – lassen Sie diese Matches in Espanso, falls Sie sie brauchen.
  5. Ihren Trigger-Modus festlegen. As-You-Type-Expansion (Trigger tippen, er expandiert inline) ist die Standardeinstellung und braucht kein Setup. Wenn Sie lieber nach dem Tippen des Triggers eine Taste drücken möchten, richten Sie das einmalig unter Settings → Triggers ein.
  6. Testen, bevor Sie irgendetwas löschen. Probieren Sie jedes Snippet in einem Testdokument aus. Behalten Sie Ihre Espanso-Konfiguration, bis Sie bestätigt haben, dass die migrierte Menge wie erwartet funktioniert – es schadet nicht, beide vorübergehend nebeneinander zu haben.

Seien Sie realistisch, was den Zeitaufwand angeht: Einen Massenimport aus YAML gibt es heute nicht, jedes Snippet wird von Hand nachgebaut. Für eine Bibliothek unter 50 Snippets ist das meist deutlich unter 15 Minuten. Wenn Sie 100+ Einträge migrieren, macht zumindest die Struktur von YAML Copy-Paste einfach – lesen Sie Trigger und Replace-Wert aus jedem Block heraus und fügen Sie sie in die entsprechenden GUI-Felder ein.

Was Sie gewinnen, und was Sie aufgeben

Was Sie gewinnen: keine Konfigurationsdateien, keine Neustart-zum-Testen-Schleife, eine durchsuchbare, in Ordnern organisierte Snippet-Bibliothek, KI-Befehle, die markierten Text per Hotkey umschreiben oder übersetzen, Push-to-Talk-Sprache-zu-Text in derselben App, automatische Cloud-Synchronisierung über Geräte hinweg und Team-Snippet-Sharing, falls Sie es brauchen. All das läuft unter Windows, macOS und Linux mit demselben Konto.

Was Sie aufgeben: Espanso ist kostenlos und Open Source, für immer – Lightning Assists kostenlose Stufe ist bei 3 Snippets gedeckelt, mit unbegrenzten Snippets, Ordnern und Team-Sharing für 5,99 $/Monat nach einer 14-tägigen Testphase (KI-Befehle und Sprachnutzung über separat gekaufte AI Credits). Außerdem verlieren Sie regex-basierte Trigger und Shell-Befehl-Matches, für die es im GUI-Modell kein Äquivalent gibt. Wenn das Ihre Gründe für Espanso sind, ist diese Migration nichts für Sie – und das ist ein legitimer Grund zu bleiben.

Wenn Sie eine GUI wollen, ohne Espansos Ökosystem ganz zu verlassen, gibt es Community-Projekte – espansoGUI (Rust/Iced, auf Flathub), EspansoEdit (Windows-Freeware) und die EspansoGUI-IDE. Sie sind einen Versuch wert, aber jedes ist eine separate, ehrenamtlich gepflegte Schicht über denselben YAML-Dateien darunter; Espanso selbst hat weiterhin keine offizielle GUI (die aktuellste stabile Version des Kernprojekts ist v2.4.0, Juli 2026). Wenn Sie ein Tool wollen, bei dem die GUI das Produkt ist, schließt diese Migration genau diese Lücke.

Häufig gestellte Fragen

Kann ich meine Espanso-YAML-Dateien direkt importieren?

Heute nicht – einen Massenimport gibt es nicht. Sie bauen jeden Match als Snippet im visuellen Editor nach. Für die meisten Bibliotheken unter 50 Snippets dauert das deutlich unter 15 Minuten; größere Bibliotheken dauern proportional länger, da es weiterhin einzeln erfolgt.

Verliere ich meine regex-basierten Trigger oder Shell-Befehl-Matches?

Ja. Das sind Espanso-spezifische Fähigkeiten, die auf seinem YAML-/Scripting-Modell aufbauen, und dafür gibt es hier kein GUI-Äquivalent. Wenn Regex-Trigger oder shell-gestützte Matches zentral für Ihr Setup sind, nutzen Sie dafür weiter Espanso und ziehen Sie einen GUI-Expander nur für Ihre einfacheren, statischen Snippets in Betracht.

Kann ich denselben Triggertext behalten, wie :br oder /addr?

Ja. Das Trigger-Feld akzeptiert jeden Text, den Sie eintippen, einschließlich eines führenden : oder /, falls das die Konvention ist, an die Sie gewöhnt sind. Nichts zwingt Sie, Ihren Abkürzungsstil während der Migration zu ändern.

Gibt es eine offizielle Espanso-GUI, die ich vor einem kompletten Werkzeugwechsel ausprobieren sollte?

Keine offizielle. Community-Projekte wie espansoGUI, EspansoEdit und die EspansoGUI-IDE fügen eine grafische Schicht hinzu, sind aber separate, ehrenamtlich gepflegte Tools über denselben YAML-Dateien – Sie sind weiterhin einen Schritt von der rohen Konfiguration entfernt. Wenn Sie wollen, dass die GUI das gesamte Produkt ist statt eines Zusatzes, geht es bei dieser Migration genau um diesen Unterschied.

Weiterführende Artikel

Quellen

Ähnliche Artikel