장 1

시작하기

JustMakeQ는 멀티미디어 쇼 컨트롤 소프트웨어입니다. 공연이 진행되는 동안 "cue" 목록(오디오, 비디오, 이미지, MIDI, OSC 등)을 순서대로 재생하며, GO 키로 하나씩 실행합니다.

JustMakeQ 설치 및 실행

다운로드 공간에서 사용 중인 시스템에 맞는 설치 프로그램을 내려받아 실행하세요. 처음 실행하면 시작 화면이 표시됩니다:

JustMakeQ 시작 화면

시작 화면: 새 프로젝트 만들기, 기존 프로젝트 열기, 최근 프로젝트 불러오기.

라이선스 상태는 로고 아래에 표시됩니다("라이선스 활성화됨"이 녹색으로). 아직 활성화되지 않았다면 "라이선스 관리" 버튼으로 활성화 마법사를 열고, 계정 생성 시 이메일로 받은 .jmqa 파일을 사용하세요.

첫 프로젝트 만들기

"새 Q"를 클릭해 빈 프로젝트를 시작하세요. 아직 비어 있는 cue 목록과 함께 메인 창이 열립니다:

JustMakeQ 메인 창, 빈 프로젝트

메인 창: 상단에 트랜스포트 바(GO/Stop/Pause), 그 아래에 cue 추가 버튼, 왼쪽에 cue 목록, 오른쪽에 인스펙터.

cue를 추가하려면 "+ Cue" 바에서 유형을 클릭하세요(Audio, Video, Image, MIDI, OSC, PJLink, HTTP, Fade, Play, Pause, Stop, Wait, Group, Sep). 바로 cue 목록에 나타납니다:

cue 목록에 추가된 Audio cue

Audio cue가 방금 추가되었습니다. 파일이 지정되기 전까지는 빨강/주황으로 표시됩니다.

목록에서 cue를 클릭하면 오른쪽 인스펙터에 열립니다. 모든 매개변수는 여기에서 설정하며, 먼저 "설정" 탭에서 재생할 파일을 지정합니다.

Audio cue sélectionnée, inspecteur ouvert

선택된 cue: 인스펙터에 정보(이름, 번호, 색상)와 타이밍(pre-wait, post-wait, auto-follow/auto-continue)이 표시됩니다.

공연 시작하기

  • 스페이스 또는 GO 버튼: 재생 커서(cue 목록의 주황색 삼각형) 위치의 cue를 실행하고 커서를 다음으로 옮깁니다.
  • Esc 또는 Stop All 버튼: 재생 중인 모든 것을 정지합니다.
  • P 또는 Pause 버튼: 선택한 cue를 일시정지합니다. Pause All은 전체를 일시정지합니다(기본 단축키 없음).
  • H 또는 Set Head 버튼: 선택한 cue로 재생 커서를 옮기되 실행하지는 않습니다.
  • / : 재생 커서를 다음/이전 cue로 옮기되 실행하지는 않습니다.

기본 단축키이며, 환경설정 > 키보드 단축키에서 변경할 수 있습니다.

각 cue에는 시작 전 대기 시간(pre-wait)과, "Auto-continue"가 켜져 있을 때 다음 cue가 자동으로 이어지기까지의 대기 시간(post-wait)을 설정할 수 있습니다. "Auto-follow"는 현재 cue가 끝나기를 기다리지 않고 다음 cue를 즉시 실행합니다.

장 2

환경설정

도구 모음의 "환경설정" 버튼을 누르면 특정 프로젝트에 종속되지 않는 모든 설정(하드웨어, 네트워크, 단축키)을 모아 놓은 탭 대화상자가 열립니다. 각 탭은 아래에서 설명하며, 키보드 단축키는 3장, AI 제어는 13장에서 따로 다룹니다.

일반

Onglet 일반 des 환경설정

테마, 비디오 GPU 가속, GO 보호(연속 입력 방지 최소 지연), Stop All 동작(즉시 정지 또는 페이드), cue 목록 클릭 옵션, 설정 내보내기/가져오기.

