Repolode
0xProbabillity

0xProbabillity/house-control

집을 실시간 3D 모델로 보여주고 Smart Life, Home Assistant, Hue, Apple Home을 통해 조명과 에어컨을 제어하는 메뉴 막대 및 iPhone 앱입니다.

대체할 수 있는 제품:Apple Home

스타
691
포크
100
열린 이슈
12
마지막 커밋
5일 전

어떤 프로젝트인가요?

House Control은 방, 벽, 문, 창문, 가구가 포함된 평면도를 JSON 파일 하나로 구성된 3D 장면으로 그려 줍니다. 램프는 장면을 밝히고, 작동 중인 에어컨은 바람의 흐름을 보여 줍니다. 조명을 켜고 끄거나 밝기를 조절하고, 색상과 백색 온도를 설정할 수 있습니다. 에어컨의 전원, 목표 온도, 모드, 팬 속도도 조절할 수 있으며, 탭 한 번으로 집 전체에 적용하는 장면도 설정할 수 있습니다.

이 앱은 Three.js 웹 UI를 감싸는 네이티브 셸입니다(macOS에서는 AppKit, iPhone에서는 SwiftUI 사용). Smart Life / Tuya, Home Assistant, Philips Hue, Apple Home의 기기를 연결할 수 있으며, 한 집에서 여러 플랫폼의 기기를 함께 사용할 수 있습니다. 로그인하지 않아도 모든 기기가 시뮬레이션되므로 앱을 먼저 사용해 볼 수 있습니다. 시각적 편집기에서 방을 그린 다음 각 램프나 에어컨을 실제 기기에 연결할 수 있습니다.

Mac 앱과 iPhone 앱은 QR 코드로 로컬 네트워크에서 페어링할 수 있으며, 서버 없이 TLS를 통해 평면도를 동기화합니다. 이 프로젝트는 메뉴 막대 아일랜드와 위젯도 제공하며, 비공개 링크나 MCP를 통해 AI 어시스턴트가 조명과 에어컨을 제어할 수 있도록 하는 AI Access 모드도 지원합니다.

핵심 기능

  • 01JSON 파일 하나로 구성하는 3D 평면도. 램프가 장면을 밝힘
  • 02조명(켜기/끄기, 밝기 조절, 색상)과 에어컨(전원, 온도, 모드, 팬) 제어
  • 03Smart Life/Tuya, Home Assistant, Philips Hue, Apple Home을 한 집에서 연결
  • 04하드웨어나 로그인 없이 완전히 시뮬레이션 모드로 실행
  • 05QR 코드 페어링을 통해 로컬 네트워크에서 Mac 앱과 iPhone 앱 동기화
  • 06iPhone 위젯, 잠금 화면 및 제어 센터 제어 기능

활용 사례

  • 다른 앱을 열지 않고 Mac 메뉴 막대에서 조명과 에어컨 제어
  • Hue, Home Assistant, Tuya 기기를 한 인터페이스에서 함께 사용하는 집 관리
  • 비공개 링크를 통해 AI 어시스턴트에 집 안 기기의 제한된 제어 권한 제공
  • 실제 하드웨어를 연결하기 전에 평면도 계획 및 시각화

빠른 시작

  1. 1

    Releases 페이지에서 HouseControl DMG를 다운로드합니다

  2. 2

    저장소를 클론합니다

    git clone https://github.com/0xProbabillity/house-control.git
  3. 3

    프로젝트 폴더에서 앱을 빌드합니다

    cd house-control && ./scripts/build-app.sh
  4. 4

    빌드한 앱을 열고 메뉴 막대에 집 아이콘이 있는지 확인합니다

    open build/HouseControl.app

사용 전 알아둘 점

  • 메뉴 막대 앱은 macOS 13 이상에서만 실행되며, iPhone 앱에는 iOS 17 이상이 필요합니다.
  • 앱은 공증되지 않았으므로 처음 실행할 때 macOS가 차단하며 수동으로 허용해야 합니다.
  • 소스에서 빌드하려면 Xcode Command Line Tools와 Node.js 20.19 이상 또는 22.12 이상이 필요합니다.

토픽

자주 묻는 질문

house-control은(는) 무엇인가요?
집을 실시간 3D 모델로 보여주고 Smart Life, Home Assistant, Hue, Apple Home을 통해 조명과 에어컨을 제어하는 메뉴 막대 및 iPhone 앱입니다. House Control은 방, 벽, 문, 창문, 가구가 포함된 평면도를 JSON 파일 하나로 구성된 3D 장면으로 그려 줍니다. 램프는 장면을 밝히고, 작동 중인 에어컨은 바람의 흐름을 보여 줍니다. 조명을 켜고 끄거나 밝기를 조절하고, 색상과 백색 온도를 설정할 수 있습니다. 에어컨의 전원, 목표 온도, 모드, 팬 속도도 조절할 수 있으며, 탭 한 번으로 집 전체에 적용하는 장면도 설정할 수 있습니다.
house-control은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
house-control은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
house-control은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. house-control의 마지막 커밋은 2026년 10월 16일입니다.
house-control은(는) 어디에 사용할 수 있나요?
다른 앱을 열지 않고 Mac 메뉴 막대에서 조명과 에어컨 제어 Hue, Home Assistant, Tuya 기기를 한 인터페이스에서 함께 사용하는 집 관리 비공개 링크를 통해 AI 어시스턴트에 집 안 기기의 제한된 제어 권한 제공 실제 하드웨어를 연결하기 전에 평면도 계획 및 시각화
house-control는 어떻게 설치하나요?
Releases 페이지에서 HouseControl DMG를 다운로드합니다 저장소를 클론합니다: git clone https://github.com/0xProbabillity/house-control.git 프로젝트 폴더에서 앱을 빌드합니다: cd house-control && ./scripts/build-app.sh 빌드한 앱을 열고 메뉴 막대에 집 아이콘이 있는지 확인합니다: open build/HouseControl.app
house-control은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/0xProbabillity/house-control

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트