BackStage 설명서

조명을 어느 행잉 바 어디에 걸고 어디를 비출지 화면에서 미리 잡아 보고, 말로 부탁해서 실제 콘솔(grandMA2)까지 세팅하는 도구예요. 조명을 처음 다뤄도 따라 할 수 있게 썼어요.

1. 시작하기

Chrome이나 Edge 최신 버전으로 사이트를 엽니다. 설치는 필요 없어요.
처음 열면 기본 무대가 나와요: 검정 바닥, 갈색 나무 앞단, 행잉 바 2개, 조명 8개, 배우 2명. 벽과 소품은 없어요.
작업 내용은 이 브라우저에 자동 저장돼요. 다른 컴퓨터로 옮기려면 저장·공유를 보세요.

채팅으로 조명 세팅하기와 콘솔 연결은 동아리원 PC에 중계 프로그램을 설치해야 써요(7장). 화면에서 조명 위치를 잡는 것만 할 거라면 설치 없이 바로 쓸 수 있어요.

2. 화면 구성

위치	내용
상단 바	페이지 이동(무대 / 레퍼런스 보드 / 설명서), 시점(객석·위·옆), 되돌리기 ↶ ↷, 저장·열기·초기화
가운데	3D 무대. 무대 크기와 모양은 무대디자인 시안 평면도를 따랐어요(뒤 끝선 폭 7.1m, 객석 쪽으로 넓어지는 사다리꼴, 앞은 곡선).
아래 패널	탭: 조명 · 행잉 바 · 무대·인물 · 채팅 · 콘솔 연결. 가운데 경계선을 끌어 높이를 바꿀 수 있어요.

무대에서 무언가를 클릭하면 그에 맞는 탭이 열려요(조명 → 조명 탭, 바 → 행잉 바 탭, 배우 → 무대·인물 탭).

방향 읽는 법

하수: 객석에서 볼 때 왼쪽 · 상수: 객석에서 볼 때 오른쪽
"뒤에서 3.0m"는 무대 뒤 끝선에서 객석 쪽으로 3m 나온 위치예요.

3. 조명 다루기

고르기와 옮기기

조명 탭 왼쪽 목록이나 무대의 조명을 클릭하면 선택돼요. 선택하면 비추는 곳까지 빨간 점선과 바닥 고리가 보여요.
조명을 끌면 걸린 바 위에서 좌우로 움직여요. 조명은 바에만 걸 수 있어요.
바닥의 빨간 고리를 끌면 비추는 곳이 바뀌어요. Alt+바닥 클릭으로 바로 그 지점을 비출 수도 있어요.

설정 항목

항목	뜻
종류	PAR(강한 색 워시), 프로파일(가장자리가 선명한 원), 프레넬(부드러운 원), 무빙(콘솔에서 방향을 움직이는 조명)
행잉 바 / 바 위치	어느 바의 어디(하수·상수 쪽으로 몇 m)에 거는지
밝기	디머 0~100%
빔 각	빛이 퍼지는 각도. 좁히면 원이 작아지고 더 밝아져요(실제 조명처럼).
가장자리	원 가장자리가 칼같이 선명한지(0) 부드럽게 번지는지(1)
색	색상 선택기나 프리셋(웜 3200K, 쿨 5600K, 빨강, 호박, 파랑, 라벤더 등)
조준 좌우·앞뒤·높이	비추는 지점. 높이 1.2m쯤이면 배우 가슴을 향해요.
인물 조준	배우를 고르면 그 배우를 비추도록 맞춰요.
콘솔 번호	grandMA2에서 이 조명의 Fixture 번호. 콘솔로 보낼 때 써요.

화면에서 보이는 것

빛은 거리가 멀수록 어두워지고, 빛 색과 물체 색이 섞여 보여요. 예를 들어 빨간 빛 아래 파란 옷은 어둡게 보여요.
배우와 벽은 그림자를 만들어요(조명 12개까지 그림자 계산).
공중의 빛줄기는 헤이즈 값으로 진하기를 바꿔요(무대·인물 탭).