하단의 "설정 내보내기..." / "설정 가져오기..."는 하드웨어와 무관한 항목(테마, 언어, OSC 패치, 서버, 단축키)을 파일로 저장하거나 옮깁니다. 다른 컴퓨터에 설정을 그대로 옮길 때 유용합니다. 설치마다 다른 화면, 사운드 카드, 비디오 서피스는 포함되지 않습니다.

Audio > Routing

Onglet Audio des 환경설정, sous-onglet Routing

각 물리 출력(사운드 카드)은 한 번만 선언합니다: 이름, 인터페이스, 채널 수.

Audio > Patch

Onglet Audio des 환경설정, sous-onglet Patch

각 patch 채널(7장의 Audio cue 믹서에서 사용)은 여기에서 자유롭게 이름을 정하고, Routing에 선언된 출력의 실제 채널로 라우팅합니다.

비디오 > 라우팅

Onglet Vidéo des 환경설정, sous-onglet Routing

각 물리 출력(화면)은 한 번만 이름을 정합니다. 보정용 테스트 패턴(격자, 체커보드 등)을 바로 띄워 올바른 화면에 제대로 맞았는지 확인할 수 있습니다.

비디오 > 표면

"서피스"는 직사각형 영역을 Routing에 선언된 출력과 연결합니다. Video/Image cue가 목적지로 선택하는 대상이 바로 이것입니다(8장). "지오메트리" 탭:

Onglet Vidéo des 환경설정, sous-onglet Surfaces, Géométrie

이름, 대상 비디오 출력, 이 서피스 전용 보정 패턴, 해상도(출력의 해상도를 가져오는 버튼 포함), 그리고 여러 출력에 걸치도록 하는 "멀티스크린 서피스" 옵션.

"Warp" 탭: 투사 왜곡(평탄하지 않은 벽, 프로젝터 각도)을 보정합니다.

Onglet Vidéo des 환경설정, sous-onglet Surfaces, Warp

왜곡 메시(Linear 또는 Bézier 모드), 포인트의 행/열 수, 마우스 드래그 또는 키보드(화살표, Shift 조합 시 10px 단위) 이동, 서피스 전체를 옮기는 중앙 포인트, 휠 확대/축소.

OSC > Sortant (Patch)

Onglet OSC des 환경설정, sous-onglet Sortant

최대 6개의 patch를 만들 수 있으며, 각각 프로토콜, 뱅크(대상 콘솔/소프트웨어), 송신 네트워크 인터페이스, 목적지, 그리고 프로토콜에 따라 선택적인 비밀번호를 갖습니다. OSC cue에서 사용합니다(10장).

OSC > Entrant (Serveur)

Onglet OSC des 환경설정, sous-onglet Entrant

OSC 명령을 수신해 JustMakeQ를 원격 제어합니다(GO, Stop, Pause, 다음/이전 cue, 특정 cue 번호로 이동).

⚠️ 이 프로토콜에는 비밀번호도 암호화도 없습니다. 해당 포트에 도달할 수 있는 모든 기기가 명령을 보낼 수 있습니다. 사용하지 않을 때는 서버를 끄고, 신뢰할 수 없는 네트워크에서는 "모든 인터페이스" 설정을 피하세요.

PJLink

Onglet PJLink des 환경설정

최대 10대의 프로젝터를 patch할 수 있으며(이름, 송신 인터페이스, 목적지, 포트, 선택적 비밀번호), PJLink cue에서 사용합니다(11장). "?" 버튼을 누르면 이 화면에서 바로 프로젝터 상태를 조회합니다.

MIDI

Onglet MIDI des 환경설정

최대 4개의 출력 포트(MIDI cue용, 9장)와 4개의 입력 포트(MIDI Learn 단축키, 믹싱 콘솔)를 시작 시 자동으로 엽니다.

장 3

키보드 단축키

환경설정 > 키보드 단축키에서 각 단축키를 변경할 수 있으며, 실제 MIDI 컨트롤러(풋스위치, 컨트롤 서피스 등)로 트랜스포트를 제어하는 "MIDI Learn" 기능도 제공합니다.

Onglet 키보드 단축키 des 환경설정

기본 키보드 단축키와 그 아래의 MIDI Learn 단축키("MIDI Learn"을 클릭한 뒤 CC 또는 Note 메시지를 보내면 컨트롤이 연결됩니다).

