Chzzk Desk v0.3.0

Chzzk Desk 0.3.0

치지직 시청용 Windows 앱과 Chrome 확장의 첫 GitHub 배포입니다. 기존 Python 봇과 별도로 실행됩니다.

• A–D 네 방송, 화면 배치·메인 방송·듣는 방송 선택
• 즐겨찾기·클립 검색, 최근 15·30·60초 MP4 저장
• 네이버 웹 로그인, Chrome 공식 탭 시청과 앱의 녹화 연결
• 통나무 보유량 표시와 선택적으로 켜는 자동 수령
• 플레이어·녹화·저장소·연결·화면 코드의 모듈 분리

다운로드와 실행

• Chzzk-Desk-0.3.0-Setup-x64.exe: Windows x64 설치 프로그램
• Chzzk-Desk-0.3.0-win-x64.zip: 모두 압축 해제한 뒤 Chzzk Desk.exe 실행
• chzzk-desk-chrome-0.3.0.zip: 압축 해제 후 chrome://extensions에서 개발자 모드 → 압축해제된 확장 프로그램 로드
• SHA256SUMS.txt: 세 배포 파일의 SHA-256

앱 배포 파일에는 Electron과 FFmpeg가 들어 있어 Node.js나 Python을 따로 설치하지 않아도 됩니다. Chrome 확장 ZIP은 Chrome 웹 스토어 배포본이 아닙니다. 앱에서 연결 코드를 복사해 확장에 입력하면 Chrome으로 시청하면서 앱에 클립을 저장할 수 있습니다. 앱 로그인과 Chrome 로그인은 별개입니다.

현재 범위

이 버전은 시험 배포(prerelease)입니다. 코드서명 인증서를 적용하지 않아 Windows에서 게시자 확인 경고가 나올 수 있습니다. 앱 내부 고화질 재생은 지원하지 않으며, 고화질은 기존 Chrome 공식 재생 환경을 사용합니다. 자동 업데이트는 없으므로 다음 버전도 Releases에서 내려받습니다.

자동 검사는 실제 계정을 사용하지 않습니다. 실제 방송의 화질·로그인·통나무 수령과 설치된 앱의 화면은 별도 확인이 필요합니다. 기존 설정과 클립은 배포 파일에 포함하지 않습니다.

배포 준비 중 JavaScript 80개 파일의 문법 검사, 앱·확장 테스트 182개, 기존 Python core 테스트 76개가 통과했습니다. 실제 Windows 설치 파일·ZIP 생성과 ASAR의 35개 앱 파일·공통 모듈 경로·FFmpeg 포함 검사를 통과했고, Chrome ZIP은 25개 항목의 원본 일치를 별도 ZIP 리더로 확인했습니다. 설치 파일과 실제 앱 화면은 실행하지 않았습니다.

포함된 외부 프로그램

Electron과 관련 라이선스 파일을 함께 제공합니다. FFmpeg 6.1.1 Windows x64 바이너리는 ffmpeg-static 5.3.0이 제공하는 GPL v3 빌드이며 resources/ffmpeg에 바이너리·LICENSE·README를 함께 제공합니다. FFmpeg 해당 소스와 빌드 스크립트, 자세한 다운로드·빌드 설정은 포함된 README에서 확인할 수 있습니다.

v1.0.2

Changes

GPU 안정성

• ASR + Ollama + 게임 동시 실행 시 Windows 먹통 방지 (TDR 타임아웃 2초→10초 설정)
• install.bat에 GPU TDR 자동 설정 단계 추가 ([7/7])

로그 정리

• transformers Setting pad_token_id 경고 억제
• aiohttp Unclosed client session / ResourceWarning 억제
• chzzkpy print(user) 디버그 출력 패치 (install.bat 자동 적용)

v1.0.1

v1.0.1 - WebSocket 안정성 개선 & 반응 쿨다운

버그 수정

• WebSocket race condition 수정: ChatSender/ChatReader 재연결 시 이벤트 루프를 닫지 않고 클라이언트만 교체하여 Event loop is closed 에러 방지
• 스레드 안전성: ChatSender에 threading.Lock 추가로 send_message()와 재연결 스레드 간 동기화
• 재연결 딜레이 초기화: on_connect 이벤트로 재연결 성공 시 retry_delay를 3초로 리셋 (기존: 최대 30초까지 증가 후 미초기화)
• aiohttp 세션 정리: client.close() 후 asyncio.sleep(0.1)로 세션 정리 시간 확보

개선

• 반응 따라하기 쿨다운: 같은 종류의 반응(ㅋ, ㅎ 등)에 60초 쿨다운 추가하여 도배 방지
• 에러 메시지 개선: 빈 예외 메시지 시 예외 타입명 표시

v1.0

ChzzkBot v1.0

치지직 AI 음성 채팅 봇 - 방송 음성을 인식하고 AI가 채팅으로 응답합니다.

설치 방법

1. zip 압축 해제
2. install.bat 실행 (Python + 패키지 자동 설치)
3. .env 파일에 CHZZK_CHANNEL_ID 설정
4. run.bat 실행