devineダウンロード - devineソースコードのダウンロード

特徴

pip 経由のシームレスなインストール
?映画、エピソード、およびソングのサービスフレームワーク
組み込みの DASH および HLS パーサー
pywidevine による Widevine DRM 統合
?ローカルおよびリモートの DRM キーコンテナー
?ローカルおよびリモートの Widevine CDM
認証情報や Cookie を使用したサービスごとのマルチプロファイル認証
?グループタグを使用した自動 P2P ファイル名構造
構成用の YAML
❤️ 完全なオープンソース!プルリクエスト歓迎

インストール

$ pip install devine

注記

pip が PATH 環境変数にパスが存在しないという警告を表示した場合は、すぐにそのパスを追加してから、開いているコマンドプロンプト/ターミナルウィンドウをすべて閉じてください。そうしないと、パスが見つからないため、 devine機能しません。

ほら？ — これで、 devineパッケージがインストールされました。
コマンドラインインターフェイスが利用できるようになりました。 devine --helpをお試しください。

依存関係

以下は、手動でインストールする必要があるプログラムのリストです。

EIA-608 などのクローズドキャプションデータをビデオストリームから抽出し、SRT として変換するための CCExtractor。
FFmpeg (および ffprobe) は、特定のサービスでストリームを再パック/再多重化し、ストリームデータを評価します。
個々のストリームを.mkvファイルに多重化するための MKVToolNix v54+。
CENC-CTR および CENC-CBCS のビデオおよびオーディオストリームを復号化するための shaka-packager。
(オプション) aria2(c) をダウンローダーとして使用します。

ヒント

可能であれば、パッケージリポジトリからこれらをインストールする必要があります。 Windows の winget/chocolatey を含む。バイナリのパスがPATH環境変数に自動的に追加されるため、将来の更新が簡単になります。

重要

これらの依存関係のほとんどは移植可能なユーティリティであるため、インストーラーを使用しません。これらを winget/choco/pacman などのパッケージリポジトリからインストールしない場合は、それらを現在の作業ディレクトリ、Devine のインストールディレクトリ、またはバイナリのパスをPATH環境変数に置くようにしてください。これを行わないと、Devine はバイナリを見つけることができません。

使用法

まず、 devine --helpで完全なヘルプドキュメントを参照してください。利用可能なすべてのコマンドがリストされ、Devine で何ができるかについての詳細情報が提供されます。

以下に、私が始めることをお勧めするチェックリストを順不同で示します。

サービスを追加します。これらはdevine dlで使用されます。
プロファイルを追加します。これらは Cookie と認証情報です。
CDM とも呼ばれる Widevine Provisions を追加します。これらは DRM で保護されたコンテンツに使用されます。
グループタグ (最終的なファイル名の末尾のテキスト) を設定します。たとえば、 ...-NOGRPにはdevine cfg tag NOGRP 。
ローカル Key Vault をセットアップし、Key Vault 構成を確認します。

ここで、さらに高度な内容を見てみましょう。

リクエストセッションが使用するデフォルトのヘッダーを設定します。
サービスに使用するデフォルトのプロファイルと CDM プロビジョニングを設定します。
自動プロキシ用の NordVPN および Hola プロキシプロバイダー。
リモートキーコンテナーのホスティングおよび/または使用。
リモート CDM プロビジョニングの提供および/または使用。

構成に関するドキュメントは CONFIG.md ファイルで入手でき、便利な設定がたくさんあります。
CLI 呼び出しに何かを入れることにうんざりし始めたら、それを検討することをお勧めします。

サービス

youtube-dl などの同様のプロジェクトとは異なり、Devine には現在サービスが付属していません。お客様は独自のサービスを開発し、法的権利を有するサービスでのみ Devine を使用する必要があります。

注記

Widevine やその他の DRM システムを使用しない Devine のサービスを作成した場合は、お気軽にプルリクエストを作成して、他の人がサービスを利用できるようにしてください。 youtube-dl (または yt-dlp) 上のサービスはどちらも Unlicense ライセンスを使用しているため、Devine リポジトリに追加できるため、コードの直接読み取りと移植は合法になります。

