映像送出Mac 設定手順書

梅＋スイッチャ案（オペレーター2人）／ MacBook Pro M5 Max ＋ QLab 5 ＋ UltraStudio 4K Mini ＋ ATEM 1 M/E Constellation HD ＋ Stream Deck XL ＋ EV2130

凡例: 事実=公式資料で確認済 仮定=もっともらしいが実機未確認 要確認=現場で決める

0. 初期化直後のキッティング手順（macOS クリーンインストール → 本番機）

0-1. 初期設定ウィザード（本人・10分）

1. 言語=日本語、キーボード=日本語。Wi-Fi は保守用ネットワークに接続
2. Apple ID はスキップ（本番機に iCloud 同期・通知を入れない）。後で App Store が要る時だけ入れる
3. ユーザ名は wyverns（管理者）。FileVault は OFF（自動ログインの前提）
4. 位置情報・解析データ共有・Siri・Screen Time はすべて OFF
5. 外観はどちらでも可。True Tone は後で OFF にする

0-2. 共有設定（本人・1分）

システム設定 → 一般 → 共有 はすべて OFF のまま（リモートログイン・画面共有・ファイル共有・AirPlay レシーバー）。保守は TeamViewer のみ。

0-3. セットアップスクリプト（本人・ターミナルで）

curl -fsSL -o ~/setup-playout-mac.sh https://yamagata-yirfk1aus6.pages.dev/setup-playout-mac.sh
bash ~/setup-playout-mac.sh --dry-run     # 何をするか確認（任意）
bash ~/setup-playout-mac.sh               # 全適用。最初に管理者パスワードを1回聞く
                                          # → Xcode CLT のダイアログが出たら「インストール」を押す（数分）

• QLab・Companion は Homebrew で入る。TeamViewer は pkg なので同じターミナルで入る（ssh 越しでは入らない）
• 途中で止まってももう一度同じコマンドでよい（導入済みは SKIP される）

0-4. Blackmagic 3種（本人・ブラウザ）

1. スクリプトが開く サポートページ から Desktop Video・ATEM Switchers・Converters の最新版を DL → インストール
2. 再起動 → もう一度 bash ~/setup-playout-mac.sh（検出されて OK になる）

0-5. GUI でしかできない設定（本人・10分）

スクリプト末尾に出るチェックリストどおり（ロック画面のパスワード要求 OFF・自動ログイン・集中モード・AirPlay レシーバー OFF・True Tone/Night Shift OFF・サウンド出力=内蔵・TeamViewer の権限）。

0-6. 検証（本人がターミナルで1行 → 出力を綴へ貼る）

bash ~/setup-playout-mac.sh --check

「===== PLAYOUT-MAC CHECK」から「===== END」までをそのまま綴へコピペする。綴が合否（pmset 全 0・アプリ4系統・固定 IP・ログイン項目・自動更新 OFF）を判定し、外れた項目のコマンドを返す。

0-7. アプリ側の初期設定

§3（Desktop Video Setup → ATEM → Companion → QLab → TeamViewer）の順。QLab の Video ライセンスは本体購入後に qlab.app でこの Mac に紐付ける。

1. 系統とIP設計

信号の流れ

IP設計（ATEM制御LAN・閉域・インターネットなし）

2. IP設定の手順

2-1. ATEM側（初回のみ・USB-C で Mac に直結）

1. ATEM の USB-C と Mac を接続し、Blackmagic ATEM Setup を起動
2. スイッチャーのアイコンをクリック → Configure タブ
3. Network: Static IP、IP 192.168.10.240、Subnet 255.255.255.0、Gateway 空欄（または同値）→ Save
4. USB-C を抜き、以後は LAN で制御

2-2. Mac側（スクリプトで）

networksetup -listallnetworkservices      # アダプタ名を確認（例: USB 10/100/1000/2.5G LAN）
ATEM_IF_NAME="USB 10/100/1000/2.5G LAN" bash setup-playout-mac.sh --no-apps

