Skip to content


Subversion checkout URL

You can clone with
Download ZIP
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.