サービスの作成

警告

完全な法的権利を有するサービスでのみサービスコードを作成または使用してください。

サービスは、 __init__.pyファイルを含むフォルダーで構成されます。ファイルには、フォルダーと同じ名前のクラスが含まれている必要があります。このクラスは Service クラスを継承し、すべての抽象化されたメソッドを実装する必要があります。最後に、CLI 引数を定義するcliという名前の新しいメソッドを実装する必要があります。

/devine/services内に新しいフォルダーを作成します。選択したフォルダー名は、サービスタグとして知られるものになります。この「タグ」は、ダウンロードされたファイルの最終出力ファイル名で、さまざまなコードチェック、キーコンテナーデータベースのキーの検索などに使用されます。
新しいフォルダー内に__init__.pyファイルを作成し、Service クラスを継承するクラスを作成します。フォルダーとまったく同じ名前を付ける必要があります。大文字と小文字が区別されます。
継承している Service クラスの、抽象としてマークされているメソッドをすべて実装します。
cliメソッドを実装して CLI 引数を定義します。このメソッドは静的である必要があります (つまり@staticmethod )。たとえば、一種のタイトル ID を受け取るための最低限の機能を実装するには、次のようにします。
```
 @ staticmethod
@ click . command ( name = "YT" , short_help = "https://youtube.com" , help = __doc__ )
@ click . argument ( "title" , type = str )
@ click . pass_context
def cli ( ctx , ** kwargs ):
    return YT ( ctx , ** kwargs )
```
CLI 引数が必要ない場合でも、このcliメソッドを実装する必要があります。コアの CLI 機能がクラスを検索して呼び出すことができるようにする必要があります。

コンストラクター ( __init__()メソッド) をオーバーライドして、CLI 引数を受け入れます。

 def __init__ ( self , ctx , title ):
    self . title = title
    super (). __init__ ( ctx )  # important
    # ... the title is now available across all methods by calling self.title

注記