GUIなら: システム設定 → ネットワーク → 該当アダプタ → 詳細 → TCP/IP → IPv4を「手入力」→ IP 192.168.10.50 / サブネット 255.255.255.0 / ルーター空欄。

2-3. 疎通確認

ping -c 3 192.168.10.240     # 返れば OK
open -a "ATEM Software Control"   # 接続先に 192.168.10.240 を入れて接続

3. 各機器の設定

3-1. UltraStudio 4K Mini（Blackmagic Desktop Video Setup）

3-2. ATEM 1 M/E Constellation HD（ATEM Software Control）

3-3. Micro Converter BiDirectional 3G（Blackmagic Converters Setup）

• 1台で HDMI→SDI と SDI→HDMI を同時に処理する事実。エンゲート入力と確認モニターが同じ卓上なら1台で足りる。離れていれば2台（現行図は2台分の役割）要確認
• 電源は USB-C（5V）。Mac のUSBから取ると Mac 落ちで消えるのでUSB電源アダプタから給電
• 設定は出荷時のままで可。触るのは SDI Level A/B と HDMI 出力フォーマット（入力に追従）のみ

3-4. EV2130（確認モニター）

• 入力 HDMI。画面モード「アスペクト比固定」（16:9 を潰さない）
• Auto EcoView（環境光で明るさが変わる）OFF、パワーセーブ OFF

3-5. Stream Deck XL ＋ Bitfocus Companion

概要のみ。操作手順は 3A. Companion の設定 を見る。

1. Companion を起動（メニューバーのアイコン → Launch GUI）。Launch at login を ON
2. Surfaces: Stream Deck XL が自動検出されること。出なければ Elgato の純正アプリが掴んでいる（純正アプリは入れない／入れたら Preferences → Devices → 該当XL を Enabled: No）事実
3. Connections → 追加:
   • Blackmagic Design: ATEM ／ IP 192.168.10.240
   • Figure 53: QLab ／ IP 127.0.0.1 ポート 53000（同じMac上のQLab）。QLab側でOSCパスコードを設定した場合はここにも入れる
4. Buttons: 下の配置案を作る（8列×4段）。Program 列は ATEM の tally（ON AIR で赤）を Feedback で受ける

青=Program選択 ／ 橙=Aux1（TO前ビジョン）選択 ／ 緑=QLab ／ 赤=遷移・非常用。PANIC=全再生停止。FTB=Fade to Black。

3-6. QLab 5（ワークスペース設定）

3-7. TeamViewer（保守）

• 初回起動時、システム設定 → プライバシーとセキュリティで 画面収録・アクセシビリティ を許可（GUI操作が必要）
• 保守用アカウントにサインイン → 「簡単アクセス（Easy Access）」ON＝無人接続
• インターネットは Wi-Fi 側。ATEM LAN には出ない（§1）。本番中に接続する時は Companion や QLab の画面を触らない

3A. Companion の設定（qlabmac・ステップバイステップ）

対象: Bitfocus Companion 5.0.6／Stream Deck XL／ATEM 1 M/E Constellation HD／QLab 5.6。画面の英語ラベルは公式ガイドとモジュールの定義から引用（2026-09-29 確認）。未知 は公式資料に記載が無く、実機で確かめる項目。

STEP 1　起動とランチャー（小窓）

1. Stream Deck XL を Mac 本体の USB-C に直挿しする（ハブを介さない）。純正の Elgato Stream Deck アプリは入れていないこと。
2. アプリケーション → Companion を開く。メニューバーにアイコンが出て、小さな窓（ランチャー）が開く。
3. ランチャーの項目を次のとおりにする。

   項目	値	理由
   「GUI Interface」	127.0.0.1（ローカルのみ）	管理画面を他の機器から開けなくする。別 PC から設定したい時だけ LAN の IP にする
   「Port」	8000（既定）	変える理由がなければそのまま
   「Run at login」	ON	電源を入れたら自動で立ち上がる（スクリプトのログイン項目と重複しても害なし）
   「Start minimized」	ON（運用に入ってから）	起動のたびに窓が前に出ない

