Hawadaar는 macOS 메뉴 막대에서 Panasonic MirAIe 에어컨을 조작하는 앱이다. 실내 온도를 확인하고 설정 온도와 운전 모드, 팬 속도, 풍향을 바꿀 수 있으며, MirAIe 계정에 등록된 에어컨 사이를 전환할 수 있다.
메뉴 막대에는 에어컨의 설정 온도가 표시되고, 아이콘을 클릭하면 전원, 16~30°C 온도 조절 슬라이더, 운전 모드, 팬 속도, 풍향, 에코 모드, 강력 운전, 표시등을 제어할 수 있다. 풍향 애니메이션은 실제 루버 움직임을 따라간다. 스윙을 켜면 좌우로 움직이고, L1~L5를 선택하면 각도가 바뀐다.
리모컨이나 MirAIe 앱에서 바꾼 설정은 1~2초 안에 Hawadaar에 반영된다. 앱은 에어컨이 보고하는 Wi-Fi 신호 세기를 보여 주며, 신호가 약하면 경고하고 연결이 끊긴 기록을 남긴다. 제작자에 따르면 앱은 SwiftUI로 만들었고 별도 의존성이 없으며, 크기는 1MB 미만이다. Apple Silicon과 Intel 맥을 지원한다.
설치와 사용 조건
최신 릴리스에서 Hawadaar-x.y.z.zip을 내려받아 압축을 푼 뒤, Hawadaar.app을 Applications 폴더로 옮긴다.
앱은 아직 Apple 공증을 받지 않았다. 처음 실행하면 “Apple could not verify Hawadaar”라는 경고가 표시된다. Done을 누른 다음 macOS 버전에 맞게 한 번 허용해야 한다.
- macOS 15 Sequoia 이상: 시스템 설정의 개인정보 보호 및 보안으로 이동해 아래쪽에 있는 Hawadaar 옆의 Open Anyway를 누르고 확인한다.
- macOS 14 Sonoma:
Hawadaar.app을 마우스 오른쪽 버튼으로 클릭하고 Open을 선택한 뒤 다시 Open을 누른다. - 모든 버전에서 터미널을 이용하려면 다음 명령을 실행한다.
xattr -dr com.apple.quarantine /Applications/Hawadaar.app
메뉴 막대의 에어컨 아이콘을 클릭하고 MirAIe 앱에서 사용하는 휴대전화 번호(또는 이메일 주소)와 비밀번호로 로그인한다. Hawadaar는 하루 한 번 새 버전을 확인한다. 업데이트가 있으면 패널에서 Update를 누르면 앱이 내려받기, 검증, 설치를 진행한 뒤 재시작하므로 다시 다운로드할 필요가 없다.
사용 조건은 macOS 14 Sonoma 이상과 MirAIe 앱에 설정된 에어컨이다. 인도에서 주로 판매되는 MirAIe 앱 제어 Panasonic 에어컨을 지원한다. 전 세계용 Comfort Cloud 앱을 사용하는 Panasonic 모델은 별도 시스템이라 지원하지 않는다. 인터넷 연결도 필요하다. MirAIe 에어컨은 Panasonic 클라우드를 통해 제어되므로 Hawadaar 역시 MirAIe 앱처럼 인터넷을 사용한다.
계정과 연결 문제
MirAIe 비밀번호는 macOS 키체인에 저장되며 MirAIe 자체 서버로만 전송된다고 제작자는 설명한다. 앱에는 분석 기능이나 자체 서버가 없고, 코드는 공개돼 있다.
에어컨 연결이 자주 끊기면 패널 아래쪽의 AC Wi-Fi에서 신호 세기를 확인할 수 있다. 약 −75 dBm보다 약한 신호는 주황색으로 표시되며, 연결이 끊길 가능성이 높다고 안내한다. ⋯ 메뉴에서 Open Connection Log를 열면 에어컨이 오프라인이 된 시각을 확인할 수 있다. 공유기 바로 옆에서도 신호가 약하다면 에어컨의 Wi-Fi 모듈에 점검이 필요할 수 있다.
소스 빌드와 프로젝트 정보
소스에서 빌드하려면 Xcode 16 또는 Xcode 16용 Command Line Tools가 필요하며, Swift 6을 사용한다.
git clone https://github.com/abdulghanitech/hawadaar.git
cd hawadaar
make run # build build/Hawadaar.app and launch it
make test # run the unit tests
make zip # universal (Apple Silicon + Intel) release zip in build/
MirAIe 프로토콜 코드는 HawadaarCore 라이브러리에, 메뉴 막대 앱은 Hawadaar에 있다. 프로토콜 문서에는 엔드포인트, MQTT 토픽, 명령 필드가 설명돼 있다. Hawadaar 제작기에서는 프로토콜, Wi-Fi 조사, App Store 외부 배포를 다룬다.
MirAIe 프로토콜은 커뮤니티가 밝혀냈으며, Hawadaar는 rkzofficial/miraie-ac와 selvakk2k/miraie-ac-in의 연구를 바탕으로 한다. Hawadaar는 Panasonic과 제휴하거나 승인을 받은 프로젝트가 아니다. Panasonic과 MirAIe는 각 소유자의 상표이며, 앱은 사전 고지 없이 바뀔 수 있는 비공식 API를 사용한다. 라이선스는 MIT다.
향후 계획에는 수면 모드, 지원 모델의 수평 스윙, 일정 및 타이머, macOS 위젯과 단축어 액션, 공증된 빌드와 Homebrew 지원이 포함돼 있다. 아이디어와 기여를 환영하며, 논의하려면 저장소에 이슈를 열 수 있다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요