챗뷰 시작하기

ChatView(챗뷰)는 스트리머 / 방송 송출 환경에서 실시간 채팅을 투명한 오버레이 창 형태로 띄워

항상 위에 두거나(고정 모드) 필요 시 재입력 / 초기화할 수 있는 Electron 기반 데스크톱 앱입니다.

이 문서는 첫 설치부터 기본 사용 흐름까지 안내합니다. 개별 서비스별 세부 설정은 아래 링크를 참고하세요.

빠른 링크

저장소 / 릴리즈에서 패키지(무설치 또는 msi 설치 파일)를 내려받아 설치 또는 압축 해제
- 무설치: 바로 실행
- msi 설치 파일: 더블 클릭 후 설치
또는 개발 모드
bash
```
npm install
npm run app
```
최초 실행 시 메인 제어 창이 뜨고 URL 입력 모달이 자동 표시됩니다.

현재 앱이 바로 오버레이 생성 대상으로 인정하는 URL

https://weflab.com/page/... 
https://chzzk.naver.com/chat/...

URL이 위 형태 중 하나로 시작하지 않으면 입력란 하단에 검증 에러가 표시됩니다.

제어 창에서 [URL 입력하기] 버튼 클릭 (첫 실행은 자동)
서비스(chat) 페이지의 실제 채팅 iframe / 보기 URL을 그대로 붙여넣기
[적용] → 별도의 투명한 "오버레이 창"이 생성되며 채팅이 표시됨
필요 시 제어 창의 스위치로 "고정 활성화"를 켜면
- 오버레이가 항상 위(always-on-top)
- 마우스 이벤트 패스스루 (게임/OBS 등 뒤 요소 클릭 가능)
URL을 다시 바꾸려면 [URL 다시 입력하기] 버튼 → 기존 오버레이는 제거 후 새로 생성
모든 값 초기화는 [리셋] → 저장된 URL, 창 위치/크기, 고정 상태 삭제

오버레이 창 위치/크기 조정 후 자동으로 저장되며 재실행 시 복원됩니다.

증상	해결 방법
URL 입력해도 에러	URL이 지원 패턴으로 시작하는지 확인 (앞/뒤 공백 제거)
오버레이 클릭이 안 됨	고정 모드가 켜진 상태인지 확인 후 끄기
오버레이가 안 뜸	리셋 후 다시 URL 적용, 또는 개발자 콘솔(Electron DevTools)에서 오류 확인
위치가 이상하게 복원	`리셋` 실행 또는 `electron-store` 데이터 삭제 → 재설정

Electron Store를 통해 아래 항목이 로컬에 저장됩니다.