동작기본 키
GOEspace
Stop AllÉchap
다음 / 이전 cue /
Pause / ResumeP
재생 커서 이동 (Set Head)H

"기본값으로 재설정"을 누르면 변경한 설정이 문제를 일으킬 때 원래 값을 한 번에 되돌릴 수 있습니다.

장 4

인터페이스

메인 창은 세 영역으로 나뉩니다:

Fenêtre principale annotée

위에서 아래로: 트랜스포트 바, cue 추가 바, 그리고 세 영역(활성 미디어, cue 목록, 인스펙터).

  • 트랜스포트 바(상단): GO, Stop All, Pause, Pause All, 이전/다음 이동, Set Head, 그리고 Inspector, 환경설정, Console(믹싱), Preview(미리보기 모니터) 버튼.
  • "+ Cue" 바: cue 유형별 버튼(5장 참고)과, cue 목록의 끌어다 놓기를 잠그는 자물쇠(공연 중 실수로 순서가 바뀌는 것을 막되, 새 파일 추가는 계속 허용).
  • 활성 미디어(왼쪽 위): cue 목록의 커서 위치와 무관하게, 실제로 재생 중인 항목을 실시간으로 보여주는 목록.
  • cue 목록(왼쪽 아래): 공연의 시퀀스. 열 구성: #(번호), Type, Name, Pre/Dur/Post(시간), 루프, 마커, Notes. 주황색 삼각형은 재생 커서(playhead)로, GO를 누르면 실행될 다음 cue를 가리킵니다.
  • 인스펙터(오른쪽): 선택한 cue의 설정을 두 개의 탭으로 제공합니다. "정보"(이름, 번호, 색상, 타이밍, auto-follow/auto-continue로 모든 유형 공통)와 "설정"(cue 유형별, 이후 장 참고).

"☰ 파일" 메뉴에서는 새 프로젝트, 열기, 저장, 번들 만들기(프로젝트와 미디어를 하나의 이동 가능한 폴더로 모음), 그리고 Coworking 세션...(16장)을 사용할 수 있습니다. "?" 메뉴에서는 도움말, 진단 로그, 라이선스 관리를 엽니다.

장 5

cue 유형

JustMakeQ는 17가지 cue 유형을 제공하며, 각각 cue 목록에서 고유한 색으로 표시되어 한눈에 구분됩니다:

Neuf types de cues dans la cue-list

위에서 아래로: Audio, Video, Image, MIDI, OSC, PJLink, HTTP, Fade, Group. 각각 고유한 색을 가집니다.

  • Audio: 사운드 파일 재생, 채널별 라우팅 지원(7장).
  • Video / Image: 투사면에 표시하며, 지오메트리와 효과를 지원합니다(8장).
  • Stream: 라이브 네트워크 비디오 스트림을 투사면에 표시합니다(13장).
  • MIDI: 하나 이상의 MIDI 메시지를 전송합니다(9장).
  • OSC: 사전 설정 뱅크 또는 수동으로 OSC 명령을 전송합니다(10장).
  • PJLink: 네트워크로 연결된 프로젝터를 제어합니다(11장).
  • HTTP: 외부 서비스로 웹 요청을 보내며, 바로 쓸 수 있는 템플릿을 제공합니다(12장).
  • VISCA / ONVIF: 전동 카메라의 팬/틸트/줌 제어(14장).
  • Fade: 이미 실행 중인 다른 cue의 볼륨, 불투명도, 위치, 속도를 점진적으로 변화시킵니다.
  • Play / Pause: 특정한 다른 cue를 실행하거나 일시정지하며, 주 재생 커서는 움직이지 않습니다.
  • Stop: 특정 cue를 정지합니다(대상을 지정하지 않으면 전체).
  • Wait: 시퀀스 안의 단순한 시간 대기.
  • GoTo: 재생 커서를 목록의 다른 cue로 옮깁니다(반복, 분기).
  • Group: 여러 cue를 묶어 순차 재생("Playlist")하거나 동시에 재생("동시")합니다. 6장 참고.
  • Sep(구분선): cue 목록의 시각적 구분 또는 장 표시일 뿐 재생에는 영향이 없으며, GO는 자동으로 건너뜁니다.

