IPTVよりも優れて安価
Better and Cheaper Than IPTV (github.com)
要約
Castorは、ウェブサイトから動画ストリームを抽出し、フォーマット互換性を処理し、リアルタイムでテレビにキャストできるコマンドラインインターフェース(CLI)ツールです。オプションで自動生成された字幕を動画に直接焼き込むことも可能です。ターミナルから離れることなく、トレンドのタイトルを閲覧したり、TMDBを検索したり、ポスターやメタデータを検査したりして、キャストできます。
全文翻訳
Castor
[画像: stupside%2Fcastor | Trendshift]
[画像: Latest Release][画像: Go Reference] [画像: Homebrew] [画像: License] [画像: Build Status]
Castorは、画面ミラーリングなしでウェブ動画をテレビにキャストします。ストリームを見つけ、互換性のないフォーマットを変換し、オプションで字幕を生成します。ローカルで実行するか、メディア処理をNASにオフロードできます。
バンドルされたコンテンツやソースはありません。DRMストリームは拒否されます。アクセス権のあるコンテンツを使用してください。
クイックスタート
macOSの場合(その他のプラットフォーム):
brew install --cask stupside/tap/castor
castor scan
スキャンで見つかった名前とタイプを使用して、作業ディレクトリにconfig.yamlを保存します:
device:
name: "Living Room TV"
type: dlna # dlna, chromecast, or roku
その後、ページまたは直接の動画URLをキャストします:
castor cast player https://example.com/watch/some-video
castor cast url https://example.com/video.m3u8
検出で何も見つからない場合は、トラブルシューティングを参照してください。
インストール
ウェブページ抽出のためにChrome/Chromium、メディア処理のためにffmpeg + ffprobe 7.1+をインストールしてください。ツールはPATH上にある必要があります。エンコーディングは、利用可能な場合は動作中のGPUエンコーダーを使用し、ソフトウェアフォールバックもあります。
| プラットフォーム | インストール |
|---|---|
| macOS | brew install --cask stupside/tap/castor |
| Linux | お使いのアーキテクチャ用のリリースを展開し、castorをPATHに配置してください。 |
| Windows | リリースZIPを展開し、castor.exeをPATHに配置してください。winget install Gyan.FFmpegおよびwinget install Google.Chromeでツールをインストールし、Castorをプライベートネットワークで許可してください。 |
| ソースから | CONTRIBUTING.mdを参照してください。 |
コマンド
| コマンド | 目的 |
|---|---|
castor scan | デバイスを検出する |
castor cast player <url> | ウェブページの動画をキャストする |
castor cast url <url> | 直接ストリームまたは動画をキャストする |
castor cast | インタラクティブにタイトルをブラウズする。TMDBキーとソースが必要 |
castor cast movie <id> | ソーステンプレートを使用して映画をキャストする |
castor cast episode <id> --season N --episode N | ソーステンプレートを使用してエピソードをキャストする |
キャストコマンドに--dry-runを追加すると、キャストせずに解決されたストリームをリスト表示できます。すべてのフラグについてはcastor --helpを使用し、診断については--debugを使用してください。
設定
Castorはconfig.yaml(または--config <path>)をロードし、gitで無視されるconfig.local.yamlでオーバーレイし、CASTOR_CAST__MAX_HEIGHT=720のような環境オーバーライドを適用します。シークレットはローカルファイルまたは環境に保存してください。サービス設定については注釈付きのconfig.yamlを参照し、1.xから2.0へのアップグレード時には移行ガイドを参照してください。
再生設定
cast:
max_height: 1080 # この上限内で選択。縦長の動画はスケールする
audio:
languages: [fr, en] # 順序付けられた優先度。それ以外はソースのデフォルト
subtitles:
languages: [fr, en] # 順序付けられたソースキャプションの優先度
transcribe_if_missing: false # Whisper生成キャプションへのオプトイン
delivery: auto # serveはCastor経由での再生を強制する
ソースキャプションはChromecastとDLNAでサポートされています。使用可能なキャプションがない場合、転写が有効になっていない限り、字幕なしで再生が続行されます。生成されたキャプションは、サポートされている場合はネイティブトラックを使用し、それ以外の場合は動画に焼き付けられます。Whisperはそのデフォルトモデルを一度ダウンロードします。カスタムモデルの場合はservers.media.whisper.model_pathを設定してください。英語のみのモデルには英語が必要です。
タイトルブラウジングとソース
インタラクティブブラウジングにはTMDBキーが必要です。タイトルコマンドには、使用が許可されているサイトのテンプレートが必要です。プロキシは順序で試行されます:
tmdb:
api_key: "<KEY>"
sources:
- proxies: ["https://your-source.example"]
templates:
movie: "/embed/movie/{itemID}"
episode: "/embed/tv/{itemID}/{season}-{episode}"
サポートされているデバイス
| プロトコル | サポート |
|---|---|
DLNA / UPnP (MediaRenderer:1) | スマートTVおよび互換性のあるプレーヤー。Samsungでテスト済み |
| Chromecast | 実験的。まだ実際のハードウェアでテストされていません |
| Roku | 実験的。再生チャンネルが必要。まだ実際のハードウェアでテストされていません |
Rokuの設定
- 開発者モードを有効にする: ホーム ×3、上 ×2、右、左、右、左、右を押し、有効にしてウェブサーバーパスワードを設定します。デバイスは再起動します。
config.local.yamlにservers.api.devices.roku.passwordを設定します。- Castorは最初のキャスト時にチャンネルをサイドロードし、その後再利用します。
公開されているチャンネルの場合は、代わりにservers.api.devices.roku.app_idを設定してください。リレーされたRoku再生は約30秒遅延します。
リモートサービス
デフォルトでは、CLIコマンドは欠落しているサービスを埋め込みます。処理をオフロードするには、NASでcastor media-serverを実行し、servers.media.tokenを設定します。コンピューター上で:
servers:
media:
url: http://my-nas:8410
token: "<same token as the server>"
コンピューターがテレビを制御し、NASがメディアを処理して提供します。テレビから到達できない場合、サーバーでservers.media.advertiseを設定します。
アプリまたは共有APIの場合は、各サービスを個別に実行します:
| コマンド | デフォルトポート | 実行場所 |
|---|---|---|
castor media-server | 8410 | デバイスはメディアURLを取得できます |
castor scraping-server | 8412 | Chromeがインストールされている |
castor api-server | 8411 | デバイスを検出し、制御できます |
APIはservers.media.url、servers.scraping.url、およびそれらのトークンで設定します。各サービスに独自のトークンを与え、クライアントはservers.api.urlとservers.api.tokenを使用します。スタンドアロンサーバーはデフォルトで全てのインターフェースをリッスンします。信頼できないネットワーク外ではHTTPSを使用してください。SECURITY.mdを参照してください。
APIは、Connect契約を通じて、デバイスリスト、キャスト/停止、ステータス監視を公開します。例として、デバイスをリスト表示します:
curl -X POST http://localhost:8411/castor.v1.DeviceService/ListDevices \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' -d '{}'
サービス所有権とキャストライフサイクルについては、ARCHITECTURE.mdを参照してください。
トラブルシューティング
| 症状 | 確認事項 |
|---|---|
| デバイスが検出されない | 通常、検出は1つのサブネットに留まります。テレビのIPにdevice.hostを設定してスキップしてください。DLNAの場合、説明URLも機能します。Android/Termuxで必要です。 |
| デバイスが同じ名前を共有する | castor scanが表示するIDにdevice.idを設定してください。 |
| ページ動画が見つからない | 動画はクリックなしで開始する必要があります。DRMストリームは拒否されます。 |
| テレビはロードするが再生できない | CASTOR_CAST__DELIVERY=serve castor --debug cast url <url>を試して、サーブされた再生を強制してください。 |
| テレビがサーブされたメディアを取得できない | ファイアウォールでCastorを許可し、servers.media.advertiseおよびservers.media.network.interfaceを確認してください。Android/Termuxではインターフェースを未設定のままにしてください。 |
デバイスは、スタンドアロンメディアサーバーの場合は8410、組み込みサーバーの場合はランダムなLANポートでメディアとキャプションを取得します。検出はSSDP UDP 1900 (DLNA/Roku) および mDNS UDP 5353 (Chromecast) を使用します。アウトバウンド制御は、Chromecast TCP 8009、Roku TCP 8060 (サイドロードの場合は80)、またはDLNAのアドバタイズされたポートを使用します。APIおよびスクレイピングポートはサービスクライアント用です。
ログには、サービス間で共有されるcast_idが含まれます。リモートサービスの場合は、各サーバーのログを確認してください。ログをOTLP/HTTP経由でエクスポートするには、telemetry.endpointを設定します。
Docker
イメージにはChrome、ffmpeg、ffprobeが含まれています。検出およびデバイスから到達可能なメディアURLのためにLinuxホストネットワーキングを使用してください。macOS/Windowsでの検出にはネイティブバイナリの方が簡単です。
docker run --rm --network host \
-v "$PWD/config.yaml:/config.yaml:ro" \
-v castor-cache:/root/.cache \
ghcr.io/stupside/castor:latest \
cast player https://example.com/watch/some-video
Intel VA-APIの場合は--device /dev/driを追加してください。それ以外の場合、エンコーディングはソフトウェアを使用します。キャッシュボリュームはWhisperモデルを保持します。
Composeスタックの場合は、gitで無視される.envにCASTOR_SERVERS__MEDIA__TOKEN、CASTOR_SERVERS__SCRAPING__TOKEN、CASTOR_SERVERS__API__TOKENを配置し、docker compose up -dを実行してください。ホストにそのデバイスがない場合は、/dev/driマッピングを削除してください。ブリッジされたメディアコンテナには-p 8410:8410とデバイスから到達可能なservers.media.advertiseが必要です。
イメージタグ: latest (安定版)、canary (プレビュー)、またはピン留めされたvX.Y.Z。
貢献と目的
ビルドまたは貢献については、CONTRIBUTING.mdを参照してください。Castorはコンテンツ、ソース、またはDRM回避を提供しません。合法的な使用とサイト規約の遵守はあなたの責任です。合法的な個人および教育目的で提供されています。