GitHub でホストされる Kodi リポジトリをセットアップするためのチュートリアルとサンプル リポジトリ。この方法を使用して作成されたリポジトリ (サブモジュールを含む) の例については、https://www.github.com/jurialmunkey/repository.jurialmunkey/ を参照してください。
このチュートリアルに従うには、まずこのリポジトリを新しいリポジトリのテンプレートとして使用し、次に新しく作成したリポジトリのクローンをローカルに作成します。最も単純なファイル マネージャーのソース URL として、新しく作成したリポジトリにYOUR_USERNAME_HERE.github.io
という名前を付けることをお勧めします。
まず、 /repo/repository.example
フォルダー内のaddon.xml
ファイルを、選択したアドオン ID、バージョン番号、 provider
のユーザー名 (または任意の名前) で編集する必要があります。 2行目:
< addon id = " ADDON_ID_HERE " name = " REPO_NAME_HERE " version = " VERSION_NUMBER_HERE " provider-name = " YOUR_USERNAME_HERE " >
また、行 4 ~ 8 に示すように、 YOUR_USERNAME_HERE
、 REPOSITORY_NAME_HERE
、およびBRANCH_NAME_HERE
を、それぞれ GitHub ユーザー名、このリポジトリの名前、ブランチの名前 (デフォルトのブランチ、通常はmaster
またはmain
を使用することをお勧めします) に置き換える必要があります。
< dir >
< info compressed = " false " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/addons.xml info >
< checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/addons.xml.md5 checksum >
< datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/ datadir >
dir >
11 ~ 12 行目にあるように、リポジトリの概要と説明も変更する必要があります。
< summary >REPO_NAME_HERE summary >
< description >DESCRIPTION OF YOUR REPO HERE description >
必須ではありませんが、 repository.example
フォルダー内のicon.png
とfanart.jpg
、リポジトリまたはそこに含まれるアドオンに関連するアートに置き換えることをお勧めします。 icon.png
は 512x512 ピクセル、 fanart.jpg
1920x1080 ピクセル、または同様の比率である必要があります。
最後に、前に選択したアドオン ID と一致するように、 repository.example
フォルダーの名前を変更します。
リポジトリを構築するには、まず、Kodi リポジトリに含めたいアドオンのアドオン ソース フォルダーをこのリポジトリ内に配置します。含まれているアドオンを簡単に更新できるように、Git ターミナルだけでなく多くの Git クライアントでサポートされている Git サブモジュールを使用することをお勧めします。サブモジュールを使用しないことを選択した場合は、ソース フォルダーをこのリポジトリに直接コピーするだけで済みます。
このリポジトリに含まれる_repo_xml_generator.py
スクリプトは、含まれる各アドオンの.zip
ファイルをビルドするとともに、Kodi がリポジトリの内容を推測できるように、必要なaddons.xml
およびaddons.xml.md5
ファイルを生成します。これは、Kodi の複数のバージョン (たとえば、Matrix に提供されるものとは異なるアドオンを Leia に提供する) と、すべての Kodi バージョンに同じアドオンを提供する単一のリポジトリを処理するように設計されています。
アドオンのソース フォルダーをこのリポジトリのrepo
フォルダーに配置します。
アドオンのソース フォルダーを、 /repo
ではなく、そこから提供したい Kodi のバージョンにちなんで名付けられたフォルダーに配置します。たとえば、Leia に重点を置いたリポジトリの場合は/leia
、Matrix に重点を置いたリポジトリの場合は/matrix
。リポジトリがどのアドオンを提供するかを区別できるようにするには、どのバージョンを提供するかを定義する新しいdir
セクションをaddon.xml
に追加する必要があります。
たとえば、レイアのみにサービスを提供するには:
< dir minversion = " 18.0.0 " maxversion = " 18.9.9 " >
< info compressed = " false " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/leia/zips/addons.xml info >
< checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/leia/zips/addons.xml.md5 checksum >
< datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/leia/zips/ datadir >
dir >
マトリックス以上の場合:
< dir minversion = " 19.0.0 " >
< info compressed = " false " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/matrix/zips/addons.xml info >
< checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/matrix/zips/addons.xml.md5 checksum >
< datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/matrix/zips/ datadir >
dir >
ソースフォルダーを追加したら、 _repo_generator.py
実行するだけです。これにより、必要なすべてのアドオンの.zip
が作成され、生成されたaddons.xml
およびaddons.xml.md5
とともにzips
というサブフォルダーに配置されます。バージョン 3 では、このスクリプトは Krypton、Leia、Matrix、Nexus のディストリビューションに加えて、任意のバージョン (リポジトリ自体、またはクロスバージョン ライブラリなど) に提供することを目的とした汎用の「リポジトリ」を作成できます。および依存関係)。
REPO_FOLDER/zips/ADDON_ID_HERE/ADDON_ID_HERE-VERSION_NUMBER_HERE.zip
にあるリポジトリの zip ファイルをコピーし、ルート フォルダーに貼り付けます。
1 行目に示すように、アドオンのファイル名を反映するように、 index.html
内のリンクを編集します。
< a href =" ADDON_ID_HERE-VERSION_NUMBER_HERE.zip " > ADDON_ID_HERE-VERSION_NUMBER_HERE.zip a >
これらの変更をリポジトリにコミットしてプッシュした後、GitHub 上のこのリポジトリの「設定」セクションに移動します。 「リポジトリ名」というラベルの付いた最初のボックスで、リポジトリの名前を変更します。通常、GitHub Pages リポジトリの名前はYOUR_USERNAME_HERE.github.io
ですが、任意の名前にすることができます。次に、「GitHub Pages」セクションまで下にスクロールし、デフォルトのブランチ (またはaddon.xml
変更するときに選択したブランチ) をソースとして選択し、「保存」をクリックします。
その後はすべて完了するはずです。
このリポジトリにYOUR_USERNAME_HERE.github.io
という名前を付けた場合 (推奨どおり)、ファイル マネージャーのソースは次のようになります。
https://YOUR_USERNAME_HERE.github.io/
別の名前を付けた場合は、次のようになります。
https://YOUR_USERNAME_HERE.github.io/REPOSITORY_NAME_HERE/
GitHub Pages 以外の別のホストで Kodi リポジトリをホストしたい場合は、テンプレートとして使用するのではなく、このリポジトリを.zip
としてダウンロードして解凍します。 GitHub Pages のセットアップを除く、残りのセットアップ手順に従います。 GitHub ではなくホストを参照する必要があるため、唯一の違いはaddon.xml
ファイル内にあります。
< dir >
< info compressed = " false " >https://YOUR_HOST_URL_HERE/repo/zips/addons.xml info >
< checksum >https://YOUR_HOST_URL_HERE/repo/zips/addons.xml.md5 checksum >
< datadir zip = " true " >https://YOUR_HOST_URL_HERE/repo/zips/ datadir >
dir >
そして、このリポジトリの内容をホストにアップロードします。 YOUR_HOST_URL_HERE
がこのリポジトリのルートフォルダーへの URL であることが非常に重要です。
これを実行すると、ファイル マネージャーのソースは次のようになります。
https://YOUR_HOST_URL_HERE/