얼불춤(A Dance of Fire and Ice) 전용 macOS 키뷰어 오버레이
| 🎮 게임 전용 오버레이 | 얼불춤이 활성화될 때만 자동 표시, 다른 앱 전환 시 자동 숨김 |
| 🖱️ Click-through | 오버레이 위 마우스 클릭이 게임으로 그대로 전달 |
| ⌨️ 키 바인딩 자유 설정 | 키 추가 / 변경 / 삭제, 드래그로 순서 변경 |
| 📊 실시간 통계 | CUR(초당 입력) · TOT(총 입력, 영구 누적) |
| 🔢 누름 횟수 카운트 | 각 키별 누른 횟수 표시 |
| 🧩 그리드 레이아웃 | 열 수·간격 자유 설정 (가로 / 세로 / 2×2 그리드 등) |
| 📍 위치 자유 설정 | 프리셋 6종 + X/Y 좌표 직접 입력 + 드래그 |
| 🌈 스타일 커스텀 | 강조 색상·불투명도·셀 크기 실시간 조절 |
| 🚀 로그인 자동 시작 | Mac 켜면 백그라운드에서 자동 실행 |
| 🖥️ Universal Binary | Apple Silicon / Intel 모두 지원 |
DMG를 열고 ADOFAI MACVIEWER.app을 Applications 폴더로 드래그하면 설치 완료입니다.
전역 키 캡처를 위해 반드시 필요합니다.
시스템 설정 → 개인 정보 보호 및 보안 → 손쉬운 사용
→ ADOFAI MACVIEWER 스위치 ON
→ 앱 재시작
설정 창 상단의 키보드 인식 권한 섹션에서 허용 여부를 언제든 확인할 수 있습니다.
얼불춤을 켜면 오버레이가 자동으로 나타납니다. 다른 앱으로 전환하면 자동으로 숨겨집니다.
로그인 시 자동 시작을 켜두면 Mac을 켤 때마다 백그라운드에서 자동 실행됩니다.
얼불춤이 활성화된 상태에서 오버레이를 드래그해 위치를 조정할 수 있습니다. 설정 → 오버레이 위치에서 프리셋 선택 또는 X/Y 좌표를 직접 입력할 수도 있습니다.
macOS는 앱을 재설치하거나 경로가 바뀌면 기존 권한 항목이 무효화됩니다. 아래 순서로 다시 추가하세요.
1. 기존 항목 제거 (있는 경우)
시스템 설정 → 개인 정보 보호 및 보안 → 손쉬운 사용
→ ADOFAI MACVIEWER 항목 선택 → 하단 [ − ] 버튼으로 삭제
2. ADOFAI MACVIEWER 다시 추가
→ 하단 [ + ] 버튼 클릭
→ Applications 폴더에서 ADOFAI MACVIEWER 선택 → 열기
→ 스위치 ON 확인
3. 앱 완전 재시작
Dock에서 ADOFAI MACVIEWER 우클릭 → 종료
→ 다시 실행
팁: 터미널에서 한 번에 권한 DB를 초기화할 수도 있습니다.
tccutil reset Accessibility com.yourname.adofai-macviewer이후 앱을 다시 실행하면 권한 요청 안내가 다시 나타납니다.
- 설정 → 키보드 인식 권한 섹션에서 초록 체크 표시 확인
- 체크가 있는데도 안 된다면 앱을 완전히 종료 후 재시작
- 그래도 안 되면 위의 "기존 항목 제거 → 다시 추가" 과정을 반복
Dock 아이콘 우클릭 또는 클릭 → 설정… 으로 진입합니다.
| 항목 | 설명 |
|---|---|
| 키보드 인식 권한 | 현재 권한 상태 확인 및 시스템 설정 바로가기 |
| 키 배치 | 드래그로 키 순서 변경, 키 추가·삭제 |
| 그리드 레이아웃 | 열 수(가로·세로·그리드), 셀 간격, CUR/TOT 위치 설정 + 실시간 미리보기 |
| 오버레이 위치 | 6가지 프리셋 · X/Y 좌표 직접 입력 · 드래그 이동 |
| 외형 | 불투명도·셀 너비/높이·강조 색상 |
| 시작 옵션 | 로그인 시 자동 시작 |
| 설정 관리 | JSON 내보내기 / 가져오기 / TOT 초기화 / 전체 초기화 |
가로 (4열 1행) 세로 (1열 4행) 2×2 그리드
┌──┬──┬──┬──┐ ┌──┐ ┌──┬──┐
│← │→ │CUR│TOT│ │← │ │← │→ │
└──┴──┴──┴──┘ ├──┤ ├──┼──┤
│→ │ │CUR│TOT│
├──┤ └──┴──┘
│CUR│
├──┤
│TOT│
└──┘
- macOS 13 Ventura 이상
- Apple Silicon 또는 Intel Mac
- 손쉬운 사용(Accessibility) 권한
| 언어 | Swift 5.9 |
| UI | SwiftUI + AppKit |
| 전역 키 캡처 | NSEvent.addGlobalMonitorForEvents |
| 앱 감지 | NSWorkspace 알림 |
| 레이아웃 | LazyVGrid (그리드 자유 배치) |
| 설정 저장 | UserDefaults + Codable |
| 빌드 | xcodegen + xcodebuild |
| 배포 | hdiutil (DMG) |