Submitting Add-ons

Submitting a Compliant Add-on to the XBMC.org Repo
After you have read the repository guidelines and made sure your addon is compliant with them, you may begin the submission process using the following steps.

Allowed submissions
We have restricted the allowed submissions of add-ons to past XBMC versions. Several reasons:
 * XBMC code improvements
 * Reduce support load for add-on developers
 * Reduce workload for repository maintainers

Below is a table of on which submissions are allowed to official XBMC.org repository.

The mailing list
We ask that all Add-on authors subscribe to the Add-ons Mailing List. This is done for several reasons.
 * This is where all updates and important information will be announced.
 * This way we can contact you regarding your add-ons if necessary.
 * You can see what other devs are requesting to be added so you know if possibly you need to check compatibility of the add-on you depend on.
 * You may find new and interesting add-ons this way on which you can get inspiration from or may depend on.

After you have subscribed to the Add-ons Mailing List you will be send a conformation e-mail. Be sure to accept this before you can submit to the Mailing List.

All pull requests should be sent to this list so that repository maintainers will be notified that you want to add of update your add-on. They will do a sanity check if all seems ok and you are following the XBMC guidelines for add-ons. If any issues or questions arise they will contact you through the e-mail you registered with. Once all checks out fine your add-on is added to repository and you will receive a confirmation e-mail that it is added.

How to submit your add-on and subsequent updates
In order to submit your addon, you must send a request that we add or update your add-on to the Add-ons Mailing List (We call this a "pull request."). Each request will require a version bump in the addon.xml. We ask that you also keep a changelog.txt up to date so that users may easily see what has changed.

Note that .xbt files will be generated automatically for skins so you do not include this in your pull request.

There are several ways to request that we add or update your add-on. Please preface threads using the following conventions:

After you have send it to the mailing list please keep an eye out for any reply from our repository maintainers if there are any remarks or changes needed or a simple confirmation it has been added. Do note it might take some time to process the request.

After it has been added or updated it will be available from the XBMC.org repository in XBMC itself, on http://addons.xbmc.org/ and on the wiki page http://wiki.xbmc.org/index.php?title=Category:All_add-ons.

Example e-mail
Subject: [Git Pull] my cool plugin Body: *addon -  my.cool.plugin *version - 1.1.0 *url - git://some.where.git *revision - a241345a *branch - master *xbmc version - frodo