화면은 "어디에 걸고 어디를 비출지" 감을 잡는 초안이에요. 실제 밝기와 색은 장비·필터·거리마다 달라요.

4. 행잉 바

행잉 바는 2개예요(1번 바: 앞, 2번 바: 뒤). 바 위치는 무대 뒤 끝선 기준 앞뒤 거리와 높이로 정해요.
무대에서 바를 끌면 앞뒤로, Shift+끌기는 높이를 바꿔요. 바를 고른 뒤 ↑↓, PageUpPageDown도 돼요.
행잉 바 탭에서 슬라이더로 바꾸고, 바마다 걸린 조명을 확인할 수 있어요.
바를 옮기면 걸린 조명도 같이 움직이고, 비추는 곳은 그대로라 각도가 바뀌어요.

5. 무대·인물

뒤쪽 벽 세우기: 기본은 벽이 없어요. 켜면 벽 색과 위치를 정해 빛·그림자가 벽에 어떻게 맺히는지 볼 수 있어요.
헤이즈: 공기 중 빛줄기가 보이는 정도. 작업등: 조명 없이도 무대가 보이게 하는 은은한 전체 빛(실제 공연이라면 0에 가깝게).
인물: 추가·삭제, 위치·키·방향·의상 색. 무대에서 배우를 끌어 옮기고, 선택 후 R로 돌릴 수 있어요.

6. 채팅으로 조명 세팅

채팅 탭에서 원하는 느낌을 말하거나 조명 시안을 첨부하면, AI가 화면의 조명을 바꾸고 콘솔에도 같이 반영돼요.

채팅→이 PC의 중계 프로그램→내 AI(ChatGPT Codex)→화면 조명 변경→콘솔(grandMA2)

중계 프로그램을 실행하고 콘솔 연결 탭에서 연결해요.
AI는 ChatGPT의 Codex를 써요. 이 PC에 Codex CLI가 설치·로그인돼 있어야 해요(7장).
부탁해요. 예:
- "L1, L2를 따뜻한 흰색 60%로, 배우 1을 비추게 해줘"
- "회상 장면처럼 전체를 파란 톤으로 어둡게"
- "2번 바에 프레넬 하나 더 달고 하수 앞 벤치 자리를 비춰줘"
AI가 바꾼 항목은 답변 아래 ↳ 줄로 표시돼요. 마음에 안 들면 Ctrl/⌘+Z로 되돌려요.

첨부: 조명 시안 텍스트(.md, .txt)나 이미지(4MB 이하)를 붙일 수 있어요. PDF·docx는 텍스트로 옮기거나 캡처 이미지로 첨부해 주세요.

AI는 화면 조명만 바꿀 수 있어요. 쇼 파일 삭제 같은 위험한 콘솔 명령은 보내지 않아요.

7. 중계 프로그램 설치 (조명 담당 PC에서 한 번)

중계 프로그램은 사이트와 내 PC의 AI·콘솔을 이어 주는 작은 프로그램이에요. 받아서 더블클릭해 켜 두기만 하면 되고, 창을 닫으면 꺼져요.

받기: 이 PC에 맞는 버튼이 빨갛게 표시돼요. [콘솔 연결] 탭에도 같은 버튼이 있어요.
macOS용 받기 · Windows용 받기
압축 풀고 실행: backstage-bridge 폴더의 start-backstage를 더블클릭해요. 처음 한 번은 파이썬 실행 도구(uv)를 자동으로 설치해서 1~2분 걸려요.
- macOS에서 "확인되지 않은 개발자"라며 막히면: 시스템 설정 → 개인정보 보호 및 보안 → 아래쪽 그래도 열기를 누른 뒤 다시 실행해요.
- Windows에서 "Windows의 PC 보호" 창이 뜨면: 추가 정보 → 실행을 눌러요.
연결: 창에 나온 연결 토큰을 [콘솔 연결] 탭에 붙여 넣어요. 이 창은 켜 둔 채로 두세요.
Codex 설치·로그인(채팅을 쓸 때만): Codex CLI 안내대로 설치하고(예: Node.js가 있으면 npm install -g @openai/codex), codex login으로 내 ChatGPT 계정에 로그인해요. 무료 계정도 쓸 수 있지만 사용량 한도가 작아요. 설치한 뒤에는 중계 프로그램을 다시 켜요.
콘솔까지 쓰려면 grandma2-mcp를 받아 두고 콘솔 주소를 설정해요. 받은 폴더의 bridge/README.md 3절을 보세요.

