/ Published in Gümrük Malları

Maccy 백업과 복원: 설정, 고정 항목, 클립보드 기록을 안전하게 옮기는 방법

Maccy 백업과 복원: 설정, 고정 항목, 클립보드 기록을 안전하게 옮기는 방법

빠른 답변: Maccy에는 원클릭 내보내기 기능이 없습니다. 하지만 Maccy App가 저장하는 데이터는 복사할 수 있는 두 곳에 모여 있습니다. 설정이 담긴 환경설정 파일, 그리고 클립보드 기록과 고정 항목이 담긴 작은 SQLite 데이터베이스입니다. Maccy Mac를 종료한 뒤 두 가지를 안전한 폴더에 복사해 두고, 복원할 때는 Maccy Clipboard를 실행하기 전에 원래 위치에 되돌려 놓으면 됩니다. 설정만 백업한다면 defaults 명령어 한 줄로도 내보낼 수 있습니다.

Maccy는 실제로 무엇을 저장하고, 무엇을 백업해야 할까?

Maccy는 로컬 우선(local-first) 방식이라 계정도 없고, 문제가 생겼을 때 기댈 클라우드 사본도 없습니다. 데이터는 오직 내 Mac에만 존재합니다. 데이터는 세 개의 층으로 나뉘며, 층마다 다루는 방법이 다릅니다.

구분 들어 있는 내용 백업할 가치 방법
설정 전역 단축키, 기록 개수, 무시 목록, 외관, 붙여넣기 동작 예, 항상 defaults export 또는 .plist 파일 복사
고정 항목 재사용하려고 고정해 둔 스니펫 예. 직접 골라 모은 것이라 다시 만들기 어렵습니다 데이터베이스 복사
클립보드 기록 최근에 복사한 모든 내용 대개 아니요. 일시적인 데이터이고 민감한 내용이 많습니다 데이터베이스 복사 (선택)

고정 항목과 기록은 같은 데이터베이스를 공유하기 때문에 한쪽만 따로 백업할 수는 없습니다. 고정 항목만 남기고 싶다면 데이터베이스를 복원한 뒤 메뉴에서 고정되지 않은 항목을 지우면 됩니다.

0단계: 어떤 빌드의 Maccy를 쓰고 있나요?

이 튜토리얼에서 가장 중요한 단계입니다. 빌드마다 파일 위치가 다르기 때문입니다. Mac App Store 버전은 Apple의 샌드박스 안에서 실행되어 데이터가 컨테이너 폴더로 옮겨집니다. 반면 GitHub나 Homebrew(brew install maccy)로 설치한 빌드는 샌드박스가 아닙니다.

App Store (샌드박스) GitHub / Homebrew
데이터 폴더 ~/Library/Containers/org.p0deje.Maccy/Data/Library/Application Support/Maccy/ ~/Library/Application Support/Maccy/
환경설정 파일 ~/Library/Containers/org.p0deje.Maccy/Data/Library/Preferences/org.p0deje.Maccy.plist ~/Library/Preferences/org.p0deje.Maccy.plist

어느 쪽인지 모르겠다면 터미널에서 ls ~/Library/Containers | grep -i maccy를 실행해 보세요. org.p0deje.Maccy가 출력되면 샌드박스 빌드입니다. 아무것도 나오지 않으면 ~/Library/Application Support/Maccy/를 확인하면 됩니다. (라이브러리 폴더는 Finder에서 기본적으로 숨겨져 있습니다. 이동 → 폴더로 이동…을 선택하고 경로를 붙여넣으세요.)

Maccy 설정 백업하는 법

방법 A: defaults 명령어 (비샌드박스 빌드)

Maccy의 환경설정은 org.p0deje.Maccy defaults 도메인에 저장됩니다. 다음 명령어로 이동 가능한 파일로 내보낼 수 있습니다.

defaults export org.p0deje.Maccy ~/Desktop/maccy-settings.plist

환경설정 파일을 그대로 복사하는 것보다 깔끔한 방법입니다. macOS가 마지막으로 디스크에 기록한 내용이 아니라 현재 적용 중인 값을 읽어 오기 때문입니다.

방법 B: plist 파일 직접 복사 (두 빌드 모두 가능)

먼저 메뉴 막대의 Maccy 아이콘에서 Maccy를 종료한 다음, 위 표의 경로에서 환경설정 파일을 복사하세요. 종료가 중요한 이유는 macOS가 환경설정을 메모리에 캐시해 두었다가 종료할 때 내가 복사한 파일이나 복원한 파일을 덮어쓸 수 있기 때문입니다.

