使い方 & こんな時は

Ligastmir の導入から日々の操作、つまずいた時の対処までをまとめたページです。アプリ同梱の「セットアップガイド」と同じ内容を、サイトから読めるように再構成しています。

① まず起動する

1. 解凍したフォルダの中の 起動.bat をダブルクリックします。（Ligastmir.exe ではなく 起動.bat です）
2. 初回は「WindowsによってPCが保護されました」と出ることがあります → 「詳細情報」→「実行」で開けます（署名のない自作アプリのため・問題ありません）。
3. 少し待つと操作画面（コマンドセンター）が開きます。

② OBSに表示する（字幕・コメビュー・アラート）

OBSで ソース欄の「＋」→「ブラウザ」を追加し、下のURLを貼り付けます。（アプリの「🖥 ブラウザソース」ページに「コピー」ボタン付きでまとまっています）

※ 弾幕（コメントが画面を横切る）とエモートフロート（スタンプが浮遊）は任意です。使いたいものだけ追加してください（追加しなければ表示も負荷もありません）。

③ ブラウザソースの見た目を調整する

アプリの「🖥 ブラウザソース」ページで、各オーバーレイの見た目をその場で調整できます（OBSに貼ったまま変化が反映されます）。設定は自動保存され、OBSソースの再読込やアプリ再起動のあとも元に戻ります。

• 💬 コメビュー： 本文の文字サイズ・ユーザー名サイズ・背景の不透明度・最大表示件数・表示寿命（「ずっと表示」）に加え、本文の色とアクセント色（ユーザー名・カード左の枠線）を変えられます。※Twitch側で名前に色を付けている人は、その色が優先されます。「色を既定に戻す」でいつでも戻せます。
• 🔤 フォント： 字幕とコメビューの字体を5種類から選べます（標準／まる字／極太／明朝／手書き風）。選択ボタン自体がその字体で表示されるので、雰囲気を見ながら選べます。
• 🎊 弾幕： 文字サイズと流れる範囲（画面全体／上部／中央／下部）。
• ✨ エモートフロート： 出る向き（下から上／上から下）・出る位置（全体／左／中央／右）・大きさ。
• 🎤 字幕・翻訳字幕： 字幕の色・翻訳字幕の色とサイズを別々に調整できます。さらに表示位置（上下＝上／中央／下・左右＝左／中央／右・画面端からの余白）と最大行数を変えられ、翻訳字幕は日本語字幕と別の位置に置けます（ゲーム画面やワイプに被らないよう逃がせます）。設定は音声・コメントページの「字幕表示設定」。テスト/ログページの「調整用字幕プレビュー」で出しっぱなしにすると合わせやすいです。

④ コメントの読み上げ（TTS）

• Windows標準の声（SAPI5）： 追加準備なしでそのまま使えます。
• VOICEVOX（ずんだもん等のキャラ声）： ① VOICEVOX（無料）を 公式サイトからインストール → ② 詳細設定 → 同伴機能ページの「VOICEVOX 同伴起動」をON →「自動検出」でパス設定 → ③ 次回から一緒に立ち上がります。（声・速度など読み上げ自体の設定は音声・コメントページ）
• 棒読みちゃんを既にお使いの場合： 本体を起動してから音声エンジンで「棒読みちゃん」を選ぶだけ。読み方辞書・声・速度は棒読みちゃん側の設定がそのまま使えます（音量のみ Ligastmir のスライダーを反映）。一緒に起動する（同伴起動）は 詳細設定 → 同伴機能ページにまとまっています。
• スタンプ（エモート）の読み： コード（例: curama1Neko0）のまま読まれます。TTS辞書（またはチャットの !教育 コマンド）で読みを登録できます。

⑤ コメント連動・翻訳（Twitch）

• コメント読み上げ（匿名でOK）： 配信ページでチャンネル名を入れて「接続」。
• 海外コメントの翻訳： 音声・コメントページの「💬コメント関連」で「チャット翻訳」をON。コメビューに原文＋日本語訳が2段で出て、日本語訳を読み上げます。言語は自動検出＝英語・中国語・韓国語・アラビア語など、翻訳エンジンが対応する言語はすべて対象です。
• コメビューの見た目： 文字サイズ・色・不透明度・表示件数や「ずっと表示」は🖥 ブラウザソースページでまとめて調整できます（③参照）。
• 表示するプラットフォームの切替： コメビュー・弾幕・エモートに出すコメントを「両方／Twitchのみ／YouTubeのみ」で選べます（コメビュー見た目設定）。同時配信で結合したコメントを画面に出す扱いは各社のルールが関わるため、必要に応じて分けられます。※画面表示だけの切替で、読み上げ・ログには影響しません。

⑥ もっと使う（任意・各自で登録が必要）

