Tutorial dan contoh repositori untuk menyiapkan repo Kodi yang dihosting GitHub. Untuk contoh repo yang dibuat menggunakan metode ini (termasuk submodul), lihat https://www.github.com/jurialmunkey/repository.jurialmunkey/.
Untuk mengikuti tutorial ini, pertama-tama gunakan repositori ini sebagai templat untuk repositori baru, lalu kloning repositori yang baru Anda buat secara lokal. Untuk URL sumber pengelola file yang paling sederhana, disarankan untuk memberi nama repositori yang baru Anda buat sebagai YOUR_USERNAME_HERE.github.io
.
Pertama, Anda harus mengedit file addon.xml
di dalam folder /repo/repository.example
dengan ID add-on yang Anda pilih, nomor versi, dan nama pengguna Anda (atau apa pun yang Anda inginkan) untuk provider
, seperti yang terlihat di jalur 2:
< addon id = " ADDON_ID_HERE " name = " REPO_NAME_HERE " version = " VERSION_NUMBER_HERE " provider-name = " YOUR_USERNAME_HERE " >
Anda juga perlu mengganti YOUR_USERNAME_HERE
, REPOSITORY_NAME_HERE
, dan BRANCH_NAME_HERE
dengan nama pengguna GitHub Anda, nama repositori ini, dan nama cabang (disarankan untuk menggunakan cabang default, biasanya master
atau main
), seperti yang terlihat pada baris 4-8:
< 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 >
Anda juga harus mengubah ringkasan dan deskripsi repositori Anda, seperti yang terlihat pada baris 11-12:
< summary >REPO_NAME_HERE summary >
< description >DESCRIPTION OF YOUR REPO HERE description >
Meskipun tidak diwajibkan, disarankan juga untuk mengganti icon.png
dan fanart.jpg
di folder repository.example
dengan karya seni yang relevan dengan repositori Anda atau add-on yang ada di dalamnya. icon.png
harus berukuran 512x512 px, dan fanart.jpg
harus berukuran 1920x1080 px, atau rasio serupa.
Terakhir, ganti nama folder repository.example
agar sesuai dengan ID add-on apa pun yang Anda pilih sebelumnya.
Untuk membangun repositori, pertama-tama tempatkan folder sumber add-on untuk add-on mana pun yang ingin Anda masukkan ke dalam repo Kodi Anda di dalam repositori ini. Untuk kemudahan memperbarui add-on yang disertakan, metode yang disarankan untuk melakukan hal ini adalah melalui Submodul Git, yang didukung oleh banyak klien Git, serta terminal Git. Jika Anda memilih untuk tidak menggunakan submodul, Anda cukup menyalin folder sumber langsung ke repositori ini.
Skrip _repo_xml_generator.py
disertakan dalam repositori ini dengan file build .zip
untuk setiap add-on yang disertakan, serta menghasilkan file addons.xml
dan addons.xml.md5
yang diperlukan, sehingga Kodi dapat menyimpulkan konten repo. Ini dirancang untuk menangani beberapa versi Kodi (misalnya, untuk menyajikan add-on yang berbeda ke Leia daripada yang disajikan ke Matrix), dan repositori tunggal yang menyajikan add-on yang sama untuk semua versi Kodi.
Tempatkan folder sumber tambahan Anda di folder repo
repositori ini.
Tempatkan folder sumber tambahan Anda ke dalam folder yang diberi nama sesuai versi Kodi yang ingin Anda sajikan, bukan /repo
. Misalnya, /leia
untuk repo yang berfokus pada Leia, atau /matrix
untuk repo yang berfokus pada Matriks. Agar repositori Anda dapat membedakan add-on mana yang akan dilayani, Anda perlu menambahkan bagian dir
baru ke addon.xml
Anda, yang menentukan versi mana yang harus dilayani.
Misalnya, untuk melayani Leia saja:
< 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 >
Dan untuk Matrix dan yang lebih baru:
< 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 >
Setelah menambahkan folder sumber Anda, jalankan saja _repo_generator.py
. Ini akan membuat .zip
dari semua add-on yang diinginkan, dan menempatkannya dalam subfolder yang disebut zips
, bersama dengan addons.xml
dan addons.xml.md5
yang dihasilkan. Pada versi 3, skrip ini dapat membuat distribusi untuk Krypton, Leia, Matrix, dan Nexus, serta "repo" generik, yang dimaksudkan untuk digunakan pada versi apa pun (seperti untuk repositori itu sendiri, atau pustaka lintas versi apa pun dan ketergantungan).
Salin file zip repositori Anda, yang terletak di REPO_FOLDER/zips/ADDON_ID_HERE/ADDON_ID_HERE-VERSION_NUMBER_HERE.zip
, dan tempelkan ke folder root.
Edit tautan di dalam index.html
untuk mencerminkan nama file add-on Anda, seperti yang terlihat pada baris 1:
< a href =" ADDON_ID_HERE-VERSION_NUMBER_HERE.zip " > ADDON_ID_HERE-VERSION_NUMBER_HERE.zip a >
Setelah melakukan dan menerapkan perubahan ini ke repo Anda, buka bagian "Pengaturan" untuk repositori ini di GitHub. Di kotak pertama, berlabel "Nama repositori", ubah nama repositori Anda. Umumnya, repositori Halaman GitHub diberi nama YOUR_USERNAME_HERE.github.io
, namun bisa juga sesuai keinginan Anda. Selanjutnya, gulir ke bawah ke bagian "Halaman GitHub", pilih cabang default (atau mana pun yang Anda pilih saat memodifikasi addon.xml
) sebagai sumber, dan klik "Simpan".
Setelah itu, semuanya harus selesai!
Jika Anda menamai repositori ini YOUR_USERNAME_HERE.github.io
(seperti yang direkomendasikan), sumber pengelola file Anda adalah:
https://YOUR_USERNAME_HERE.github.io/
Jika Anda menamainya dengan nama lain, hasilnya akan menjadi:
https://YOUR_USERNAME_HERE.github.io/REPOSITORY_NAME_HERE/
Jika Anda ingin menghosting repo Kodi Anda di host lain selain Halaman GitHub, cukup unduh repositori ini sebagai .zip
, dan unzip, daripada menggunakannya sebagai templat. Lanjutkan mengikuti prosedur pengaturan selanjutnya, kecuali untuk pengaturan Halaman GitHub. Satu-satunya perbedaan terletak pada file addon.xml
Anda, karena file tersebut perlu mereferensikan host Anda, bukan GitHub:
< 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 >
Dan unggah konten repositori ini ke host Anda. Sangat penting bahwa YOUR_HOST_URL_HERE
adalah URL ke folder root repositori ini.
Setelah melakukannya, sumber pengelola file Anda akan menjadi:
https://YOUR_HOST_URL_HERE/