App Store 사용자 주의: defaults export는 샌드박스 컨테이너가 아니라 일반 환경설정 위치를 읽기 때문에, 샌드박스 빌드에서는 빈 값이나 오래된 값이 나올 수 있습니다. 이 빌드에서는 방법 B를 사용하세요.

고정 항목과 클립보드 기록 백업하는 법

  1. Maccy를 완전히 종료하세요. 앱이 실행 중일 때는 데이터베이스가 계속 사용되고 있습니다.
  2. 사용 중인 빌드의 데이터 폴더를 엽니다 (위 표 참고).
  3. Maccy 폴더 전체를 복사하세요. 파일 하나만 골라 복사하면 안 됩니다. WAL 모드의 SQLite 데이터베이스는 최근 기록을 보조 파일(보통 메인 .sqlite 파일 옆의 -wal, -shm)에 보관하기 때문에, 메인 파일만 백업하면 가장 최근에 고정한 항목이 조용히 빠질 수 있습니다.
  4. 안전한 곳에 붙여넣으세요. maccy-2026-10-21처럼 폴더 이름에 날짜를 넣어 두면 좋습니다.
  5. Maccy를 다시 실행합니다.

비샌드박스 빌드에서 쓸 수 있는 간단한 한 줄 스크립트입니다.

osascript -e 'quit app "Maccy"'
cp -R ~/Library/Application\ Support/Maccy ~/Desktop/maccy-backup-$(date +%F)
open -a Maccy

같은 Mac 또는 새 Mac에서 Maccy 복원하는 법

  1. Maccy를 설치하세요. 경로가 같아지도록 이전과 같은 배포 채널로 설치하고, 폴더가 생성되도록 한 번 실행한 뒤 다시 종료합니다.
  2. 데이터베이스 복원: Maccy 데이터 폴더의 내용을 백업해 둔 사본으로 교체합니다.
  3. 설정 복원:
    • 비샌드박스: defaults import org.p0deje.Maccy ~/Desktop/maccy-settings.plist
    • 두 빌드 공통: 저장해 둔 .plist 파일을 환경설정 경로의 파일 위에 덮어 복사합니다.
  4. 환경설정 캐시를 비웁니다: killall cfprefsd
  5. Maccy를 다시 실행하고 단축키로 열어 보세요. 고정 항목과 설정이 돌아와 있을 겁니다.
  6. 권한을 다시 허용하세요. macOS는 손쉬운 사용 권한을 설치된 앱에 묶어 두기 때문에, 새 Mac에서는 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용에서 Maccy를 켜야 자동 붙여넣기가 동작합니다.

샌드박스 빌드와 비샌드박스 빌드 사이를 옮기는 경우에는 파일을 새 빌드의 해당 경로에 복사하면 됩니다. 형식은 같고 위치만 다릅니다. 다만 먼저 복사본으로 테스트해 보시길 권합니다.

자동화하기: 타임머신과 간단한 스크립트

타임머신이 켜져 있다면 이미 이 문제는 해결되어 있습니다. 두 데이터 위치 모두 홈 폴더의 Library 안에 있고, 타임머신은 기본적으로 이를 포함하기 때문입니다. 복원하려면 Maccy를 종료한 상태에서 Finder로 해당 폴더를 열고 타임머신에 들어가 이전 시점의 Maccy 폴더를 가져오면 됩니다. 대부분의 사용자에게는 이것이 백업 전략의 전부입니다.

dotfiles 관리나 새 Mac 체크리스트용으로 의도적으로 가져갈 수 있는 사본을 만들고 싶다면, 설정만 백업하는 스크립트가 가장 적당합니다.

#!/bin/bash
# Maccy 설정만 백업 (비샌드박스 빌드)
mkdir -p ~/Backups/maccy
defaults export org.p0deje.Maccy ~/Backups/maccy/settings-$(date +%F).plist

설정 파일은 용량이 작고 민감한 정보가 없어서 dotfiles 저장소에 넣어도 안전합니다. 데이터베이스는 그렇지 않습니다.

다들 놓치는 부분: 백업 파일은 민감 정보 덩어리입니다

