Home

SmartThings PC Control은 SmartThings와 텔레그램에서 Windows PC의 전원을 제어하는 Windows 서비스 + 트레이 앱입니다. SmartThings 쪽은 이 프로젝트의 전용 Edge 드라이버가 맡습니다.

English readers: see Home-EN.

5분 시작하기

1. 설치 — Releases에서 smartthings-pc-control.exe를 받아 C:\Program Files\SmartThings PC Control\에 두고 실행 → 설정 탭 → 서비스 관리 → [설치] → UAC 승인. (설치와 첫 설정)
2. 시크릿 — 설정 탭에서 시크릿을 정하고 **[저장]**합니다.
3. SmartThings — Protomothis 채널(초대 링크)에 가입해 드라이버 SmartThings PC Control을 설치합니다. PC와 PC Control이 켜진 상태에서 SmartThings 앱의 **[주변 기기 검색]**으로 장치를 추가하고, 장치 설정에 시크릿을 넣습니다. (SmartThings Edge 드라이버)
4. 텔레그램(선택) — @BotFather로 봇을 만들고 알림 탭에 토큰과 Chat ID를 넣습니다. (텔레그램)

SmartThings에서 온 종료·재시작·절전·최대 절전은 기본 5분 유예 뒤 실행되며, 그동안 Windows 토스트·트레이·예약 탭·텔레그램·SmartThings 앱에서 취소할 수 있습니다. (원격 명령 유예와 예약)

문서

페이지	내용
설치와 첫 설정	다운로드, 설치 위치, 서비스 설치, 시크릿, 방화벽, 제거
데스크톱 앱 가이드	6개 탭, 저장 바, 트레이 아이콘
SmartThings Edge 드라이버	채널 가입, 장치 추가, 화면·명령·예약, 자동화, 환경설정, Wake-on-LAN
여러 PC 설정	PC가 두 대 이상일 때 — 장치 구분, MachineGuid 복제, 봇 하나 = PC 하나
원격 명령 유예와 예약	유예 시간, 취소 경로, 예약 탭, 단일 예약 슬롯
텔레그램	봇 연결, 알림, 명령과 버튼, 절전·재부팅 시 동작
알림 카테고리와 조용한 시간대	21개 이벤트, 보안 집계, 조용한 시간대와 요약, /mute
설정 파일 레퍼런스	config.json 전체 키, state.json, 로그 파일
CLI와 API 레퍼런스	exe 하위 명령, /st/v1 API(5001), 로컬 API(5002)
자동 업데이트와 서명	확인 주기, 서명 검증, 실패 시 동작, 수동 교체
보안	시크릿, WebUI 노출, 텔레그램 허용 목록, 토큰 암호화
문제 해결과 FAQ	연결·검색·WoL·토스트·텔레그램·업데이트 문제와 로그
아키텍처	(개발자용) 패키지 배치, 이벤트 버스, 빌드·릴리스