4. 「Launch GUI」を押す。既定のブラウザで管理画面が開く（http://127.0.0.1:8000 仮定）。
5. macOS が「ネットワーク接続の受信を許可しますか」等を出したら許可する未知（公式ガイドに macOS の権限の記載なし。出たものをメモしておく）。

STEP 2　Stream Deck XL を認識させる（Surfaces）

1. 管理画面の Surfaces タブを開く。
2. 一覧に Stream Deck XL が無ければ「Rescan USB」を押す。「Watch for new USB Devices」を ON にしておくと抜き差しで自動検出する。
3. 出ない時: Stream Deck 用のサーフェスモジュールが未導入（画面の案内に従って導入・要インターネット）／USB を挿し直す／純正アプリが動いていないか確認。
4. 一覧の XL を選び、次を設定する。

   項目	値
   「Surface Name」	SD-XL
   「Startup Page」	1（「Use Last Page At Startup」は OFF）
   「Brightness」	会場の明るさに合わせる（暗い卓なら 40〜60）
   「Surface Rotation」	0
   「Never pin code lock」	ON（本番中にロックさせない）

5. XL の全キーに Companion の初期画面が出れば認識完了。

STEP 3　ATEM を接続する（Connections）

1. Connections タブ → 検索欄に ATEM → 「Blackmagic Design: ATEM」を選ぶ。
2. モジュールのバージョンは最新を選ぶ（未導入ならここで取得・要インターネット）。
3. 設定欄:

   項目	値
   Label（接続名）	atem（変数やボタンでこの名前を使う）
   「Target IP」	192.168.10.240
   「Model」	自動判別のまま。「Detected Model」に 1 M/E Constellation HD と出ることを確認
   「Preset Style」	Short Names（キーの文字が大きくなる）
   「Enable Camera Control」「Enable Timecode variable」	OFF（使わない）

4. 保存。一覧の状態が正常になること。ATEM を繋いでいない間はエラー表示のままで正常（実機接続後に確認）。
5. うまくいかない時: 一覧右端のメニュー →「View Logs」。ターミナルで ping 192.168.10.240。USB では制御できない（ネットワーク必須）事実。

STEP 4　QLab 側で OSC を受ける設定

1. QLab で本番用のワークスペースを開く → Workspace Settings → Network → OSC Access タブ。
2. 左上のチェックで OSC 受信を ON。
3. 表を確認する。1 行目「No Passcode」は View／Edit／Control の全てチェックなしのまま（既定）事実。
4. 新規ワークスペースには 4 桁のパスコードが 1 つ自動で入っている（View／Edit／Control すべて ON）。この 4 桁を控える。Companion 専用に分けたい時は行を足し、Control と View を ON にした 4 桁を作る。
5. 「OSC listening port」は 53000 のまま。

STEP 5　QLab を接続する（Connections）

1. Connections タブ → 検索欄に QLab → 「Figure 53: QLab」。バージョンは 2.1.0 以上（QLab 5.2 以降の必須条件）事実。
2. 設定欄:

   項目	値
   Label	qlab
   「Target Host/IP」	127.0.0.1（同じ Mac 上の QLab）
   「Target Port」	53000
   「Use TCP?」	ON（OFF だと変数とフィードバックが動かない）
   「OSC Passcode」	STEP 4 の 4 桁
   「Workspace」	本番のワークスペースを選ぶ（QLab 5 は未指定だと開いている全ワークスペースに命令が飛ぶ）
   「Specific Cue List」	キューリストが 1 つなら未指定
   「Use Tenths?」	任意（残り時間を 0.1 秒まで出す）

3. 保存 → 状態が正常になること。QLab を閉じるとエラーになるのは正常。

STEP 6　ボタンを作る（Buttons）

Stream Deck XL は 8 列 × 4 段。§3-5 の配置案をページ 1 に作る。早いのは Presets から置く方法。

