HASS.Agent

소개

HASS.Agent는 비공식 개발 프로젝트로, Home Assistant 플랫폼과 연동하여 알림 표시 및 빠른 조작 기능을 제공하는 Windows 프로그램입니다.

주요 기능

• 알림 입력 화면을 통해 사용자 정의 알림을 표시합니다.
• 경고 알림 화면에서 공기 중 미세먼지 농도 등 센서 정보를 시각적으로 보여줍니다.
• 빠른 조작 버튼을 통해 Home Assistant 엔티티(예: 조명)를 토글하거나 켤 수 있습니다.
• 새 빠른 조작 설정 화면에서 도메인, 엔티티, 동작 등을 구성하고 저장할 수 있습니다.

지원 환경

Windows 운영 체제에서 winget을 통해 설치 및 실행할 수 있습니다.

기본 사용법

1. winget 명령어로 HASS.Agent를 설치합니다.
2. 프로그램을 실행하고 알림 입력 화면에서 제목과 내용을 입력하여 테스트 알림을 확인합니다.
3. 경고 알림 화면에서 센서 데이터를 확인하거나, 빠른 조작 버튼을 눌러 연결된 Home Assistant 장치를 제어합니다.
4. 새 빠른 조작 설정 화면에서 도메인(예: Light), 엔티티, 원하는 동작 등을 선택하고 저장을 눌러 커스텀 조작을 추가합니다.

제한 사항 및 체크포인트

• HASS.Agent는 비공식 프로젝트이므로 공식 지원이 제한될 수 있습니다.
• 스크린샷에서 확인할 수 있듯이 핫키 조합은 기본적으로 비활성화되어 있으며, 수동으로 설정해야 할 수 있습니다.
• 모든 Home Assistant 기능이 구현되지 않았을 수 있으며, 주요 알림 및 빠른 조작에 중점을 둡니다.

자주 묻는 질문 (FAQ)

• Q: HASS.Agent는 공식 Home Assistant 제품인가요?
  A: 아닙니다. 이는 커뮤니티에서 만든 비공식 개발 프로젝트입니다.
• Q: winget으로 업데이트는 어떻게 하나요?
  A: winget upgrade hass.agent 명령어로 최신 버전을 확인할 수 있습니다.
• Q: 알림이나 빠른 조작이 작동하지 않을 경우 어떻게 해야 하나요?
  A: Home Assistant 서버 연결 상태와 토큰 설정을 확인하고, 필요 시 프로그램을 다시 시작해 보세요.

화면으로 보는 주요 기능

알림 입력 화면

HASS.Agent 앱의 알림 창으로, 'This is a test notification!'라는 제목과 22:11 시간이 표시된다. 알림 내용은 검은색과 흰색 고양이가 꽃을 만지는 사진이며, 그 아래 'Notification Input Title'이라는 라벨과 'Notification Input Text'라는 입력 필드가 있다. 하단에는 'Yes'와 'No' 두 개의 버튼이 있다.

경고 알림 화면

HASS.Agent 앱의 경고 알림 창으로, 'HASS.Agent Test'라는 제목과 'ALERT: The amount of particles in the air is now very high.'라는 경고 메시지가 표시된다. 메시지 아래에는 '1 µm: 11 µg/m3', '2.5 µm: 21 µg/m3', '10 µm: 21 µg/m3'라는 공기 중 미세먼지 농도 정보가 나열되어 있다.

빠른 조작 화면

'Quick Actions'라는 제목의 창으로, 세 개의 빠른 조작 버튼이 있다. 각 버튼은 흰색 전구 아이콘과 함께 '[TOGGLE] Attic Light', '[TOGGLE] Wall Light', '[ON] Hallway Light'라는 라벨을 가지고 있다.

새 빠른 조작 설정 화면

'New Quick Action' 설정 창으로, 왼쪽에는 'domain' 목록이 있고, 'Light'가 선택되어 있다. 오른쪽에는 'entity' 필드에 'hallway_light', 'desired action' 드롭다운에서 'On'이 선택되어 있고, 'description' 필드에 'Hallway Light'가 입력되어 있다. 'hotkey combination' 필드는 'None'이며, 'enable hotkey' 체크박스는 선택되지 않았다. 하단에는 'store quick action' 버튼이 있다.