트렌드깃허브 · 쇼핑에서 뜬 것, 매일 07:30 · English

깃허브 · 2026년 11월 8일 기준 · 깃허브에서 보기 →

mbillow/localthings

삼성 가전을 로컬에서 제어하는 통합 도구

최근 30일 가운데 하루 트렌딩

삼성 가전을 인터넷 없이 내 집 네트워크에서 직접 제어하는 방법

세탁기나 냉장고가 인터넷을 끊어도 제어가 멈추지 않는 장면을 상상해 보세요. LocalThings는 홈 어시스턴트와 삼성 가전을 직접 연결해 클라우드 서버를 거치지 않고 명령을 주고받게 합니다. 이 도구는 가전의 IP 주소만 알면 자동으로 종류와 모델을 파악해 필요한 버튼과 센서를 만들어 줍니다.

클라우드 없이 동작하는 원리

LocalThings는 가전이 사용하는 표준 프로토콜인 OCF와 CoAP를 활용해 통신합니다. 데이터는 DTLS 암호화 세션을 통해 오가며, 가전이 상태를 변경하면 즉시 알려주는 푸시 업데이트를 지원합니다. 나머지 가전은 30초마다 상태를 확인합니다. 설정이 끝난 후에는 삼성 서버에 접속하지 않으므로 인터넷이 끊겨도 제어가 가능합니다. 다만 가전 자체는 삼성 서버와의 연결을 유지하므로, 스마트싱스 앱에서 가전을 삭제하면 네트워크 설정이 초기화될 수 있습니다.

지원하는 가전과 제어 범위

2022년 이후 출시된 대부분의 삼성 가전과 일부 구형 모델이 지원됩니다. 세탁기, 건조기, 냉장고, 에어컨, 오븐, 로봇 청소기, 공기청정기 등이 포함되며, 멀티 스플릿 에어컨의 각 실외기나 듀얼 오븐의 각 구획도 개별 장치로 인식합니다. 가전이 보고하는 정보에 따라 전원, 모드 선택, 시작/중지, 온도, 남은 시간, 문 상태, 에너지 사용량 등을 제어하거나 확인할 수 있습니다. 특정 모델은 읽기 전용으로만 지원될 수 있으며, 오븐이나 전자레인지처럼 원격 시작이 불가능한 모드도 있습니다.

설치와 초기 설정 과정

HACS에서 LocalThings를 검색해 설치하거나, custom_components/localthings/ 폴더를 홈 어시스턴트 설정 폴더에 복사해 넣습니다. 홈 어시스턴트를 재시작한 후, 설정 > 장치 및 서비스 > 통합 추가에서 LocalThings를 선택합니다. 가전의 IP 주소를 입력하면 LocalThings가 자동으로 연결되어 장치 정보를 읽어옵니다. 첫 가전 추가 시 삼성 서버에 한 번 접속해 공개 식별자를 가져오지만, 이후 추가는 인터넷 없이 IP 주소만으로 가능합니다. 일부 구형 가전은 TCP 8888 포트를 사용하며, 이 경우 장치 토큰 입력이 필요합니다.

사용 전 확인해야 할 사항

가전이 스마트싱스에 등록되어 있어야 네트워크 설정이 유지됩니다. 스마트싱스에서 가전을 삭제하면 Wi-Fi 설정이 초기화되어 재설치가 필요합니다. 일부 세탁기와 건조기는 스마트싱스에 연결되지 않으면 에너지 사용량 기록이 멈출 수 있습니다. 또한 가전은 동시에 하나의 연결만 허용하므로, 다른 장치가 가전에 연결되어 있으면 LocalThings가 연결을 끊을 수 있습니다. IP 주소가 변경된 경우, MAC 주소를 보고하는 가전은 자동으로 감지되지만 그렇지 않은 가전은 수동으로 재설정해야 합니다.

AI가 이 저장소의 README를 읽고 2026년 11월 7일에 쓴 글입니다. 사실관계는 깃허브 원문이 기준입니다.

숫자로 본 저장소

깃허브 트렌딩 기록
트렌드가 기록을 시작한 2026년 6월 19일 ~ 11월 8일 가운데 하루 · 처음 오른 날 11월 7일 · 일간 최고 12위(11월 7일)

2026년 11월 8일 기준으로 깃허브에서 읽은 숫자입니다.

언어
Python
주제 태그
coap-protocol · coap-server · custom-component · dtls · hacs · hacs-integration · home-assistant · home-automation
별
1,143
기여자
53
포크
117
최근 릴리스
v0.37.0 · 2026년 11월 8일
커밋
1,173
마지막 커밋
2026년 11월 8일
열린 이슈
72
열린 PR
10

함께 보면 좋은 저장소

깃허브에서 보기 →

README에 달기

trend.ondo.sh · 깃허브 일간 트렌딩 12위 · 2026년 11월 7일 trend.ondo.sh · GitHub daily trending #12 · November 7, 2026

위 배지는 이 저장소가 2026년 6월 19일 이후 깃허브 일간 트렌딩에서 가장 높이 오른 순위와 그날을 보여 줍니다. README의 언어에 맞는 줄을 붙여 넣으세요. 배지를 누르면 이 페이지가 열리고, 저장소가 더 높이 오르면 배지도 저절로 바뀝니다.

한국어 README

[![trend.ondo.sh](https://trend.ondo.sh/github/r/mbillow--localthings/badge.svg)](https://trend.ondo.sh/github/r/mbillow--localthings/)

영어 README

[![trend.ondo.sh](https://trend.ondo.sh/github/r/mbillow--localthings/badge.en.svg)](https://trend.ondo.sh/github/r/mbillow--localthings/en.html)