설치 · 사용법

Espanso 설정 백업·복원 — 문구 규칙과 설정 옮기기

한줄 요약

실제 설정 경로를 확인하고 Espanso를 정지한 뒤 설정 폴더의 사본을 날짜별로 보관하세요. 복원할 때는 대상의 현재 상태도 먼저 따로 보존하고, 원래 경로에 백업 내용을 돌려놓은 뒤 재시작해 같은 트리거의 문구가 돌아오는지 확인합니다. 설정 사본만으로 외부 파일·패키지·모든 OS 조건까지 옮겨지는 것은 아닙니다.

1. 기본 정보

대상
이미 만든 Espanso 문구 규칙·설정
경로 확인
espanso path config의 실제 결과
보관 시점
규칙 수정·PC 이전 전 앱 정지 후
완료 기준
복원 파일 확인 + 같은 트리거의 기대 문구

2. 백업·복원 순서

  1. 1. 실제 경로 확인

    설정·패키지·runtime 경로를 구별하고 이번에 보관할 폴더와 외부 참조를 확인합니다.

  2. 2. 사본 보관

    Espanso를 정지한 뒤 설정 폴더 전체를 날짜가 있는 별도 위치에 복사합니다.

  3. 3. 현재 상태 보존·복원

    복원 대상의 현재 설정을 따로 남기고, 백업 내용이 원래 설정 경로에 오도록 돌려놓습니다.

  4. 4. 재시작·대조

    Espanso를 시작하고 같은 시험 트리거로 기대 문구와 동작 설정이 돌아왔는지 확인합니다.

3. 무엇을 보관할까

이 글은 이미 만든 문구 규칙을 수정하기 전 보관하거나 Windows 환경에서 이전 상태로 돌리는 과업입니다. 처음 규칙을 만드는 방법은 Espanso 대표 페이지의 첫 문구 등록에서 확인하세요. 기존 설정을 지우기 전에 읽을 수 있는 백업 사본부터 준비합니다.

설정 사본의 범위
항목 보관 판단
match trigger·replace 등 문구 규칙
config 기본·앱별 동작 설정
외부 이미지·스크립트·별도 파일 규칙이 참조하는 실제 파일과 경로를 따로 확인
패키지 실제 패키지 경로·설치 목록을 별도로 기록
runtime 실행 중 상태·로그 등의 경로. 설정 폴더와 혼동하지 않기

경로가 한곳에 모여 있더라도 역할은 다릅니다. 단순 정적 문구는 설정 사본으로 옮길 수 있지만, 외부 파일·명령·패키지에 의존하는 규칙은 그 항목도 있어야 합니다. 다른 OS로 옮길 때는 파일 경로·권한·지원 기능을 다시 확인해야 합니다.

4. 실제 경로 확인

터미널에서 다음 명령으로 이번 앱이 사용하는 경로를 확인합니다. 명령이 검색되지 않는 포터블은 배포 README에 따라 포터블 폴더의 래퍼를 사용하세요. 경로를 추측해서 다른 프로필을 복사하지 않습니다.

espanso path
espanso path config

Windows의 기본 위치와 별도 설정·포터블 배포의 안내가 실제 실행 경로와 다를 수 있습니다. 실제 명령 결과를 우선하고, 경로·설치 방식·버전과 외부 의존 목록을 백업 메모에 적어 두세요.

5. 사본 만들기

espanso stop
  1. 앱을 정지한 뒤 확인한 설정 폴더를 열고 match와 config 등 내용을 확인합니다.
  2. 설정 폴더 전체를 앱이 읽는 위치 밖의 새 폴더에 복사합니다. 예: 날짜가 붙은 Espanso-backup-날짜 폴더.
  3. 사본에 원래 파일이 들어 있는지, 문구·설정 파일이 비어 있지 않은지 확인합니다. 외부 참조 자료는 구별해서 함께 보관합니다.
  4. 다시 사용할 원본 위치와 날짜별 사본을 구별하고 필요하면 별도 저장장치에 사본을 더 보관합니다. 백업 위치를 앱의 활성 설정 경로로 바꾸지는 않습니다.

명령의 정지는 일시적인 대치 비활성화와 다릅니다. 백업이 끝나면 espanso start로 다시 실행할 수 있습니다. 중요한 설정을 수정할 때는 기존 사본을 덮어쓰지 않고 새 시점의 사본을 남기세요.

