VRCYouTube Streamer

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

║ 面倒なサーバー構築やエンコード知識は不要。

║ EXEを起動してURLを貼るだけで。

║ ワールド内の動画プレイヤーにYouTubeが流れ始めます。

※無料枠と有料枠の内容は完全に同一です。お金を払っても機能やサポートは増えませんのでご注意ください。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【ツール概要】 『VRCYouTube Streamer』は、YouTubeの動画・プレイリストを自分専用のHLSライブストリーム（.m3u8）に変換し、VRChat内の各種動画プレイヤー（iwaSync3, YPlay, ProTV 等）でシームレスに再生するためのWindowsアプリケーションです。

もともと自分で使うために個人的に作成したものです。

AIバイブコーディング製なので細かいサポートはできませんが、動いたらラッキーくらいの気持ちでどうぞ

本バージョン（v2.0.0）は基本機能のみを搭載した比較的安定版です。

（v1.0.0は完全個人利用していました。）

【✨ 主な機能と特徴】

「起動してURLを貼るだけ — 事前準備ゼロ」

Python・FFmpeg・その他ランタイムのインストールは一切不要です。ZIPを解凍して EXE を起動するだけですぐに使えます。

「YouTube動画＆プレイリストの連続再生」

YouTube URLを入力するだけで、動画の取得→HLS変換→ストリーミング配信を自動で行います。プレイリストURLを入れれば一括展開＆連続再生。

「キューのドラッグ＆ドロップ並び替え」 　

各行の「☰」マークまたはタイトルをドラッグして直感的に順番を変更できます。リストの上下端に持っていくと自動スクロール。「▲」「▼」ボタンも併用可能です。

「ループ再生＆シャッフル再生」 　

🔁 Loop: 再生終了した動画をキュー末尾に自動再登録しループ再生。 　

🔀 Shuffle: キューからランダムに次の曲を選出。ループと併用でランダム再生も

🔀 Shuffle List: 現在のキューを一瞬でランダム順に並べ替え。

「Cloudflare Tunnel で自動URL発行（設定不要）」

起動するだけで外部アクセス可能なストリームURLが自動生成されます。ポート開放やDDNSの設定は不要です。生成されたURLをVRChat内の動画プレイヤーに貼るだけ。

「📱 スマホQRコードでフレンドからリクエスト受付」

キューが空になると、待機画面にQRコード＆WebURLが表示されます。フレンドがスマホで読み取ると、Webリモコン画面から動画のリクエストを送れます。

ソフト上にQRコード＆WebURLは常時表示されています。

「🌐 Webリモコン＆ブラウザ再生」

ブラウザで http://localhost:8000/ にアクセスすると、HLS Web Player による配信プレビューとキュー操作・動画追加が可能です。(:8000は初期設定値です)

「⚙ 設定画面 (Settings)」

サーバーポート、HLSセグメント秒数、動画切り替え待機秒数、Web Player同期バッファ数、Loop/Shuffleのデフォルト設定などをGUIから変更・保存可能。設定画面内にAPI仕様リファレンスも内蔵。

「🤖 ヘッドレス / APIサーバーモード」

GUIを表示せずバックグラウンドで動作するAPIサーバーモードを搭載。外部アプリからHTTP JSON API経由で状態取得・キュー追加・再生制御が可能です。

「🛡️ セキュリティ（多層防御）」

停止・設定変更などの管理操作はホストPC限定。フレンド向けの操作権限（動画追加 / キュー編集 / 再生制御）は設定画面からON/OFF可能。SSRF防止、連投制限、CSRF対策、キュー上限など基本的な保護機能を備えています。

┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅

【🚧 調整中の機能（今後のアップデートで追加予定）】

以下の機能は現在開発・調整中です。

今後のバージョンで追加される予定ですが、時期は未定です。

・ 📻 BGM / ラジオモード（音声のみ抽出＋超低帯域配信）

・ 🖼️ 写真アップロード＆スライドショー配信

・ 🎨 サムネイル＆楽曲情報カード画面の自動生成

・ 📎 QRコード・URLの映像オーバーレイ表示

・ ⚡ 先行バースト生成＆先読みバッファリング（超低遅延化）

・ 🔄 曲切り替わり時のシームレス遷移

