프로젝트 소개

Device Activity Telegram Bot은 Windows 기기가 로그인되거나 잠금 해제될 때 Telegram 알림을 보내는 유틸리티입니다. 또한 Telegram 명령을 통해 기기를 원격으로 종료할 수 있습니다. 특징: - 기기 로그인/잠금 해제 시 Telegram 메시지 전송. - `/halt` 명령을 수신하여 기기를 원격으로 종료. - 모든 기기 또는 특정 이름의 기기를 종료할 수 있음. - Python 3.14 이상이 필요함. - 봇 토큰, 채팅 ID, 허용된 사용자 ID를 환경 변수로 구성 가능. - pyenv-win 설정을 위한 Windows용 지침 포함. - ruff, mypy, pytest와 같은 개발 도구 포함. 사용 방법: 1. Python 3.14 및 종속 항목 설치. 2. `.env` 파일에 `BOT_TOKEN`, `CHAT_ID`, 선택적으로 `ALLOWED_USER_IDS` 구성. 3. 알림을 위해 `python -m src.send`, 종료 수신을 위해 `python -m src.halt` 실행. 4. 선택적으로 Windows 작업 스케줄러에 추가하여 자동 시작 가능. 참고: 단일 사용자 설정의 경우 `CHAT_ID`는 사용자 ID여야 합니다. 그룹의 경우 `/halt` 명령 접근을 제한하기 위해 `ALLOWED_USER_IDS`가 필요합니다.