장 6

공연 운영하기

재생 커서(playhead, 주황색 삼각형)는 GO를 누를 때마다 한 cue씩 이동합니다. 각 cue에는 시작 전 대기(pre-wait)와 이후 대기(post-wait)를 설정할 수 있습니다. 정보 탭의 두 체크박스가 자동 연결을 제어합니다:

  • Auto-follow: 현재 cue가 끝나기를 기다리지 않고 다음 cue가 즉시 시작됩니다.
  • Auto-continue: post-wait가 끝나면 GO를 다시 누르지 않아도 다음 cue가 자동으로 시작됩니다.

비활성화된 cue("Armed" 체크 해제)는 일반 cue와 동일한 지연을 따르지만 미디어를 재생하지 않습니다. 아직 준비되지 않은 영상이나 음향을 실행하지 않고 리허설할 때, 또는 cue를 삭제하지 않고 잠시 꺼둘 때 유용합니다. cue 목록에서 이름에 취소선이 표시됩니다.

그룹: Playlist 또는 동시

Group cue는 여러 하위 cue를 묶습니다(안으로 끌어다 놓거나, 선택한 뒤 오른쪽 클릭 메뉴의 "그룹화" 사용). 모드는 설정 탭에서 선택합니다:

Réglages d'une cue Group

그룹 모드는 여기에서 선택합니다: Playlist(순차) 또는 동시.

  • Playlist(순차): 하위 cue들이 차례로 이어지며, 각각 자신의 pre/post-wait를 따릅니다.
  • 동시: 모든 하위 cue가 동시에 시작됩니다.

그룹은 모드에 따라 cue 목록에서 고유한 색으로 표시되며, 선택한 상태에서 "<"/">" 키로 펼치거나 접을 수 있습니다.

장 7

Audio cue

Audio cue의 설정 탭에서는 파일 선택, 시작/종료 지점 지정(일부 구간만 재생), 루프, 재생 속도, 그리고 물리 출력으로의 라우팅을 설정할 수 있습니다.

Réglages d'une cue Audio

파일, 시작/종료, Loop, 속도, 그리고 채널별 믹서(Master와 환경설정 > Audio에서 지정한 채널들).

  • 속도: 0.25배에서 4배까지. 속도를 바꾸면 음정도 함께 변합니다(가변 속도 테이프처럼). 피치 보정은 의도적으로 넣지 않았습니다.
  • Mixer / Routing: 설정된 출력 채널마다 페이더가 하나씩(환경설정 > Audio > Routing에서 이름 지정) 있고, Master도 있습니다. "콘솔 설정 붙여넣기"는 출력 콘솔에서 실시간으로 맞춘 레벨을 그대로 가져옵니다(9장).
  • 오디오 효과(믹서 아래): 저음/고음 EQ, 컴프레서/리미터, 16밴드 이퀄라이저(전용 그래픽 인터페이스), 리버브(알고리즘 방식, 컨볼루션 아님), 딜레이. cue당 한 번에 하나의 효과만 활성화됩니다.

이 cue를 대상으로 하는 Fade cue는 이미 재생 중인 볼륨이나 속도를 점진적으로 변화시킬 수 있습니다.

장 8

Video 및 Image cue

Video 또는 Image cue를 실행하려면 먼저 환경설정 > Video > Surfaces에서 투사 "서피스"를 하나 이상 정의해야 하며(2장), 그 서피스는 Routing 탭에 선언된 물리 출력(화면)과 연결되어 있어야 합니다.

서피스가 준비되면 Video/Image cue에서 다음을 설정할 수 있습니다:

Réglages d'une cue Vidéo

파일, 대상 서피스, 그리고 지오메트리(전체 화면, 불투명도, 크기, 위치, 3D X/Y/Z 회전).

  • 지오메트리: 크기, 위치, 3D 회전, 불투명도. 모두 Fade cue로 점진적으로 변화시킬 수 있습니다.
  • Warp(서피스 편집기, 환경설정 > Video > Surfaces, 2장): 메시 기반 변형으로, 평탄하지 않은 면이나 프로젝터 각도로 인한 왜곡을 보정합니다.
  • 효과(Video/Image 공통, 지오메트리 아래): 채도, 대비, 밝기, 흑백, 세피아.
  • 재생 속도(Video 전용): 0.25배에서 4배까지. 영상과 내장 음향은 동기 상태를 유지합니다.
