PixelWatch · 화면 변화 감시기

지정한 화면 영역(예: 카카오톡 대화창)을 감시하다가 픽셀 변화가 감지되면 텔레그램 봇·Windows 토스트로 알려주는 Windows 데스크톱 앱입니다.

주요 기능

• 🖱 영역 직접 지정 · 다중 영역 — 화면을 드래그해 여러 영역을 동시에 감시합니다. (다중 모니터·고DPI 대응)
• 🎚 영역별 개별 옵션 — 영역마다 간격·감도·픽셀 임계값·쿨다운·확인 프레임·이미지 전송·키워드를 따로 설정합니다.
• 🔍 픽셀 변화 감지 — 캡처한 영역의 픽셀을 비교해 변화 비율을 계산합니다.
• 🔤 OCR 키워드 필터 — 변화 화면을 글자 인식(Windows 내장 OCR)해, 지정한 단어가 보일 때만 알림합니다.
• 🔔 텔레그램 + 토스트 알림 — 변화 시 텔레그램 메시지(+캡처 이미지)와 Windows 토스트를 함께 띄웁니다.
• 📲 텔레그램 원격 명령 — 폰에서 봇에게 명령을 보내 전체 모니터 스크린샷을 받거나 감시를 제어합니다.
• 🧠 순간 변화 무시 — 마우스 커서가 지나가는 등 일시적 변화는 무시합니다. 변화가 정지된 상태로 여러 프레임 연속 유지될 때만 알림합니다.
• ☕ 절전 방지 — 감시 중에는 시스템 절전·화면 꺼짐을 막습니다.
• 🖥 모니터 구성 변경 대응 — 모니터를 껐다 켜도 오탐 없이 이어서 감시합니다. 화면 밖으로 벗어난 영역만 건너뛰고, 복귀하면 자동 재개합니다.
• 🗕 트레이 상주 — 창을 닫아도(X) 종료되지 않고 시스템 트레이에서 계속 감시합니다.
• ⬆ 자동 업데이트 — GitHub 릴리즈를 확인해 새 버전을 내려받아 교체·재시작합니다.
• 💾 설정 자동 저장 — 토큰·Chat ID·영역·영역별 옵션을 자동 복원합니다.

사용 방법

1. ＋ 영역 추가 → 감시할 화면 영역을 드래그로 선택합니다. (ESC = 취소) 여러 개 추가할 수 있습니다.
2. 각 영역 카드에서 간격·감도·쿨다운·확인 프레임·키워드 등 옵션을 개별 조정합니다.
3. 텔레그램 준비
   • 텔레그램에서 봇에게 아무 메시지(/start)를 먼저 보냅니다.
   • 자동 감지 버튼을 누르면 Chat ID가 채워집니다.
   • 테스트 알림 보내기로 연결을 확인합니다.
4. 감시 시작 버튼을 누릅니다. 이후 변화가 생기면 알림이 옵니다.
5. 창의 X를 눌러도 트레이에서 계속 실행됩니다. 트레이 아이콘 더블클릭=열기, 우클릭 → 종료=완전 종료.

영역별 감지 옵션

옵션	설명	기본값
간격(ms)	이 영역을 다시 캡처·비교하는 주기	800
쿨다운(초)	한 번 알림 후 다음 알림까지 최소 간격(도배 방지)	15
감도(변화 %)	이 비율 이상 픽셀이 바뀌면 "변화"로 판단	1.0
픽셀 임계값(0-255)	한 픽셀을 "바뀐 것"으로 볼 색상 차이. 낮을수록 민감	30
확인 프레임	변화가 정지 상태로 N회 연속 유지돼야 알림. 클수록 순간 변화 무시	2
이미지 전송	알림에 캡처 이미지를 첨부	켜짐
알림 키워드	쉼표 구분. 지정 시 OCR로 해당 단어가 보일 때만 알림(비우면 모든 변화)	(없음)

커서 통과 등 오탐이 잦다면 → 확인 프레임을 3~4로 올리거나, 감도·픽셀 임계값을 높이세요.

텔레그램 원격 명령

'텔레그램 원격 명령 수신'을 켠 뒤, 봇에게 다음을 보냅니다.

명령	동작
/shot	전체 모니터 스크린샷을 찍어 전송(감시 영역과 무관)
/status	현재 감시 상태·활성 영역 수·버전
/go	감시 시작
/stop	감시 정지
/help	명령 도움말

보안상 앱에 설정된 Chat ID의 발신자만 응답합니다.

