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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file kodi_repo_bootstrap-3.0.2.tar.gz.

File metadata

  • Download URL: kodi_repo_bootstrap-3.0.2.tar.gz
  • Upload date:
  • Size: 18.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for kodi_repo_bootstrap-3.0.2.tar.gz
Algorithm Hash digest
SHA256 c434cbff7a1aa6bae879ddd2590c6c18790f32d55a161583c53b547f333d7648
MD5 b23a2954c50c7704e55f4fb7dfcde484
BLAKE2b-256 73c4a1a334b08958b6b95a9db4da1033aa7dea227ef3f0a46eec84bed5ceaf42

See more details on using hashes here.

File details

Details for the file kodi_repo_bootstrap-3.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for kodi_repo_bootstrap-3.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 620188f3275079af913c06a20ca0fb6ece8056bfcbe261ff671fbfabdc1c726b
MD5 2f0fd50d2fa3823913f9a1b2c81fa4ae
BLAKE2b-256 b699a72d53a868cc060a6cae392d8dc17a133da0f8b9a95bbe12e65cbb8feab3

See more details on using hashes here.

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