Keyboard Maestro 매크로 백업·복구 체크리스트: 새 Mac 이전부터 검증까지

새 Mac 책상 앞에서 늘 쓰던 단축키를 눌렀어요. 화면은 조용했고, 기대한 앱도 열리지 않았습니다. Keyboard Maestro 편집기를 확인하니 매크로 목록은 그대로 보였어요. 그런데 파일 정리 자동화와 보고서 생성만 중간에서 멈췄습니다. 목록이 있다는 사실만으로는 안심하기 어려운 순간이에요. 예전에 Mac 교체 직전 매크로 파일만 챙겼다가 변수 값과 외부 스크립트 경로를 다시 맞추느라 반나절을 쓴 적이 있습니다. 백업 파일의 존재만 확인하고 복원 시험을 생략했을 때는 장애 대응도 길어졌어요. 이 Keyboard Maestro 매크로 백업·복구 체크리스트는 보존할 범위를 정하고, 안전한 순서로 복구하고, 실제 실행 결과까지 확인하는 흐름을 담았습니다. 제품 버전에 따라 메뉴 이름과 화면 구성은 달라질 수 있으니 현재 버전의 표시도 함께 확인하세요.

복구 목표부터 네 가지로 나눠 보세요

첫 점검은 무엇을 되살릴지 정하는 일입니다. 동료에게 자동화 하나를 전달하는 경우와 새 Mac에 작업 환경 전체를 옮기는 경우는 준비물이 달라요. 여러 Mac을 계속 쓰는 상황도 별도 운영 규칙이 필요합니다.

• ☐ 한두 개를 공유한다면 선택 내보내기를 기준으로 삼아요.
• ☐ 새 Mac으로 매크로 이전을 한다면 전체 데이터와 외부 자산을 함께 조사해요.
• ☐ 두 대를 계속 운영한다면 매크로 동기화의 교체 범위와 충돌 규칙을 기록해요.
• ☐ 장애 시점으로 돌아가야 한다면 독립 백업과 복원 이력도 준비해요.

저는 이 구분을 배포 계획 첫 줄에 적습니다. “업무 매크로 전체와 실행에 필요한 자산”처럼 목적을 한 문장으로 써 두면 백업 방법을 고르기 쉬워요. .kmmacros 파일의 보존 범위를 과대평가하면 변수와 경로가 빈칸으로 남을 수 있습니다.

백업 전에 실행 조건을 인벤토리로 남기세요

백업 전 기록은 복구 때의 답안지예요. 날짜, Mac 이름, macOS 버전, Keyboard Maestro 버전을 한 줄에 남깁니다. 기기 식별에는 사용자가 알아볼 수 있는 이름과 모델 정도면 충분해요. 라이선스 번호나 계정 정보는 캡처에 넣지 않습니다.

• ☐ 활성화된 Macro Group과 특정 앱에서만 켜지는 그룹을 구분해요.
• ☐ 자주 쓰는 단축키, Typed String, 시간·로그인 트리거를 적어요.
• ☐ 영구 전역 변수 가운데 복구에 필요한 이름과 값을 확인해요.
• ☐ Named Clipboard가 텍스트나 이미지를 공급하는 액션을 찾아요.
• ☐ 셸 스크립트, AppleScript, 문서, 폴더, 앱 경로를 목록화해요.
• ☐ 손쉬운 사용, 자동화, 입력 모니터링 등 실제 사용 권한을 기록해요.

영구 전역 변수는 디스크에 저장되어 재시작 뒤에도 유지됩니다. 비밀번호 성격의 semi-permanent 변수는 메모리에만 머무르므로 일반 파일 백업으로 되살릴 수 있다고 보면 곤란해요. API 키와 토큰은 변수 목록, 화면 캡처, 파일명에 드러내지 마세요. 비밀값은 조직에서 정한 보안 저장소와 재발급 절차로 관리합니다.

내보낸 매크로는 읽을 수 있는 형태로 관리하세요

선택한 매크로나 Macro Group은 File 메뉴의 내보내기 기능으로 .kmmacros 파일을 만들 수 있어요. 그룹별 파일은 공유와 부분 복구에 편합니다. 전체 매크로를 폴더 형태로 내보내면 버전 관리나 변경 이력 검토에 활용할 수 있어요. 그 결과물의 용도와 다시 가져올 수 있는 형식인지는 현재 버전에서 확인합니다.

• ☐ 파일명은 2026-10-05-office-mac-km-version처럼 날짜, Mac, 앱 버전을 알아보게 지어요.
• ☐ 작업 Mac과 분리된 외장 저장장치 또는 접근 통제된 저장소에도 복사해요.
• ☐ 파일 크기가 0이 아닌지, 예상한 매크로와 그룹 수가 맞는지 확인해요.
• ☐ 빈 시험 환경에서 안전 가져오기를 수행하고 내용을 열어 봐요.