1. Buttons タブ → 右側の Presets タブ → 接続 atem を選ぶ → 分類（Program／Aux/Output／Transitions など）を開く。
2. 使いたいボタンを、左のグリッドの置きたい位置へドラッグする。動作（アクション）と点灯（フィードバック）が最初から入っている。
3. 同じ要領で接続 qlab の Presets から Go／Stop／Panic／Previous／Next を置く（QLab モジュールは主要アクションに Presets あり事実）。
4. Presets に無いものは手で作る: 空のキーをクリック →「Regular button」→ 文字を入れる →「Add Press/on action」で下表のアクションを選ぶ → Feedbacks に下表のフィードバックを足す。

• 変数の書式は $(接続名:変数名)。Program の入力名は $(atem:pgm1_input)。
• QLab の「Go」と「Start (Cue/ID)」は別物。Go は再生ヘッドの位置を出し、Start は番号のキューを直接出す。本番の基本は Go、差し込みは Start。
• 押し間違いが致命的な PANIC と FTB は、他のキーから 1 つ空けて置く。
• 日本語の文字がキーに出るかは公式資料に記載なし未知。1 つ試して化けたら英字にする。

STEP 7　外からの操作口を閉じる（Settings）

1. Settings → Protocols: 「TCP Listener」「UDP Listener」「OSC Listener」をすべて OFF（他の機器から Companion を叩く用途が無いため）。
2. Settings の「Enable Pin Codes」は OFF のまま（本番中に PIN を求められると操作が止まる）。
3. 管理画面のパスワード（Settings → Advanced「Enable Locking」）は任意。公式も「通りすがりを止める程度」としている。STEP 1 で 127.0.0.1 にしてあれば不要。

STEP 8　設定を書き出して保管（Import / Export）

1. Import / Export タブ → エクスポート。ファイルは .companionconfig。
2. ファイル名に日付を入れ、Mac 本体と USB メモリの 2 か所に置く。自動バックアップは無いので、ボタンを変えたらその都度書き出す。
3. 戻す時は同じタブでインポート。「Import, Preserving unselected components」＝選んだ部分だけ戻す／「Full Reset then Import」＝全消去して戻す。

STEP 9　動作確認

困った時

4. QLabで動画を任意のサイズに縮小して出力する

仕組み（QLab 5 の3層）事実

Video cue 側の Geometry タブは、Stage の中で素材をどう置くかを決める（Fill Stage モード = Fit / Fill / Stretch ／ Custom モード = Scale・Translation・Rotation・Anchor・Crop・Opacity）事実。

方法A: cue 単位で縮小（一番よく使う）

1. Video cue を選択 → Inspector → Geometry
2. モードを Custom にする（Fill Stage だと常に画面いっぱい）
3. Scale に倍率を入れる。1.0 = 素材の原寸。鍵アイコンでアスペクト比固定
   • 例: 1920×1080 の素材を 960×540 に → Scale 0.5
   • 例: 3840×2160 の素材を 1920×1080 に → Scale 0.5（4K素材は原寸だと Stage からはみ出す）
   • 例: 任意の幅 W px にしたい → Scale = W ÷ 素材の横ピクセル
4. Translation で位置。Stage 中心が (0,0)、右・上が正。左上に寄せるなら X 負・Y 正
5. はみ出しを切りたい時は Crop（上下左右のピクセル）

方法B: 動きで縮小する（演出）

Fade cue を作り、対象に Video cue を指定 → Fade cue の Geometry で到達 Scale／Translation を入れ、Duration で時間を決める。Video cue を GO した後に Fade cue を GO すると滑らかに縮む仮定（QLab 5 の Fade cue は Geometry を持つ。実機で確認）。

方法C: 出力側で常時縮小・切り出し（全 cue 共通）

Region / Output route を使う。Video cue は触らずに済む。

