Captix 완전 사용 매뉴얼

01Captix 소개 — 무엇을 할 수 있나

Captix 는 실시간 자막 · 그래픽 송출 통합 도구입니다. 예배·방송·세미나·이벤트에서 자막과 그래픽을 디자인하고 NDI/SDI/OBS 로 송출합니다.

1.1 주요 기능

• 스크립트 → 슬라이드 — 대본·가사·발표문을 빈 줄 단위로 자동 분할. TXT 파일 가져오기 지원
• 강력한 페이지 디자인 — 텍스트/도형/이미지/영상/마스크/그룹 레이어, 그라데이션·외곽선·그림자·글로우
• 빠른 애니메이션 — Enter/Loop/Exit 3-phase + 11개 채널 + 9가지 파형 + 프리셋 저장
• AI 통합 — Pollinations 이미지 생성, Iconify 20만 아이콘, AI SVG 도형, 한↔영 자동 번역, Whisper 실시간 자막
• 4 채널 동시 송출 — NDI + SDI(DeckLink) + 별도 윈도우 + OBS Browser Source
• 다중 레이어 합성 — 한 화면에 자막·로고·시계·다른 콘텐츠를 동시 송출 가능
• 외부 제어 — OSC / HTTP / WebSocket — Stream Deck, vMix, 커스텀 자동화 연동
• 데이터 큐 — Excel/CSV/API 행 단위 송출, 성경 4 버전 (개역한글/NIV/KJV/ASV) 교차 검색

1.2 누가 사용하나

02설치 + 첫 실행

2.1 시스템 요구사항

2.2 설치

1. 설치 파일 (Captix Setup x.x.x.exe Windows / .dmg macOS) 실행
2. 설치 완료 후 첫 실행
3. (선택) NDI Tools 설치 — NDI 송출 필요 시 (ndi.video)
4. (선택) Blackmagic Desktop Video — DeckLink SDI 카드 사용 시

2.3 첫 실행 시 자동 다운로드

Whisper 실시간 자막을 처음 사용하면 자동으로:

• Python 가상 환경 (~200 MB)
• faster-whisper large-v3-turbo 모델 (~1.5 GB)
• CUDA/cuDNN (NVIDIA GPU 사용 시 자동)

1회만 진행. 5~15분 소요 (네트워크 속도에 따라).

03핵심 개념 — Project / Page / Cue / Layer / Widget

5 개의 핵심 객체만 이해하면 Captix 의 모든 기능이 명확해집니다.

04화면 구성 — 3가지 모드

Captix 는 작업 단계마다 다른 화면을 보여줍니다. 상단 메뉴바 좌측의 [디자인]/[송출] 버튼으로 모드를 전환합니다.

4.1 ☆ 디자인 모드 (Design) — 페이지 만들기

4.2 ☆ 송출 모드 (Show) — 실제 운용

4.3 슬라이드 편집 모드 (Slide Editor)

스크립트의 각 슬라이드를 직접 편집 (텍스트 변경, 슬라이드별 스타일 오버라이드).

4.4 메뉴바 구성 (좌 → 우)

4.5 하단 StatusBar

[SIZE 1920×1080] [FPS 30p] [NDI 30fps] [OUT NDI·WIN·WEB·SDI] [SDI ✓142 ⚠3] [FRAME 12.5/18.2ms]

• SIZE · 프로젝트 해상도
• FPS · 프레임 레이트
• NDI · NDI 활성 시 실시간 fps
• OUT · 활성 출력 (NDI/WIN/WEB/SDI 중 ON)
• SDI · 송출 통계 ✓성공 ⚠에러
• FRAME · 평균/최대 frame 처리 시간 (30fps 예산 33.3ms)

0510분 퀵스타트 — 첫 송출까지

Captix 의 전형적 사용 패턴 — 한 번만 따라하면 전체 흐름이 이해됩니다.

안녕하세요, 반갑습니다.

오늘 발표를 시작하겠습니다.

첫 번째 주제부터 살펴보겠습니다.

06스크립트 작성 — 슬라이드 자동 분할 + TXT 가져오기

대본·가사·발표문 같은 긴 텍스트를 슬라이드별로 송출하는 방법.

6.1 스크립트 생성

1. 좌측 ScriptStore 패널의 + 버튼
2. 스크립트 이름 입력 (예: "1부 설교")
3. 본문 입력 영역에 텍스트 붙여넣기

6.2 슬라이드 자동 분할 규칙

예시:

안녕하세요 반갑습니다       ← 슬라이드 1, 1줄
                            ← 빈 줄 (구분자)
오늘 발표 주제는            ← 슬라이드 2, 1줄째
신제품 출시 계획입니다       ← 슬라이드 2, 2줄째
                            ← 빈 줄
첫 번째로                   ← 슬라이드 3, 1줄째
시장 분석을 보겠습니다       ← 슬라이드 3, 2줄째

6.3 멀티 텍스트 슬롯 (한글+영어 동시)

같은 슬라이드에 여러 텍스트 슬롯을 두려면 && 구분자 사용:

안녕하세요 여러분&&Hello everyone
오늘 발표를 시작하겠습니다&&Let's begin today's presentation

슬롯 1, 슬롯 2 가 각각 다른 텍스트 레이어에 바인딩 (페이지 디자인 시 슬롯 번호로 지정).

6.4 TXT 파일 가져오기

