﻿OtoMotion — はじめにお読みください / Read me first
============================================================
DBT OtoMotion（XPression のための音声連動ツール） / DekoBokoTech

■ 中身（ダウンロードした zip を右クリック →［すべて展開］してから使います）
  OtoMotion\            アプリ本体（Windows 10 / 11）
                         中に利用規約（EULA_JA.pdf・EULA_EN.pdf）と、同梱した他社の部品の著作権表示（THIRD_PARTY_NOTICES.txt）
  マニュアル\            HTML マニュアル（index.html を開く。英語版は en\index.html）
  XPression_サンプル\    XPression 12.5 のサンプルシーン（.xpp）、背景画像、スクリプト
                         ラウドネスメーターと、会場向け盛り上がりメーター CROWD POWER の 4 シーン入り。
                         fonts\ は CROWD POWER の数字用フォント Teko（無料・SIL OFL）

■ 起動（Windows）
  0. 展開する前に、ダウンロードした zip を右クリック →［プロパティ］→ 下の「セキュリティ」の［許可する］にチェック → OK
     （インターネットから入れたファイルに出る Windows の確認が、まとめて出なくなります。
       先に展開してしまったときは、展開したフォルダを消し、zip でこの手順をしてから展開し直してください）
  1. OtoMotion フォルダを PC の好きな場所へコピーする（zip の中からは起動できません）
  2. 「OtoMotion を起動する.bat」をダブルクリック（10 秒ほどで監視画面が開きます）
     手順 0 をしていないと、Windows の確認が出ます。「発行元を確認できませんでした」は［実行］、
     「Windows によって PC が保護されました」は［詳細情報］→［実行］で進めます
  3. 初回はライセンスの画面が出ます。メールに添付してお送りした license.json をデスクトップかダウンロードに保存しておくと一覧に出るので、［読み込む］を押します。出ない場合は［ファイルを選んで読み込む］で保存した license.json を選びます
  4. 設定タブ → デバイスと系統 で入力デバイスを選び、「設定を反映して保存」

■ 起動（Mac。Mac 版はこの zip には入っていません。お申し込み・ご購入のときに別の zip でお送りします）
  1. お送りした zip を開き、OtoMotion.app を Mac の「アプリケーション」などにコピーする。初回に「開けません」と出たら、システム設定 › プライバシーとセキュリティ ›「このまま開く」
  2. ダブルクリックで起動（監視画面は Google Chrome のアプリ風の窓で開きます。無ければ既定のブラウザ）
  3. 初回起動では、デスクトップ・ダウンロード・USB などのリムーバブルボリューム・マイクへのアクセスを尋ねる画面が続けて何回か出ます。すべて「OK」／「許可」を押してください
  4. 初回はライセンスの画面が出ます。メールに添付してお送りした license.json をデスクトップかダウンロードに保存しておくと一覧に出るので、［読み込む］を押します。出ない場合は［ファイルを選んで読み込む］で選びます
  5. 設定タブ → デバイスと系統 で入力デバイスを選び「設定を反映して保存」→ マイクへのアクセスを「許可」
  6. XPression は Windows の PC なので、設定タブ → XPression へ送る の「送り先 IP」を XPression の PC の IP に
  ・「許可しない」を押してしまったとき: デスクトップやダウンロードのライセンスが候補に出ない、または音が拾えなくなります。システム設定 › プライバシーとセキュリティ › ファイルとフォルダ（および マイク）で OtoMotion をオンにしてから、OtoMotion を再起動してください
  ・Dock にアイコンは出ません。終了は監視画面の「終了」ボタン
  ・アプリを入れ替えたあと音が来ないとき: ターミナルで tccutil reset Microphone com.dekobokotech.otomotion
  ・確認済み: MacBook Pro（M1）/ macOS 26.5.2

■ XPression 側（1 回だけ）
  1. XPression DataLinq Server に XML/JSON TCP DataLinq Source を追加
     （TCP Server・ポート 7327・Start <none>・End NULL・Format JSON）
  2. XPression の Project → DataLinq Manager で DataLinq Server（localhost:8888）につなぐ
  3. サンプルを使うときは XPression_サンプル\OtoMotion_sample_scene.xpp をダブルクリック
     （XPression が展開を案内します。DataLinq1 が OtoMotion のソースを指しているか確認）
  4. CROWD POWER のシーンを使うときは、先に XPression_サンプル\fonts の Teko-Bold.ttf と
     Teko-SemiBold.ttf を XPression の PC にインストールし、DataLinq Server のソース名を「OtoMotion」に。
     OtoMotion 側の設定（バーの動き・系統）はマニュアルの 10.8
  ひも付け: 系統の値は Column に g1、Row に m。拍は Column に beat、Row に bpm。
            共通のキー（elapsed など）は Column を空欄、Row にキー名。
  詳しくはマニュアルの 9 章・10 章。