클립보드 데이터베이스는 내가 복사한 모든 것의 일기장입니다. API 키, 주소, 개인 메시지 일부, 때로는 비밀번호까지 들어 있을 수 있습니다. Maccy는 비밀번호 관리자가 숨김 처리한 복사 내용을 무시하지만, 이는 출처 앱이 제대로 동작한다는 전제에 달려 있습니다. 데이터베이스는 그에 걸맞게 다루세요.

  • Git에 커밋하지 마세요. 공유 클라우드 폴더에 올리는 것도 안 됩니다.
  • 암호화해서 보관하세요. 암호화한 디스크 이미지(디스크 유틸리티 → 새로운 이미지 → 빈 이미지, 암호화 옵션 선택)나 FileVault로 보호되는 볼륨을 사용하면 됩니다.
  • 고정 항목만 백업하는 방법도 고려해 보세요. 데이터베이스를 복원하고 Maccy 메뉴를 연 다음 지우기로 고정되지 않은 기록을 삭제합니다. 백업을 공유하기 전에는 필요 없는 내용을 정리하세요.
  • 오래된 사본은 삭제하세요. 6개월 전 백업에는 그때 복사했던 모든 민감 정보가 그대로 들어 있습니다.

이것이 로컬 우선 도구의 솔직한 트레이드오프입니다. 내 데이터를 쥐고 있는 서버가 없다는 건 프라이버시 측면에서 큰 장점이지만, 그만큼 파일을 제대로 관리할 책임도 나에게 있다는 뜻입니다.

복원이 안 될 때

증상 추정 원인 해결 방법
가져오기(import) 후에도 설정이 바뀌지 않음 macOS 환경설정 캐시 Maccy를 종료하고 killall cfprefsd를 실행한 뒤 다시 실행
복원 후 기록이 비어 있음 다른 빌드의 폴더이거나, 메인 데이터베이스 파일만 복사함 경로 표를 다시 확인하고, 보조 파일까지 포함해 폴더 전체를 복사
고정 항목은 보이는데 최근 것이 빠져 있음 Maccy가 실행 중일 때 백업함 Maccy를 완전히 종료한 상태에서 백업을 다시 진행
단축키는 되는데 자동 붙여넣기가 안 됨 새로 설치한 앱에 손쉬운 사용 권한이 없음 개인정보 보호 및 보안 → 손쉬운 사용에서 Maccy 허용
복원한 설정이 종료하면 원래대로 돌아감 파일을 복사할 때 Maccy가 실행 중이었음 파일을 만지기 전에는 항상 Maccy를 종료

정리하면

설정은 자주 백업하세요. 간단하고 부담도 없습니다. 데이터베이스는 보관할 가치가 있는 고정 항목이 있을 때만 백업하고, 언제나 Maccy를 종료한 상태에서 진행하세요. 기록이 포함된 백업은 반드시 암호화하세요. 이것이 전체 체계이고, 처음 해 보는 데 2분 정도면 충분합니다.

Maccy는 무료 오픈소스이므로, 사용 환경에서 이 글의 설명과 다르게 동작하는 부분이 있다면 프로젝트의 GitHub 이슈에서 최신 동작을 확인해 보세요. 여러분에게 더 중요한 건 설정인가요, 고정 항목인가요? 고정 항목이라면 고정 항목 정리 가이드를 이어서 읽어 보시길 추천합니다.

자주 묻는 질문

Maccy에 내보내기/가져오기 기능이 내장되어 있나요?

제가 알기로는 없습니다. 그래서 이 튜토리얼에서는 파일 복사와 defaults 명령어를 사용합니다.

Maccy는 iCloud로 클립보드 기록을 동기화하나요?

아니요. Maccy는 모든 데이터를 로컬에 저장하며 동기화 서비스가 없습니다. Apple의 유니버설 클립보드는 기기 간에 현재 클립보드 내용을 공유해 주지만, 이는 별개의 시스템 기능이고 동기화된 기록을 만들어 주지는 않습니다.

Maccy는 Mac의 어디에 데이터를 저장하나요?

GitHub와 Homebrew 빌드는 ~/Library/Application Support/Maccy/에, Mac App Store 빌드는 ~/Library/Containers/org.p0deje.Maccy/ 안에 저장합니다.

타임머신이 Maccy 기록도 백업해 주나요?

네. 두 위치 모두 사용자 Library 폴더 아래에 있고, 타임머신은 별도로 제외하지 않는 한 이를 기본으로 포함합니다.

고정 항목만 따로 백업할 수 있나요?

단독으로는 불가능합니다. 고정 항목과 기록은 하나의 데이터베이스를 공유합니다. 데이터베이스를 백업한 뒤, 깨끗한 상태가 필요하면 복원 후에 고정되지 않은 항목을 지우세요.