1. 좌측 ScriptStore + 클릭 → 새 스크립트 작성 모달
2. 모달 우측 상단 [TXT 가져오기] 버튼
3. .txt 파일 선택 → 본문에 자동 삽입

UTF-8 / EUC-KR 인코딩을 자동 감지합니다. 기존 본문이 있으면 뒤에 이어 붙입니다. 빈 줄로 슬라이드를 구분하므로, TXT 가져오기 후 빈 줄을 조정하면 슬라이드 단위가 결정됩니다.

6.5 슬라이드 개별 편집

스크립트 만든 후 특정 슬라이드만 다르게 디자인하고 싶으면:

• 슬라이드 더블클릭 → 슬라이드 편집 모드 진입
• 그 슬라이드만 폰트/색/위치 오버라이드
• 나머지 슬라이드는 페이지 기본 디자인 따름

6.6 스크립트 큐로 사용

1. 모드 [송출] → Rundown → + → Script 큐
2. 스크립트 선택 + 페이지 선택
3. 큐 TAKE 후 ↓ / Space 로 슬라이드 진행

07페이지 디자인 — 레이어 + 변수 바인딩

페이지는 자막의 "디자인 템플릿". 이걸 한 번 만들면 모든 큐에서 재사용됩니다.

7.1 새 페이지 만들기

1. 모드 [디자인]
2. 좌측 Design Library 의 +
3. 이름 입력 → 캔버스 사이즈 결정 (보통 1920×1080)

7.2 레이어 추가 (가장 자주 하는 작업)

7.3 ★ 변수 바인딩 — 큐 데이터를 페이지에 자동 주입

방법 1 — Script Slot (스크립트 큐 전용)

1. 텍스트 레이어 선택
2. 우측 속성 패널 → "스크립트 슬롯" 토글 ON
3. 슬롯 번호 지정 (1번 = 첫 텍스트, 2번 = && 뒤 영문 가사 등)
4. 큐 TAKE 하면 슬라이드의 텍스트가 이 레이어에 자동 주입

방법 2 — Widget Tag (위젯 변수)

텍스트 레이어 안에 {widget_name} 직접 입력. 송출 중 위젯 값으로 자동 치환.

발표자: {presenter}        ← DataIO 위젯 "presenter"
경과 시간: {timer1}        ← Timer 위젯
자막: {transcript1,last3}  ← Whisper 최근 3줄

방법 3 — Style Preset Marker

한 텍스트 안에서 일부 글자만 다른 스타일 적용:

안녕하세요 {1}홍길동{0}입니다
            ↑ 프리셋 1 적용 ↑ 리셋

이름만 강조색·큰 글씨로 표시.

7.4 페이지 단축키 (디자인 모드)

7.5 페이지 재사용 패턴

• 페이지 복제 — Design Library 에서 우클릭 → 복제 → 일부만 수정 (같은 디자인의 변형)
• 페이지 export/import — .capt 파일로 다른 프로젝트에 가져가기
• 그룹 레이어 — 자주 쓰는 조합 (로고+이름표+배경박스) 을 그룹화 → 복사·붙여넣기

08런다운 구성 — 큐 배치 + 그룹

런다운은 큐의 실행 순서. 행사 진행 흐름대로 위에서 아래로 배치.

8.1 큐 추가

1. 송출 모드 → Rundown 패널 → + 버튼
2. 큐 종류 선택 (Script / Text / Image / Video / DataIO / Black / Page)
3. 속성 입력 (페이지 선택, 텍스트 입력, 미디어 첨부 등)

8.2 큐 조작

8.3 큐 인스펙터 (선택 큐의 속성)

• 대상 레이어 — 어느 레이어로 송출할지 (-3 ~ 3, 기본 0)
• Dissolve In/Out — 입장/퇴장 디졸브 효과 + 시간 (frames)
• Sound In/Out — TAKE 시 효과음 재생
• Auto Next — 일정 시간 후 자동으로 다음 큐
• Lock — 송출 중 우발적 TAKE 방지

8.4 다중 런다운 (1부 / 2부 분리)

한 프로젝트에 런다운 여러 개 가능. 좌상단 런다운 선택 드롭다운에서 전환.

09TAKE 송출 — 다중 레이어 + 디졸브

9.1 Preview vs Program

9.2 TAKE 워크플로우

1. Rundown 에서 큐 클릭 → 자동으로 Preview 에 올라감
2. Preview 영역에서 내용 확인
3. Enter 또는 [TAKE] 버튼 → Program 으로 전환 (실제 송출)
4. 이전 큐는 Dissolve Out (설정 시) 후 사라짐

9.3 ★ 다중 레이어 동시 송출

예시 구성:

큐 인스펙터의 대상 레이어 를 다르게 지정 → 동시에 송출. - 키로 특정 레이어만 OUT.

9.4 Dissolve (트랜지션)

• 큐 속성 → Dissolve In 체크 + 시간 (frames, 30fps 기준)
• 큐 속성 → Dissolve Out 체크 + 시간
• 기본 15 frames ≈ 500ms (NTSC 29.97fps)
• 모든 출력 (NDI/SDI/창/Browser) 에 동일 적용

9.5 [BLACK] 응급 컷아웃

모든 레이어 즉시 종료. 화면 검정 → 응급 시 사용 (실수 송출, 비상 상황).

9.6 송출 단축키

