repository.example
1.0.0
Tutorial y repositorio de ejemplo para configurar un repositorio Kodi alojado en GitHub. Para ver un ejemplo de un repositorio creado con este método (incluidos los submódulos), consulte https://www.github.com/jurialmunkey/repository.jurialmunkey/.
Para seguir este tutorial, primero use este repositorio como plantilla para un nuevo repositorio y luego clone su repositorio recién creado localmente. Para obtener la URL de origen del administrador de archivos más simple, se recomienda nombrar su repositorio recién creado como YOUR_USERNAME_HERE.github.io .
Primero, deberá editar el archivo addon.xml dentro de la carpeta /repo/repository.example con el ID del complemento elegido, un número de versión y su nombre de usuario (o lo que desee) para provider , como se ve. en la línea 2:
< addon id = " ADDON_ID_HERE " name = " REPO_NAME_HERE " version = " VERSION_NUMBER_HERE " provider-name = " YOUR_USERNAME_HERE " > También debes reemplazar YOUR_USERNAME_HERE , REPOSITORY_NAME_HERE y BRANCH_NAME_HERE con tu nombre de usuario de GitHub, el nombre de este repositorio y el nombre de la rama (se recomienda usar la rama predeterminada, generalmente master o main ) respectivamente, como se ve en las líneas 4-8:
< dir >
< info compressed = " false " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/addons.xmlinfo >
< checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/addons.xml.md5checksum >
< datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/datadir >
dir >También debes cambiar el resumen y la descripción de tu repositorio, como se ve en las líneas 11-12:
< summary >REPO_NAME_HEREsummary >
< description >DESCRIPTION OF YOUR REPO HEREdescription > Si bien no es necesario, también se recomienda reemplazar icon.png y fanart.jpg en la carpeta repository.example con arte relevante para su repositorio o los complementos que contiene. icon.png debe tener 512x512 px y fanart.jpg debe tener 1920x1080 px, o una proporción similar.
Finalmente, cambie el nombre de la carpeta repository.example para que coincida con el ID del complemento que eligió anteriormente.
Para crear el repositorio, primero coloque las carpetas de origen de los complementos que desee que estén contenidos en su repositorio de Kodi dentro de este repositorio. Para facilitar la actualización de los complementos incluidos, el método recomendado para hacerlo es a través de los submódulos de Git, que son compatibles con muchos clientes de Git, así como con el terminal Git. Si elige no utilizar submódulos, simplemente deberá copiar las carpetas de origen directamente en este repositorio.
El script _repo_xml_generator.py incluido en este repositorio con archivos .zip de compilación para cada complemento incluido, además de generar los archivos addons.xml y addons.xml.md5 necesarios, para que Kodi pueda inferir el contenido del repositorio. Está diseñado para manejar múltiples versiones de Kodi (por ejemplo, para ofrecer diferentes complementos a Leia que los que se ofrecen a Matrix) y repositorios únicos que brindan los mismos complementos para todas las versiones de Kodi.
Coloque las carpetas de origen de sus complementos en la carpeta repo de este repositorio.
Coloque las carpetas de origen de sus complementos en una carpeta con el nombre de la versión de Kodi que desea servir, en lugar de /repo . Por ejemplo, /leia para un repositorio centrado en Leia o /matrix para uno centrado en Matrix. Para que su repositorio pueda diferenciar qué complementos ofrecer, deberá agregar una nueva sección dir a su addon.xml , que defina qué versiones se deben ofrecer.
Por ejemplo, para servir únicamente a Leia:
< 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.xmlinfo >
< checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/leia/zips/addons.xml.md5checksum >
< datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/leia/zips/datadir >
dir >Y para Matrix y superiores:
< 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.xmlinfo >
< checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/matrix/zips/addons.xml.md5checksum >
< datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/matrix/zips/datadir >
dir > Después de agregar sus carpetas de origen, simplemente ejecute _repo_generator.py . Esto creará archivos .zip de todos los complementos deseados y los colocará en subcarpetas llamadas zips , junto con los addons.xml y addons.xml.md5 generados. A partir de la versión 3, este script puede crear distribuciones para Krypton, Leia, Matrix y Nexus, así como el "repositorio" genérico, que está destinado a servir a cualquier versión (como el repositorio en sí o cualquier biblioteca entre versiones). y dependencias).
Copie el archivo zip de su repositorio, ubicado en REPO_FOLDER/zips/ADDON_ID_HERE/ADDON_ID_HERE-VERSION_NUMBER_HERE.zip , y péguelo en la carpeta raíz.
Edite el enlace dentro de index.html para reflejar el nombre de archivo de su complemento, como se ve en la línea 1:
< a href =" ADDON_ID_HERE-VERSION_NUMBER_HERE.zip " > ADDON_ID_HERE-VERSION_NUMBER_HERE.zip a > Después de confirmar y enviar estos cambios a su repositorio, vaya a la sección "Configuración" de este repositorio en GitHub. En el primer cuadro, denominado "Nombre del repositorio", cambie el nombre de su repositorio. Generalmente, los repositorios de GitHub Pages se llaman YOUR_USERNAME_HERE.github.io , pero puede ser el que quieras. A continuación, desplácese hacia abajo hasta la sección "Páginas de GitHub", elija la rama predeterminada (o la que eligió al modificar su addon.xml ) como fuente y haga clic en "Guardar".
¡Después de eso, deberías haber terminado!
Si nombró este repositorio YOUR_USERNAME_HERE.github.io (como se recomienda), la fuente de su administrador de archivos será:
https://YOUR_USERNAME_HERE.github.io/
Si le pusiste otro nombre, será:
https://YOUR_USERNAME_HERE.github.io/REPOSITORY_NAME_HERE/
Si desea alojar su repositorio de Kodi en un host diferente además de GitHub Pages, simplemente descargue este repositorio como .zip y descomprímalo, en lugar de usarlo como plantilla. Continúe siguiendo el resto del procedimiento de configuración, excepto la configuración de GitHub Pages. Las únicas diferencias estarán en su archivo addon.xml , ya que deberá hacer referencia a su host, en lugar de a GitHub:
< dir >
< info compressed = " false " >https://YOUR_HOST_URL_HERE/repo/zips/addons.xmlinfo >
< checksum >https://YOUR_HOST_URL_HERE/repo/zips/addons.xml.md5checksum >
< datadir zip = " true " >https://YOUR_HOST_URL_HERE/repo/zips/datadir >
dir > Y cargue el contenido de este repositorio en su host. Es muy importante que YOUR_HOST_URL_HERE sea la URL de la carpeta raíz de este repositorio.
Después de hacerlo, la fuente de su administrador de archivos será:
https://YOUR_HOST_URL_HERE/