출처가 확실한 .kmmacros도 안전 가져오기 기능을 사용하면 비활성 상태에서 트리거와 액션을 검토할 수 있습니다. 파일 존재만 확인하고 리허설을 미루면 손상이나 누락을 장애 당일에 발견하게 돼요. 원본은 수정하지 않고 복사본으로 시험하며, 성공 날짜와 확인한 매크로 수를 백업 기록에 추가하세요.

새 Mac으로 전체 환경을 옮길 때 실행 상태를 통제하세요

Keyboard Maestro 공식 안내에 따르면 매크로는 로컬 Mac의 Application Support 영역에 저장됩니다. 전체 정보를 옮길 때는 ~/Library/Application Support/Keyboard Maestro 폴더를 복사하고, 필요에 따라 ~/Library/Preferences/com.stairways.keyboardmaestro.* 파일도 다룰 수 있어요. 구체적인 범위와 주의사항은 공식 설치 백업·이전 안내에서 현재 내용을 확인하세요.

1. 원본 Mac의 최근 백업을 만들고 백업 시각을 기록해요.
2. 원본과 대상 Mac에서 Keyboard Maestro 편집기를 종료해요.
3. 상태 메뉴나 File 메뉴를 이용해 Keyboard Maestro Engine도 종료해요.
4. Application Support 폴더와 선택한 환경설정 파일을 복사해요.
5. 대상 파일과 폴더의 소유자 및 읽기·쓰기 권한을 확인해요.
6. 대상 Mac에서 앱을 실행하고 작은 검증 순서로 넘어가요.

편집기 창을 닫은 뒤에도 Engine이 실행될 수 있으므로 양쪽 Mac에서 각각 확인합니다. 실행 중인 프로세스가 파일을 갱신하면 복사 시점이 섞일 여지가 있어요. 복사 작업 전에는 원본 백업을 유지하세요.

환경설정 파일을 복사하면 MacUUID도 함께 복사되어 두 기기가 동기화 과정에서 같은 Mac으로 인식될 수 있습니다. 기존 Mac을 계속 쓸 계획이라면 환경설정 파일 복사 여부를 신중히 정해요. 앱이 참조하는 셸 도구, 스크립트, 폰트, 네트워크 볼륨은 각각 새 Mac의 실제 경로와 실행 권한을 맞춰야 합니다.

Time Machine은 Mac의 파일과 앱 데이터를 주기적으로 보존하는 상위 백업 계층으로 활용할 수 있습니다. 복구 시점, 제외된 볼륨, 외부 자산의 포함 여부는 따로 확인해요. Keyboard Maestro의 File 메뉴에 있는 Revert Macros도 이전 매크로 상태를 살피는 복구 수단이 될 수 있습니다. 보관 기간은 환경과 버전에 따라 확인하세요.

Macro Syncing을 시작하기 전에 대상 Mac을 보존하세요

매크로 동기화는 여러 Mac에서 같은 매크로 모음을 운영할 때 편리해요. 변경 실수도 동기화될 수 있으므로 독립된 백업 사본을 유지합니다. 공식 Macro Syncing 안내는 동일한 Keyboard Maestro 버전 사이에서 동기화할 것, 동기화가 전체 단위로 동작할 것, 대상 Mac의 기존 매크로가 교체될 수 있음을 경고합니다.

• ☐ 두 Mac의 Keyboard Maestro 버전이 같은지 확인해요.
• ☐ 대상 Mac의 기존 매크로를 별도 .kmmacros 파일로 내보내요.
• ☐ 동기화 파일이 두 기기에 완전히 전달된 뒤 다음 단계를 진행해요.
• ☐ 한 기기의 변경이 반영된 것을 확인한 다음 다른 기기에서 편집해요.
• ☐ 오프라인 작업과 클라우드 동기화 지연을 작업 기록에 표시해요.
• ☐ 동기화 파일도 날짜가 있는 독립 백업에 포함해요.

예전에 두 Mac에서 같은 파일을 열어 둔 채 그룹 이름을 각각 고친 적이 있어요. 어느 변경이 남을지 확신할 수 없어 두 사본을 내보내고 다시 대조해야 했습니다. 그 뒤로는 “편집 중인 Mac”을 한 대만 지정하고, 동기화 완료 시각까지 기록합니다. 특히 iCloud Drive는 반영이 지연될 가능성이 있다는 공식 경고가 있어요. 수정 시각과 실제 매크로 내용을 함께 확인하세요.

Macro Syncing의 이전 범위는 매크로 전체입니다. 환경설정, 변수, Named Clipboard에는 별도의 이전 절차가 필요해요. 파일·앱 참조도 대상 Mac의 같은 경로에 준비되어야 합니다. 새 Mac에 매크로를 한 번 전달하는 용도라면 동기화 파일을 적용한 뒤 동기화를 끄는 흐름도 가능해요. 현재 공식 안내와 화면 문구를 읽고 진행하세요.