10레이어 종류 — 8가지

11텍스트 스타일링 — 그라데이션·외곽선·그림자·글로우

11.1 기본 속성 (TextStyle Panel)

• Font Family · 시스템 폰트 + 프로젝트 내 임베디드 폰트
• Font Size · 숫자 드래그 가능 (값 위에서 좌우 드래그)
• Weight / Italic · 100~900 또는 normal/bold
• Align · 좌/중/우 + Vertical Align (top/middle/bottom)
• Line Height / Letter Spacing · 행간 / 자간

11.2 채우기 (Fill)

• 단색 · 색상 선택
• 투명 · alpha 0 → stroke 만 보임
• 선형 그라데이션 · 시작/끝 색상 + 각도 + 정지점 다중
• 방사형 그라데이션 · 중심점 + 색상 정지점
• Gradient Scope · text (전체 텍스트에 한 그라데이션) / glyph (글자마다 독립 그라데이션)

11.3 외곽선 (Stroke) — 다중 지원

• 색상 + 너비 + 위치 (outside / center / inside)
• 각 stroke 도 그라데이션 가능
• Blend Mode 적용 (Multiply, Overlay 등)
• 순서 동적 조정 (바깥 → 안)

11.4 그림자 / 글로우

• Shadow · 색상 + 오프셋 X/Y + 블러 + 스프레드
• Glow · 색상 + 반경 + 강도 + Inner 옵션 (글자 안쪽으로 글로우)

11.5 고급 텍스트 옵션

• Tab Stops · 탭 위치 + 정렬 (이름표/타임라인 용)
• Hanging Indent · 연속 줄 들여쓰기
• First Line Indent · 단락 첫 줄 들여쓰기
• Background Shape · 텍스트 박스 (모서리 반경, padding, per-line flush)
• AutoSize / FixedSize / WordWrap · 박스 크기 동작
• Writing Mode · horizontal / vertical-rl / vertical-lr (세로쓰기)

11.6 Style Preset Marker (인라인 스타일)

한 텍스트 레이어 안에서 일부만 다른 스타일:

{1}강조{0} 그리고 본문

• {N} · 폰트 프리셋 N 적용 시작
• {0} · 리셋 (기본 스타일로 복원)
• 프리셋은 우측 FontPreset 패널에서 관리

12빠른 애니메이션 — 프리셋 + 11개 채널

12.1 3-Phase 애니메이션

• Enter · 레이어가 처음 나타날 때 (fade in, slide up 등)
• Loop · 표시되는 동안 반복 (떠다니기, 회전, 점멸)
• Exit · 레이어가 사라질 때

12.2 채널 11종

12.3 파형 함수 9종 (Loop 용)

12.4 ★ 가장 빠른 애니메이션 만들기 — 프리셋

1. 레이어 선택
2. Animation 패널의 Preset 드롭다운
3. 프리셋 선택 → 즉시 적용
4. (선택) 미세 조정 후 새 프리셋으로 저장

12.5 Stagger (글자별 타이밍)

텍스트의 글자/단어/줄마다 애니메이션 시작 시간을 약간씩 늦춤. "한 글자씩 등장" 효과:

• Mode · sequential (앞→뒤) / reverse (뒤→앞) / random
• Delay (ms) · 각 글자 간격
• Scope · glyph (글자) / word (단어) / line (줄)

12.6 Easing

Enter/Exit 의 진행 곡선 — linear / ease-in / ease-out / ease-in-out / spring / bounce / cubic.

13편집 단축키 + 캔버스 조작

13.1 전역 단축키

13.2 캔버스 (디자인 모드)

13.3 송출 모드

13.4 Mac 키패드 호환 (편의 alias)

Mac 노트북은 숫자 키패드가 없어, 키패드 키를 본체 키로 대체할 수 있도록 alias 가 적용됩니다. 결과 동작은 동일합니다.

DataIO 패널 · Script Cue 패널 · 메인 송출 영역 모두 동일하게 작동합니다.

14AI 이미지 생성 (Pollinations) + 배경 제거

자막 디자인에 필요한 일러스트·아이콘·효과를 텍스트만으로 생성. 무료.

14.1 접근 경로

1. 디자인 모드 → 캔버스에 우클릭 → 에셋 추가 또는 좌측 패널 +
2. Asset Picker 팝업 → 🎨 AI 생성 탭

14.2 옵션

• 프롬프트 · 한국어 또는 영어 (한글은 자동 영문 번역됨)
• 모델 · Flux (기본) / Flux Realism / Flux Anime / Flux 3D / Turbo
• 스타일 · 자동 / 벡터 / 만화 / 애니 / 실사 / 3D / 수채화 / 픽셀 / 미니멀
• 크기 · 256 / 512 / 768 / 1024
• Seed · 같은 시드 = 같은 결과 (재현용)
• 배경 제거 · 기본 ON — ONNX 모델로 자동 알파 분리
• 빠른 모드 · prompt enhancer 끔 (1-3초 빠름)

14.3 추천 프롬프트 칩 (1-click)

자주 쓰는 자막 조각 — ☁ 구름 / 💨 연기 / ✨ 골드플레어 / ➖ 가로광선 / 💫 블루크로스 / 🌟 스파클 / ⭐ 별 / 🔥 불꽃 / 🎀 리본 / 💎 보석 / 🏆 트로피 / 🥇 금메달 / 🌹 장미 / 🍃 잎사귀 / 🌈 무지개 / 💬 말풍선 / 👑 왕관 / 🎭 캐릭터 / ✏ 손그림

