HN 日本語サマリー

← 一覧へ戻る
プログラミング

IPTVよりも優れて安価

Better and Cheaper Than IPTV (github.com)

314 pointsby xonery98 コメント

要約

Castorは、ウェブサイトから動画ストリームを抽出し、フォーマット互換性を処理し、リアルタイムでテレビにキャストできるコマンドラインインターフェース(CLI)ツールです。オプションで自動生成された字幕を動画に直接焼き込むことも可能です。ターミナルから離れることなく、トレンドのタイトルを閲覧したり、TMDBを検索したり、ポスターやメタデータを検査したりして、キャストできます。

全文翻訳

Castor

[画像: Castor]

[画像: stupside%2Fcastor | Trendshift]

[画像: Latest Release][画像: Go Reference] [画像: Homebrew] [画像: License] [画像: Build Status]

Castorは、画面ミラーリングなしでウェブ動画をテレビにキャストします。ストリームを見つけ、互換性のないフォーマットを変換し、オプションで字幕を生成します。ローカルで実行するか、メディア処理をNASにオフロードできます。

バンドルされたコンテンツやソースはありません。DRMストリームは拒否されます。アクセス権のあるコンテンツを使用してください。

[画像: Castor TUIでのタイトルブラウジング]

クイックスタート

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エンコーダーを使用し、ソフトウェアフォールバックもあります。

プラットフォームインストール
macOSbrew 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の設定
  1. 開発者モードを有効にする: ホーム ×3、上 ×2、右、左、右、左、右を押し、有効にしてウェブサーバーパスワードを設定します。デバイスは再起動します。
  2. config.local.yamlにservers.api.devices.roku.passwordを設定します。
  3. 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-server8410デバイスはメディアURLを取得できます
castor scraping-server8412Chromeがインストールされている
castor api-server8411デバイスを検出し、制御できます

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回避を提供しません。合法的な使用とサイト規約の遵守はあなたの責任です。合法的な個人および教育目的で提供されています。