OCR 키워드 알림

• Windows 내장 OCR(Windows.Media.Ocr)을 사용해 외부 설치가 필요 없습니다.
• 한국어 인식은 시스템에 한국어 OCR 언어팩이 있어야 합니다: 설정 → 시간 및 언어 → 언어 → 한국어 → 옵션에서 언어 기능(광학 문자 인식) 설치.
• 언어팩이 없으면 키워드 필터를 건너뛰고 모든 변화를 알립니다(무음 실패 방지).
• 공백 무시 매칭: OCR이 한글을 음절로 쪼개 읽어도(토리→"토 리") 키워드가 매칭됩니다.
• 작은 영역 자동 확대: 글씨가 작으면 OCR 전에 확대해 인식률을 높입니다.
• 키워드를 못 찾으면 로그에 OCR이 실제로 읽은 텍스트가 남아 원인 파악이 쉽습니다.

모니터를 껐다 켰을 때

감시 영역 좌표는 가상 화면 기준 절대 물리 픽셀입니다. 모니터 전원을 끄면(특히 DisplayPort) Windows는 이를 모니터 분리로 처리해 가상 화면을 다시 계산하므로, 그 모니터에 있던 영역은 화면 밖 좌표가 됩니다. PixelWatch는 이 상황을 자동으로 처리합니다.

상황	동작
모니터를 껐다가 같은 배치로 복구	캡처를 잠시 멈췄다가, 기준 프레임을 새로 잡고 그대로 이어서 감시
일부 모니터가 꺼진 채 유지	화면 밖 영역만 건너뛰고 나머지는 계속 감시 · 텔레그램으로 통지
해상도·배치가 바뀐 채 복구	영역별로 유효성을 재검사해, 화면 안에 있는 영역은 계속 감시

• 화면 밖 영역은 카드에 화면 밖으로 표시되고, 모니터를 다시 켜면 자동으로 재개됩니다.
• ⚠️ 절전 방지로는 막을 수 없습니다. KeepAwake는 Windows가 스스로 화면을 끄거나 절전에 드는 것만 막습니다. 사용자가 모니터 전원 버튼을 직접 끄는 것은 OS 권한 밖입니다.
• 무슨 일이 있었는지는 로그 파일에서 확인할 수 있습니다: %AppData%\PixelWatch\logs\pixelwatch-yyyyMMdd.log (14일 보관)

요구 사항

• Windows 10 (1809+) / 11
• .NET 8 Desktop Runtime (프레임워크 종속 배포). 미설치 시 실행할 때 안내가 뜹니다. 다운로드: https://dotnet.microsoft.com/download/dotnet/8.0

빌드 / 배포

# 개발 빌드 & 실행
dotnet run -c Debug

# 단일 실행파일(프레임워크 종속) 배포
dotnet publish -c Release -r win-x64 --self-contained false -p:PublishSingleFile=true -o publish

산출물: publish/PixelWatch.exe

구조

detect/
├─ App.xaml(.cs)              앱 진입점 · 전역 예외 처리 · 스타일
├─ MainWindow.xaml(.cs)       메인 UI · 시스템 트레이 · 토스트 · 업데이트 확인
├─ app.manifest               Per-Monitor V2 DPI 인식
├─ Models/
│  ├─ CaptureRegion           감시 영역(물리 픽셀)
│  ├─ WatchRegion             영역별 옵션·미리보기(다중 영역)
│  └─ AppSettings             설정 영속화
├─ Services/
│  ├─ ScreenCaptureService    영역/전체화면 캡처
│  ├─ ChangeDetector          LockBits 기반 고속 픽셀 비교
│  ├─ OcrService              Windows 내장 OCR(키워드 필터)
│  ├─ TelegramService         메시지/사진 전송 · 명령 수신(getUpdates)
│  ├─ KeepAwakeService        절전·화면 꺼짐 방지
│  ├─ DisplayTopologyService  모니터 배치 스냅샷 · 영역 화면 밖 판정
│  ├─ LogFileService          진단 로그 파일 기록(14일 보관)
│  └─ UpdateService           GitHub 릴리즈 기반 자동 업데이트
├─ ViewModels/MainViewModel   감시 루프 · 알림 · 명령 · 업데이트 오케스트레이션(MVVM)
├─ Views/RegionSelectorForm   드래그 영역 선택 오버레이
└─ Helpers/                   Bitmap↔BitmapSource · 컨버터

---

© H.Soft (Jeju, KR) · Hyun-woo Bae