14.4 워크플로우

1. 프롬프트 입력 (예: "벚꽃 흩날리는 봄 풍경")
2. 스타일 선택 (예: "벡터")
3. [🎨 생성] 클릭 → 5-10초 대기
4. (옵션 ON 시) 배경 제거 자동 진행 (~3초)
5. 미리보기 확인 → + 에셋에 저장
6. 이미지 레이어가 자동으로 캔버스에 삽입

14.5 솔직한 한계

• Pollinations 의 Flux Schnell 은 4-step 증류 모델 — 카메라 각도, 숫자 인식 약함
• "사람 자동 배제" 자동 적용 (자막 조각 용도라 사람 안 만듦)
• 품질 더 높이려면 → 설정 → AI 제공자에서 Cloudflare/Hugging Face/OpenAI 활성화

15Iconify 아이콘 200,000개 검색

가장 빠르게 아이콘을 추가하는 방법. 인증 불필요, 무료, 200,000+ 아이콘.

15.1 접근

1. Asset Picker → 🎯 아이콘 검색 탭
2. 검색어 입력 (영어 권장: "home", "play", "arrow")

15.2 모드

• Shape (벡터) — SVG path 로 추가 → 색상 자유 변경, 무한 확대 가능, 다색 아이콘은 단색화
• Image (PNG) — PNG 이미지로 추가 → 원본 색상 보존 (다색 아이콘에 권장)

15.3 아이콘 세트

• Lucide — 깔끔한 stroke 스타일 (선)
• Phosphor — fill / regular / bold
• Material Symbols — Google Material Design
• Tabler — 보편적 stroke
• MDI — Material Design Icons
• + 150 다른 세트

15.4 다색 아이콘 자동 감지

아이콘이 2가지 이상 색상 사용 시 → 자동으로 PNG 모드 권장 (정보 손실 방지).

15.5 도넛/링 모양 (가운데 구멍)

SVG fill-rule="evenodd" 자동 감지 → 가운데 구멍 보존.

16AI SVG 도형 생성

커스텀 도형이 필요한데 적당한 아이콘이 없을 때, AI 에게 SVG 직접 생성 요청.

16.1 접근

Shape Picker → AI 생성 탭 (또는 도형 추가 메뉴에서 AI 옵션).

16.2 지원 AI 제공자

• Groq — 무료, 매우 빠름 (1-2초)
• Anthropic Claude — 가장 정확한 도형 생성
• OpenAI — GPT-4 기반
• Ollama — 로컬 LLM (인터넷 없이)

16.3 키워드 매핑 + AI fallback

자주 쓰는 30+ 도형은 하드코딩 (즉시 반환) — 번개, 별, 하트, 화살표 등. 그 외 입력은 AI 호출.

16.4 자동 검증

• viewBox 0-100 좌표계 자동 변환
• 단일/다중 subpath 분해
• 좌표 범위 검증 (out-of-bounds 자동 수정)

17한글 → 영문 자동 프롬프트 번역

AI 이미지 생성 시 자동으로 적용 — 사용자는 신경 안 써도 됨.

17.1 작동 방식

1. 한국어 프롬프트 입력 ("벚꽃 흩날리는 봄")
2. Pollinations Text API (LLM) 호출 → 영문 image-gen 친화 프롬프트로 확장
3. 변환 결과: "cherry blossoms falling in spring, soft pink petals, gentle breeze, photorealistic, beautiful, high quality"
4. 이 영문이 실제 Flux 에 전달됨

17.2 장점

• Pollinations Text API 사용 — 별도 API 키 불필요, 무료
• 단순 번역이 아닌 image-gen 친화 prompt 로 확장
• 세션 캐시 — 같은 한글 입력 → 같은 영문 (재호출 없음)
• 실패 시 원본 한글 그대로 사용 (graceful fallback)

17.3 토글

AI 이미지 생성 패널의 🇰🇷→🇺🇸 자동 번역 체크박스. 기본 ON.

18스크립트 큐 (대본·가사)

Captix 의 가장 많이 쓰는 큐 종류. 대본/가사처럼 슬라이드 단위로 진행되는 콘텐츠.

18.1 큐 생성

1. Rundown → + → Script 큐
2. 스크립트 선택 (또는 즉석 입력)
3. 페이지 선택 (디자인 템플릿)

18.2 슬라이드 진행

18.3 슬라이드 카운터

런다운 큐 옆에 "3/24" 형태로 현재 위치 표시.

18.4 활용 예

19텍스트 큐 (단일 자막)

스크립트 안 만들고 빠르게 한 문장만 송출.

1. Rundown → + → Text 큐
2. 텍스트 입력 (예: "환영합니다")
3. 페이지 선택
4. TAKE

페이지의 텍스트 레이어 안에 {text} 가 있으면 자동 주입.

19.1 활용

• 오프닝 인사, 종료 인사 같은 단발성 자막
• 발표자 이름 (텍스트 큐 + 이름표 페이지)
• 광고/공지 — 자주 바뀌지 않는 정적 메시지

20DataIO 큐 — Excel·CSV·API·성경

외부 데이터 행을 자막으로 송출. 인물 명단, 가사, 통계 등.

