# 맥(macOS)에서 사용하기

Windows용 `AutoClicker.exe` 는 맥에서 실행되지 않습니다.
맥에서는 아래 두 방법 중 하나로 사용하세요. 코드(`autoclick_gui.py`)는 Windows/맥 공용입니다.

---

## 준비물

1. **Python 3** — 터미널에서 확인:
   ```bash
   python3 --version
   ```
   없으면 https://www.python.org 에서 설치하거나 `brew install python`.

2. 이 폴더의 파일 중 맥에 필요한 것:
   `autoclick_gui.py`, `target.png`, `config.json`,
   `requirements_mac.txt`, `run_mac.command`, `build_mac.command`

---

## ⚠️ 가장 중요 — 권한 2가지 (안 하면 절대 작동 안 함)

**시스템 설정 → 개인정보 보호 및 보안** 에서:

1. **화면 기록(Screen Recording)** — 화면을 캡처해 이미지를 인식하려면 필요.
2. **손쉬운 사용(Accessibility)** — 마우스를 움직이고 클릭하려면 필요.

두 항목 모두에서, 실행에 쓰는 앱을 **허용(체크)** 해야 합니다:
- 터미널로 실행 → **터미널(Terminal)** 을 추가/허용
- `.app` 으로 빌드해 실행 → **AutoClicker.app** 을 추가/허용

> 권한을 바꾼 뒤에는 터미널/앱을 **완전히 껐다가 다시 실행**해야 적용됩니다.

---

## 방법 A) 스크립트로 바로 실행 (간단)

1. **터미널** 을 엽니다.
2. 이 폴더로 이동 후 실행:
   ```bash
   cd /파일이/있는/폴더
   chmod +x run_mac.command      # 최초 1회만
   ./run_mac.command
   ```
   (또는 Finder 에서 `run_mac.command` 우클릭 → 열기)

   최초 실행 시 필요한 패키지(opencv, numpy, mss, pyautogui)가 자동 설치됩니다.

3. GUI 창에서 **활성화** 를 누르면 동작합니다.

---

## 방법 B) 독립 실행 앱(.app) 만들기 (남에게 주기 좋음)

맥에서 아래를 실행하면 `dist_mac/AutoClicker.app` 이 생성됩니다:
```bash
chmod +x build_mac.command    # 최초 1회만
./build_mac.command
```
- `AutoClicker.app` 과 같은 폴더에 `target.png`, `config.json` 이 함께 있어야 합니다.
- 처음 열 때 "확인되지 않은 개발자" 경고가 뜨면: 앱 우클릭 → **열기** → **열기**.
- 위의 **권한 2가지**를 AutoClicker.app 에 대해 허용하세요.

> 참고: `.app` 은 반드시 **맥에서** 빌드해야 합니다(윈도우에서 맥용 빌드 불가).

---

## 맥에서 달라지는 점 (자동 처리됨)

- 클릭: Windows(Win32) → 맥은 **Quartz/pyautogui** 백엔드로 자동 전환.
- **레티나 디스플레이**: 화면이 2배 해상도로 캡처되는 것을 자동 보정하여 정확한 위치를 클릭합니다.
- 좌표계도 자동 변환되므로, 영역 지정·이미지 캡처를 맥에서 새로 해주면 가장 정확합니다.

---

## 잘 안 될 때

- **클릭이 안 됨** → 손쉬운 사용 권한 확인 + 앱 재시작.
- **신뢰도가 계속 낮음** → 화면 기록 권한 확인. 그리고 **맥에서 직접** `화면에서 캡처` 로 target.png 를 다시 만드세요(윈도우에서 만든 이미지는 폰트/렌더링이 달라 안 맞을 수 있음).
- **오류 로그** → 폴더의 `debug.log` 파일 내용을 확인하세요.
