매뉴얼 d'utilisation
JustMakeQ 시작하기와 전체 레퍼런스를 장별로 안내합니다.
장 1
JustMakeQ는 멀티미디어 쇼 컨트롤 소프트웨어입니다. 공연이 진행되는 동안 "cue" 목록(오디오, 비디오, 이미지, MIDI, OSC 등)을 순서대로 재생하며, GO 키로 하나씩 실행합니다.
다운로드 공간에서 사용 중인 시스템에 맞는 설치 프로그램을 내려받아 실행하세요. 처음 실행하면 시작 화면이 표시됩니다:
시작 화면: 새 프로젝트 만들기, 기존 프로젝트 열기, 최근 프로젝트 불러오기.
라이선스 상태는 로고 아래에 표시됩니다("라이선스 활성화됨"이 녹색으로). 아직 활성화되지 않았다면 "라이선스 관리" 버튼으로 활성화 마법사를 열고, 계정 생성 시 이메일로 받은 .jmqa 파일을 사용하세요.
"새 Q"를 클릭해 빈 프로젝트를 시작하세요. 아직 비어 있는 cue 목록과 함께 메인 창이 열립니다:
메인 창: 상단에 트랜스포트 바(GO/Stop/Pause), 그 아래에 cue 추가 버튼, 왼쪽에 cue 목록, 오른쪽에 인스펙터.
cue를 추가하려면 "+ Cue" 바에서 유형을 클릭하세요(Audio, Video, Image, MIDI, OSC, PJLink, HTTP, Fade, Play, Pause, Stop, Wait, Group, Sep). 바로 cue 목록에 나타납니다:
Audio cue가 방금 추가되었습니다. 파일이 지정되기 전까지는 빨강/주황으로 표시됩니다.
목록에서 cue를 클릭하면 오른쪽 인스펙터에 열립니다. 모든 매개변수는 여기에서 설정하며, 먼저 "설정" 탭에서 재생할 파일을 지정합니다.
선택된 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장에서 따로 다룹니다.
테마, 비디오 GPU 가속, GO 보호(연속 입력 방지 최소 지연), Stop All 동작(즉시 정지 또는 페이드), cue 목록 클릭 옵션, 설정 내보내기/가져오기.
하단의 "설정 내보내기..." / "설정 가져오기..."는 하드웨어와 무관한 항목(테마, 언어, OSC 패치, 서버, 단축키)을 파일로 저장하거나 옮깁니다. 다른 컴퓨터에 설정을 그대로 옮길 때 유용합니다. 설치마다 다른 화면, 사운드 카드, 비디오 서피스는 포함되지 않습니다.
각 물리 출력(사운드 카드)은 한 번만 선언합니다: 이름, 인터페이스, 채널 수.
각 patch 채널(7장의 Audio cue 믹서에서 사용)은 여기에서 자유롭게 이름을 정하고, Routing에 선언된 출력의 실제 채널로 라우팅합니다.
각 물리 출력(화면)은 한 번만 이름을 정합니다. 보정용 테스트 패턴(격자, 체커보드 등)을 바로 띄워 올바른 화면에 제대로 맞았는지 확인할 수 있습니다.
"서피스"는 직사각형 영역을 Routing에 선언된 출력과 연결합니다. Video/Image cue가 목적지로 선택하는 대상이 바로 이것입니다(8장). "지오메트리" 탭:
이름, 대상 비디오 출력, 이 서피스 전용 보정 패턴, 해상도(출력의 해상도를 가져오는 버튼 포함), 그리고 여러 출력에 걸치도록 하는 "멀티스크린 서피스" 옵션.
"Warp" 탭: 투사 왜곡(평탄하지 않은 벽, 프로젝터 각도)을 보정합니다.
왜곡 메시(Linear 또는 Bézier 모드), 포인트의 행/열 수, 마우스 드래그 또는 키보드(화살표, Shift 조합 시 10px 단위) 이동, 서피스 전체를 옮기는 중앙 포인트, 휠 확대/축소.
최대 6개의 patch를 만들 수 있으며, 각각 프로토콜, 뱅크(대상 콘솔/소프트웨어), 송신 네트워크 인터페이스, 목적지, 그리고 프로토콜에 따라 선택적인 비밀번호를 갖습니다. OSC cue에서 사용합니다(10장).
OSC 명령을 수신해 JustMakeQ를 원격 제어합니다(GO, Stop, Pause, 다음/이전 cue, 특정 cue 번호로 이동).
최대 10대의 프로젝터를 patch할 수 있으며(이름, 송신 인터페이스, 목적지, 포트, 선택적 비밀번호), PJLink cue에서 사용합니다(11장). "?" 버튼을 누르면 이 화면에서 바로 프로젝터 상태를 조회합니다.
최대 4개의 출력 포트(MIDI cue용, 9장)와 4개의 입력 포트(MIDI Learn 단축키, 믹싱 콘솔)를 시작 시 자동으로 엽니다.
장 3
환경설정 > 키보드 단축키에서 각 단축키를 변경할 수 있으며, 실제 MIDI 컨트롤러(풋스위치, 컨트롤 서피스 등)로 트랜스포트를 제어하는 "MIDI Learn" 기능도 제공합니다.
기본 키보드 단축키와 그 아래의 MIDI Learn 단축키("MIDI Learn"을 클릭한 뒤 CC 또는 Note 메시지를 보내면 컨트롤이 연결됩니다).
| 동작 | 기본 키 |
|---|---|
| GO | Espace |
| Stop All | Échap |
| 다음 / 이전 cue | ↓ / ↑ |
| Pause / Resume | P |
| 재생 커서 이동 (Set Head) | H |
"기본값으로 재설정"을 누르면 변경한 설정이 문제를 일으킬 때 원래 값을 한 번에 되돌릴 수 있습니다.
장 4
메인 창은 세 영역으로 나뉩니다:
위에서 아래로: 트랜스포트 바, cue 추가 바, 그리고 세 영역(활성 미디어, cue 목록, 인스펙터).
"☰ 파일" 메뉴에서는 새 프로젝트, 열기, 저장, 번들 만들기(프로젝트와 미디어를 하나의 이동 가능한 폴더로 모음), 그리고 Coworking 세션...(16장)을 사용할 수 있습니다. "?" 메뉴에서는 도움말, 진단 로그, 라이선스 관리를 엽니다.
장 5
JustMakeQ는 17가지 cue 유형을 제공하며, 각각 cue 목록에서 고유한 색으로 표시되어 한눈에 구분됩니다:
위에서 아래로: Audio, Video, Image, MIDI, OSC, PJLink, HTTP, Fade, Group. 각각 고유한 색을 가집니다.
장 6
재생 커서(playhead, 주황색 삼각형)는 GO를 누를 때마다 한 cue씩 이동합니다. 각 cue에는 시작 전 대기(pre-wait)와 이후 대기(post-wait)를 설정할 수 있습니다. 정보 탭의 두 체크박스가 자동 연결을 제어합니다:
비활성화된 cue("Armed" 체크 해제)는 일반 cue와 동일한 지연을 따르지만 미디어를 재생하지 않습니다. 아직 준비되지 않은 영상이나 음향을 실행하지 않고 리허설할 때, 또는 cue를 삭제하지 않고 잠시 꺼둘 때 유용합니다. cue 목록에서 이름에 취소선이 표시됩니다.
Group cue는 여러 하위 cue를 묶습니다(안으로 끌어다 놓거나, 선택한 뒤 오른쪽 클릭 메뉴의 "그룹화" 사용). 모드는 설정 탭에서 선택합니다:
그룹 모드는 여기에서 선택합니다: Playlist(순차) 또는 동시.
그룹은 모드에 따라 cue 목록에서 고유한 색으로 표시되며, 선택한 상태에서 "<"/">" 키로 펼치거나 접을 수 있습니다.
장 7
Audio cue의 설정 탭에서는 파일 선택, 시작/종료 지점 지정(일부 구간만 재생), 루프, 재생 속도, 그리고 물리 출력으로의 라우팅을 설정할 수 있습니다.
파일, 시작/종료, Loop, 속도, 그리고 채널별 믹서(Master와 환경설정 > Audio에서 지정한 채널들).
이 cue를 대상으로 하는 Fade cue는 이미 재생 중인 볼륨이나 속도를 점진적으로 변화시킬 수 있습니다.
장 8
Video 또는 Image cue를 실행하려면 먼저 환경설정 > Video > Surfaces에서 투사 "서피스"를 하나 이상 정의해야 하며(2장), 그 서피스는 Routing 탭에 선언된 물리 출력(화면)과 연결되어 있어야 합니다.
서피스가 준비되면 Video/Image cue에서 다음을 설정할 수 있습니다:
파일, 대상 서피스, 그리고 지오메트리(전체 화면, 불투명도, 크기, 위치, 3D X/Y/Z 회전).
Image cue는 Video cue와 동일한 지오메트리와 효과를 사용합니다(여기에서는 채도를 선택한 상태).
트랜스포트 바의 "Preview" 버튼은 선택한 출력에서 현재 활성화된 모든 미디어를 합성한 미리보기를 열며, 아무것도 실행하지 않습니다. 공연 전에 화면 구도를 확인할 때 유용합니다.
장 9
MIDI cue는 설정된 출력 포트로 하나 이상의 메시지를 보냅니다:
출력 포트, 그리고 자유롭게 추가·삭제할 수 있는 메시지 목록(Note On/Off, Control Change, SysEx, NRPN 등).
포트는 환경설정 > MIDI에서 선언합니다(출력 4개, 입력 4개까지):
입력 포트는 MIDI 명령(MIDI Learn 단축키, 믹싱 콘솔)을 수신하며 시작 시 자동으로 열립니다.
트랜스포트 바의 "Console" 버튼을 누르면 믹싱 콘솔이 열립니다. Master와 10개의 출력 채널, VU 미터, 그리고 페이더별 MIDI Learn 할당(실제 컨트롤러로 각 채널을 제어)을 제공합니다.
"설정 복사"는 이 레벨을 선택한 Audio cue의 믹서로 옮기고, "전체 0 dB로 재설정"은 모든 페이더를 기준값으로 되돌립니다.
장 10
OSC cue는 외부 소프트웨어나 콘솔로 명령을 보냅니다. 설정 탭에 두 가지 모드가 있습니다:
"수동" 모드: host/포트/OSC 주소를 직접 입력하며, 인자(Args)의 자료형(숫자, 불리언, 텍스트)은 자동으로 인식됩니다.
송신 patch와 수신 서버는 환경설정 > OSC에서 설정합니다:
최대 6개의 송신 patch를 만들 수 있으며, 각각 프로토콜, 뱅크, 송신 네트워크 인터페이스, 목적지, 그리고 프로토콜에 따라 선택적인 비밀번호를 갖습니다.
JustMakeQ의 기본 포트: 53025(일반 patch)와 53026(로컬 수신 서버). QLab의 기본 포트와 겹치지 않도록 의도적으로 다르게 정했습니다.
장 11
PJLink는 프로젝터를 제어하기 위한 표준 네트워크 프로토콜입니다(전원 켜기·끄기, 입력 선택, 화면 차단 등). 프로젝터는 환경설정 > PJLink에서 한 번만 patch합니다(10개 슬롯):
각 프로젝터의 이름, 송신 네트워크 인터페이스, 목적지 IP 주소, 포트, 선택적 비밀번호를 설정합니다. 행 끝의 "?" 버튼은 프로젝터를 직접 조회합니다(이름, 제조사, 모델, 전원, 활성 입력, 셔터, 램프, 오류). 마지막 조회 일시는 해당 열에 계속 표시됩니다.
PJLink cue는 patch된 프로젝터와 명령을 고르기만 하면 됩니다:
cue는 선택한 프로젝터와 명령에 맞춰 자동으로 이름이 바뀝니다.
장 12
HTTP cue는 외부 서비스로 웹 요청(GET/POST/PUT/PATCH/DELETE)을 보냅니다. 웹 API를 제공하는 거의 모든 장치나 소프트웨어를 제어할 수 있습니다(스마트 조명, 알림, 홈 오토메이션 등).
"제품" 다음 "동작"으로 이어지는 선택 흐름이 바로 쓸 수 있는 템플릿을 제공하며, 메서드·URL·헤더·요청 본문은 자유롭게 수정할 수 있습니다.
vMix, WLED, Bitfocus Companion, Philips Hue, Shelly, Home Assistant, Discord, Pushover, ntfy, PTZOptics 호환 PTZ 카메라 등 15종 안팎의 흔한 제품용 템플릿이 미리 채워져 있어, 매 요청을 직접 작성할 필요가 없습니다. "마지막 응답" 필드는 서버의 응답을 실시간으로 보여 주므로, 공연 전에 요청이 제대로 동작하는지 확인할 때 유용합니다.
"지정 시간 후 자동 재시도" 옵션은 첫 전송이 실패했을 때(일시적인 네트워크 장애) 선택한 시간이 지난 뒤 요청을 한 번만 다시 보냅니다. 두 번 모두 실패한 경우에만 cue가 오류 상태가 됩니다.
장 13
Stream cue는 네트워크 비디오 라이브 스트림을 투사면에 표시합니다. 표준 스트림을 제공하는 IP 카메라, 인코더, 비디오 믹서를 사용할 수 있습니다. 지오메트리(위치, 크기, 회전), 비디오 효과, 오디오 믹싱(채널별 라우팅, 효과)은 일반 Video cue(8장)와 동일하며, 소스만 다릅니다.
입력한 URL의 접두사로 자동 인식되는 프로토콜: rtsp://, rtsps://, rtmp://, rtmps://, srt://, rist://, udp://, rtp://, tcp://, 그리고 HLS(.m3u8) 또는 DASH(.mpd) 스트림용 http:///https://.
장 14
두 가지 전용 cue로 별도의 소프트웨어 없이 팬/틸트/줌(PTZ) 전동 카메라를 cue에서 직접 제어할 수 있습니다. 이동, 줌, 프리셋 호출 및 저장을 지원합니다.
대부분의 프로/방송용 PTZ 카메라(Sony 및 호환 기기)가 채택한 표준 바이너리 프로토콜입니다. 각 카메라는 환경설정 > VISCA에서 한 번만 patch하고(목적지, 포트 기본값 52381, VISCA 버스 주소 1~7), 이후 각 VISCA cue에서 patch된 카메라와 명령을 선택합니다(4방향 팬/틸트와 정지, 줌 인/아웃/정지, 홈 위치, 0~127번 프리셋 호출 또는 저장).
SOAP/HTTP 기반의 개방형 표준으로, IP 감시 카메라와 일부 방송용 기기에서 널리 쓰입니다. 각 카메라는 환경설정 > ONVIF에서 patch합니다(목적지, 포트, 사용자 이름/비밀번호, 미디어 프로필, 서비스 경로 — 기본값이 모든 제조사에 맞지는 않으므로 모델별로 확인 필요). 사용 가능한 명령: 연속 이동(팬/틸트/줌 속도 조절), 정지, 홈 위치, 프리셋 호출/저장(VISCA처럼 번호가 아니라 자유로운 이름으로 식별).
장 15
JustMakeQ에는 MCP(Model Context Protocol) 서버가 내장되어 있어, 호환되는 AI 어시스턴트(Claude Code, Claude Desktop, Codex 등)가 열려 있는 세션을 제어할 수 있습니다. cue 목록 조회, 생성, 수정, 순서 변경과 GO/Stop/Pause 실행이 가능합니다.
기본적으로 비활성화되어 있습니다. 수신 포트(53020)와 네트워크 인터페이스(기본값 localhost), 그리고 모든 연결에 필요한 액세스 토큰을 여기에서 설정합니다.
localhost 밖으로 열지 마세요. "재생성" 버튼을 누르면 기존 토큰으로 설정된 모든 클라이언트의 접근이 즉시 취소됩니다.
서버를 활성화하면, 주요 AI 클라이언트용 설정 예시를 그대로 복사할 수 있도록 탭에서 제공합니다(CLI 명령, .mcp.json 파일, config.toml).
장 16
Coworking을 사용하면 여러 오퍼레이터가 서로 다른 컴퓨터에서 같은 시퀀스를 동시에 다룰 수 있습니다. 호스트가 실제로 미디어를 재생하고, 접속한 클라이언트는 상태(cue 목록, 상태, playhead)를 실시간으로 확인하며, 권한 수준에 따라 시퀀스를 편집하거나 트랜스포트 명령을 실행할 수 있습니다.
파일 > "Coworking 세션..." 메뉴에서 사용합니다. 호스트로 세션을 시작하거나, 로컬 네트워크에서 자동으로 발견된 세션에 참여할 수 있습니다. 호스트는 새 연결을 하나씩 직접 승인하며, "협업자" 대화상자에서 각 클라이언트의 권한 수준(읽기 전용, 편집, 전체 제어)을 언제든 조정할 수 있습니다.
ws://, 포트 53015). 신뢰할 수 있는 기술용 네트워크에서만 사용하고, 관객과 공유하는 공연장 Wi-Fi에서는 피하세요.
장 17
"?" > "로그 보기..." 메뉴를 선택하면 로그 파일이 들어 있는 폴더가 바로 열립니다. 로그는 실행할 때마다 시각이 기록됩니다. 충돌이 발생한 경우 이 폴더에는 전체 Python 예외가 담기거나, 더 낮은 수준(네이티브)의 충돌이라면 오류 시점의 모든 스레드 스택이 담긴 *_fault.log 파일이 따로 생성됩니다. 지원 요청 시 이 파일들을 함께 보내면 진단이 훨씬 빨라집니다.
여기에서 다루지 않은 질문은 지원 페이지에서 팀에 직접 문의하실 수 있습니다.