20.1 지원 데이터 소스

20.2 성경 검색

4 버전 지원:

• 개역한글 (Korean Revised Version)
• NIV (New International Version)
• KJV (King James Version)
• ASV (American Standard Version)

20.3 검색 문법

창 1:1         → 창세기 1:1
요 3:16~20     → 요한복음 3:16-20
1 John 3:16    → 요한일서 3:16
Gen 1          → 창세기 1장 (전체)
하나님          → "하나님" 단어 검색

20.4 ★ Cross-Language 검색

한글 입력 → 영문 성경에서 자동 매칭, 영문 입력 → 한글 성경에서 자동 매칭.

'창 1:1' + KJV 선택 → Genesis 1:1 자동 매치
'Jn 3:16' + 개역한글 → 요한복음 3:16 자동 매치

20.5 컬럼 매핑

DataIO 데이터의 컬럼 (예: 이름 / 직책 / 사진URL) → 페이지의 텍스트 레이어에 매핑:

페이지 텍스트 레이어:  {name}
                       {title}
DataIO 행:           name="홍길동", title="대표"
                    ↓
출력:                홍길동
                     대표

20·API외부 API 로 실시간 값 받기

스코어, 선수 이름처럼 외부에서 값을 보내 자막을 실시간 갱신할 때 사용합니다. DATA I/O 의 API 소스가 HTTP/UDP 서버를 열고, 들어온 값을 런다운·PGM·PVW·UI 에 즉시 반영합니다.

API.1 API 소스 만들기

1. DATA I/O 탭 → + 새 소스 추가 → API
2. 소스 이름 입력 (예: 스코어보드)
3. 서버 설정: HTTP 포트(기본 3030) · UDP 포트(기본 3031, 0=비활성) · 미정의 변수 자동 수용(acceptAll)
4. 변수 정의: 변수명 입력 후 Enter (예: team1_score, team1_name). acceptAll 이 꺼져 있으면 여기 등록된 이름만 수용
5. 💾 소스 저장 → ▶ 서버 시작 (상태 ● 실행 중)
6. + 큐에 추가 → 런다운에서 큐 선택 → 페이지(테마) 선택 → 🔗 템플릿 링크에서 텍스트의 Main Text 에 변수 매핑

API.2 엔드포인트

API.3 값 보내기 (터미널)

# PowerShell — 숫자
Invoke-RestMethod -Uri "http://localhost:3030/update" -Method Post `
  -ContentType "application/json" -Body '{"team1_score":"5"}'

# 텍스트 (값을 따옴표로)
Invoke-RestMethod -Uri "http://localhost:3030/update" -Method Post `
  -ContentType "application/json" -Body '{"team1_name":"Lions"}'

# 쿼리 파라미터 (한 변수)
Invoke-RestMethod -Uri "http://localhost:3030/update?var=team1_score&value=5" -Method Post

# curl
curl -X POST http://localhost:3030/update -H "Content-Type: application/json" -d "{\"team1_score\":\"5\"}"

API.4 앱 내 테스트 도구 (🧪)

서버 실행 중이면 API 편집 패널에 🧪 API 테스트 블록이 나타납니다. 변수별 테스트 값을 적고 ▶ 테스트 전송 → 외부 클라이언트와 동일한 POST /update 로 실제 전송, 결과(✓ 200 / 오류 / 연결 실패)를 즉시 표시. JSON 따옴표 걱정 없이 검증할 수 있어 편리합니다.

API.5 값 반영 흐름

외부 전송(HTTP/UDP) → API 서버 수신
  → 전역 데이터 소스 갱신 (위젯/필터 재계산)
  → 참조 DataCue 갱신
       ├ 편집 패널 변수 칸 동기화
       ├ PVW(프리뷰) 즉시 반영
       └ 송출 중이면 PGM·출력창·NDI 즉시 반영

즉 송출 중인 텍스트도 다시 TAKE 하지 않고 값만 바뀝니다. 잦은 업데이트는 자동으로 묶여(coalescing) 처리되어 안전합니다.

API.6 자주 묻는 문제

21영상 · 이미지 · Black 큐

21.1 Image 큐

단일 이미지 풀스크린 송출. 광고, 안내 슬라이드, 정적 화면.

21.2 Video 큐

• MP4/MOV 재생
• In/Out 포인트 (앞뒤 자르기)
• 루프 / 원샷 모드
• 자동 재생, 음소거, 볼륨
• Fit 모드 (contain/cover/fill)
• 재생 완료 후 자동 OFF

21.3 Page 큐

페이지 디자인만 보여주고 텍스트는 Preview 에서 즉석 편집. "이름표" 같은 한 번 쓰고 버리는 큐에 적합.

21.4 Black 큐

모든 레이어 검정. 응급 컷아웃, 휴식 시간, 광고 사이 공백.

21.5 Group Header

런다운의 섹션 구분자. 송출 단위 아님 (TAKE 안 됨). 1부 / 2부 / 폐회 같은 구획용.

22위젯 4종 — Timer / Counter / DataFilter / Transcript

위젯은 실시간으로 값이 변하는 데이터 공급원. 큐와 달리 "송출 항목" 이 아니라 페이지 안에 박혀서 계속 갱신됨.

22.1 Timer 위젯

• 포맷 · HH:MM:SS, MM:SS, MM:SS.S 등 자유
• Auto Start · GO/TAKE 시 자동 시작

