Archive:Create a repository for add-ons

From Official Kodi Wiki
Revision as of 18:01, 13 January 2011 by >Anarchintosh (→‎Things you will require)
Jump to navigation Jump to search

After you have created your repository, consider adding it to Unofficial Add-on Repositories.

Things you will require

  • Any HTTP server. A popular method is to use the svn or git source code servers of googlecode, gitorious and github.
  • A folder containing one or more add-on.
  • A master addons.xml file. This file contains metadata about all available add-ons.
  • A checksum of the above file.
  • A zipped repository add-on for distribution. This allows you to share your repository with others.

You can use addons_xml_generator.py[1] to generate the master xml and the MD5. Put it in the folder with all your add-ons and run it from your Python interpreter. If using a source code server, you can now upload your add-on folder via svn or git to your repository. Every time you update an add-on run the addons_xml_generator.py before uploading the add-ons folder.

Repository Files

Repositories are distributed just like any other add-on. In order for you to browse one in XBMC, you'll need to create an add-on and install it. The repository addon extends the xbmc.addon.repository extension point, so in addition to the general XML structure and icons required for an icon, you'll need an <extension> block specfically pointing to your repository. Use the addon.xml of any of the Unofficial Add-on Repositories as a template. Online repositories should always have zip set to true, both for efficiency of download and for the protection that .zip offers by way of verifying the download (i.e. can we unzip it).

How to make an add-on self-updating without distributing a repository file

This is optional. You still need a repository for this, you just distribute the actual zipped plugin or script, as opposed to the repository file. First you need to have a working repository file. Copy the equivalent of this code from the addon.xml of your repository file: 

  <extension point="xbmc.addon.repository"
              name="Official XBMC.org Add-on Repository">
    <info compressed="true">http://mirrors.xbmc.org/addons/dharma-pre/addons.xml</info>
    <checksum>http://mirrors.xbmc.org/addons/dharma-pre/addons.xml.md5</checksum>
    <datadir zip="true">http://mirrors.xbmc.org/addons/dharma-pre</datadir>
  </extension>

Then simply add it under the other <extension point> entries of your add-on's addon.xml The name= part of this repository extension must never be the same as your add-on.

Retrieved from "https://kodi.wiki/index.php?title=Archive:Create_a_repository_for_add-ons&oldid=25316"