Child pages
  • Setting up Media Items

  Wiki Navigation


 Recently Updated

 Latest Releases

 MediaPortal 1.34
            Releasenews | Download
 MediaPortal 2.5
            Releasenews | Download

Table of Contents


MediaPortal 2 can detect your media items and import them into its own data base. The importer will automatically recognize media items by their file and folder names. It is recommended to prepare media items well to ensure that everything is perfectly recognized.


We strongly recommend to prepare all media items with external tools prior importing to MediaPortal 2 with deactivated online sources.

  • The import process is multiple times faster and reliabble
  • Metadata and fanarts can be easily fixed or modified
  • Metadata and fanarts are organized and kept independently from MediaPortal and could be in parallel used by non-windows based applications as KODI. Additionally the data are not lost in case the MediaPortal 2 data base is removed or corrupted.

Manual correction of imports

If the automatic import was not successful, e.g. because there was more than one hit, you can use the "reimport" function from the media item's context menu. A new search is then triggered and you can then chose from the different options to assign the correct media information afterwords. As this is not part of the preparation  details are decribed later in Media Screen.

Symbolic links allow to gather media from different locations and display them in one place.

If this feature is not working in MP2, it is likely that your Windows system is not adequately configured yet to enable "remote to remote symlinks".  A standard Windows 10 installation defaults to "Not allowed" and you will need to activate this first:

  • Open an administrative command window or use PowerShell (easily accessible by right-clicking on the Windows Start button and selecting "Windows PowerShell (Administrator)"
  • In the newly opened window type  fsutil behavior set SymlinkEvaluation R2R:1 

Then hit enter and your symbolic links should work as expected.


The following is a guide only and charts common usage.

Artwork is skin dependant and skinners are free to use artwork how and where they choose. Some skins may conform with the following, others may not.

Artwork Usage


MovieMovie SetsArtistsAlbumsSeriesSeasonsEpisodes


Posters replicates the movie posters often seen in cinema complexes, or the front cover of home video releases, and contain a clearly visible logo or name of the video.

Image specifications
Typejpg or png
Resolution1000w x 1500h
Aspect Ratio2:3
Transparent backgroundNo


In the video library, banners are wide and short images that contain recognizable characters or props from the video and typically includes a clearly visible logo or the name of the movie, movie set or tv show.

In the music library it contains the artist or band members and typically includes a clearly visible logo or the name of the artist/band

Image specifications
Typejpg or png
Resolution1000w x 185h
Aspect Ratio200:37
Transparent backgroundNo


They are used as full screen displays.

Fanart has no text on the image. (fanart with text is known as landscape. See below)

Image specifications
Typejpg or png
Resolution1920w x 1080h

3840w x 2160h

Aspect Ratio16:9
Transparent backgroundNo

Note: For the Music library, the file names recognised by Kodi and loaded as local fanart can be configured by entries in the advancedsettings.xml


The Actor artwork is a portrait of an actor for display in the cast information pages.

The files are named as <FirstName>_<LastName>.jpg and are saved in the dedicated .actors folder in the movie folder and tv show folder.

Image specifications
Resolution1000w x 1500h
Aspect Ratio2:3
Transparent backgroundNo


Clearart have a transparent background with recognizable characters or props from the video along with a logo or name and its transparent background allows it to be overlaid images or video with minimal impact.

Image specifications
Resolution1000w x 562h
Aspect Ratio16:9
Transparent backgroundYes

Logos typically use the distinctive font associated with the video and is uncluttered by other images. The transparent background allows it to be overlaid images or video with minimal impact.

Image specifications
Resolution800w x 310h
Aspect Ratio80:31
Transparent backgroundYes


Discart replicates the picture on the physical Blu-ray or other disc. Although the disc artwork is round, the image itself is square and the disc image is placed in the center on a transparent background.

Image specifications
Resolution1000w x 1000h
Aspect Ratio1:1
Transparent backgroundYes


Keyart is a poster without text or a logo. This is useful as a separate item in a skinner's toolbox as it can be paired with a clearlogo or large text title elsewhere on the window, and without text it is less distracting in the background or half-obscured, similar to fanart.

Image specifications
Resolution1000w x 1500h
Aspect Ratio2:3
Transparent backgroundNo


Thumb is the most basic art type. The properties differ depending on the area being used. Skins often show this type of art both full size, and also as a small icon alongside each item in a list.

Image specifications
Aspect Ratio
Transparent backgroundNo

NFO Files


1. The file is saved as Unicode Transformation Format-8 (UTF-8). The first line of the file will contain the following...

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 

2. The second line and the last line of the file contains the appropriate opening and closing tags for the class of media. Avaliable classes are...

<movie></movie>, <tvshow></tvshow>, <episodedetails></episodedetails>, <artist></artist>, <album></album> and <musicvideo></musicvideo>

3. Between the opening and closing category tags are the tags for the metadata. Each tag must have an opening tag and a closing tag. eg...

<title>Blade Runner 2049</title>

4. Available tags are listed in the appropriate Metadata NFO page.

5. Once created, the file is named as follows:

Moviesnote{VideoFileName}.nfo or movie.nfo
TV Showstvshow.nfo


NFO (xml) TagRequiredMultipleNotes
<tvshow></tvshow> or <movie> </movie>YesNoThe top level parent tag for the nfo file. All other tags must be contained within these two tags
<title></title>YesNoThe title of the TV Show
<originaltitle></originaltitle>NoNoThe original title, usually in the language of the country of origin.
<sorttitle></sorttitle>NoNoAllows alternate title sort without modifying the TV Show title. Not displayed in any library listing.
   <rating name="" max="10" default="">
NoNodefault="true" default="false"

Only one rating can be set as default="true", additional ratings must be set as default="false" or ommitted

name="identifier". Do not use "default". Examples of identifier include...

<rating name="imdb" max="10"><rating name="trakt" max="10"><rating name="tvmaze" max="10"><rating name="metacritic" max="10"><rating name="tomatometerallcritics" max="10"><rating name="tomatometerallaudience" max="10">

Example of complete entry...

<rating name="themoviedb" max="10" default="true"><rating name="imdb" max="10" default="false"> or <rating name="themoviedb" max="10">

<userrating></userrating>NoNoPersonal rating set by the user
<season></season>NoNoNumber of seasons of this TV Show in the library
<episode></episode>NoNoNumber of episodes of this TV Show in the library
<displayepisode></displayepisode>NoNoNot used
<outline></outline>NoNoNot Used
<plot></plot>NoNoCan contain more information on multiple lines, will be wrapped
<tag></tag>NoYesList of tag words
<runtime></runtime>NoNoNot used
<thumb aspect="" preview=""></thumb>

<thumb aspect="poster" type="season" season="" preview=""></thumb>

NoYesPath to available TV Show Posters. Not needed when using local artwork

Example use of aspect=""

<thumb aspect="banner"<thumb aspect="clearart"<thumb aspect="clearlogo"<thumb aspect="landscape"<thumb aspect="poster"

type="season" used for season specific artwork
season="2" nominates season number eg. season 2

    <thumb preview=""></thumb>
NoYesPath to available TV Show fanart.

Multiple <thumb> entries allowed between the <fanart></fanart> tags

<mpaa></mpaa>NoNoCountry specific mpaa rating system. Check with skin author which prefix is required to diplay your country local rating system
<playcount></playcount>NoNoNumber of times TV show has been played. Will only ever show 0 or 1. Episodes track playcounts
<lastplayed></lastplayed>NoNoDate TV Show was last played
  <url cache=""></url>

When using TVDB scraper, Kodi will only read the URL created by the TVDB v2 API
When a URL is used, the corresponding scraper must be set.

<id></id>NoNoThe default ID.

Do not use as this is a Kodi generated tag. See next item.

<uniqueid type="" default=""></uniqueid>YesYesThe ID from the scraper site.

type="" Identifier of the ID. Do not use "default". Examples of identifier include...

<uniqueid type="imdb"<uniqueid type="tvdb"<uniqueid type="tmdb"For non-scraped items, use simple values like "home", "sport", "doco" etcThe value can be alpha-numeric eg tt3480556 for imdb, 286668 for tmdb, home001 for home movies, etc

default="true" default="false"

Only one uniqueID can be set as default="true", additional uniqueID's must be set as default="false" or ommit the default attribute

Example of complete entry...

<uniqueid type="tmdb" default="true"><uniqueid type="imdb" default="false"> or <uniqueid type="imdb">

<premiered></premiered>NoNoRelease date of TV Show. Comes from Aired Date of the first episode.

Format as 2019-01-31

<year></year>NoNoRelease Year.

Do not use. Use <premiered> instead

<status></status>NoNoContinuing or Ended show

NoNoNot used
<aired></aired>NoNoNot used
<studio></studio>NoYesProduction studio
<trailer></trailer>NoNoLocal or online path to TV Show trailer
NoYesThe <order> tag determines where in the list the actor will appear. 0 = first in the list

Supports "clear" attribute

<namedseason number=""></namedseason>NoYesAllows naming of Seasons- eg Game of Thrones named seasons

number="" = Season number to be renamed

NoNoNot used for TV Show
<dateadded></dateadded>NoNomTime of the playable video file. Can be altered in advancedsettings.xml



This page has no comments.