抽象としてマークされたService ( @abstractmethod ) から継承されたクラスのすべてのメソッドは、クラスによって実装されなければなりません。
メソッド (例: __init__()メソッド) をオーバーライドするときは、それをスーパーコールしなければなりません (例: オーバーライドの先頭でsuper().__init__() 。抽象メソッドは実装されていないため、これは適用されません。
グローバルヘッダーなどを使用してリクエストセッションを準備する場合は、 get_sessionメソッドをオーバーライドしてからself.session変更する必要があります。 self.session最初から手動で作成しないでください。

ヒント

Web リクエストを行うには、 self.sessionクラスのインスタンス変数 (例: self.session.get(url)を使用します。
__init__.pyの隣にconfig.yamlファイルを作成すると、 self.configを使用してアクセスできます。
サービスで使用するために、サービスフォルダー内に任意のファイルを含めることができます。たとえば、TLS 証明書ファイル、またはヘルパー関数とクラスを含む他の Python ファイルです。

サービスタグ

サービスタグは通常、次のルールに従います。

タグは 2 ～ 4 文字の長さで、 [A-Z0-9i]{2,4}のみで構成されている必要があります。
- 小文字のi 、選択されたサービスにのみ使用されます。具体的にはBBC iPlayerとiTunesです。
サービスの商用名に+またはPlus付いている場合、最後の文字はPである必要があります。たとえば、 Apple TV+の場合はATVP 、 Discovery+の場合はDSCP 、 Disney+の場合はDSNP 、 Paramount+の場合はPMTP 。

これらのルールは完全なものではないため、ガイドとしてのみ使用してください。これらのルールに厳密に従う必要はありませんが、一貫性を保つためにそうすることをお勧めします。

シェアリングサービス

zip 形式のサービスフォルダーの送受信は非常に面倒です。サービスコードでコラボレーションするための別のルートを検討してみましょう。

警告

誰を信頼し、何を実行するかには注意してください。サービスコードで共同作業しているユーザーは、次回の呼び出しで devine 経由で実行される悪意のあるコードでサービスコードを更新する可能性があります。

分岐

複数のサービスでチームと共同作業している場合は、プロジェクトをフォークすることが最善の方法です。

README、.gitignore、または LICENSE ファイルを使用せずに、新しいプライベート GitHub リポジトリを作成します。注: GitHub Fork ボタンは使用しないでください。使用しないと、リポジトリを非公開にすることができなくなります。
git clone <your repo url here> 、そこにcdします。
git remote add upstream https://github.com/devine-dl/devine
git remote set-url --push upstream DISABLE
git fetch upstream
git pull upstream master
(オプション) タグによって最新の安定バージョンにハードリセットします。たとえば、 git reset --hard v1.0.0です。

次に、サービスまたはその他の変更をフォークされたリポジトリにコミットします。
一度コミットすると、他のチームメンバー全員が簡単に変更をプルしたり、新しい変更をプッシュしたりできます。

新しいアップデートがリリースされた場合、フォークをそのコミットにリベースして更新することが簡単にできます。

git fetch upstream
git rebase upstream/master

ただし、リベースする前に必ず各バージョン間の変更を確認し、新しいバージョンにリベースするときに重大な変更や非推奨を解決してください。

gitを初めて使用する場合は、GitHub Desktop をご覧ください。

ヒント

この方法の大きな利点は、独自のサービスでも依存関係を同期できることです。 poetry使用して依存関係を適切に追加または変更し、変更されたpoetry.lockコミットするだけです。ただし、コアプロジェクトにも依存関係の変更がある場合は、 poetry.lock変更が競合するため、競合の解決/リベースの方法を学ぶ必要があります。でもそれだけの価値はあります！

シンボリックリンク

これは、フォーク方法のようなことを実行したいが、いつどのような変更が行われたかは気にせず、単にチーム全体で変更を同期したい人にとっては優れたオプションです。

これにより、サービスコードをホストしたり共同作業したりする方法も開かれます。ディレクトリ内のサービスのみを更新するディレクトリを受信できれば、問題ありません。オプションには、FTP サーバー、共有 Google ドライブ、サービスのみを備えた非フォークリポジトリなどが含まれます。

通常のドライブと同様にサービスファイルにアクセスするための疑似ディレクトリを提供するクラウドソースを使用します。例: rclone、Google ドライブデスクトップ (別名ファイルストリーム)、Air Drive、CloudPool など。
その中のどこかにservicesディレクトリを作成し、その中にすべてのサービスを入れます。
servicesディレクトリを/devineフォルダーにシンボリックリンクします。最終的には、 /devine/services /devine/services/services services フォルダーが作成されるはずです。

元のフォルダーがそれらの変更を受信し、ダウンロード/ストリーミングし続けることを確認する必要があります。また、ローカルにある devine のバージョンがサービスコードでサポートされていることを確認する必要があります。

注記

ファイルが開かれるとダウンロードするクラウドソースを使用している場合は、自動的にダウンロードされるため心配する必要はありません。 Python がファイルをインポートすると、ダウンロードが開始されます。ただし、起動時に遅延が発生する可能性があります。

Cookieと認証情報

Devine は、Cookie や資格情報を使用してサービスで認証できます。認証情報は設定に保存され、Cookie はdevine env info実行すると見つかるデータディレクトリに保存されます。

サービスに認証情報を追加するには、サービスごとに 1 つ以上の認証情報を設定する方法について、認証情報設定を参照してください。サービスごとに 1 つ以上の資格情報を追加し、 -p/--profile使用して使用する資格情報を選択できます。

サービスに Cookie を追加するには、Cookie ファイル拡張子を使用してcookies.txtファイルを作成し、それを Cookies ディレクトリに移動します。 cookies.txtファイルの名前をサービスタグの名前 (大文字と小文字が区別される)、たとえばNF.txtに変更する必要があります。これをサービス Cookie フォルダー ( /Cookies/NF/default.txtまたは/Cookies/NF/.txtなど) に配置することもできます。

複数の Cookie を独自の一意の名前で/Cookies/NF/フォルダーに追加し、 -p/--profile使用してどれを使用するかを選択できます。たとえば、 /Cookies/NF/sam.txt --profile samとともに使用します。 .txtまたはdefault.txtを持たずに別のファイルを使用してサービス Cookie フォルダーを作成した場合、示されているように-p/--profile使用しない限り、Cookie はロードされません。これにより、気まぐれに認証をオプトインできます。

ヒント

サービスに認証が必要ない場合は、そのサービスに対して資格情報や Cookie を定義しないでください。
サービスが両方を取得して使用する限り、Cookie と認証情報の両方を同時に使用できます。
プロファイルを使用している場合は、 -p/--profile使用するときに資格情報名と Cookie ファイル名に同じ名前を使用していることを確認してください。

警告

プロファイル名は大文字と小文字が区別され、サービスごとに一意です。任意の文字や長さの制限はありませんが、端末が混乱する可能性があるため、便宜上、特殊文字を使用することはお勧めしません。

Cookieのファイル形式と拡張子

Cookie は、標準の Netscape Cookie ファイル形式である必要があります。
推奨される Cookie エクスポーター拡張機能:

Firefox: 「Cookie のエクスポート」 by Rotem Dan
Chromium: 「Open Cookies.txt」 by Ninh Pham 、~~またはRahul Shawの「Get cookies.txt」~~

標準 Netscape 形式にエクスポートする他の拡張機能は、理論的には機能するはずです。

警告Rahul Shaw による Get cookies.txt 拡張機能は、本質的にはスパイウェアです。使用しないでください。安全なバージョンがいくつか出回っていますが (通常は拡張機能の古いバージョンだけです)、安全な代替手段があるため、私はそれを完全に避けます。出典: https://reddit.com/r/youtubedl/comments/10ar7o7

ワイドバインの規定

Widevine プロビジョニングは、DRM で保護されたコンテンツの復号キーを含むライセンスを取得するために必要です。 DRM フリーのサービスで devine を使用する場合は必要ありません。 Widevine デバイスファイル、キー、プロビジョンは提供できないため、要求しないでください。

Devine は.WVDファイル (widevine デバイスファイル) のみをサポートします。ただし、Provision RSA 秘密キーとデバイスクライアント識別 BLOB を BLOB ファイル ( device_private_keyやdevice_client_id_blobなど) として持っている場合は、 pywidevine create-device --helpを実行して、それらを.WVDファイルに変換できます。

.WVDファイルを取得したら、 devine env info呼び出すことで見つけられる WVDs ディレクトリにそれらのファイルを置きます。その後、 devine cfg cdm.default wvd_nameを使用して、デフォルトでどの WVD を使用するかを (ファイル名のみで) 設定することができます。ここから、特定のサービスごとにどの WVD を使用するかを設定できます。可能な限り、最も低いセキュリティレベルのプロビジョニングを使用することが最善です。

代わりに、pywidevine Serve 準拠の CDM API を使用することもできます。もちろん、サービスを提供している人を知っている必要があり、その人があなたにアクセスを許可する必要があります。セットアップ情報については、remote_cdm config オプションを参照してください。詳細については、pywidevine リポジトリを参照してください。

エンドユーザー使用許諾契約書

Devine とそのコミュニティページは、他のプロジェクトと同じように親切に扱われるべきです。サービスのエンドユーザーライセンス契約に違反するスパムや質問はご遠慮ください。

権利を持たない目的で Devine を使用しないでください。
侵害コンテンツを共有したりリクエストしたりしないでください。これには、 Widevine プロビジョニングキー、コンテンツ暗号化キー、サービス API 呼び出しまたはコードが含まれます。
コアコードベースは無料かつオープンソースであり続けることを目的としていますが、サービスコードは非公開に保つ必要があります。
単独でも、バンドルの一部としても、このプロジェクトのいかなる部分も販売しないでください。このソフトウェアの代金を支払った場合、または支払後にバンドルの一部として受け取った場合は、直ちに返金を要求する必要があります。
お互いに親切にし、誰かを非難しないでください。