Stream Deck으로 OBS 그래픽 제어: 그래픽마다 버튼 하나

Stream Deck용 OBS 플러그인은 장면을 전환하고 소스를 숨길 수 있습니다. 하지만 그래픽에 적힌 내용은 바꾸지 못합니다. 이 가이드에서는 그것이 가능한 키를 설정합니다. 이름 자막, 홈팀 골, 경기 시계, 진행표의 다음 항목 — 모두 한 번만 누르면 되고, 각 키는 해당 그래픽이 방송 중인지 보여 줍니다.

장면 전환과 그래픽 제어의 차이

대부분은 Stream Deck으로 이미지 소스의 표시/숨김을 전환하는 것부터 시작합니다. 그래픽에 다른 문구가 필요해지기 전까지는 잘 됩니다. 새 게스트, 새 점수, 다른 헤드라인이 필요해지면 변형마다 소스를 하나씩 만들게 되고, 똑같아 보이는 버튼으로 덱이 가득 찹니다.

그래픽 엔진을 쓰면 구조가 뒤집힙니다. OBS에는 투명 브라우저 소스 하나만 두고, 버튼은 OBS가 아니라 그래픽 엔진과 통신합니다. 키는 자막 내보내기나 홈팀 점수 +1이라고만 말하고, 애니메이션과 문구는 엔진이 처리합니다. OBS는 알 필요조차 없습니다.

준비물

• 방송용 PC에서 실행 중인 CueFinch, 그리고 OBS에 브라우저 소스로 추가한 출력 페이지(추가 방법).
• Stream Deck(Stream Deck Mobile을 포함한 모든 모델)과 Elgato의 무료 Stream Deck 앱 7.1 이상(Windows 10+ 또는 macOS 12+).
• CueFinch Stream Deck 플러그인 — 앱 안의 Prep → Connections(준비 → 연결)에서 내려받습니다.

설정하기 — 단계별

1. CueFinch에서 Prep → Connections(준비 → 연결)를 열고 Generate key and turn on(키 생성 후 켜기)을 누릅니다. 버튼이 사용하는 로컬 HTTP API가 켜집니다. 키가 없으면 API는 꺼진 상태로 유지됩니다.
2. Stream Deck plugin 카드에서 Download the plugin(플러그인 다운로드)을 누르고 CueFinch.streamDeckPlugin 파일을 더블클릭합니다. Stream Deck 앱이 플러그인을 설치하고, 동작 목록에 CueFinch 카테고리가 나타납니다.
3. CueFinch 동작 하나를 키로 끌어다 놓습니다. 설정 맨 위의 Connection(연결) 상자에 서버 주소를 입력합니다 — Stream Deck과 CueFinch가 같은 PC에 있으면 http://localhost:5275, 다른 PC라면 그 PC의 네트워크 주소만 입력하면 포트는 자동으로 붙습니다 — 그리고 API 키를 붙여 넣습니다. Test connection(연결 테스트)을 눌러 확인하세요. 이 값은 한 번만 입력하면 되고, 다른 모든 키가 이를 함께 사용합니다.
4. 키가 할 일을 고릅니다: 그래픽 내보내기/내리기, 점수 변경, 시계 제어, 경기 이벤트 실행, 진행표 이동, 또는 전체 지우기.
5. CueFinch의 Live(라이브) 페이지를 열고, 방송하는 동안 열어 두세요. 버튼 입력은 그 페이지가 실행하며, 페이지의 버튼을 직접 클릭한 것과 똑같이 동작합니다.

경기 중계에 맞는 덱 배치

축구 중계 방송 하나를 진행하는 데는 키 15개면 충분합니다. 실전에서 잘 통하는 배치 예시입니다.

• 윗줄: 스코어 버그 켜기/끄기 · 경기 시계 시작/정지 · 라인업 · 전체 지우기.
• 가운뎃줄: 홈팀 골 · 원정팀 골 · 홈팀 −1 · 원정팀 −1(골이 취소될 때).
• 아랫줄: 옐로카드 · 레드카드 · 선수 교체 · 이름 자막 · 진행표 다음 항목.

전체 지우기는 다급할 때 누르는 키들과 떨어진 구석에 두세요. 한 번에 모든 그래픽을 내리는 키라서, 비상시에는 꼭 필요하지만 실수로 눌렀을 때는 가장 곤란합니다.

방송 중인 것을 보여 주는 키

플러그인은 화면에 무엇이 나가 있는지 CueFinch에 계속 묻습니다. Stream Deck +에서는 다이얼로 점수를 바꿉니다. 돌리면 한 골씩, 누르면 설정한 단계만큼 바뀝니다. 그래픽 키는 해당 그래픽이 방송 중일 때 빨갛게 변하고, 점수 키는 현재 점수를, 시계 키는 흐르는 시간을 보여 줍니다. 말하는 도중에 슬쩍 내려다봐도 어떤 버튼이 있는지가 아니라 방송의 현재 상태를 알 수 있습니다.

CueFinch가 꺼져 있거나, Live 페이지가 열려 있지 않거나, 키가 틀리면 아무 일 없이 넘어가지 않고 키에 경고가 표시됩니다.

Bitfocus Companion과 다른 컨트롤러

모든 동작은 일반 웹 주소이기도 하므로, HTTP 요청을 보낼 수 있는 것이라면 무엇이든 그래픽을 제어할 수 있습니다. Bitfocus Companion에서는 Generic HTTP 연결을 추가하고 버튼에 http://localhost:5275/api/v1/object/score/toggle 같은 GET 동작을 지정한 뒤, 키를 X-Api-Key 헤더(또는 URL의 ?key=)에 넣으면 됩니다. Companion이 이미 ATEM 스위처를 제어하는 스튜디오에서 흔히 쓰는 방법입니다.

Stream Deck이 아예 없나요? 내장된 휴대폰·태블릿 리모컨이 같은 버튼을 터치스크린에 제공합니다.

문제와 해결

• 키에 “NO LINK”(연결 없음)가 표시됩니다. 같은 PC의 브라우저에서 서버 주소를 열어 보세요. 아무것도 뜨지 않으면 CueFinch가 실행 중이 아니거나 다른 포트를 쓰고 있습니다.
• “PANEL CLOSED”(패널이 닫힘). Live 페이지가 열려 있지 않습니다. 브라우저에서 열고 탭을 그대로 두세요.
• “WRONG KEY”(잘못된 키). API 키가 새로 생성되었습니다. 아무 CueFinch 키의 설정에 새 키를 붙여 넣으세요.
• Stream Deck이 다른 PC에 있습니다. localhost 대신 방송용 PC의 네트워크 주소(Prep → Connections에 표시됨)를 쓰고, Windows 방화벽에서 개인 네트워크에 대해 포트 5275를 허용하세요.

자주 묻는 질문

관련 페이지

• OBS 축구 스코어보드
• OBS 농구 스코어보드
• OBS 카운트다운 타이머
• 휴대폰으로 그래픽 제어
• Google Sheets → OBS