Skip to content
XBMC Addon Manager
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

XBMC Addon Manager

Build Status

A CLI utility for searching and listing XBMC Addon Repositories.


  • List addons available in remote repositories.
  • List addons which require another addon as a dependency.
  • Download the current version of an addon locally.
  • Display the addon.xml for a remote addon.
  • Search all addon.xml files in a repository for a given string.
  • Supports the official XBMC respositories as well as 3rd party repos.


$ pip install xam

Example Usage

List addon ids and versions for the Eden repo

$ xam all
* Updating addons.xml from remote... 1.0.9 1.0.7 2.0.1
webinterface.wtouch 0.4

List addon id and version for every addon in bluecop's repo.

$ xam --repo all
* Downloading to /Users/jbeluch/.xam_cache/aHR0cDovL2JsdWVjb3AteGJtYy1yZXBvLmdvb2dsZWNvZGUuY29tL2ZpbGVzL3JlcG9zaXRvcnkuYmx1ZWNvcC54Ym1jLXBsdWdpbnMuemlw
* Warning: Repositories which do not zip addons are unsupported at this time. The download functionality might not work properly.
* Updating addons.xml from remote... 0.4.6 0.1.0 0.9.9 0.3.0 3.4.5 0.0.3 0.0.3 0.7.0 0.0.3
repository.bluecop.xbmc-plugins 1.0.1
script.hululibraryautoupdate 1.1.2
script.module.cryptopy 1.2.6
script.module.demjson 1.4
script.module.mechanize 0.2.5
script.module.pycrypto 2.5

Get the current version for the youtube plugin in the Dharma repo

$ xam --repo dharma all | grep 2.1.4

List all addons that require xbmcswift

$ xam depends script.module.xbmcswift
* Local addons.xml is up to date... 1.0 0.1.4 1.2.1 1.4.2 1.0.6 0.9.0 1.0.2 1.1.3 2.1.1 1.0.1 1.0.0

Search for any facebook related addons

$ xam search facebook
* Local addons.xml is up to date...
script.web.viewer:1: Web viewer also allows addon developers to process application authorization (ie. facebook,flickr etc.) with little programming and without violating terms of use. <addon id="" name="Facebook Media" provider-name="Rick Phillips (ruuk)" version="0.6.4">     <summary lang="en">Browse Facebook photos and videos</summary>

Download a local copy of the youtube plugin

$ xam get
* Local addons.xml is up to date...
* Downloading to
* Downloading to
* Downloading to
* Downloading to
$ ls

Show the addon.xml for the academic earth plugin

$ xam info
* Updating addons.xml from remote...
Academic Earth ( 1.2.1)

<addon id="" name="Academic Earth" provider-name="Jonathan Beluch (jbel)" version="1.2.1">
    <import addon="xbmc.python" version="2.0" />
    <import addon="script.module.beautifulsoup" version="3.0.8" />
    <import addon="script.module.xbmcswift" version="0.2.0" />
    <import addon="" version="2.9.1" />
  <extension library="" point="xbmc.python.pluginsource">
  <extension point="xbmc.addon.metadata">
    <summary>Watch lectures from Academic Earth (</summary>
    <description>Browse online courses and lectures from the world's top scholars.</description>

Release a new version of your addon

(xbmc-vimcasts)jon@lenovo ~/Code/xbmc-vimcasts (master) $ xam release

  oooo    ooo  .oooo.   ooo. .oo.  .oo.
   `88b..8P'  `P  )88b  `888P"Y88bP"Y88b
     Y888'     .oP"888   888   888   888
   .o8"'88b   d8(  888   888   888   888
  o88'   888o `Y888""8o o888o o888o o888o


  I'm going to help you create a new release for VimCasts.

.. Init ..

Please answer the following:
[?] I see you are using git. Is master the branch you want to use for the release? (Y/n) 
[?] This release will be for XBMC EDEN. Is this correct? (Y/n) 

.. Release Metadata for ..

[?] The current version is 1.1. What should the new version be? [1.2] 1.1
Writing new version to addon.xml...OK
[?] I see your addon has a few dependencies. Would you like to check for new versions? (Y/n) 
Starting new HTTP connection (1):
Dependency script.module.xbmcswift2 is already at the newest version.
[?] I see you have a changelog.txt. Would you like to update it now? (Y/n) n
[?] I'm ready to commit the changes and tag the release. Should we continue? (Y/n) y

.. Release 1.1..

Adding local changes to staging...OK
[master d5e32ee] [xam-release-script] creating release for version 1.1
 1 file changed, 6 insertions(+), 7 deletions(-)
Creating commit...OK
Tagging release...OK
Counting objects: 5, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 385 bytes, done.
Total 3 (delta 2), reused 0 (delta 0)
   63e631c..d5e32ee  HEAD -> master
Counting objects: 1, done.
Writing objects: 100% (1/1), 164 bytes, done.
Total 1 (delta 0), reused 0 (delta 0)
 * [new tag]         1.1 -> 1.1
Pushing commit and tags to remote...OK

Congrats. Release was successful.

| Mailing List Email |

Subject: [git pull]

*addon -
*version - 1.1
*url - git://
*tag - 1.1
*xbmc version - eden
Something went wrong with that request. Please try again.