22.2 Counter 위젯

• +/− 버튼으로 증감
• Step 설정 (1, 5, 10 등)
• Min/Max 제약
• 용도: 출석 인원, 점수, 회차

22.3 DataFilter 위젯

DataSource (Excel/CSV/API) 의 데이터를 검색·필터링한 결과를 위젯으로 노출.

태그: {필터명,열,행} (1-based)

{members,name,3}    → members 필터의 name 컬럼 3행
{members,phone,1}   → members 필터의 phone 컬럼 1행

22.4 Transcript 위젯 (Whisper)

Part 6 의 다음 섹션에서 자세히.

22.5 위젯 생성

1. 좌측 Widget 패널 → 추가 (4종 중 선택)
2. 이름 부여 (영문/숫자 권장 — 태그로 쓰임)
3. 옵션 설정 → 페이지의 텍스트에 {이름} 삽입

23실시간 자막 위젯 (Whisper) — 음성 인식

Captix 의 부가 기능 중 하나. 마이크나 시스템 오디오를 받아 실시간으로 자막화. faster-whisper large-v3-turbo 모델 사용 (완전 로컬, 인터넷 불필요).

23.1 위젯 생성

1. Widget 패널 → 실시간 자막 추가
2. 위젯 이름 (예: transcript1)
3. 캡처 소스 선택 (mic / system / ndi-mix)
4. 마이크 디바이스 선택 (mic 모드)
5. 언어 (auto / ko / en / ja 등)
6. ▶ (시작) 버튼

23.2 캡처 소스

23.3 페이지에 자막 표시

텍스트 레이어 안에:

{transcript1}        → 가장 최근 1줄
{transcript1,last3}  → 최근 3줄 (개행 join)
{transcript1,full}   → 세션 전체

23.4 줄 수 / 글자 수 옵션

• keepLines · 보관 줄 수 (기본 3)
• maxLineChars · 한 줄 최대 글자 (기본 20, 초과 시 자동 줄바꿈)

23.5 도메인 컨텍스트 (정확도 향상)

인명·지명·전문용어를 사전에 등록 → Whisper 의 정확도 ↑.

1. 설정 → AI 탭 → Whisper 도메인 컨텍스트
2. 자유 텍스트 입력 (줄바꿈으로 항목 구분)
3. 모든 transcript 위젯이 공유

예시:

홍길동 김영희 이철수
서울 부산 광주 대전
ESG 메타버스 NFT
captix 캡틱스

23.6 SRT / TXT 내보내기

위젯 헤더의 📄 SRT / 📝 TXT 버튼 → 세션 자막 파일 다운로드. YouTube/Vimeo 자막 import 가능.

24데이터 바인딩 — {태그} 시스템

페이지 안의 텍스트가 동적 데이터와 자동 연결되는 메커니즘.

24.1 태그 종류 종합

24.2 우선순위

한 텍스트 레이어에 여러 태그 가능. 큐가 우선이고 위젯이 그 다음:

발표자 {name} · 시각 {timer1} · 자막: {transcript1}
          ↑ DataIO 큐    ↑ Timer       ↑ Whisper

25송출 개요 + NDI

Captix 의 모든 출력은 같은 합성 결과(투명 배경 포함)를 4가지 경로로 내보냅니다. 용도에 맞게 하나 이상을 켜고 쓸 수 있습니다.

📡 NDI 송출

같은 LAN 의 다른 PC 로 영상을 보냅니다. 수신 측 OBS/vMix/TriCaster 가 NDI 소스로 받습니다. 케이블 없이 네트워크만으로 방송 품질 영상을 전달하는 가장 흔한 방식입니다.

25.1 사전 준비

• 수신 PC: OBS 라면 NDI 플러그인(obs-ndi / DistroAV) 설치, 또는 NDI Tools(ndi.video, 무료)
• 네트워크: 송출/수신 PC 가 같은 서브넷. 유선 기가비트 권장(1080p60 ≈ 100~150Mbps)
• 방화벽: mDNS 5353 + NDI 동적 포트(5960~) 허용

25.2 설정 + 송출

1. 설정 → 출력 → NDI 출력 활성화
2. 해상도·FPS 확인(공통 설정)
3. 상단 [📡 송출] 클릭 → 수신 PC 의 NDI 소스 목록에 이 PC 이름으로 나타남

25.3 특징

• 알파 채널 지원 — 자막/그래픽의 투명 배경이 그대로 전달되어 수신 측에서 영상 위에 합성
• 지연이 매우 낮음(통상 한 프레임 수준)
• 수신 측에서 NDI 소스가 안 보이면: 같은 서브넷인지, 방화벽(5353), NDI 플러그인 설치 여부 확인

26SDI 송출 (DeckLink) — 4가지 모드

Blackmagic DeckLink 카드로 방송 표준 SDI 출력.

26.1 4가지 모드

26.2 keyer-sw 옵션

• Key Source · Alpha (표준) / Luminance / RGB Max
• Key Threshold · 0=그라데이션, 128=hard-clip (글씨 가장자리 sharp)
• Invert Key · 스위처가 BLACK=visible 일 때
• Premultiply Fill · 일부 스위처 (Shaped Key) 요구
• Flicker Filter · 인터레이스 출력 시 vertical anti-flicker (CPU 비용 ↑)

26.3 1080i 59.94 (방송 표준)