6. 현재 상태 보존 후 복원

  1. 복원할 대상에서 실제 설정 경로를 다시 확인합니다. 다른 PC·설치 방식이라면 옛 경로와 같다고 가정하지 않습니다.
  2. Espanso를 정지하고, 대상의 현재 설정 폴더를 복원-직전-날짜 같은 별도 위치에 보존합니다. 백업 원본도 그대로 남깁니다.
  3. 대상의 활성 설정 폴더를 보존용으로 옮긴 뒤, 되돌릴 백업 사본을 원래 설정 경로·이름으로 복사합니다. 서로 다른 규칙을 무작정 병합하지 않습니다.
  4. 폴더가 한 겹 더 중첩되지 않았는지 확인합니다. 앱이 읽는 설정 루트 바로 아래에 예상한 match·config가 있어야 합니다.
  5. 버전·기기별 경로와 외부 참조를 확인한 뒤 Espanso를 시작하고 결과를 대조합니다.
espanso start

이 절차는 백업을 삭제하거나 현재 상태를 영구 제거하는 흐름이 아닙니다. 복원 결과가 맞지 않으면 앱을 정지하고 복원 직전 사본으로 돌아갈 수 있도록 두 사본을 구분해 두세요.

7. 같은 문구로 대조

실제 입력 결과를 확인하기 전에는 파일 복사를 마쳤다는 것과 앱에서 복원이 끝났다는 것을 구별합니다. 중요한 규칙 전체를 바꾸기 전에 가짜 정적 규칙 하나로 과정을 연습하면 경로·중첩·파일 충돌을 찾기 쉽습니다.

시험 사본으로 확인할 순서
단계 기대 결과
백업 전 고유 트리거가 원래 시험 문구로 대치됨
규칙 수정 후 같은 트리거가 바꾼 시험 문구로 대치됨
백업 복원·재시작 후 같은 트리거가 원래 시험 문구로 다시 대치됨

동작 설정을 함께 되돌렸다면 해당 설정도 따로 확인합니다. 정적 문구 한 개의 성공이 모든 한글 입력기·앱·외부 실행 규칙의 완전 복원을 증명하지는 않습니다.

8. 기대한 결과가 아닐 때

먼저 볼 항목
상태 확인
설정을 못 읽음 실제 config 경로·파일 확장자·폴더 중첩
YAML 오류 공백 들여쓰기·따옴표·저장 형식
옛 문구와 새 문구가 함께 나옴 병합하면서 남은 중복 trigger·추가 규칙
문구는 있으나 대치 안 됨 앱 재시작·대치 활성·대상 앱/입력기
일부 규칙만 실패 외부 파일·스크립트·패키지·기기별 경로·권한

기본값으로 초기화하거나 모든 설정을 지우기 전에 읽는 경로와 오류 메시지를 확인하세요. espanso cmd enable은 실행 중인 대치 기능을 켜는 명령으로, 누락된 백업 파일을 복구하지는 않습니다.

9. 백업과 동기화

동기화는 여러 기기의 현재 상태를 맞추는 작업이고, 백업은 이전 시점 사본을 남기는 작업입니다. 잘못 편집한 규칙이 동기화되면 다른 기기에도 반영될 수 있습니다. 클라우드 폴더 하나가 있다는 사실만으로 원하는 시점으로 돌아갈 수 있다고 가정하지 마세요.

공식 동기화 문서에는 환경 변수·링크 등을 쓰는 별도 구성이 있습니다. 이 글의 기본 백업 절차에서는 심볼릭 링크나 실시간 동기화를 새로 설정하지 않습니다. 규칙 보관을 마쳤다면 Espanso의 입력·대치 방식으로 돌아갈 수 있습니다.

10. 자주 묻는 질문

AppData 폴더만 복사하면 되나요?

+

실제 espanso path config 결과가 기준입니다. 포터블·별도 경로·이전 설정에 따라 다를 수 있습니다. match/config 외부의 이미지·스크립트·패키지도 따로 확인하세요.

백업을 현재 설정 위에 덮어쓰면 되나요?

+

현재 상태를 먼저 별도로 보존하고 앱을 정지한 뒤 복원하세요. 무작정 병합하면 새 규칙이나 중복 trigger가 남을 수 있습니다. 백업의 내용이 원래 설정 경로에 오도록 폴더 중첩도 확인합니다.

설정 사본을 옮기면 모든 기기에서 같아지나요?

+

같은 파일이라도 OS·앱·입력기·외부 경로·권한·패키지 조건에 따라 달라질 수 있습니다. 같은 시험 트리거와 실제 사용할 규칙을 각각 점검해야 합니다.

문구만 복원되면 완료인가요?

+

규칙 파일과 실제 대치 결과를 확인하고 함께 보관한 동작 설정도 점검해야 합니다. 정적 문구 한 개 성공을 모든 규칙의 복원으로 일반화하지 않습니다.

출처: Espanso 실제 경로·match/config 역할, Espanso 정지·시작·대치 활성 CLI, Espanso 설정·패키지·runtime와 이동 전 정지

함께 보면 좋은