치지직 채팅 리액션 오버레이

치지직 채팅에 맞춰 OBS 화면에 이미지나 영상을 띄워주는 프로그램입니다.

시청자가 채팅에 특정 문구를 입력하면, 미리 등록해 둔 오버레이가 방송 화면 위에 잠깐 표시됩니다.

예를 들어 채팅에 ?가 올라오면 물음표 이미지가 뜨고, ㅋㅋ가 올라오면 웃긴 효과 이미지가 뜨는 식으로 사용할 수 있습니다.

---

주요 기능

• 치지직 채팅 문구에 반응하는 OBS 오버레이
• 이미지, GIF, 영상 파일 등록 가능
• OBS 브라우저 소스로 간단히 연결
• 오버레이 위치, 크기, 볼륨 설정
• 채팅 연결 전 테스트 기능 제공
• 여러 미디어를 등록해 랜덤 재생 가능

지원 파일 형식은 다음과 같습니다.

svg, webm, mp4, mov, gif, png, jpg, jpeg, webp

복잡한 플러그인 설치 없이, 프로그램을 실행하고 OBS 브라우저 소스만 추가하면 사용할 수 있습니다.

---

실제 화면

컨트롤 페이지에서 오버레이를 추가하고, 반응할 채팅 문구와 이미지/영상을 설정할 수 있습니다.

OBS에는 아래 주소를 브라우저 소스로 추가하면 됩니다.

http://127.0.0.1:39291/overlay

 

설정 후 테스트 버튼을 누르면 실제 채팅 연결 전에도 오버레이가 잘 뜨는지 확인할 수 있습니다.

---

다운로드

최신 버전은 GitHub Releases에서 받을 수 있습니다.

 

https://github.com/picaqwe104/Stream_Overray/releases/latest

 

Windows 실행 파일 기준으로 배포하고 있습니다.

다운로드한 압축 파일을 풀고, 폴더 안의 실행 파일을 실행하면 됩니다.

OBS_Reaction_Overlay.exe

별도 설치는 필요 없습니다.

---

실행 방법

압축을 푼 뒤 OBS_Reaction_Overlay.exe를 실행합니다.

프로그램을 실행하면 잠시 후 컨트롤 페이지가 열립니다.
자동으로 열리지 않는 경우에는 브라우저에서 아래 주소로 접속하면 됩니다.

http://127.0.0.1:39291/control

같이 뜨는 검은 창은 로컬 서버 창입니다.
방송 중에는 닫지 말고 그대로 두면 됩니다.

---

처음 한 번 필요한 설정

치지직 채팅을 읽으려면 치지직 앱 키가 필요합니다.

치지직 개발자 센터에서 애플리케이션을 등록한 뒤, 발급받은 Client ID와 Client Secret을 컨트롤 페이지에 입력하면 됩니다.

치지직 개발자 센터 주소는 아래와 같습니다.

https://developers.chzzk.naver.com

애플리케이션 등록 시 Redirect URI에는 아래 주소를 입력합니다.

http://127.0.0.1:39291/auth/chzzk/callback

권한은 채팅 메시지 조회 권한을 선택하면 됩니다.

앱 정보를 저장한 뒤 치지직 로그인을 진행하고, 컨트롤 페이지에서 채팅 연결을 시작하면 준비가 끝납니다.

---

OBS 연결 방법

OBS에서 소스를 추가합니다.

소스 추가
→ 브라우저
→ URL 입력

URL에는 아래 주소를 입력합니다.

http://127.0.0.1:39291/overlay

브라우저 소스의 크기는 오버레이가 나타날 영역에 맞게 조절하면 됩니다.

화면 전체에서 랜덤으로 뜨게 하고 싶으면 브라우저 소스를 화면 전체 크기로 맞추면 되고, 특정 영역 안에서만 뜨게 하고 싶으면 해당 영역만큼만 잡으면 됩니다.

---

오버레이 추가 방법

처음 실행하면 등록된 오버레이가 없습니다.

컨트롤 페이지에서 오버레이를 추가하고, 사용할 이미지나 영상을 등록하면 됩니다.

설정할 내용은 간단합니다.

• 오버레이 이름
• 표시할 이미지 또는 영상
• 반응할 채팅 문구
• 위치와 크기
• 볼륨
• 한 번에 표시할 개수

예를 들어 반응 채팅에 ?를 입력해두면, 시청자가 채팅에 ?를 입력했을 때 해당 오버레이가 표시됩니다.

채팅 문구는 정확히 일치할 때만 반응합니다.
원하지 않는 채팅에 갑자기 오버레이가 뜨는 것을 줄이기 위한 방식입니다.

---

사용 예시

이런 식으로 설정해서 사용할 수 있습니다.

?      → 물음표 이미지 표시
ㅋㅋ    → 웃긴 리액션 이미지 표시
ㄱㄱ    → 시작 효과 영상 표시
억까    → 억울한 이미지 표시

방송 스타일에 맞게 직접 만든 이미지나 짧은 영상 파일을 넣으면 됩니다.

---

참고사항

이 프로그램은 방송하는 PC 안에서 실행되는 로컬 프로그램입니다.

오버레이 설정, 업로드한 이미지/영상, 치지직 앱 정보는 사용자의 PC에 저장됩니다.

다만 치지직 채팅을 읽기 위해 치지직과 통신하고, 새 버전 확인을 위해 GitHub 릴리스 정보를 확인할 수 있습니다.

또한 프로그램에는 기본 게임 에셋이 포함되어 있지 않습니다.
사용할 이미지나 영상은 직접 추가해야 합니다.

저작권이 있는 이미지나 영상을 사용할 경우에는 사용 조건을 확인해 주세요.

---

문제가 있을 때

OBS에 아무것도 보이지 않는다면 먼저 브라우저 소스 URL을 확인해 주세요.

http://127.0.0.1:39291/overlay

설정을 바꿨는데 OBS 화면에 반영되지 않는다면, OBS 브라우저 소스를 새로고침하면 됩니다.

OBS 브라우저 소스 우클릭
→ 새로고침

채팅이 들어오지 않는 경우에는 컨트롤 페이지에서 치지직 로그인 상태와 연결 상태를 확인한 뒤, 재연결을 눌러보면 됩니다.

---

GitHub

https://github.com/picaqwe104/Stream_Overray