Réglages d'une cue Image, avec le groupe Effets déplié

Image cue는 Video cue와 동일한 지오메트리와 효과를 사용합니다(여기에서는 채도를 선택한 상태).

트랜스포트 바의 "Preview" 버튼은 선택한 출력에서 현재 활성화된 모든 미디어를 합성한 미리보기를 열며, 아무것도 실행하지 않습니다. 공연 전에 화면 구도를 확인할 때 유용합니다.

장 9

MIDI cue와 믹싱 콘솔

MIDI cue는 설정된 출력 포트로 하나 이상의 메시지를 보냅니다:

Réglages d'une cue MIDI

출력 포트, 그리고 자유롭게 추가·삭제할 수 있는 메시지 목록(Note On/Off, Control Change, SysEx, NRPN 등).

포트는 환경설정 > MIDI에서 선언합니다(출력 4개, 입력 4개까지):

Onglet MIDI des 환경설정

입력 포트는 MIDI 명령(MIDI Learn 단축키, 믹싱 콘솔)을 수신하며 시작 시 자동으로 열립니다.

출력 콘솔

트랜스포트 바의 "Console" 버튼을 누르면 믹싱 콘솔이 열립니다. Master와 10개의 출력 채널, VU 미터, 그리고 페이더별 MIDI Learn 할당(실제 컨트롤러로 각 채널을 제어)을 제공합니다.

출력 콘솔

"설정 복사"는 이 레벨을 선택한 Audio cue의 믹서로 옮기고, "전체 0 dB로 재설정"은 모든 페이더를 기준값으로 되돌립니다.

장 10

OSC cue

OSC cue는 외부 소프트웨어나 콘솔로 명령을 보냅니다. 설정 탭에 두 가지 모드가 있습니다:

Réglages d'une cue OSC en mode manuel

"수동" 모드: host/포트/OSC 주소를 직접 입력하며, 인자(Args)의 자료형(숫자, 불리언, 텍스트)은 자동으로 인식됩니다.

  • Patch(사전 설정 뱅크): 환경설정 > OSC > 송신에서 선언한 patch를 선택한 뒤, 대상 제품에 맞게 준비된 목록에서 명령을 고릅니다(ETC Eos, QLab, Midas/Behringer, grandMA3, Resolume, OBS 등).
  • 수동(host / 직접 주소): 뱅크가 지원하지 않는 경우, host/포트/주소/인자를 직접 입력합니다.

송신 patch와 수신 서버는 환경설정 > OSC에서 설정합니다:

Onglet OSC des 환경설정, patchs sortants

최대 6개의 송신 patch를 만들 수 있으며, 각각 프로토콜, 뱅크, 송신 네트워크 인터페이스, 목적지, 그리고 프로토콜에 따라 선택적인 비밀번호를 갖습니다.

JustMakeQ의 기본 포트: 53025(일반 patch)와 53026(로컬 수신 서버). QLab의 기본 포트와 겹치지 않도록 의도적으로 다르게 정했습니다.

장 11

PJLink cue

PJLink는 프로젝터를 제어하기 위한 표준 네트워크 프로토콜입니다(전원 켜기·끄기, 입력 선택, 화면 차단 등). 프로젝터는 환경설정 > PJLink에서 한 번만 patch합니다(10개 슬롯):

Onglet PJLink des 환경설정

각 프로젝터의 이름, 송신 네트워크 인터페이스, 목적지 IP 주소, 포트, 선택적 비밀번호를 설정합니다. 행 끝의 "?" 버튼은 프로젝터를 직접 조회합니다(이름, 제조사, 모델, 전원, 활성 입력, 셔터, 램프, 오류). 마지막 조회 일시는 해당 열에 계속 표시됩니다.

PJLink cue는 patch된 프로젝터와 명령을 고르기만 하면 됩니다:

Réglages d'une cue PJLink

cue는 선택한 프로젝터와 명령에 맞춰 자동으로 이름이 바뀝니다.

장 12

HTTP cue

