macOS Auto Network Switch (Ethernet ↔ Wi‑Fi)

잠자기/깨우기 이후 유선(USB LAN) 연결이 끊기거나, 유선이 다시 연결돼도 Wi‑Fi에서 자동으로 돌아오지 않는 문제를 겪는 사용자를 위한 안정성 중심 자동 전환 스크립트입니다.

• ✅ 유선 우선(Ethernet 우선) + 자동 전환
• 🔔 전원/네트워크 변경 알림(사운드 포함)
• 🧾 날짜별 로그 + 7일 자동 정리
• 🧠 상태 변화 감지(중복 방지)로 CPU 부하 최소화
• 🧩 (선택) 전원 기준 VPN 제어

---

이 프로젝트는 어떤 문제에서 출발했나요?

• 잠자기에서 깬 뒤 유선(USB LAN)이 끊긴 채로 복구되지 않음
• Wi‑Fi도 종종 끊겨 재시작해야만 다시 연결되는 경우가 있음
• 유선이 다시 꽂혀도 macOS가 즉시/확실하게 유선 우선 전환을 재시도하지 않는 느낌
• 현재 어떤 네트워크(유선/무선)를 쓰는지 사용자가 즉시 알기 어려움

---

빠른 시작(정답지 스타일)

설치는 INSTALL.md를 그대로 따라하면 됩니다.
“명령어는 ✅ 입력 박스만 복사해서 붙여넣기” 규칙으로 작성돼 있습니다.

• 📦 설치: INSTALL.md
• 🔔 커스터마이즈: CUSTOMIZE.md
• 🧹 제거/원복: UNINSTALL.md

---

기능(왜 넣었나요?)

• 유선 우선: 유선 연결 감지 시 Wi‑Fi OFF
• 자동 대체: 유선이 끊기면 Wi‑Fi ON + 지정 SSID 연결 시도
• 상태 변화 감지 + 중복 방지: 이전 상태와 같으면 즉시 종료
• 알림(사운드 포함): 전원/네트워크 전환 시 알림
• 로그 기록: 날짜별 로그 파일 생성
• 로그 자동 정리: 7일 지난 로그 자동 삭제(하루 1회)
• (선택) 전원 기준 VPN 제어

---

자주 묻는 질문(FAQ) / 문제 해결

Q1. 설치했는데 알림이 안 떠요.

1. LaunchAgent가 로드됐는지 확인:

✅ 입력(회색 박스 전체를 복사 → 터미널에 붙여넣기 → Enter):

launchctl list | grep com.auto.network.switch

2. plist 경로 확인:
   /Users/YOUR_USERNAME/auto-network-switch.sh에서 YOUR_USERNAME가 본인 사용자로 바뀌었는지 확인하세요.

3. 스크립트 실행 권한 확인:

✅ 입력(회색 박스 전체를 복사 → 터미널에 붙여넣기 → Enter):

ls -l ~/auto-network-switch.sh

x가 없다면:

✅ 입력(회색 박스 전체를 복사 → 터미널에 붙여넣기 → Enter):

chmod +x ~/auto-network-switch.sh

---

Q2. /auto-network-switch.sh 오류가 떠요.

앞에 /를 붙이면 “최상위 폴더”에서 찾습니다.
올바른 실행은 아래입니다.

✅ 입력(회색 박스 전체를 복사 → 터미널에 붙여넣기 → Enter):

bash ~/auto-network-switch.sh

---

Q3. 로그는 어디에 쌓이나요?

홈 폴더에 날짜별로 생성됩니다.

• ~/auto-network-switch-YYYY-MM-DD.log

---

Q4. 개인 정보가 수집되나요?

아니요. 로컬에서만 동작하며 외부 전송 기능이 없습니다.

---

안전성/원복

• 시스템 파일을 수정하지 않습니다(사용자 홈 폴더 내부만 사용).
• 제거는 UNINSTALL.md대로 진행하면 완전 원복됩니다.

---

라이선스

MIT License (LICENSE 참고)