Skip to content


Subversion checkout URL

You can clone with
Download ZIP
XBMC Addon Manager
Tree: 4d733d036e

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

XBMC Addon Manager

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>
Something went wrong with that request. Please try again.