Kodi Repository Bootstrapper

Many thanks to @Twilight0 and all the others who contributed code for this project before.

Installation

You can install this Python package via pip(x):

pip(x) install kodi-repo-bootstrap

Otherwise the package can be downloaded from PyPI: https://pypi.org/project/kodi-repo-bootstrap/

Usage

1. Preperations

You need two directories:

addons_dir: This direcotry contains the Kodi addons you want to publish. The single addons can be present as ZIP files or as a directory with the official Kodi addon structure.

A valid addons_dir will look like this:
```
addons_dir/
    |- plugin.addon.id-versionX.zip
    - and / or -
    |- plugin.addon.id/
    |    |- addon.xml
    |    |- ...
    |    - and / or -
    |    |- plugin.addon.id-versionX.zip
```
If multiple versions of the same addon (same ID) are present, only the newest version will be used by the script.
repo_dir where this script creates the necessary structure for a Kodi repository. Please do not make any manual changes to this directory.

2. Define repository settings

Create a configuration file in JSON format (e.g. config.json). An example file with the available options can be found in the root directory of this repository: config.json.example

Configure the Kodi repository with CLI arguments. See

kodi-repo-bootstrap -h

for the available settings.

3. Run the script

kodi-repo-bootstrap <CONFIG_FILE>

The path to the config file is mandatory.

This will create all files and directories that are necessary for a Kodi repository. No user interaction is needed.

4. Publish the `repo_dir` e.g. via HTTP server (webdav)

The repo_dir contains all files and directories that are necessary for Kodi to recognize it as a valid repository. You only have to publish it via HTTP.

For a simple Webdav setup with Docker, you can have a look at my other repository: docker-webdav

5. [Optional] Change repository settings

To change any settings you can either

adjust the config file

use a CLI argument. The script will then save the changes to the config file for you.

Troubleshooting

If you encounter any errors, please clear the repo_dir first and run the script again. This will recreate the Kodi repository file structure.

If the error is still present, feel free to open an issue on GitHub.

mammo0/kodi-repo-bootstrap