Espanso는 짧은 트리거를 입력하면 긴 문장, 날짜와 코드 조각으로 바꾸는 무료 텍스트 확장 프로그램입니다. 현재 2.4.1 Windows 설치형과 포터블을 받을 수 있습니다.
설치 후 기본 :espanso 확장을 확인하고 base.yml에 :addr 문구를 추가해 메모장에서 자동 입력되는 단계까지 진행합니다.
Espanso는 어떤 프로그램인가요?
Windows 여러 앱에서 반복 문구를 같은 트리거로 입력하고 Alt+Space 검색 바에서 스니펫을 찾을 수 있습니다.
구성은 로컬 YAML 파일에 저장되며 날짜, 폼, 스크립트와 Hub 패키지로 확장할 수 있습니다.
Espanso 트리거·자동 확장·Windows 트레이 화면
Espanso 공식 저장소의 실제 데모와 Windows 안내 화면입니다. 트리거 입력, 확장 결과, 검색과 트레이 아이콘을 확인할 수 있습니다.
| 설치형 | EXE · 7.0MB |
|---|---|
| 포터블 | ZIP · 7.4MB |
| 라이선스 | GPL-3.0 |
| 기본 예제 | :espanso → Hi there! |
| 검색 바 | Alt+Space |
| 구성 편집 | espanso edit |
| 설정 형식 | YAML |
| 저장 방식 | 로컬 구성 파일 |
설치형과 포터블 선택
일반 Windows 10·11 x64 PC는 약 7.0MB인 Espanso-Win-Installer-x86_64.exe를 선택합니다. 시작 메뉴, 트레이 실행과 자동 시작을 편하게 쓰는 방식입니다.
설치 없이 시험하려면 약 7.4MB인 Espanso-Win-Portable-x86_64.zip을 빈 폴더에 모두 풉니다. ZIP 안에서 바로 실행하지 말고 구성 폴더와 실행 파일을 함께 관리하세요.
- Windows 설치형 EXE 또는 포터블 ZIP을 선택합니다.
- Espanso를 실행해 작업 표시줄 트레이 아이콘을 확인합니다.
- 메모장에서 :espanso를 입력해 기본 확장을 시험합니다.
- Alt+Space를 눌러 검색 바가 열리는지 확인합니다.
- espanso edit 명령으로 match/base.yml을 엽니다.
- :addr 트리거와 주소 문구를 추가해 저장합니다.
- 메모장에서 :addr를 입력해 문구가 바뀌는지 확인합니다.
- 문제가 있으면 espanso status와 espanso log를 확인합니다.
Espanso는 어떤 프로그램인가요?
Espanso는 특정 짧은 트리거를 입력하면 긴 문장, 날짜, 이모지나 코드 조각으로 바꾸는 로컬 텍스트 확장 프로그램입니다. 고객 답변, 주소, 이메일 서명과 반복 코드를 여러 앱에서 같은 방식으로 입력할 수 있습니다.
GPL-3.0 무료 오픈소스이며 기본 구성은 PC에 저장됩니다. 텍스트를 클라우드로 보내는 서비스가 아니지만 구성 파일에 비밀번호나 인증 키 같은 비밀을 평문으로 넣지는 마세요.
Windows에 Espanso 설치
Espanso-Win-Installer-x86_64.exe를 실행해 설치합니다. Windows 보호 화면이 표시되면 게시자와 공식 릴리스에서 받은 파일인지 확인한 뒤 More info와 Run anyway를 선택할 수 있습니다.
설치가 끝나면 시작 메뉴에서 Espanso를 실행하고 작업 표시줄 알림 영역의 아이콘을 확인합니다. 아이콘이 숨겨졌다면 위쪽 화살표를 눌러 표시합니다.
기본 확장 동작 확인
메모장을 열고 :espanso를 입력한 뒤 단어 구분 문자나 Enter를 입력합니다. 기본 예제가 활성화되어 있으면 Hi there! 같은 문구로 바뀝니다.
트리거가 그대로 남으면 Espanso가 실행 중인지, 입력한 콜론과 철자가 맞는지 확인합니다. 브라우저 주소창보다 일반 메모장에서 먼저 시험하면 앱별 입력 제한을 구분하기 쉽습니다.
Alt+Space 검색 바 사용
단축키 Alt+Space를 누르면 Espanso 검색 바가 열립니다. 등록된 스니펫 이름이나 내용을 검색하고 방향키로 결과를 골라 Enter를 누르면 활성 입력 칸에 문구가 들어갑니다.
Windows 창 시스템 단축키나 다른 런처가 Alt+Space를 가로채면 Espanso 설정에서 검색 단축키를 바꾸거나 충돌하는 앱의 단축키를 해제하세요.
match/base.yml 열기
PowerShell이나 명령 프롬프트에서 espanso edit를 실행하면 기본 편집기로 match/base.yml을 엽니다. espanso path 명령을 사용하면 구성과 match 폴더의 실제 위치를 확인할 수 있습니다.
파일을 다른 확장자로 저장하거나 YAML 들여쓰기를 탭으로 만들면 읽지 못할 수 있습니다. .yml 형식과 공백 들여쓰기를 유지하고 저장 뒤 로그에 구문 오류가 없는지 확인하세요.
주소 자동 입력 만들기
matches 목록 아래에 trigger를 :addr, replace를 실제 주소 문구로 지정합니다. 기존 항목과 같은 두 칸 들여쓰기를 지켜 저장하면 Espanso가 구성을 다시 읽습니다.
메모장에서 :addr를 입력하고 구분 문자를 누릅니다. 주소 전체로 바뀌면 새 match가 정상이며, 바뀌지 않으면 트리거 중복과 YAML 오류를 먼저 확인합니다.
여러 줄 문구 등록
메일 서명이나 반복 답변은 YAML의 여러 줄 문자열을 사용해 줄바꿈을 유지할 수 있습니다. replace 뒤에 | 기호를 쓰고 다음 줄부터 동일한 추가 들여쓰기로 문장을 입력합니다.
저장한 뒤 메모장에서 각 줄이 원하는 위치에 들어가는지 확인하세요. 대상 앱이 서식을 다시 적용하면 일반 텍스트 입력과 클립보드 방식 설정을 비교합니다.
날짜 자동 입력
Espanso date 확장을 사용하면 오늘 날짜나 현재 시간을 지정한 형식으로 넣을 수 있습니다. trigger와 replace에 변수를 연결하고 vars에서 type을 date로 지정합니다.
날짜 형식과 시간대가 다르면 format, locale과 tz 값을 확인합니다. 출력 결과를 파일명에 쓸 때는 슬래시나 콜론처럼 Windows에서 허용되지 않는 문자를 피하세요.
앱별로 match 제한
같은 트리거를 모든 프로그램에서 쓰지 않으려면 app-specific 설정을 사용해 실행 파일이나 앱 식별자별 구성을 나눌 수 있습니다. 코드 편집기 전용 스니펫과 메일 전용 서명을 분리할 때 유용합니다.
대상 앱 이름을 추측하지 말고 espanso log나 앱 정보 확인 기능에서 실제 식별자를 확인하세요. 잘못된 필터는 match가 전혀 실행되지 않는 원인이 됩니다.
Espanso Hub 패키지 설치
공식 Espanso Hub에는 이모지와 공용 스니펫 패키지가 있습니다. espanso install 패키지명으로 설치하고 match 목록과 패키지 문서를 확인합니다.
패키지의 트리거가 개인 match와 겹칠 수 있으므로 설치 직후 자주 쓰는 콜론 조합을 시험하세요. 사용하지 않는 패키지는 제거해 검색 결과와 충돌을 줄입니다.
트리거가 글자 중간에서 실행될 때
트리거는 일반적으로 단어 경계와 함께 사용하지만 옵션에 따라 단어 안에서도 실행될 수 있습니다. 너무 짧은 트리거는 일반 문장과 충돌하므로 :addr처럼 구분하기 쉬운 접두사를 사용하세요.
원치 않는 확장이 생기면 해당 match의 word 옵션과 트리거를 바꾸고 같은 문장을 다시 입력합니다. 여러 match가 같은 트리거를 쓰지 않는지도 확인하세요.
확장된 문구가 일부만 입력될 때
일부 앱은 키 입력 속도나 클립보드 붙여넣기를 제한해 긴 문구가 잘릴 수 있습니다. 메모장에서는 정상인지 비교하고 Espanso의 inject mode 또는 clipboard mode 설정을 앱에 맞게 바꿉니다.
암호 입력창, 관리자 권한 앱과 원격 데스크톱에서는 보안 경계 때문에 확장이 차단될 수 있습니다. Espanso를 불필요하게 관리자 권한으로 상시 실행하지 말고 앱 권한 수준을 맞춰 시험하세요.
구성 저장 후 반영되지 않을 때
espanso status로 서비스 상태를 확인하고 espanso restart로 다시 불러옵니다. 이어 espanso log에서 YAML 줄 번호, 중복 키와 잘못된 필드 메시지를 찾습니다.
오류 난 파일 전체를 지우기보다 마지막에 추가한 match를 잠시 주석 처리해 정상 상태로 되돌립니다. 수정 전 base.yml 사본을 보관하면 빠르게 비교할 수 있습니다.
트레이 아이콘이 없을 때
작업 관리자에서 Espanso 프로세스와 시작 프로그램 상태를 확인합니다. 설치형을 썼는데 재부팅 후 시작하지 않으면 espanso service 관련 명령과 Windows 시작 앱 설정을 확인하세요.
포터블 ZIP은 폴더 이동이나 자동 시작 등록 상태에 따라 실행 경로가 끊길 수 있습니다. 새 위치에서 직접 실행하고 구성 경로가 그대로인지 espanso path로 확인합니다.
한글 입력과 구분 문자 문제
한글 입력기 조합 중에는 영문 트리거가 확정되기 전에 입력이 바뀔 수 있습니다. 영문 입력 상태에서 콜론 트리거를 시험하고 확장 후 한글 문구가 정상인지 확인하세요.
트리거 끝의 구분 문자가 필요하면 Space나 Enter까지 입력합니다. 즉시 실행이 필요할 때는 match 옵션을 바꾸되 일반 문장과 충돌하지 않는 긴 트리거를 사용하세요.
비밀정보를 match에 넣지 않기
base.yml과 패키지 파일은 일반 텍스트이므로 비밀번호, API 키와 복구 코드를 replace에 저장하지 마세요. 화면 공유와 구성 백업 과정에서 그대로 노출될 수 있습니다.
반복 로그인 정보는 전용 비밀번호 관리 프로그램의 자동 입력 기능을 사용하고 Espanso에는 공개 가능한 문구, 서명과 템플릿만 저장합니다.
Forms로 입력값 받기
고정 문구 일부만 매번 바뀐다면 Espanso Forms를 사용해 이름, 날짜와 선택 목록을 입력받을 수 있습니다. match의 replace에 폼 변수를 넣고 vars에서 type을 form으로 지정하면 트리거 실행 시 입력 창이 열립니다.
폼 필드 이름과 replace의 변수 이름이 정확히 같아야 합니다. 기본값과 선택 항목을 짧게 구성하고 메모장에서 폼을 열어 확인과 취소 동작, 최종 문장 줄바꿈을 각각 시험하세요.
구성 파일 백업과 다른 PC 이동
espanso path로 표시되는 config와 match 폴더를 함께 복사하면 직접 만든 스니펫을 보관할 수 있습니다. 이동 전 Espanso를 중지하고 YAML 파일이 완전히 저장된 상태에서 폴더를 복사하세요.
다른 PC에서는 같은 버전의 Espanso를 설치한 뒤 폴더 구조를 확인하고 필요한 match 파일만 옮깁니다. 운영체제별 앱 식별자와 스크립트 경로는 달라질 수 있으므로 기본 텍스트 match부터 확인한 뒤 고급 설정을 적용하세요.
직접 만든 :addr 확장 완료
espanso edit로 base.yml을 열고 :addr 트리거와 주소 문구를 추가해 저장합니다. 메모장에서 :addr와 구분 문자를 입력해 전체 주소로 바뀌는지 확인하세요.
Alt+Space 검색 바에서도 새 항목을 찾아 입력할 수 있으면 설치, 구성 읽기와 텍스트 확장이 정상입니다. 구성 파일을 안전하게 백업한 뒤 다른 반복 문구를 추가하세요.
자주 묻는 질문
Espanso는 무료인가요?
네. GPL-3.0 라이선스의 무료 오픈소스 프로그램입니다.
Windows에서는 어떤 파일을 받나요?
일반 PC는 Espanso-Win-Installer-x86_64.exe를 받고 설치 없이 쓰려면 포터블 ZIP을 선택합니다.
문구는 어디에 저장되나요?
match 폴더의 base.yml 같은 로컬 YAML 파일에 저장됩니다.
검색 바는 어떻게 여나요?
기본 단축키 Alt+Space를 누릅니다. 다른 앱과 충돌하면 설정에서 바꾸세요.
설치 후 무엇을 확인하나요?
:espanso가 Hi there!로 바뀌는지 확인한 뒤 직접 만든 :addr 트리거를 시험하세요.
:addr를 입력해 자동 확장을 확인하세요
Espanso를 실행하고 base.yml에 :addr 문구를 저장한 뒤 메모장에서 트리거를 입력하세요. 전체 주소로 바뀌고 Alt+Space 검색에서도 찾을 수 있으면 설치와 기본 구성이 완료됩니다.
공식 자료와 확인일
Espanso 공식 릴리스 · Espanso 시작 문서 · Espanso match 기본 문서 | 2026-09-30T22:00:37.177253+09:00