HTTP cue는 외부 서비스로 웹 요청(GET/POST/PUT/PATCH/DELETE)을 보냅니다. 웹 API를 제공하는 거의 모든 장치나 소프트웨어를 제어할 수 있습니다(스마트 조명, 알림, 홈 오토메이션 등).

Réglages d'une cue HTTP

"제품" 다음 "동작"으로 이어지는 선택 흐름이 바로 쓸 수 있는 템플릿을 제공하며, 메서드·URL·헤더·요청 본문은 자유롭게 수정할 수 있습니다.

vMix, WLED, Bitfocus Companion, Philips Hue, Shelly, Home Assistant, Discord, Pushover, ntfy, PTZOptics 호환 PTZ 카메라 등 15종 안팎의 흔한 제품용 템플릿이 미리 채워져 있어, 매 요청을 직접 작성할 필요가 없습니다. "마지막 응답" 필드는 서버의 응답을 실시간으로 보여 주므로, 공연 전에 요청이 제대로 동작하는지 확인할 때 유용합니다.

"지정 시간 후 자동 재시도" 옵션은 첫 전송이 실패했을 때(일시적인 네트워크 장애) 선택한 시간이 지난 뒤 요청을 한 번만 다시 보냅니다. 두 번 모두 실패한 경우에만 cue가 오류 상태가 됩니다.

장 13

라이브 스트림 cue (Stream)

Stream cue는 네트워크 비디오 라이브 스트림을 투사면에 표시합니다. 표준 스트림을 제공하는 IP 카메라, 인코더, 비디오 믹서를 사용할 수 있습니다. 지오메트리(위치, 크기, 회전), 비디오 효과, 오디오 믹싱(채널별 라우팅, 효과)은 일반 Video cue(8장)와 동일하며, 소스만 다릅니다.

입력한 URL의 접두사로 자동 인식되는 프로토콜: rtsp://, rtsps://, rtmp://, rtmps://, srt://, rist://, udp://, rtp://, tcp://, 그리고 HLS(.m3u8) 또는 DASH(.mpd) 스트림용 http:///https://.

⚠️ 스트림은 끝을 알 수 없으므로, Stream cue에는 Video cue와 달리 길이도, 시작/종료 구간 지정도, 루프도 없습니다. 인스펙터의 미리보기 썸네일은 라이브 스트림에서 한 프레임을 가져오려 시도하며(최대 3초 대기), 실패하면 기본 이미지가 표시됩니다.

장 14

VISCA 및 ONVIF cue (PTZ 카메라)

두 가지 전용 cue로 별도의 소프트웨어 없이 팬/틸트/줌(PTZ) 전동 카메라를 cue에서 직접 제어할 수 있습니다. 이동, 줌, 프리셋 호출 및 저장을 지원합니다.

VISCA-over-IP

대부분의 프로/방송용 PTZ 카메라(Sony 및 호환 기기)가 채택한 표준 바이너리 프로토콜입니다. 각 카메라는 환경설정 > VISCA에서 한 번만 patch하고(목적지, 포트 기본값 52381, VISCA 버스 주소 1~7), 이후 각 VISCA cue에서 patch된 카메라와 명령을 선택합니다(4방향 팬/틸트와 정지, 줌 인/아웃/정지, 홈 위치, 0~127번 프리셋 호출 또는 저장).

ONVIF

SOAP/HTTP 기반의 개방형 표준으로, IP 감시 카메라와 일부 방송용 기기에서 널리 쓰입니다. 각 카메라는 환경설정 > ONVIF에서 patch합니다(목적지, 포트, 사용자 이름/비밀번호, 미디어 프로필, 서비스 경로 — 기본값이 모든 제조사에 맞지는 않으므로 모델별로 확인 필요). 사용 가능한 명령: 연속 이동(팬/틸트/줌 속도 조절), 정지, 홈 위치, 프리셋 호출/저장(VISCA처럼 번호가 아니라 자유로운 이름으로 식별).

⚠️ VISCA-over-IP도 ONVIF도 제공하지 않고 단순한 웹 API만 제공하는 PTZ 카메라(PTZOptics 등 스트리밍용 기기가 많습니다)라면, HTTP cue의 "PTZ 카메라(HTTP CGI)" 템플릿(12장)으로도 충분합니다.

