HA Desktop Widget 3.11.0 무료 다운로드·설치, PC에서 스마트홈 기기 제어하기
Home Assistant 기기를 Windows PC의 작은 위젯에서 확인하려면 개발자 GitHub의 v3.11.0 릴리스에서 HA-Desktop-Widget-3.11.0-win-x64-Setup.exe를 무료로 받을 수 있습니다. 설치 뒤에는 기존 Home Assistant 서버 주소를 입력하고 브라우저에서 연결을 승인해야 실제 기기가 표시됩니다.
HA Desktop Widget 3.11.0 Windows 공식 파일
Windows 설치형 파일은 이름이 win-x64-Setup.exe로 끝납니다. 같은 릴리스의 Portable.exe는 설치 없이 쓰는 별도 실행 파일이며, .blockmap과 latest.yml은 설치 파일이 아닙니다.
Windows x64 파일 구별하기
v3.11.0 공식 릴리스의 설치형 Windows 파일은 HA-Desktop-Widget-3.11.0-win-x64-Setup.exe입니다. 게시된 크기는 115,582,592바이트로 약 115.6MB입니다. 같은 릴리스 목록에 있는 win-x64-Portable.exe는 설치 없이 사용하는 별도 실행 파일입니다. 이 글은 Windows 시작 메뉴에서 사용할 설치형 Setup.exe 기준으로 안내합니다.
macOS에는 universal.dmg·zip, Linux에는 AppImage·deb 등이 올라와 있습니다. 운영체제 이름이 다른 파일을 Windows에서 선택하지 마세요. Setup.exe.blockmap이나 latest.yml도 보이지만 일반 사용자가 설치를 시작할 파일은 아닙니다. 릴리스 번호가 바뀐 뒤에는 현재 버전의 파일명과 운영체제를 다시 비교하세요.
프로그램은 MIT 라이선스의 무료 오픈소스입니다. 다만 이 앱만 설치해서 스마트홈 서버가 생기지는 않습니다. 컴퓨터에서 평소 접속하는 Home Assistant 주소와 로그인 권한이 있어야 연결할 수 있습니다. 설치 전 그 주소를 브라우저에서 열어 두면 다음 단계에서 사용할 정확한 http 또는 https 주소와 포트를 확인하기 쉽습니다.
설치 후 Home Assistant 연결하기
설치 파일을 저장해 Windows에서 설치를 마친 뒤 HA Desktop Widget을 엽니다. Settings에서 Home Assistant URL에 평소 브라우저로 접속하는 서버 주소를 넣고 Connect를 누르세요. 개발자는 브라우저 승인 방식을 기본 절차로 안내합니다. 시스템 브라우저가 열리면 자신의 Home Assistant 계정으로 로그인하고 앱의 접근을 승인합니다. 비밀번호를 위젯의 입력칸에 직접 넣는 방식이 아닙니다.
브라우저 승인을 마치면 위젯으로 돌아와 연결 상태를 확인합니다. 처음 연결하는 사람에게는 방이나 기기를 골라 첫 Quick Access 페이지를 만드는 안내가 나타날 수 있습니다. 방을 선택하고 미리보기에 나타난 기기 이름을 살핀 다음 페이지를 추가하세요. 건너뛰었다면 Quick Access의 +에서 원하는 조명이나 센서를 검색해 직접 추가할 수 있습니다.
조명 타일이 나타났다면 현재 상태를 확인하고 실제 조명이 맞는지 살펴보세요. 밝기 조절을 지원하는 조명은 상세 창에서 슬라이더나 비율 단추를 사용할 수 있습니다. 서버에 등록된 기기와 위젯의 이름이 같아야 혼동을 줄일 수 있습니다. 먼저 한 기기를 확인한 뒤 자주 쓰는 기기를 늘리면 연결 문제도 빨리 구분할 수 있습니다.
- 공식 v3.11.0 릴리스에서 Windows x64 Setup.exe 파일명을 확인하고 저장합니다.
- 설치를 마친 뒤 위젯 Settings에 자신의 Home Assistant 주소를 입력하고 Connect를 누릅니다.
- 시스템 브라우저에서 로그인과 연결 승인을 완료합니다.
- Quick Access에 조명 하나를 추가하고 실제 기기의 상태와 표시가 맞는지 확인합니다.
설치 후 연결되지 않거나 상태가 비어 있을 때
Connect가 진행되지 않으면 같은 PC의 브라우저에서 서버 주소가 열리는지 먼저 확인하세요. 브라우저에서도 열리지 않는다면 서버의 네트워크 연결과 입력한 주소, http/https, 포트를 살펴봐야 합니다. 브라우저에서는 열리는데 위젯만 연결이 끊긴다면 Settings의 Reconnect with Home Assistant를 사용해 승인을 다시 진행하세요.
연결은 되었지만 Quick Access가 비어 있다면 아직 기기를 추가하지 않았을 수 있습니다. 첫 설정의 방·기기 안내를 사용하거나 Quick Access의 +에서 엔티티를 선택하세요. 기기를 골랐는데 unavailable이라고 보이면 Home Assistant 서버 화면에서도 같은 상태인지 확인합니다. 서버와 위젯의 상태가 다르면 앱을 다시 열고 재연결을 확인하세요.
화면이 무겁게 느껴지면 Quick Access에 넣은 엔티티 수를 줄이고 투명 효과를 꺼 보세요. 공식 문제 해결 문서의 권장 점검 항목입니다. 어떤 단계에서 멈췄는지 기록해 두면 서버 접속 문제, 브라우저 승인 문제, 개별 기기 상태 문제를 나눠 확인할 수 있습니다. 계속 반복되면 Settings의 View Logs에서 로그 위치를 찾을 수 있습니다.
자주 묻는 질문
Windows 설치형 파일 이름은 무엇인가요?
HA-Desktop-Widget-3.11.0-win-x64-Setup.exe입니다. 공식 v3.11.0 GitHub 릴리스에서 확인하세요.
Portable.exe도 함께 받아야 하나요?
아니요. 같은 프로그램을 설치 없이 사용하는 별도 Windows 파일입니다. 설치형을 쓸 때 둘 다 받을 필요는 없습니다.
Home Assistant 서버가 없어도 기기를 제어할 수 있나요?
아니요. 기존 서버에 등록된 기기와 접속 권한이 필요합니다. 이 앱은 서버를 설치하거나 기기를 자동 등록하지 않습니다.
로그인 창이 위젯에 뜨지 않습니다.
Connect 뒤 시스템 기본 브라우저가 열리는 방식입니다. 서버 주소가 PC 브라우저에서 열리는지 확인하고, 필요하면 Settings에서 다시 연결하세요.
연결 후 기기가 보이지 않습니다.
Quick Access에 엔티티를 추가했는지 확인하세요. 추가했는데 unavailable이면 먼저 Home Assistant 서버 화면의 기기 상태를 살펴보세요.
마무리
Windows x64 PC에서는 HA Desktop Widget 3.11.0의 Setup.exe 파일을 선택하세요. 설치 뒤 자신이 쓰는 Home Assistant 주소로 연결하고 브라우저에서 승인을 마치면 Quick Access에 첫 조명을 추가할 수 있습니다. 브라우저에서 서버가 열리지 않으면 주소와 네트워크를 먼저 확인하고, 서버에는 들어가는데 위젯만 멈췄다면 Settings에서 재연결을 시도하세요.