복구 직후에는 작은 영향부터 단계별로 실행하세요

Keyboard Maestro 복구 성공은 트리거 발동, 올바른 자산 참조, 예상 결과 기록까지 확인해야 판정할 수 있어요. 가져온 매크로는 우선 비활성 상태에서 살펴봅니다. 출처, 트리거, 파일 변경 액션, 네트워크 전송, 삭제 동작을 확인한 뒤 필요한 항목만 켜세요.

1. 구조 확인: 예상한 Macro Group과 매크로 수를 백업 기록과 대조해요. 그룹의 활성 상태와 특정 앱 조건도 봅니다.
2. 트리거 확인: 단축키가 macOS나 다른 앱과 겹치는지 시험해요. 스케줄, 로그인, 장치 트리거는 조건 충족 여부도 확인합니다.
3. 의존성 확인: 참조 앱 설치 위치, 폴더와 문서 경로, 외부 스크립트의 실행 권한을 점검해요. 사용자 이름이 포함된 절대 경로는 새 계정에서 자주 끊깁니다.
4. 데이터 확인: 필요한 영구 변수와 Named Clipboard의 이름, 형식, 실제 내용을 확인해요. 비밀값은 승인된 절차로 다시 넣습니다.
5. 실행 환경 확인: 로그인 시 Engine 실행 설정과 macOS의 손쉬운 사용, 자동화, 입력 모니터링 등 필요한 보안 권한을 검토해요.
6. 시험 실행: 조회, 알림, 창 이동처럼 되돌리기 쉬운 매크로부터 실행해요. 파일 변경·전송·삭제 작업은 복사한 테스트 데이터와 시험 계정에서 검증합니다.

일부 자동화만 멈춘다면 실패 지점을 한 단계씩 좁혀요. Engine 실행 여부와 Macro Group 활성 조건을 보고, 이어서 트리거 충돌, 변수, 경로, 권한을 확인합니다. 앱 업데이트로 메뉴 이름이나 UI 위치가 바뀐 화면 자동화는 클릭 좌표와 이미지 인식 조건도 다시 살펴야 해요.

오류가 나면 여러 설정을 한꺼번에 변경하지 않습니다. 발생 시각, 실행한 매크로, 실패한 액션, 표시된 오류, 사용한 백업본을 기록해요. 한 번에 한 항목씩 수정하고 같은 테스트 데이터로 재실행합니다. 원본 백업과 대상 Mac의 복구 전 내보내기 파일은 검증이 끝날 때까지 보존하세요. 배포 기록처럼 결과를 남기면 다음 Mac 교체 때 실패 원인을 다시 찾는 시간을 줄일 수 있습니다.

지금 바로 예와 아니요로 복구 준비도를 확인하세요

아래 Keyboard Maestro 매크로 백업·복구 체크리스트에서 각 질문에 예 또는 아니요로 답해 보세요. 하나라도 아니요라면 같은 줄의 보완 작업을 끝낸 뒤 복구를 시작합니다.

• ☐ 매크로 파일과 전체 환경 백업의 범위를 구분했나요? 아니요라면 복구 목표를 공유, 전체 이전, 지속 동기화 중에서 정하고 대상 목록을 다시 써요.
• ☐ 변수·Named Clipboard·외부 파일을 별도로 확인했나요? 아니요라면 각 액션의 참조와 필요한 값, 별도 자산 위치를 인벤토리에 추가해요.
• ☐ 원본과 대상의 Keyboard Maestro 및 macOS 버전을 기록했나요? 아니요라면 두 기기의 버전과 Mac 이름을 백업 날짜 옆에 적어요.
• ☐ 복구 전에 대상 Mac의 기존 매크로를 보존했나요? 아니요라면 동기화나 가져오기를 멈추고 대상 매크로부터 내보내요.
• ☐ 백업 파일을 다른 위치에도 보관했나요? 아니요라면 원본 Mac과 장애를 함께 겪지 않을 저장 위치에 복사해요.
• ☐ 실제 가져오기 또는 복원 테스트를 했나요? 아니요라면 복사본과 격리된 시험 데이터로 파일 열기, 개수 대조, 실행 시험을 진행해요.
• ☐ 트리거, Macro Group, 앱 경로, 보안 권한을 확인했나요? 아니요라면 읽기 전용 매크로부터 조건별로 실행하고 결과를 남겨요.
• ☐ 마지막 성공 복구 날짜와 결과를 기록했나요? 아니요라면 날짜, Mac, 버전, 성공한 매크로, 남은 예외를 한 줄로 기록해요.