장 15

AI 제어 (MCP)

JustMakeQ에는 MCP(Model Context Protocol) 서버가 내장되어 있어, 호환되는 AI 어시스턴트(Claude Code, Claude Desktop, Codex 등)가 열려 있는 세션을 제어할 수 있습니다. cue 목록 조회, 생성, 수정, 순서 변경과 GO/Stop/Pause 실행이 가능합니다.

Onglet IA / MCP des 환경설정

기본적으로 비활성화되어 있습니다. 수신 포트(53020)와 네트워크 인터페이스(기본값 localhost), 그리고 모든 연결에 필요한 액세스 토큰을 여기에서 설정합니다.

⚠️ 토큰은 네트워크에서 평문으로 전송됩니다(암호화되지 않은 프로토콜). 로컬에서는 필수지만, 사용하지 않을 때는 서버를 끄고, 통제할 수 없는 네트워크에서 localhost 밖으로 열지 마세요. "재생성" 버튼을 누르면 기존 토큰으로 설정된 모든 클라이언트의 접근이 즉시 취소됩니다.

서버를 활성화하면, 주요 AI 클라이언트용 설정 예시를 그대로 복사할 수 있도록 탭에서 제공합니다(CLI 명령, .mcp.json 파일, config.toml).

장 16

협업

Coworking을 사용하면 여러 오퍼레이터가 서로 다른 컴퓨터에서 같은 시퀀스를 동시에 다룰 수 있습니다. 호스트가 실제로 미디어를 재생하고, 접속한 클라이언트는 상태(cue 목록, 상태, playhead)를 실시간으로 확인하며, 권한 수준에 따라 시퀀스를 편집하거나 트랜스포트 명령을 실행할 수 있습니다.

파일 > "Coworking 세션..." 메뉴에서 사용합니다. 호스트로 세션을 시작하거나, 로컬 네트워크에서 자동으로 발견된 세션에 참여할 수 있습니다. 호스트는 새 연결을 하나씩 직접 승인하며, "협업자" 대화상자에서 각 클라이언트의 권한 수준(읽기 전용, 편집, 전체 제어)을 언제든 조정할 수 있습니다.

⚠️ 네트워크 전송은 암호화되지 않습니다(ws://, 포트 53015). 신뢰할 수 있는 기술용 네트워크에서만 사용하고, 관객과 공유하는 공연장 Wi-Fi에서는 피하세요.

장 17

문제 해결

로그 보기

"?" > "로그 보기..." 메뉴를 선택하면 로그 파일이 들어 있는 폴더가 바로 열립니다. 로그는 실행할 때마다 시각이 기록됩니다. 충돌이 발생한 경우 이 폴더에는 전체 Python 예외가 담기거나, 더 낮은 수준(네이티브)의 충돌이라면 오류 시점의 모든 스레드 스택이 담긴 *_fault.log 파일이 따로 생성됩니다. 지원 요청 시 이 파일들을 함께 보내면 진단이 훨씬 빨라집니다.

자주 발생하는 문제

  • Video/Image cue에 아무것도 표시되지 않음: 해당 cue의 설정에서 서피스가 선택되어 있는지, 그리고 그 서피스가 환경설정 > Video > Routing에서 실제 물리 출력과 연결되어 있는지 확인하세요.
  • 소리가 나지 않음: 환경설정 > Audio > Routing에서 선택한 인터페이스와, cue의 설정 탭에 있는 채널별 라우팅을 확인하세요.
  • OSC/HTTP/PJLink 명령이 전송되지 않음: "마지막 응답" 필드(HTTP)나 메인 창 오른쪽 아래의 서버 상태 표시등을 보면 네트워크 연결이 실제로 있는지 확인할 수 있습니다.
  • 라이선스: "?" > "라이선스 관리" 메뉴에서 상세 상태를 확인할 수 있습니다. 활성화 중 네트워크 오류가 발생하면, 이제 메시지가 원인을 알려 줍니다(시스템 시계, 방화벽, DNS, 프록시).

여기에서 다루지 않은 질문은 지원 페이지에서 팀에 직접 문의하실 수 있습니다.