TL;DR

  • Espanso GUI는 Espanso가 사용하는 설정 파일을 그대로 활용해 텍스트 확장 규칙을 관리하는 데스크톱 편집기임.
  • 매치 파일과 매치를 만들고, 이름 변경·복제·이동·삭제할 수 있으며, 대체 매치·폼·폼 필드·변수도 편집 가능함.
  • 셸·스크립트·폼·선택 변수를 다루고, 트리거·유형·내용별 검색과 정렬, 전체 YAML 편집 및 저장 전 검증을 제공함.
  • Linux·macOS·Windows에서 사용할 수 있으며, 설치 전 Espanso가 필요하고 별도의 매치 파일 세트를 만들지 않음.
  • 저장 후 Espanso를 재시작해 설정을 다시 불러올 수 있으며, Espanso GUI는 Espanso와 무관한 독립 프로젝트임.

Espanso GUI

  • Espanso GUI는 Espanso 매치 파일을 관리하는 데스크톱 편집기임.
  • Espanso가 사용하는 설정 파일을 그대로 다루며, 그래픽 인터페이스에서 텍스트 확장 규칙을 관리함.
  • Espanso와 제휴 관계가 없는 독립 프로젝트임.

제공 기능

  • 매치 파일과 매치를 탐색·생성·이름 변경·복제·이동·삭제함.
  • 대체 매치, 폼, 폼 필드, 변수를 편집함.
  • 셸·스크립트·폼·선택 변수를 다룸.
  • 트리거·유형·내용별로 매치를 검색하고 정렬함.
  • 편집기에서 노출하지 않는 옵션을 다룰 때 전체 매치 파일 YAML을 열 수 있음.
  • Espanso의 default.yml 및 애플리케이션별 설정 프로필을 관리함.
  • 변경 사항을 저장한 뒤 Espanso를 재시작함.
  • 그래픽 편집기는 일반적인 매치 유형을 처리하며, 고급 Espanso 옵션을 위한 전문가용 YAML 모드에서 저장 전에 문서 유효성을 검사함.

설치

  • 먼저 Espanso를 설치해야 함.
  • Espanso GUI는 설정 디렉터리를 자동으로 찾으며 별도의 매치 파일 세트를 만들지 않음.

Linux

  • 설치 스크립트는 Debian, Ubuntu, Arch Linux 및 호환 배포판을 지원함. 최신 릴리스 패키지를 내려받으며 관리자 권한이 필요함.
  • 다음 명령으로 설치 스크립트를 실행할 수 있음: curl -fsSL https://raw.githubusercontent.com/johannjdk/espanso-gui/main/scripts/install-linux.sh | sh
  • 또는 릴리스 페이지에서 패키지를 내려받을 수 있음.
  • Debian 및 Ubuntu에서는 sudo apt install ./espanso-gui-all.deb를 실행함.
  • Arch Linux에서는 sudo pacman -U ./espanso-gui-any.pkg.tar.zst를 실행함.

macOS

  • 릴리스 페이지에서 해당 DMG를 내려받음.
  • Apple silicon: espanso-gui-macos-arm64.dmg
  • Intel: espanso-gui-macos-x64.dmg
  • DMG를 열고 Espanso GUI를 Applications 폴더로 이동함.

Windows

  • Windows 빌드는 Windows x64에서 만들어짐.
  • Python 3.10 이상을 설치한 뒤 저장소 루트에서 PowerShell로 .\scripts\build-windows.ps1을 실행함.
  • 결과 아카이브는 dist/에 생성되며, 압축을 풀고 Espanso GUI.exe를 실행함.

소스에서 실행

  • Python 3.10 이상이 필요함.
  • 저장소 https://github.com/johannjdk/espanso-gui.git을 복제하고 해당 디렉터리로 이동함.
  • 가상 환경 .venv를 만들고 활성화한 뒤 pip install -e .로 설치하고 espanso-gui를 실행함.

애플리케이션 사용

  • 설정 디렉터리는 운영체제에 따라 선택됨.
  • Linux: $XDG_CONFIG_HOME/espanso/match 또는 ~/.config/espanso/match
  • macOS: ~/Library/Application Support/espanso/match
  • Windows: %APPDATA%\\espanso\\match
  • 왼쪽 패널에서 파일과 매치를 선택하고, 편집을 마친 뒤 저장함.
  • Restart Espanso를 사용하면 설정을 즉시 다시 불러오며, 이 동작에는 시스템에서 espanso 명령을 사용할 수 있어야 함.
  • 설정 프로필을 관리하려면 File → Espanso configuration…을 엶.
  • default.yml은 모든 곳에 적용되며, 다른 프로필은 filter_exec, filter_class, filter_title, filter_os 등의 Espanso 필터를 사용함.
  • Espanso는 Wayland에서 애플리케이션별 프로필을 지원하지 않음.

기여

  • 버그 보고와 기능 요청은 이슈 트래커에서 받음.
  • 풀 리퀘스트에는 변경 사항을 설명하고, 유용한 경우 재현 방법이나 테스트 참고 사항을 포함해야 함.

라이선스

  • Espanso GUI는 GNU General Public License v3.0에 따라 라이선스가 부여됨.
  • 애플리케이션 아이콘은 Espanso 프로젝트에서 파생됐으며 동일한 라이선스로 배포됨.
  • Espanso는 별도 프로젝트이며, 라이선스는 Espanso의 라이선스 정보를 참조함.