Skip to main content

Bootstrap GIT repo for setting up a Kodi repository

Project description

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

OR

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

OR

  • 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kodi_repo_bootstrap-3.0.2.tar.gz (18.1 kB view hashes)

Uploaded Source

Built Distribution

kodi_repo_bootstrap-3.0.2-py3-none-any.whl (21.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page