・ 🧩 WebリモコンUI（Tailwind CSS + レスポンシブ対応 + UI気持ちモダン化）

┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅

【📦 導入方法】

1.ZIPを展開し、フォルダごと書き込み可能な場所に置いてください。

（例: デスクトップ、ドキュメント、D:\Tools\ など）

※「C:\Program Files」直下では正常に動作しません。

2.「VRCYouTubeStreamer.exe」を起動する。

VRChat側の設定で「信頼されていないURLを許可(Allow Untrusted URLs)」を有効にしてください。 　（設定 ＞快適性とセーフティ）

※ 初回起動時にWindows SmartScreenの警告が出る場合があります。 　

コード署名を行っていないためです。「詳細情報」→「実行」で起動できます。

【📦 内容物】

・ VRCYouTubeStreamer.exe（本体）

・ ffmpeg.exe（動画変換エンジン／同梱必須・同じフォルダに置いてください） ・ README.txt（使い方の説明）

・ FFmpeg_LICENSE.txt / THIRD_PARTY_LICENSES.txt（ライセンス表記）

【💻 動作環境】

・ 対応OS: Windows 10 / 11 (64bit)

・ 安定したインターネット接続（アップロード帯域を使用します）

・ VRChat側: iwaSync、YamaPlayerなど HLS対応の動画プレイヤー

・ 事前インストール: 不要（必要なものはすべて同梱済み）

┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅ ┅┅┅┅┅┅┅┅┅┅┅┅┅┅

【ℹ️ 仕様・制限事項】

・ URLの再生成: Cloudflareの一時トンネルを使用しているため、ツールを再起動するたびにストリームURLが変わります。起動中は同じURLで利用できます。

・ YouTubeの仕様変更: YouTube側の更新により、動画の取得が一時的にできなくなることがあります。

・ ウイルス対策ソフトの誤検知: コード署名を行っていないため、一部のウイルス対策ソフトが誤検知する場合があります。

・短時間の大量リクエストによる一時制限: 短時間に大量の動画URLを連続追加したり、巨大なプレイリストを一気に読み込ませると、YouTube側またはCloudflare側から一時的なアクセス制限（レートリミット / 429エラー）がかかり、一時的に動画が取得できなくなる場合があります。その場合は連投を控え、数分〜10分程度時間を置いてから再度お試しください。（※制限の解除を待つか、回線IPの変更で復旧します）

・推奨用途:本ツールは常時稼働を想定したものではありません。ワールド内プレイヤーの不調時やURLが読み込めない場合など、一時的なトラブル回避や個人・少人数での検証用途としての利用を推奨します。

┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅┅

∥ 免責事項

個人開発: 本ツールは個人が自分用に開発したものを公開しているものであり、商用製品ではありません。

自己責任の原則: 本ツールの使用によって生じたいかなる損害・損失・トラブルについて、製作者は一切の責任を負いません。自己責任においてご利用ください。

動作保証の範囲: 特定の環境・動画・プレイリストでの動作を完全に保証するものではありません。作者の環境ではだいたい動いています。

外部サービスへの依存: YouTube・Cloudflareなど外部サービスの仕様変更・障害により、ツールの機能が利用できなくなる場合があります。これらは製作者の管理外です。

サポートについて: 個人の趣味開発のため、不具合報告は受け付けますが、対応時期や修正をお約束するものではありません。

非公式ツール: 本ツールはYouTube・VRChat・Cloudflareの公式ツールではありません。各サービスの利用規約は利用者ご自身でご確認ください。

⚖️ ライセンス / LICENSE 本パッケージには、動画変換処理を行う外部ツールとして FFmpeg（GPL v3）の実行ファイルが同梱されています。本アプリはFFmpegのバイナリを改変せず、独立した外部プロセスとして呼び出しています。 　→ 詳細は同梱の「FFmpeg_LICENSE.txt」を参照してください。

その他、cloudflared（Apache-2.0）、yt-dlp、Python、Tcl/Tk、CustomTkinter、Pillow 等を利用しています。 　→ 同梱の「THIRD_PARTY_LICENSES.txt」を参照してください。

【ソースコード / GitHub】

https://github.com/sou2000sw/VRCYouTube-Streamer