■ 終了
  監視画面の「終了」ボタン。

--------------------------------------------------------------------
■ Contents (right-click the downloaded zip → Extract All first)
  OtoMotion\            The app (Windows 10 / 11)
                         Also inside: the license agreement (EULA_EN.pdf, EULA_JA.pdf) and third-party notices (THIRD_PARTY_NOTICES.txt)
  マニュアル\            HTML manual (open index.html; English: en\index.html)
  XPression_サンプル\    XPression 12.5 sample scene (.xpp), background image, scripts
                         Includes the loudness meter and the four CROWD POWER crowd-meter scenes.
                         fonts\ holds Teko, the free (SIL OFL) font for the CROWD POWER numbers

■ Launch (Windows)
  0. Before extracting, right-click the downloaded zip → Properties, tick [Unblock] under Security at the bottom → OK
     (this stops the Windows warnings for files from the internet. If you already extracted it,
      delete the extracted folder, unblock the zip, and extract it again)
  1. Copy the OtoMotion folder anywhere on the PC (it does not start from inside the zip)
  2. Double-click "OtoMotion を起動する.bat" (the monitor opens in about 10 seconds)
     Without step 0, Windows asks first: "The publisher could not be verified" → [Run];
     "Windows protected your PC" → [More info] → [Run anyway]
  3. On first launch the license screen appears. Save the license.json attached to our email to the Desktop or Downloads and it is listed: press [Load]. If not, use [Choose a file to load] and pick the saved license.json
  4. Settings tab → Device and groups: choose the input device, then press "Apply and save"

■ Launch (Mac. The Mac version is not in this zip; we send it as a separate zip with your trial or purchase)
  1. Open the zip we send you and copy OtoMotion.app to Applications (or anywhere). If macOS says it can't be opened the first time: System Settings › Privacy & Security › "Open Anyway"
  2. Double-click it (the monitor opens in a Google Chrome app window, or your default browser)
  3. On first launch, macOS asks for permission several times in a row: access to the Desktop, Downloads, removable volumes (USB), and the microphone. Click "OK" / "Allow" every time
  4. On first launch the license screen appears. Save the license.json attached to our email to the Desktop or Downloads and it is listed: press [Load]. If not, use [Choose a file to load]
  5. Settings tab → Device and groups: choose the input, press "Apply and save", then allow microphone access
  6. XPression runs on a Windows PC: set Settings tab → Send to XPression → host to the XPression PC's IP
  ・If you clicked "Don't Allow": a license on the Desktop or in Downloads won't appear as a candidate, or there will be no sound. Go to System Settings › Privacy & Security › Files and Folders (and Microphone), turn OtoMotion on, then restart OtoMotion
  ・No Dock icon. Quit with the Quit button on the monitor
  ・No audio after replacing the app: run tccutil reset Microphone com.dekobokotech.otomotion in Terminal
  ・Tested on: MacBook Pro (M1) / macOS 26.5.2

■ XPression (once)
  1. In XPression DataLinq Server, add an XML/JSON TCP DataLinq Source
     (TCP Server, port 7327, Start <none>, End NULL, Format JSON)
  2. In XPression, Project → DataLinq Manager: connect to DataLinq Server (localhost:8888)
  3. For the sample, double-click XPression_サンプル\OtoMotion_sample_scene.xpp
     (XPression guides the unpacking; check that DataLinq1 points to the OtoMotion source)
  4. For the CROWD POWER scenes, first install Teko-Bold.ttf and Teko-SemiBold.ttf from
     XPression_サンプル\fonts on the XPression PC, and name the DataLinq Server source "OtoMotion".
     OtoMotion settings (bar motion, groups): manual section 10.8
  Binding: group values Column g1 / Row m; beat Column beat / Row bpm;
           common keys (elapsed etc.) Column empty / Row = key name.
  See chapters 9 and 10 of the manual.

■ Quit
  The Quit button on the monitor.

XPression は Ross Video Ltd. の商標です。OtoMotion は DekoBokoTech の製品で、Ross Video Ltd. とは関係ありません。
XPression is a trademark of Ross Video Ltd. OtoMotion is a DekoBokoTech product, not affiliated with or endorsed by Ross Video Ltd.