• フォロー/サブ/レイド通知・アラート演出（Twitch）： 配信ページ「📡Twitch関連」の手順で dev.twitch.tv に自分用アプリを無料登録 → Client ID / Secret を入力 →「Twitchで認証する」。アラートはイベント別にON/OFFできます（配信ページの「表示するアラート」）。
• YouTubeのコメント取り込み： Google Cloud で YouTube Data API キーを取得 → 配信ページの接続モードで YouTube を選び、URLとキーを入力。
• 配信タイトル・カテゴリの変更（Twitch / YouTube）： 配信ページからツールを離れずにタイトル・カテゴリ（ゲーム）・説明・サムネイルを書き換えられます。Twitch と YouTube の両方に一度で反映するボタンもあります（片方だけ接続している時は、その配信だけに反映）。※Twitch は初回に「タイトル変更の権限」を追加で認証、YouTube は Google 認証（デスクトップ用）が必要です。ページ内の手順に従ってください。
• OBS操作（シーン切替・配信開始/停止）： OBSの「ツール → WebSocketサーバー設定」でサーバーを有効化（ポート/パスワード確認）→ OBS連携ページで接続。
• OBSを一緒に起動する： Ligastmir の起動時にOBSも自動で立ち上げる設定ができます（詳細設定 → 同伴機能ページ・任意）。OBSの実行ファイルの場所を一度指定しておくだけ。配信中は誤操作防止のため終了させない安全策付き。閉じる時に一緒に終了させるかも選べます。接続・シーン切替はOBS連携ページです。
• 📌 コメントピックアップ： ダッシュボードの「コメントピックアップ」ウィジェットで、気になったコメントを検索して、選んだ1件を OBS に質問カードとして大きく表示できます（原文＋翻訳を併記・配信終了で自動的に消えます）。「さっきの質問をもう一度出したい」に。直近コメントはメモリにだけ一時保持し、ファイルには保存しません。
• 📚 辞書・構成の共有： 読み上げ辞書（用語や名前の読み）を配信者どうしでファイルで受け渡しできます（読み上げ設定の「辞書パック」）。ダッシュボードの構成（レイアウト）も書き出し・取り込みで共有できます。どちらも視聴者名やパスワード等の機微情報は含めない安全設計です。

⑦ 見た目を着せ替える（画像・効果音）

「🎨 着せ替え」ページで、アラートやコメビューに自分の画像・効果音を割り当てて見た目を変えられます。絵を描く機能ではなく、用意した素材を決まった場所にはめ込む方式です。使わない場合はスキップでOK（既定の見た目のまま動きます）。

1. 着せ替えページで「🖼 画像...」「🎵 効果音...」を押してファイルを選ぶ（自動で取り込み＆保存）。
2. 「▶ テスト」「💬 テストコメント」でOBSの表示を確認。
3. 外したい時は ✕ で解除（既定の見た目に戻ります）。

割り当てられる場所と素材の目安：

• 保存場所： 取り込んだ素材は exe と同じフォルダの user_assets に入ります。割り当ては自動保存され、再起動後も復元されます。
• 軽量起動： Ligastmir.exe --skin-editor で、配信機能を立ち上げずに着せ替えだけを開けます（配信前の準備に便利）。

⑦-2 コメントで演出を出す（リアクション）

「🎨 着せ替え」ページの「⚡ リアクション」で、コメントやイベントをきっかけに演出を自動で出せます。たとえば「888 と打たれたら拍手の効果音」「特定のスタンプで絵文字が舞う」といった仕掛けを、配信を止めずに用意できます。

• きっかけ（3種）： キーワード（コメント本文に特定の語）／スタンプ（特定のエモート・Twitch）／イベント（フォローなど）。
• 出す演出： アラート演出（画像＋効果音）／絵文字を画面に舞わせる、を割り当て。着せ替えと同じ素材のしくみを使います。
• 連打対策： 各リアクションのクールダウン（連続で出さない待ち時間）と、全体の最小間隔を設定でき、荒れた時の出しすぎを防げます。
• チャンネルポイント報酬ごとの演出： 同じページの「🎉 報酬演出」で、Twitchのチャンネルポイント報酬が使われた時の専用演出も割り当てられます。

⑧ 困ったとき（基本）

配信中や配信前に「あれ？」となった時に、落ち着いて対処するための道具をひと通り用意しています（v0.8.0〜）。

• 🛟 配信中に困ったら「軽い停止」： どのページでもヘッダのボタンから、読み上げ・翻訳・演出だけをワンボタンで一時停止できます（コメント表示は続きます）。「今ちょっと静かにしたい」を安全に。外部接続（Twitch/YouTube/OBS）の一括切断や、負荷を下げる軽量モードも同じ場所から。
• 🩺 まず「総合診断」： 詳細設定 → テスト/ログの「総合診断」で、主要機能の状態をまとめて確認できます。うまくいかない項目には日本語で「原因かも／試すこと」が表示され、結果はDiscord報告用にワンクリックでコピーできます。
• 🔧 設定が壊れて開けない時は「セーフモード起動」： 最小構成で立ち上げ直し、壊れた設定だけを個別に初期化して復旧できます（詳細設定 → テスト/ログ／次回セーフモードで起動、または Ligastmir.exe --safe）。
• 🎙 配信前に「マイクチェック」： 声の大きさ・音割れ・ノイズを判定してくれます（PC内で完結・録音は保存しません）。
• 画面が真っ白／開かない： 「Edge WebView2 ランタイム」（無料）を Microsoftのサイトから入れてください（最近のWindowsなら大抵入っています）。
• 声が出ない： Windowsの音量・出力先を確認。VOICEVOXの声なら VOICEVOX が起動しているか確認。
• 動きがおかしい： exe と同じフォルダの ust_debug.log を開く（または作者に送る）と原因が分かります。「総合診断」から報告用ログを zip でまとめて書き出すこともできます。
• 別のPCに渡したとき： セキュリティ上、APIキーやトークンはそのPCごとに入力し直しが必要です（設定ごとコピーしても暗号化で読めない仕組み）。

こんな時は（症状から探す）