Home

SmartThings PC Control은 SmartThings(그리고 원하면 텔레그램)에서 Windows PC의 전원을 제어하는 Windows 서비스 + 트레이 앱입니다. PCControl Edge 드라이버와 100% 호환되며 Remote Shutdown Manager를 그대로 대체합니다. 이 위키는 README보다 자세한 안내서입니다.

English readers: see Home-EN for an English overview. Detailed pages are in Korean for now.

페이지	내용
설치와 첫 설정	다운로드, 권장 위치, 앱/CLI 설치, 서비스 확인, 방화벽, 로그인 자동 시작, 제거
데스크톱 앱 가이드	상태줄, 6개 탭의 모든 컨트롤, 저장 바, 트레이 아이콘
SmartThings 연동	기존 PCControl 드라이버 설정, 명령 URL, 9개 명령, ping, WoL 준비
SmartThings Edge 드라이버	(Protomothis 채널 공개) 전용 드라이버 — 채널 가입, [주변 기기 검색]으로 장치 추가, 상태·조작 두 카드, 명령과 예약, 자동화 예시, 환경설정, 문제 해결
여러 PC 설정	PC가 두 대 이상일 때 — PC별 시크릿·MAC·브로드캐스트, MachineGuid 복제 주의, DHCP와 자동 추적, 봇 하나 = PC 하나
원격 명령 유예와 예약	유예 개념과 시간, 취소 경로, 예약 탭, 단일 슬롯과 출처 표시
텔레그램 알림 설정	봇 만들기, 토큰·Chat ID, 테스트, 토큰 보호, 상세 수준, 메시지 예시
텔레그램에서 PC 제어	제어 켜기, 보안 모델, 명령 레퍼런스, 인라인 버튼, 절전·재부팅 시 동작
알림 카테고리와 조용한 시간대	21개 이벤트 카탈로그, 마스터/개별 체크, 보안 집계, 조용한 시간대와 요약, /mute
자동 업데이트와 서명	확인 주기, 업데이트 대화상자, 서명 매니페스트 검증, 실패 시 동작, gui.log
설정 파일 레퍼런스	config.json 전체 키(`smartthings.*` 포함), state.json, service.log/gui.log, 파일 위치 규칙
CLI와 API 레퍼런스	exe 하위 명령, SmartThings 엔드포인트(5001), Edge 드라이버 API `/st/v1`, WebUI API(5002) 전체 경로
보안	시크릿, WebUI 노출, CSRF, rate limit, 텔레그램 허용 목록, DPAPI, 서명 업데이트
문제 해결과 FAQ	연결·토스트·WoL·텔레그램·업데이트 문제와 로그 보는 법
아키텍처	(개발자용) 패키지 배치, 이벤트 버스, 폴러, 빌드·테스트·릴리스

5분 시작하기

설치 — Releases에서 smartthings-pc-control.exe를 받아 C:\Program Files\SmartThings PC Control\에 두고 더블클릭 → 설정 탭 → 서비스 관리 → [설치] → UAC 승인. (설치와 첫 설정)
시크릿 — 설정 탭에서 시크릿을 정하고 [저장]. 포트는 기본 5001.
SmartThings — 허브에 PCControl Edge 드라이버를 설치하고 PC 디바이스의 IP·포트·시크릿을 같게 맞춥니다. 명령 URL은 http://<PC-IP>:5001/{secret}/{command}. (SmartThings 연동)
- 전용 SmartThings Edge 드라이버 를 쓸 수도 있습니다. Protomothis 채널에 가입해 드라이버를 설치하고, PC를 켜 둔 채 [주변 기기 검색]을 누르면 시크릿만 넣으면 되고, 전원 상태(절전·최대절전·깨우는 중)·유예 카운트다운·예약·취소가 SmartThings 앱에 그대로 보입니다. 기존 방식도 계속 동작하니 옮겨 갈 의무는 없습니다.
텔레그램(선택) — @BotFather에게 /newbot → 토큰 복사 → 새 봇에게 아무 메시지 → 앱 알림 탭에 토큰 붙이기 → [Chat ID 찾기] → [테스트 발송] → "텔레그램 알림 사용" 켬 → [저장]. PC 제어까지 원하면 "텔레그램 명령으로 이 PC 제어 허용"도 켭니다. (텔레그램 알림 설정, 텔레그램에서 PC 제어)

기본으로 SmartThings의 종료/재시작/절전/최대절전 명령은 5분 유예 뒤 실행되며, 그동안 Windows 토스트·트레이·예약 탭·텔레그램에서 취소할 수 있습니다. 즉시 실행하고 싶으면 설정 탭의 "원격 명령 유예"를 "사용 안 함 (즉시 실행)"으로 바꾸세요. (원격 명령 유예와 예약)

설정 탭 알림 탭