설정 → SDI → 인터레이스 출력 체크 → 30fps NTSC 가 자동으로 1080i 59.94 로 송출.

26.4 디바이스 capability 표시

설정 → SDI → 채널 드롭다운에 [KEY/DL/QL] 라벨:

• KEY · supportsInternalKeying
• DL · supportsDualLinkSDI
• QL · supportsQuadLinkSDI

26.5 8K Pro 사용자 노트

• SDI 1, 2 만 internal keyer 지원 (SDI 3, 4 는 미지원)
• keyer-hw 사용 시 device=0 (SDI 1) 선택 권장
• 또는 keyer-sw (4 독립 채널 활용)

26.6 진단 — sdi.log

설정 → SDI → 📂 SDI 로그 폴더 열기 → 송출 통계, 에러, 장치 capability 모두 기록.

27창 모드 & 브라우저 출력

🖥 창 모드 (별도 출력 창)

송출 화면을 독립된 프레임리스 창으로 띄웁니다. 그 창을 두 번째 모니터(또는 캡처 보드 입력)로 보내 사용합니다. NDI/SDI 장비 없이 로컬에서 가장 간단하게 송출하는 방법입니다.

1. 설정 → 출력 → 출력 창 활성화 → 상단 [송출] → 별도 창이 열림
2. 그 창을 2번째 모니터로 드래그(또는 전체화면)
3. 상단 [출력창] 버튼으로 언제든 다시 열거나 포커스