1. 設定 → Video → 出力パッチ → Stage「MAIN」→ Layout タブ
2. Region の Size を出したい範囲に（例: Stage 1920×1080 の中央 1176×672）、Lower left / Upper right で位置
3. Output route の Scaling mode:
   • Center: Region を原寸で 1080p フレームの中央に置く（周囲は黒）。「LED実解像度の絵を 1080p の中央に埋め込んで送る」に使う
   • Fit: アスペクト比を保って機器解像度に拡大縮小（余白は黒）
   • Fill: 余白なしで埋める（はみ出しはカット）
   • Stretch: 引き伸ばし（歪む。使わない）

LED実解像度の目安仮定

実際のピクセル数はモジュール構成で決まる（例: 1モジュール 168×168 なら 7×4 枚で 1176×672）。コントローラーの設定値を現場で確認して上表を書き換える。16:9 の 1920×1080 を 1176×672 に縮めると縦横比 1.78→1.75 で約2%の差。コントローラーで「アスペクト固定」なら左右に各 5px 程度の黒、「フル」なら約2%の縦伸び。どちらにするかは要確認。

「メインとTO前に別々の映像」を出したい時

4A. 素材の受け入れと変換（ProRes 422 Proxy）

QLab 公式の推奨は、透過なしが ProRes 422 Proxy、透過ありが ProRes 4444事実。Adobe Media Encoder は公式が強く非推奨事実。変換コマンドは Apple Silicon の Mac mini で 2026-09-29 に実測済み。qlabmac での実行は未確認。

制作側（EDIUS）で書き出してもらう

1. 「ファイル」→「エクスポート」→「ファイルへ出力」
2. 分類「QuickTime」→「ProRes MOV」
3. 「ProRes CODECの設定」で 422 Proxy（選択肢は 422 HQ／422／422 LT／422 Proxy）
4. 透過が要る素材は「ProRes 4444 MOV」。乗算済みアルファで書き出す

対応は EDIUS Pro 9 Ver.9.40（2019年5月）以降・EDIUS X・EDIUS 11事実。一覧に出ない時は HQX か高ビットレートの MP4 でもらい、下の手順で変換する。

qlabmac で確認・変換する

curl -fsSL -o ~/qlab-convert.sh https://yamagata-yirfk1aus6.pages.dev/qlab-convert.sh
bash ~/qlab-convert.sh --check ~/Movies/QLab-IN     # 素材の仕様を一覧（変換しない）
bash ~/qlab-convert.sh                              # ~/Movies/QLab-IN → ~/Movies/QLab-OUT へ一括変換

• 解像度とフレームレートは変えない。1920×1080・59.94p と違う素材には ⚠ を出すだけ。違っていたら制作側に出し直してもらう（QLab 側で拡大縮小するより確実）。
• 元ファイルは消さず、出力済みは飛ばす。記録は出力先の convert-log.csv。
• 目安: 10 秒の 1080p59.94 が約 1 秒、容量は約 58MB（1 分で約 350MB）。
• ffmpeg が無い時は brew install ffmpeg（セットアップスクリプト v7 以降は自動で入る）。
• --check の「===== QLAB-CONVERT」から「===== END」までを綴へ貼れば、素材の合否を判定できる。

受け入れの確認（QLab で）

5. 立ち上げ・撤収の順番

立ち上げ

1. LEDコントローラー・ATEM・Micro Converter（USB電源）の電源ON
2. UltraStudio を Thunderbolt で Mac に接続 → Mac 電源ON → 自動ログイン
3. Companion が自動起動 → Stream Deck XL に絵が出る（出なければ USB 抜き差し）
4. QLab 起動 → ワークスペースが開く → Show モード
5. 確認モニターのマルチビューで IN1 に QLab の待機画が見えること、Stream Deck の PGM ボタンでスイッチできることを確認
6. 音響卓に XLR 2ch の信号が来ていること（QLab のテスト cue）
7. 本番前: Wi-Fi OFF、集中モード ON

撤収

1. QLab 保存→終了
2. Mac システム終了（スリープにしない。次回の Thunderbolt 認識が不安定になる）
3. ATEM・LEDコントローラーの順で電源OFF

6. トラブル早見表

本書は ~/Claude/playout-mac/site/index.html が正本。セットアップスクリプトは同フォルダの setup-playout-mac.sh。