처음 연결할 때 Chrome이 "로컬 네트워크의 기기에 접근" 허용을 물어볼 수 있어요. 허용해야 사이트가 이 PC의 중계 프로그램과 이야기할 수 있어요.

8. 콘솔 연결

콘솔 연결 탭에서 중계 주소(기본 http://127.0.0.1:47800)와 연결 토큰을 넣고 [연결 확인]을 눌러요. 탭 이름 옆이 연결됨으로 바뀌면 성공이에요.
조명마다 콘솔 번호(grandMA2 Fixture 번호)를 조명 탭에서 맞춰요. 기본값은 101~108이에요.
화면이 바뀌면 자동으로 콘솔에 보내기를 켜면, 화면에서 바꾼 것(직접 조작이든 채팅이든)이 콘솔로 가요. [지금 전체 보내기]는 한꺼번에 다시 보내요.
콘솔이 없으면 중계 프로그램이 mock(연습) 모드로 돌아 보낼 명령만 기록해요. 최근 전송 칸에서 확인할 수 있어요.

방향은 한쪽이에요: 화면 → 콘솔. 콘솔에서 직접 바꾼 값은 화면으로 돌아오지 않아요.

9. 저장·공유

자동 저장: 이 컴퓨터의 이 브라우저 안. 브라우저 사이트 데이터를 지우면 사라져요.
저장: 지금 무대를 .json 파일로 내려받아요. 열기: 그 파일을 불러와요. 팀원에게 파일을 보내 같은 무대를 보게 할 수 있어요.
초기화: 기본 무대로. 되돌리기로 취소할 수 있어요.

10. 단축키

키	하는 일
`1` `2` `3`	객석 / 위 / 옆 시점
`Tab` (`Shift`+`Tab`)	다음(이전) 조명 선택
`←` `→`	선택한 조명을 바 위에서 0.1m 이동(`Shift`: 0.5m)
`↑` `↓`	선택한 바를 앞뒤로 이동 / 선택한 배우 이동(방향키 모두)
`PageUp` `PageDown`	선택한 바 높이
`R` (`Shift`+`R`)	선택한 배우 회전
`Delete`	선택한 조명·배우 삭제
`Alt`+바닥 클릭	선택한 조명을 그 지점으로 조준
`Ctrl/⌘`+`Z` / +`Shift`	되돌리기 / 다시 하기
`Esc`	선택 해제

11. 자주 묻는 질문

3D 화면이 안 보여요

WebGL이 필요해요. Chrome·Edge 최신 버전인지, 하드웨어 가속이 켜져 있는지 확인하세요.

채팅이 "중계 프로그램 연결 안 됨"이에요

중계 프로그램 창이 켜져 있는지, 콘솔 연결 탭의 토큰이 창에 나온 것과 같은지 확인하세요. Chrome이 로컬 네트워크 접근을 물었다면 허용해야 해요.

"Codex CLI가 설치되어 있지 않아요"라고 나와요

이 PC에 Codex CLI를 설치하고 codex login으로 로그인한 뒤, 중계 프로그램 창을 닫고 다시 실행하세요(7장).

화면이 느려요

조명이 많으면 그림자 계산이 무거워져요. 헤이즈를 0으로 하거나 쓰지 않는 조명을 지워 보세요.

12. 레퍼런스 보드

여러 사람이 낸 조명 레퍼런스를 장면별로 나란히 비교해 하나의 메인 플로우로 모으는 도구예요. 상단의 레퍼런스 보드에서 열고, 사용법은 보드 설명서를 보세요.