크로마 키 배경: 출력 창은 OS 창이라 진짜 투명이 어려우므로, 투명 대신 단색 크로마 배경(기본 #00ff00 녹색)을 깔 수 있습니다.

• 설정 → 출력 → 크로마 키 배경 체크 + 색상 지정
• OBS/스위처에서 그 색을 키로 제거 → 자막만 합성
• 투명이 그대로 필요하면 창 모드 대신 NDI·브라우저를 쓰세요(알파 지원)

🌐 브라우저 출력 (OBS Browser Source)

같은 PC 의 OBS 에서 브라우저 소스로 받습니다. 내장 HTTP+WebSocket 서버가 합성 프레임을 실시간으로 푸시하며, 알파(투명 배경)를 그대로 지원합니다. 같은 PC + OBS 조합에서 가장 깔끔합니다.

1. 설정 → 출력 → 브라우저 소스 서버 활성화 (기본 포트 4577)
2. 상단 [송출] 으로 서버 시작
3. OBS → 소스 추가 → 브라우저
4. URL: http://localhost:4577/?browser=1&transparent=true
5. 너비/높이: 출력 해상도와 동일하게 (예: 1920 × 1080)
6. OBS 브라우저 소스는 CEF 가 알파를 지원 → 투명 배경 자동

• WebSocket 으로 프레임을 실시간 push — 별도 새로고침 불필요
• 같은 PC 사용 권장(네트워크를 거치지 않아 부하·지연 최소)
• 다른 PC 의 OBS 라면 localhost 대신 송출 PC 의 LAN IP 사용 + 방화벽 허용 — 이 경우엔 NDI 가 더 적합

28Remote 제어 — OSC / HTTP / WebSocket

다른 PC, 스튜디오 컨트롤러 (Stream Deck, TouchOSC), 자동화 스크립트에서 Captix 큐를 제어.

28.1 3가지 프로토콜

28.2 지원 명령

28.3 HTTP 경로 (curl/자동화)

기본 포트 3040. 큐 인덱스는 0-based(첫 큐 = 0).

# 첫 큐 TAKE / 전체 OUT (PowerShell)
Invoke-RestMethod -Uri "http://localhost:3040/api/cue/idx/0/take" -Method Post
Invoke-RestMethod -Uri "http://localhost:3040/api/layer/out-all"   -Method Post

28.4 설정

1. 설정 → 원격 제어 탭 → 프로토콜별 활성화 + 포트(HTTP 기본 3040, OSC 9000)
2. 시작(▶) 클릭 (원격 서버는 자동 시작 안 됨)
3. 로그 보기 — 들어오는 명령 실시간 확인

28.5 사용 예 — Stream Deck

Bitfocus Companion 모듈로 Captix HTTP 엔드포인트 연결 → 버튼 하나로 큐 TAKE.

28.6 WebSocket 예제

// JavaScript 클라이언트 (HTTP 와 포트 공유, 경로 /api/ws)
const ws = new WebSocket('ws://localhost:3040/api/ws')
ws.onopen = () => {
  ws.send(JSON.stringify({ type: 'cue:take-idx', index: 0 }))
}
ws.onmessage = (e) => console.log('Captix event:', e.data)

29렌더 Export — PNG / ProRes 4444 / SRT

29.1 큐를 영상/이미지로 내보내기

편집 후 NLE (Premiere, DaVinci) 로 가져가거나 다른 시스템에서 재생할 때.

29.2 절차

1. 런다운에서 큐 선택 (다중 선택 가능)
2. 메뉴 [출력] → 포맷 선택
3. FPS (24/30/60) + 출력 폴더
4. 시작 → 백그라운드 렌더링

29.3 자동 제외

Image / Video 큐는 원본 파일이 결과물이므로 자동 제외.

29.4 SRT / TXT 자막

실시간 자막 위젯 (Whisper) 결과 → 📄 SRT / 📝 TXT 버튼 → 파일 다운로드.

30파일 형식 — .capp / .capt / .capts

30.1 .capp 내부 구조

captix-project.capp (zip)
├── manifest.json         메타 (버전, 작성자, 생성일)
├── storage/
│   ├── themes-v1.json    페이지 디자인들
│   ├── rundown-v1.json   런다운
│   ├── widgets.json      위젯
│   ├── font-presets.json
│   ├── anim-presets-v3.json
│   └── my-shapes-v1.json
├── mediaAssets/          비디오/이미지
└── designs/              디자인 이미지

30.2 import 흐름

1. 메뉴 → 파일 → 프로젝트 가져오기 → .capp 선택
2. zip 자동 해제 → temp → userData 복사
3. 절대 경로 → basename pathMap 으로 rewrite
4. localStorage 덮어쓰기 + reload

30.3 Undo / Redo

• 최대 100 스냅샷 유지
• 250ms 연속 변경 (드래그 등) 은 한 단위로 묶임 (coalescing)
• Ctrl+Z / Ctrl+Y

31설정 패널 가이드

메뉴바 [⚙] 클릭. 5개 탭.

31.1 General (일반)

• Frame Size · 720p / 1080p / 2160p / Custom
• FPS · 23.976 / 25 / 29.97 NTSC / 30 / 50 / 59.94 / 60
• 출력 활성화 토글 · NDI / 창 / Browser / SDI
• SDI 채널 + 모드 + 옵션 · 26장 참조
• 인터레이스 · 1080i 59.94 (방송 표준)
• 프로젝트 백업/복원 · .capp export/import

31.2 AI

• 기본 이미지 제공자 · Pollinations / Cloudflare / Hugging Face / OpenAI
• 제공자별 API 키 입력
• Whisper 도메인 컨텍스트 · 인명/지명 사전 (모든 transcript 위젯 공유)

31.3 Remote

• OSC / HTTP / WebSocket 활성화 + 포트
• 실시간 로그 viewer

31.4 진단 도구

• SDI 로그 폴더 열기
• DevTools 열기 (F12)

32AI 제공자 API 키 설정

32.1 AI SVG 도형 생성용 (별도)

• Groq — 무료, 빠름
• Anthropic Claude — 가장 정확
• OpenAI — GPT-4
• Ollama — 로컬 LLM

33트러블슈팅

33.1 NDI 송출 안 됨

• NDI Tools 설치 확인 (ndi.video)
• 방화벽: NDI Studio Monitor 가 같은 LAN 에서 보이는지 확인
• VPN/가상 어댑터 끄기

33.2 SDI 송출 안 됨

• Blackmagic Desktop Video 설치 + 카드 인식 확인
• SDI Connections 탭 → 채널을 "Output" 으로 설정 (input/output 토글식 카드)
• sdi.log 확인 (설정 → SDI → 📂 로그 폴더 열기)

33.3 SDI 글씨 깍두기

• 인터레이스 출력 시 → Flicker Filter ON (성능 비용 있음)
• Captix 페이지 native 크기 = 출력 해상도 일치시키기 (1920×1080)

33.4 SDI keyer-sw 반투명 출력

• Key Threshold = 128 → anti-aliasing 가장자리 sharp 화
• Flicker Filter OFF (RGB 만 처리하지만 비용 여전히 큼)

33.5 Whisper 인식 안 됨

• 위젯 미리보기의 오디오 레벨 미터 확인
• 마이크 디바이스 선택 + 권한
• 도메인 컨텍스트에 자주 등장하는 인명/용어 등록

33.6 메모리 누수 / OOM

장시간 송출 (수 시간 이상) 시 메모리 안정성 확인. 최근 패치로 RemoteBridge listener 누수 수정됨 — 최신 버전 사용 권장.

33.7 OBS Browser Source 검은 화면

• URL: http://localhost:4577/?browser=1 정확히
• 설정 → 일반 → 브라우저 소스 서버 ON
• 방화벽 포트 4577 허용

34알려진 제약 · 미구현

34.1 런다운 Export 한계

• Script / DataIO 큐 이미지 내보내기 — 데이터 리스트 전체 옵션 미구현. 현재 활성 항목 1프레임만. 우회: 항목별 활성화 + 반복.
• Script / DataIO 영상 내보내기 — 항목 전환 처리 미정의. PNG 시퀀스 → NLE 권장.

34.2 AI 모델 본질적 한계

• Pollinations Flux Schnell — 카메라 각도, 숫자 인식, 다중 객체 배치 약함
• 더 좋은 품질 원하면 → 유료 제공자 (OpenAI / Anthropic) 활성화

34.3 보안

• API 키 localStorage 평문 저장 (향후 safeStorage 이전 예정)
• Windows 코드 사이닝 인증서 없음 — 첫 실행 시 SmartScreen 경고 ("추가 정보 → 실행")

34.4 Whisper

• 5초 이상 침묵 시 "감사합니다" 같은 환각 출현 (자동 필터링 일부 적용)
• 다중 화자 분리 (diarization) 미지원

34.5 SDI

• 8K Pro 의 SDI 3, 4 채널 — internal keyer 미지원 (카드 자체 한계). keyer-sw 사용.
• 4K 60p / 8K 송출 — 현재 1080p 60fps 까지 안정 작동. Native pixconv 모듈로 4K 30p 가능 수준.

35용어 사전