My Movies Wiki

Page History: My Movies XBMC Add-on

Compare Page Revisions

« Older Revision - Back to Page History - Newer Revision »

Page Revision: 2009/08/05 22:41


Using the My Movies API, you can now access the high quality My Movies meta-data from within XBMC using your My Movies account. The service can be accessed either by purchasing an API access ($20 + VAT %25 in EU), by contributing data to our service up to where you have 2500 points on your account, or you can create a 21 day trial for the 2500 points, to evaluate the scraper.

Notice that the "scraper" is a partly commercial option, as you can choose to purchase access or contribute data to access the service. The scraper is created for users who do not want other programs than XBMC itself to maintain the meta-data. You can as an alternative download and install My Movies Server/Client or My Movies for Windows Home Server to freely store My Movies meta-data for XBMC into your movie folders, or you can combine the usage of the scraper and the software.

Notice! Because of changes in XBMC scraping functionality, XBMC build 21882 or later is required. The latest nightly build can be downloaded here. We hope that the My Movies "scraper" will be part of future XBMC builds, but until then, you can download the "scraper" here.

Scraper Definition

The "scraper" is actually not a scraper in the traditional way, as XBMC does not "scrape" a website, but instead access the My Movies API service directly, and received easy to process XML data, which is imported into XBMC's library. Along with the speed and stability of our servers, this process makes the My Movies "scraper" much faster and reliable than any other scraper for XBMC, at the same time as providing you with the best available meta-data.

Account Information

Before you start using the scraper, you must create a My Movies user account here. You now have three different options to enable the API access for your account:

  • Purchase a $20 (+ VAT %25 in EU) API access here. This gives you a not time limited access to the My Movies API. You will be able to download up to 2.500 titles from our service, and at 2.500 titles, our service will temporary hold your account from downloading more titles, to avoid data harvesting. Should you reach the 2.500 title limit, you can contact to lift the limitation and receive access for another 2.500 titles. Unless we find that your account have been used in ways that does not comply with the usage terms of the API, lifting the limit can be done indefinately, making the access unlimited.

  • Gain 2.500 points for your account. Users who have 2.500 points or more on their account will automatically be given access to the API without the need to purchase API access. This means that users who already use our software, and either have purchased points for their account, contributed data to our service or users who would like to purchase points to unlock features in our software can use the 2.500 points to use the service. New users can start to contribute data to reach the 2.500 points. Accounts accessing the service using points will also be limited to loading 2.500 titles from the service at a time, just as the purchased API option.

  • Create a 21 day 2500 point trial here. During the trial period, your account will have access to the My Movies API as if you had 2.500 points, however to avoid data harvesting using trial accounts, during a trial period, your account is limited to loading maximum 250 titles from our service. During the trial period, if you purchase an API access, the 250 title limit will be lifted.

Even if you have purchased API access to our service, your data contributions are much welcomed, to increase the quality of the service for both yourself and others.

Configuring Scraper in XBMC

Copy the "scaper" files (mymoviesdk.xml + mymoviesdk.png) from the downloaded zip file to the "System\Scrapers\Video" folder in your XBMC installation directory.

In XBMC it is then possible to select the My Movies.DK video scraper when setting content for your video sources in file mode.

XBMC Configuration 1. Click for full screen.

You are required to enter your user credentials on the settings page. The user account must have purchased API access or have 2500 points.

XBMC Configuration 2. Click for full screen.

This is enough to use the scraper with it's default settings.

Optional Settings

Enable Fanart: Use this option to enable or disable the addition of fanart/backdrops to your library.

Preferred language: Tex and posters fetched for your movies will be returned in the preferred language if available. If preferred language is not available, text and posters will be fetched in English.

Include adult movies: Adult titles will be included in title searches, and will be added as normal titles.


Below is shown an example folder and file structure for use with the "scraper". It is recommended to have each movie placed in it's own folder:


Optionally, you can place an NFO file containing the IMDB url of the movie. This forces the My Movies scraper to locate this specific movie to get a 100% safe match.

Image Image

For titles that does not have an NFO file, the folder name will be used for searching for the movie.


Having added a source to this structure and scanned for new content we end up with a library showing this:

XBMC Example 1. Click for full screen.

For each movie it's possible to change fanart/backdrop and poster if available:

XBMC Example 2. Click for full screen. XBMC Example 3. Click for full screen.

Final Words

With the My Movies.DK "scraper" you are able to get high quality meta-data and graphics into your XBMC library at a very high speed.

The data retrieved is film data. This is because XBMC currently do not support disc id's (which My Movies do), so we are unable to determine the media type when loading data from the My Movies WebService. This might change some day in XBMC and if it does then the My Movies scraper can easily be extended to support this and then optionally correct DVD, HD-DVD or Blu-ray front and meta-data will be shown in XBMC, rather than movie posters and movie meta-data.

The XBMC skin used for the screenshots in this guide can be found here.