Developer Guides


Intro
uRepo is a repository that tries to promote Add-ons in the best way possible, for this reason we recommend adding a few extra bits of metadata and artwork.
Please read the below guides before uploading Add-ons.


Uploading Notes

uRepo is an automated Add-on site where developers can upload their Add-on in the form of a zip file and get instant feedback from our upload validator.
Feedback includes metadata and artwork checks as well as checking for duplicates or updates to specific Add-ons already in our database.
Once an Add-on is uploaded it goes into a moderation queue where a site admin can authorize the Add-on and it can instantly go into our repository.
This is usually done within the hour. We usually trust developers and will not normally request any changes as long as you stay within the rules.
Only the developer who creates the Add-on can upload so make sure your username on uRepo is the same as the developer name in your addon.xml
To start uploading an Add-on just click on the "Upload" button on the site header and select your zip file.

Screenshots

(Essential)
Include screenshots with your Add-on before uploading. From the Krypton release onwards, these will also show inside Kodi's Add-on manager

Plugins = 3 screenshots
Scripts = 3 screnshots (if possible)
Skins = 9 screenshots



As you can see in this script example, we have 3 screenshots of the Add-on running inside Kodi.
Use print screen on the keyboard while kodi is running to save the screen to disk.
Then you will need to resize the images to 1280x720 and rename to "screenshot-01.jpg", "screenshot-02.jpg" and "screenshot-03.jpg" while saving as a JPG (not png).
Finally you will need to place these 3 screenshots in a subfolder of your Add-on called "\resources". So in the above example they are placed in:
\script.hello.world\resources\screenshot-01.jpg
\script.hello.world\resources\screenshot-02.jpg
\script.hello.world\resources\screenshot-03.jpg

Logos

(Optional)
uRepo also allows you to optionally add transparent logo artwork. NOTE: This feature is not available in Kodi yet but we are hopeful it will be added soon.
800x310 Transparent PNG image
\script.hello.world\resources\logo.png
NOTE: If you need some help creating these files, why not ask on our forums?


Banners

(Optional)
uRepo allows you to optionally add banner artwork. NOTE: This feature is not available in Kodi yet but we are hopeful it will be added soon.
1000x185 JPG image
\script.hello.world\resources\banner.jpg
NOTE: If you need some help creating these files, why not ask on our forums?


Artwork Metadata

We also require the latest Addon.xml structures for Kodi.
You will need to reference your artwork like so:
<assets> <icon>icon.png</icon> <fanart>fanart.jpg</fanart> <screenshot>resources/screenshot-01.jpg</screenshot> <screenshot>resources/screenshot-02.jpg</screenshot> <screenshot>resources/screenshot-03.jpg</screenshot> <banner>resources/banner.jpg</banner> <logo>resources/logo.png</logo> </assets>

Metadata

You can also include some of the new Kodi addon tags such as news
NOTE: This is in addition to your historical changelog.txt and should only show the latest bit of news. <news>This can include the latest news for your Add-on such as: Fixed feature 1</news>
Including the Github link to your source is very useful for people who may wish to contribute or test development builds <source>https://github.com/zag2me/script.hello.world</source>
Including a forum link is helpful so users know where to discuss the Add-on <forum>This is typically a link to the Kodi or uRepo forum thread</forum>

Video Demos

You can include a youtube clip in your addon.xml file using the "video" tag.

This video will be embedded on the Add-ons website page
<video>https://www.youtube.com/watch?v=W-w3WfgpcGg</video>

Donations

You can include a donation button link to paypal in your addon.xml. You can create a button ID link for paypal here:
www.paypal.com/buttons/paymentbuttons/donate/create
<donate>ZYFYNBF3WFS94</donate> NOTE: Original link would have been like this (you just need the button ID).
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=ZYFYNBF3WFS94

Summary

Your Addon folder should now look like this. Note: The icon.png and fanart.jpg are in the root so its compatible with previous Kodi versions.


And your addon.xml should look something like this:


That completes the guide for Kodi Add-ons. Our upload tester should alert you to any missing bits.
We always try to aim for all green ticks :)