Official Kodi Wiki - User contributions [en]

Add-on:VideoExtras

2015-01-10T19:32:47Z

Rich.T.: /* Location of XML */

{{Addon
|Name=VideoExtras
|provider-name=robwebset
|ID=script.videoextras
|latest-version=1.2.1
|extension point=xbmc.python.script
|provides=
|Summary=Add Video Extras to your Movies and TV shows.
|Description=Provides a way to add Video Extras to your Video library. Look at the wiki for setup instructions.
|Platform=all
|Language=
|License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991
|Forum=http://forum.kodi.tv/showthread.php?tid=214289
|Website=
|Source=http://robwebset.googlecode.com/svn/trunk/script.videoextras/
|Email=
|broken=
|icon url=http://mirrors.kodi.tv/addons/gotham/script.videoextras/icon.png}}


 
== Introduction ==
VideoExtras is an addon to allow you to store, list and play the "extras" for a given Movie or TV Series. (i.e. The extras that often come on DVD's or Blu-Rays)

 
== Forum and Issue Report Pages ==
If you have any questions, found an issue to report or would just like to know a little more you can take part in the forum discussions at:

:[http://forum.kodi.tv/showthread.php?tid=214289 VideoExtras Forum]

 
== Quickstart Guide ==
This Quickstart guide is aimed at first time users of VideoExtras, who also have some freedom to re-arrange their video content to fit best with VideoExtras.
==== Install VideoExtras ====
VideoExtras is in the official repo, so you should be able to install it like any other addon.
==== Arranging Your Video Files ====
Although VideoExtras will support most structures (with various configuration changes), the easiest and best structure is as follows:

:''../<Movie Name>/movie-name.avi''
:''../<Movie Name>/Extras/extras-name-1.avi''
:''../<Movie Name>/Extras/extras-name-2.avi''
:''...''
More details of extras setup can be found in the [[Add-on:VideoExtras#File_Naming_Convention|File Naming Convention Section]]
==== Stopping The Extras Being Scanned Into Your Library ====
Now that you have copied your Extras files into the correct directories, you do not want them to be accidently picked up/scanned as a Movie or TV Series in their own right. To stop this you need to add "excludes" into the advancedsettings.xml file. This can be done for you by click on the [[Add-on:VideoExtras#Extras|"Update advancedsettings.xml File"]] operation on the first tab of the VideoExtras settings, or you could always do it yourself [[Add-on:VideoExtras#XBMC_File_Exclusions|manually]].
==== Scanning Media Into Your Library ====
Once you have updated the advancedsettings.xml file it should now be safe to perform any scans you wish to pull media into your library. At this point, the scanner should skip over any Extras files.
==== Viewing Your Extras ====
In order to view the Extras you have now stored with your Movies or TV Shows you will need one of the following 2 things:
* To update the default Confluence Skin, this can either be done [[Add-on:VideoExtras#Skin_Modifications|manually]] or by navigating to the Advanced tab of the VideoExtras settings and clicking on [[Add-on:VideoExtras#Advanced|"Update Confluence Skin"]].
* Use one of the non default [[Add-on:VideoExtras#Skins_With_Build_In_Support|skins that has built in support]] for VideoExtras
==== You Are Now Up And Running ====
That's it! You should now be able to navigate to your extras by either going to the Video Information Dialog for the given video, or by going via: ''[[Add-on:VideoExtras#Video_Extras_Browser|Videos -> Addons -> VideoExtras]]''
 
There are plenty more things you can do to improve your user experience such as adding [[Add-on:VideoExtras#Images:_Thumbnails.2C_Icons_and_Fanart|icons/fanart/thumbnails]] or giving detailed [[Add-on:VideoExtras#NFO_Files|titles or plots]]. However, this is a quickstart guide, and you should take a look at the rest of the wiki for those features.
 
 
== Using VideoExtras ==
Now that you have [[Add-on:VideoExtras#Quickstart_Guide|configured]] VideoExtras, you can start using it. If you are using Confluence with the supplied [[Add-on:VideoExtras#Viewing_Your_Extras|Confluence update]] then any Movies or TV Shows that have extras will be highlighted with an overlay image:
<center> [[File:VideoExtras-ThumbnailOverlay.JPG|200px]]</center>
 Then if you navigate into the Video Information Screen you should see an Extras button available:
<center> [[File:VideoExtras-VideoInfoDialog.JPG|400px]]</center>
 Selecting this button will then result in seeing the list of extras available:
<center> [[File:VideoExtras-DetailedListScreen.JPG|400px]]</center>
 
 
== Video Extras Browser ==
The VideoExtras browser allows you to view all the Movies/Tv Shows/Music Videos that have extras, and then watch those extras. You can load the extras browser in the following ways:
# Via the [[Add-on:VideoExtras#Database|VideoExtras Settings screen]] "Database" -> "Browse Extras"
# From the Programs Menu -> VideoExtras
# Videos -> Addons -> VideoExtras
 
 
== Settings ==
This section details all the settings options for VideoExtras
==== Extras ====
{| border="0"
|- valign=top
|
:'''Extras Directory Name'''
::The name of the sub directory that stores all the extras files
:'''Search Nested Directories'''
::If directories below the selected TV Show or Movie should be searched for more extras. This is useful if you select a given TV Show and have all your seasons for that show in separate directories under that show. This means that all extras will be displayed when viewed via the root TV Show, and only the seasons extras if selected from inside a given season.
:'''Enable Extras with File Tag'''
::Finds extras based on a "tag", listing anything containing that tag
:'''Extras File Name Tag'''
::If "Enable Extras with File Tag" was enabled, this gives the name to search for as the tag
:'''Use Detailed List Screen'''
::Displays a more advanced listing screen which displays resume points and a watched flag
:'''Window to show after exiting detailed list'''
::(If detailed list screen is enabled) - Which screen to go to after exiting the detailed list screen, options are: "Video Selection", "Information", "Home"
:'''Menu to show after playing an extra'''
::(If detailed list screen is disabled) - Which screen to go to after playing an extra, options are: "Extras", "Video Selection", "Information", "Home"
:'''''Operations'''''
::
:'''Update advancedsettings.xml File'''
::Will update (or create if it does not already exist) the advancedsettings.xml file so that your extras files are not accidently read into the library and incorrectly detected as actual Movies or TV Shows
| [[File:VideoExtras-Settings1.JPG|400px]]
|}
==== File System ====
{| border="0"
|- valign=top
|
:'''Use Custom Extras Location'''
::If extras are not stored with the Movies/TV Shows, this allows them to be stored in a different directory structure.
:'''Path'''
::The path that the extras are located in (Only if ''"Use Custom Extras Location"'' is enabled)
:'''Custom Movies Sub-Folder'''
::The name of the folder under the ''"Path"'' where Movie extras are stored (Note: a directory with the movie name will be located under this directory containing the extras for that movie)
:'''Custom TV Shows Sub-Folder'''
::The name of the folder under the ''"Path"'' where TV Shows extras are stored (Note: a directory with the TV Show name will be located under this directory containing the extras for that TV Show)
:'''Custom Music Video Sub-Folder'''
::The name of the folder under the ''"Path"'' where Music Video extras are stored (Note: a directory with the Music Video name will be located under this directory containing the extras for that Music Video)
:'''''Debugging'''''
::
:'''Enable Debug logging'''
::Enables VideoExtras debug logging into the Kodi log file
| [[File:VideoExtras-Settings2.JPG|400px]]
|}
==== Database ====
{| border="0"
|- valign=top
|
:'''Enable Database Support'''
::Enables the use of the Extras stand-alone database, this enables the display and storing of data such as
:::* Which extras have been viewed already
:::* Resume playing an extra from the last stop point
:'''''Operations'''''
::
:'''Clean Database'''
::Clears the extras database (resets all play states for the extras) - Note: This does not do anything to the default Kodi database.
:'''Browse Extras'''
::Loads the Video Extras Browser plugin.
| [[File:VideoExtras-Settings3.JPG|400px]]
|}
==== Advanced ====
{| border="0"
|- valign=top
|
:'''Force Extras Button Display'''
::Will always display the "Extras" button on the Video Information screen (Normal behaviour is to only show the button if there are extra's detected for the given video.
:'''Exclude Files Regular Expression'''
::Regular expression for files that will be deemed "Not to be extras" even if there are present in the Extras directory.
:'''Allow caching of extras on startup'''
::Used to cache the video extras available so that it can be used for icon overlays in some skins, if you do not wish to see icon overlays (or do not use a skin that supports them) then disable this option.
:'''Use Custom Images'''
::Allows you to change the images used in the skin to highlight if extras exist (Note: Changing these values will only be visable after a restart of Kodi)
:'''- Overlay Image'''
::(If Use Custom Images is enabled) The image that is drawn over the top of the thumbnail/cover
:'''- List Image'''
::(If Use Custom Images is enabled) The image that is used when adding to a list
:'''''Operations'''''
::
:'''Update Confluence Skin'''
::Will add VideoExtras support to the default confluence skin
| [[File:VideoExtras-Settings4.JPG|400px]]
|}
 
 
== File Naming Convention ==
For your video extras files to be found they must follow a specific naming convention. VideoExtras currently supports extras videos from Movies, TV Shows and Music Videos. Here are the supported conventions:
 
=== Extras Folder ===
''(Recommended Method)''
 
If you put all of your movies in their own folder you can simply add an "Extras" sub folder and add all of your bonus content in that directory. (The name of this folder can be changed via the settings menu). The script will simply display the filename (without extension) in the UI. By default the list of videos will appear in alphabetical order.
 
=== Same Directory ===

If for some reason you don't want to create an "Extras" folder or you want to associate a bonus feature with a specific TV show episode there is an alternative naming convention. Simply use the same name as the file you want to associate the extra feature with and then append "-extras-". (This tag can be changed via the settings menu)
 
=== Remote Location ===

If you did not want your extras stored in the same directory structure as your Movies, TV Shows or Music Videos, then there is a settings option "Use Custom Extras Location" that can be set to point to a different location. The format of this location should have 3 directories at the top level: "Movies", "TvShows" and "MusicVideos". Under each of these should be directories (That match the name of the directories containing the Movies,TV Shows and Music Videos) containing the extras files.
 
e.g.

:Movies/Die Hard
:TvShows/Blake's 7
:TvShows/Blake's 7/Series 1
:TvShows/Blake's 7/Series 2

In this case, when clicking on the "TV Information" for the whole Blake's 7 Series you would see all files in "TvShows/Blake's 7" and the two sub-folders (if nested search is enabled), if viewing Episode Information for an episode in series 1 of Blake's 7 then you would only see the extras in "Blake's 7/Series 1"
 
 
With this method (based on where this root directory is), there may not be a need to add the "File Exclusions" section into [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings].
 
 

== XBMC File Exclusions ==

Since these are video files sprinkled in among all of your other video files we need to tell the xbmc scanner to ignore these files. If we don't then the scanner will try and match them up with one of the online sites and you probably won't be happy with the results. To do this we just need to add some new regular expressions to the [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings]. It is recommended to add these settings and reboot xbmc for them to take effect BEFORE any library scan takes place, so the scanner doesn't try to parse them.

<source lang="xml">
<advancedsettings>
<video>
<excludefromscan action="append">
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>/extras/</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludefromscan>
<excludetvshowsfromscan action="append">
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>/extras/</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludetvshowsfromscan>
</video>
</advancedsettings>
</source>

''In this example the default name "Extras" has been used for the directory containing the extras, if you have changed this in the settings, then this name should also be changed to match.''

Obs.:

1) If you executed a library scan before the regexps have been put in place and found extra material accidentally scanned to your library, you can either remove/rename the extra material and conduct a 'clean library' under XBMC video settings or, delete the video sources and rescan them again after the regexps are operating properly.

2) Beware that if any of your sources contains the word 'extras' in it, e.g. a source named 'Extrasy' or 'Extrascent', nothing new that you put in it will be scanned to the library. This is because that source matches the exclude rule RegExp:'Extras'. To solve this either rename your source or change the default name 'extras', which VideoExtras operates with, to anything different.
 
 

== Images: Thumbnails, Icons and Fanart ==
=== Custom Artwork ===
In order to have thumbnails or custom fanart images displayed on your Extras listings (and player overlay) you can either reference them via an NFO file (see NFO section), or by having the image in the same directory as the extras file. Images referenced via NFO (locally or remotely) will have priority over any other. Thumbnail/icon images in the same directory as extras will be picked up in the following order:

* <filename>.tbn/png/jpg
* <filename>-poster.tbn/png/jpg
* <filename>-thumb.tbn/png/jpg
* poster.tbn/png/jpg (assigns same thumb to all those extras without one)
* folder.tbn/png/jpg (assings same thumb to all those extras without one)

For fanart, the images are picked up in the following order :
* <filename>-fanart.tbn/png/jpg
* fanart.tbn/png/jpg

obs: should you experience image caching persistency of old <filename>-poster/thumb.ext after replacing them by new ones at folder level, this is due to the way XBMC handles the caching of certain images. If you need an immediate solution and don't want to wait for XBMC to cache the new images, there is a script available that solves this issue at database level [http://Just%20to%20help%20with%20the%20cleansing%20of%20thumbs%20cached%20in%20XBMC%20to%20allow%20VideoExtras%20to%20display%20updated%20thumbs%20for%20your%20extras here] called Texture Cache Maintenance utility by MilhouseVH. There aren't cases reported of image caching persistency when using the naming convention <filename>.tbn/png/jpg

=== Default Artwork ===
* '''If no custom fanart:''' fanart is automatically inherited from the parent video file, if there's any.
* '''If no custom thumb (poster):''' default thumb is VideoExtras image icon and will only be displayed in the video overlay whilst playing the extra and not in the extras list.
 
 

== NFO Files ==

The recommended method to give a name or sort order to your "Extras" is to add an NFO for each extra file. This follows the standard XBMC method of having the same name as the file with the extension being replaced with ".nfo" (Sitting in the same directory as the original file). This nfo can take any of the followoing formats (These are in line with the default XBMC behaviour), additional data in these files will be ignored as it is not relevant for the extras file. (Note: The only mandatory element is the "title")

=== Movie NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<movie>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<plot>Something happens</plot>
<thumb>thumbnail.jpg</thumb>
<fanart>background.jpg</fanart>
</movie>
</source>

=== TV Show NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<tvshow>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<plot>Something happens</plot>
<thumb>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</thumb>
<fanart>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</fanart>
</tvshow>
</source>

=== TV Episode NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<episodedetails>
<title>Who knows</title>
<season>2</season>
<episode>1</episode>
<plot>Something happens</plot>
<thumb>C:\MyThumbs\Who.Knows.tbn</thumb>
<fanart>C:\MyFanart\myart.png</fanart>
</episodedetails>
</source>

=== Legacy Naming Format ===
The following are the legacy naming formats, they are supported in the short term only to allow easy migration from DVDExtras to VideoExtras. (If an NFO file is specified, the settings in that file will be used)
 
 
By default the list of videos will appear in alphabetical order. If you would like to specify a custom order just start the filename with brackets containing the text to sort on. For example you could create files "[0]Deleted Scenes.mkv", "[1]Bloopers.mkv", and "[2]Behind The Scenes.mkv". In this case instead of sorting on the name it will sort on the numbers. The bracket portion of the filename will not be displayed in the UI.
 
 
For extras tagged on a per file basis (rather and all in a sub-directory) the name will be taken from anything after the extras tag. So append "-extras-Display name here" will result in the name "Display name here". To customize the order here you can use the same format as the extras folder. Example: "s01e01-extras-[99]Extended Pilot.mkv"
 
 
== "videoextras.nfo" Files ==

If you do not have your video extras files stored in a standard location (as already described in the previous sections) then it is possible to create a file with the name "videoextras.nfo" in the same directory as your Movie or TV Show. This file must be of the following format:

<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<videoextras>
<file>..\..\Extras\Extras01.mkv</file>
<directory>C:\Kodi\Sample-Data\Movies\Extras</directory>
</videoextras>
</source>

You can have multiple "file" or "directory" entries in the "videoextras.nfo" file (or none of one type). The "file" will result in just the given file being listed in the extras. The "directory" will result in the entire contents of the directory being listed.
=== Common extras content for Movie Sets ===
The videoextras.nfo's capabilities are useful to assign common extras content to movies within a set (collection), thus we would have only one physical copy of the 'Extras' folder somewhere whilst each videoextras.nfo is pointing at it.
 
 
== Skin Information ==
=== Skins With Build In Support ===
The following skins (except Confluence, since it requires the hooks) have built-in support for Video Extras , so require no user skin modifications:

{| class="wikitable"
|-
! Skin !! Hook Support !! Detailed Screen Support !! Detailed Screen Skin Location !! Hooks Location
|-
| [[Add-on:Confluence|Confluence]] || <center>No</center>|| <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/xbmc/xbmc/blob/master/addons/skin.confluence/720p/DialogVideoInfo.xml DialogVideoInfo.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=145080 Confluence Modified] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=139712 Immersive] || <center>Yes</center> || <center>Yes</center> || <center>Immersive</center> || <center>[https://github.com/Sranshaft/skin.immersive/blob/master/720p/DialogVideoInfo.xml DialogVideoInfo.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=165481 Xperience1080++] || <center>Yes</center> || <center>Yes</center> || <center>Xperience1080++</center> || <center></center>
|-
| [[Add-on:Aeon_MQ_5|Aeon MQ 5]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center></center>
|-
| [[Add-on:Aeon_Nox|Aeon Nox 5]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/BigNoid/Aeon-Nox/blob/master/1080i/custom_1119_ExtrasDialog.xml custom_1119_ExtrasDialog.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=185290 Aeon Nox 4.1.9.x] || <center>Yes</center> || <center>Yes</center> || <center>Aeon Nox 4.1.9.x</center> || <center></center>
|-
| [[Add-on:Rapier|Rapier]] || <center>Yes</center> || <center>Yes</center> || <center>Rapier</center> || <center></center>
|-
| [http://forum.xbmc.org/showthread.php?tid=170954 Artic mk. ii] || <center>Yes</center> || <center>Yes</center> || <center>Artic</center> || <center></center>
|-
| [[Add-on:Metropolis| Metropolis]] ([http://forum.xbmc.org/showthread.php?tid=99317&pid=1726112#pid1726112 coming soon!]) || <center></center> || <center></center> || <center></center> || <center></center>
|-
| [[Add-on:XTV-SAF| xTV-SAF]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center></center>
|-
| [[Add-on:Transparency!|Transparency!]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/ronie/skin.transparency/blob/master/720p/custom_DialogExtras.xml custom_DialogExtras.xml]</center>
|}
 
If your skin does not support the "Detailed List Screen", then you can either:
# Switch the "Detailed List Screen" off - reverting to the basic list dialog
# Convert the Window XML file in the addon and post a link to it in the forum.
# Use the default "Detailed List Screen" (May not fit in visually with the skin you are using)

Obs: due to a natural delay between the dates of release of possible latest features (and fixed issues too) and actual implementation of these updates in the supported skins, such as support for Music Videos, these skins may still require some manual changes as per [[Add-on:VideoExtras#Skin_Modifications|item 10.2]] in certain skins with built-in support.
 
 

=== Confluence Skin Support ===
A request has been made to the XBMC official repo to have VideoExtras included in the Confluence skin:
https://github.com/xbmc/xbmc/pull/4827
Unfortunately this did not get approved to go into the official repository.
 
 
Instead of this, there is an option that will update the Confluence skin for you in the settings. Just navigate to the [[Add-on:VideoExtras#Advanced|"Update Confluence Skin"]] operation in the VideoExtras settings.
 
 
Note: For this update to work, the directory containing the Confluence skin must have write permissions set. 
As Confluence is the default skin, it's directory is not user modifiable on non-Windows systems. 
To get around this, it is recommended to copy the Confluence skin's directory from it's existing location 
to the standard location for user installed add-ons: 
On Ubuntu Linux, the operation would be to copy the directory "/usr/share/kodi/addons/skin.confluence/" 
to "/home/<username>/.kodi/addons/". 
Upon restarting Kodi, you should now be able to use the "Update Confluence Skin" feature. 
 

=== Skin Modifications ===
A skin modification is required in order to see the extras button in the UI and enjoy all the features. This is a fairly simple process but will depend on your selected skin. The file that needs modified is DialogVideoInfo.xml. This is the code needed for the default confluence skin.

Add to the top of the file (after <window>):
<source lang="xml">
<onload condition="System.HasAddon(script.videoextras)">
XBMC.RunScript(script.videoextras,check,"$INFO[ListItem.FilenameAndPath]")</onload>
</source>

Add to near the foot of the file after the last control statement:

<source lang="xml">
<control type="button" id="105">
<description>Extras</description>
<include>ButtonInfoDialogsCommonValues</include>
<label>Extras</label>
<onclick>XBMC.RunScript(script.videoextras,display,"$INFO[ListItem.FilenameAndPath]")</onclick>
<visible>System.HasAddon(script.videoextras)
+ [Container.Content(movies) | Container.Content(episodes) | Container.Content(TVShows)
| Container.Content(musicvideos)]
+ IsEmpty(Window(movieinformation).Property("HideVideoExtrasButton"))</visible>
</control>
</source>
You should be able to use something similar for other skins.

==== Location of XML ====
The DialogVideoInfo.xml's location listed by skin:
;Confluence
* '''Ubuntu Linux:''' /home/<username>/.kodi/addons/skin.confluence/720p/
* '''Ubuntu Linux (alternative):''': /usr/share/kodi/addons/skin.confluence/720p/
* '''OS X:''' /Applications/XBMC.app/Contents/Resources/XBMC/addons/skin.confluence/720p
* '''Windows 7/8.1:''' Program Files (x86)\XBMC\addons\skin.confluence\720p
;Aeon Nox 4
* '''Ubuntu Linux:''' /home/<username>/.kodi/addons/skin.aeon.nox/1080i/
* '''Windows 7/8.1:''' Program Files (x86)\XBMC\addons\skin.aeon.nox\1080i\

Obs.: Remember to create a backup of any file before altering it i.e. DialogVideoInfo.xml.old.

=== Icon Overlay on Video List Screen (Advanced Skinners Only) ===
If you are a skinner and wish to add support for some form of indication that a Movie/TV Show has extras, there is a way, it is not perfect but should get the overlays working. The first part is that you need to have "Allow caching of extras on startup" enabled in the VideoExtras settings. You then need the following in your skin:

<source lang="xml">
<control type="image">
<posx>950</posx>
<posy>14</posy>
<width>16</width>
<height>16</height>
<texture fallback="blank.png">$INFO[ListItem.DBID,special://profile/addon_data/script.videoextras/movies/,.png]</texture>
<visible>System.HasAddon(script.videoextras) + Window.IsVisible(Videos) + Container.Content(Movies)</visible>
</control>
</source>

This example would possibly be added to the confluence skin at line 554 to add an icon to movies on the "biglist" screen. There are 3 different values that can be used:

{| class="wikitable"
|-
| movies || Container.Content(Movies)
|-
| tvshows|| Container.Content(TVShows)
|-
| musicvideos|| Container.Content(MusicVideos)
|}

Where the first column supplies the value used in the <texture> element, and the second for the <visible> element.
 
 
There is a default image that is used to represent the existance of Video Extras, but this can be overridden by the skin by putting a file called "videoextras_overlay.png" in the skins "media" directory, or by updating the [[Add-on:VideoExtras#Advanced|VideoExtras settings]].
 
 
IMPORTANT: This is for advanced skinners only, please only post on the forum if you '''own the skin you are trying to update''' - this is because it will require lots of changes to patch an existing skin, and this feature is only intended to support skins that will support VideoExtras "Out Of The Box".
 
 

=== Request To Skinners (Detailed List Screen) ===
VideoExtras uses a custom window to show the extras, I have written the Window XML files for Confluence. With the large array of different skins available it is not possible to write versions for every skin. If you would be willing to support Video Extras I would really like to include a skin specific Window XML file for your skin and would be greatful for any contribution.
 
The files are very small, so hopefully will not take long to convert for your skin.
 
 

== Known Issues ==
=== Cast List In Summary Screen Not Populated ===
There is a known issue that when you return from the detailed list screen that shows the extras back to the summary screen, the Cast section is not populated, the following was posted for this, but there is no solution:
http://forum.kodi.tv/showthread.php?tid=173502
 
 

== Debugging ==
If reporting a problem, please also provide a debug log. To do this you need to enable BOTH:
* XBMC [[Settings/System#Debugging|logging]] from the main setting menu
* VideoExtras debug from the VideoExtras addon settings menu
Please do not paste the log into the forum thread, just link to it.
 
 
== Donations ==
If you have found VideoExtras useful and would like to help support future development and bug fixes, then please feel free to make a small donation. Any donations made will be put towards hardware to enable support and development on different platforms (I can currently only test Windows - however I would like to be able to verify changes on Android and Mac - and this is what donations would go towards)
 
 
Please use the link on the top of the [http://forum.xbmc.org/showthread.php?tid=178717 VideoExtras Forum]
 
 
''Note:'' Donations will not make any difference to the level of support I will give people on the forum - this project is Open Source - and is completely free!!
 
 

[[Category:Frodo add-on repository]]
[[Category:Gotham add-on repository]]
[[Category:Helix add-on repository]]

Add-on:VideoExtras

2015-01-10T19:10:49Z

Rich.T.: /* Confluence Skin Support */

{{Addon
|Name=VideoExtras
|provider-name=robwebset
|ID=script.videoextras
|latest-version=1.2.1
|extension point=xbmc.python.script
|provides=
|Summary=Add Video Extras to your Movies and TV shows.
|Description=Provides a way to add Video Extras to your Video library. Look at the wiki for setup instructions.
|Platform=all
|Language=
|License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991
|Forum=http://forum.kodi.tv/showthread.php?tid=214289
|Website=
|Source=http://robwebset.googlecode.com/svn/trunk/script.videoextras/
|Email=
|broken=
|icon url=http://mirrors.kodi.tv/addons/gotham/script.videoextras/icon.png}}


 
== Introduction ==
VideoExtras is an addon to allow you to store, list and play the "extras" for a given Movie or TV Series. (i.e. The extras that often come on DVD's or Blu-Rays)

 
== Forum and Issue Report Pages ==
If you have any questions, found an issue to report or would just like to know a little more you can take part in the forum discussions at:

:[http://forum.kodi.tv/showthread.php?tid=214289 VideoExtras Forum]

 
== Quickstart Guide ==
This Quickstart guide is aimed at first time users of VideoExtras, who also have some freedom to re-arrange their video content to fit best with VideoExtras.
==== Install VideoExtras ====
VideoExtras is in the official repo, so you should be able to install it like any other addon.
==== Arranging Your Video Files ====
Although VideoExtras will support most structures (with various configuration changes), the easiest and best structure is as follows:

:''../<Movie Name>/movie-name.avi''
:''../<Movie Name>/Extras/extras-name-1.avi''
:''../<Movie Name>/Extras/extras-name-2.avi''
:''...''
More details of extras setup can be found in the [[Add-on:VideoExtras#File_Naming_Convention|File Naming Convention Section]]
==== Stopping The Extras Being Scanned Into Your Library ====
Now that you have copied your Extras files into the correct directories, you do not want them to be accidently picked up/scanned as a Movie or TV Series in their own right. To stop this you need to add "excludes" into the advancedsettings.xml file. This can be done for you by click on the [[Add-on:VideoExtras#Extras|"Update advancedsettings.xml File"]] operation on the first tab of the VideoExtras settings, or you could always do it yourself [[Add-on:VideoExtras#XBMC_File_Exclusions|manually]].
==== Scanning Media Into Your Library ====
Once you have updated the advancedsettings.xml file it should now be safe to perform any scans you wish to pull media into your library. At this point, the scanner should skip over any Extras files.
==== Viewing Your Extras ====
In order to view the Extras you have now stored with your Movies or TV Shows you will need one of the following 2 things:
* To update the default Confluence Skin, this can either be done [[Add-on:VideoExtras#Skin_Modifications|manually]] or by navigating to the Advanced tab of the VideoExtras settings and clicking on [[Add-on:VideoExtras#Advanced|"Update Confluence Skin"]].
* Use one of the non default [[Add-on:VideoExtras#Skins_With_Build_In_Support|skins that has built in support]] for VideoExtras
==== You Are Now Up And Running ====
That's it! You should now be able to navigate to your extras by either going to the Video Information Dialog for the given video, or by going via: ''[[Add-on:VideoExtras#Video_Extras_Browser|Videos -> Addons -> VideoExtras]]''
 
There are plenty more things you can do to improve your user experience such as adding [[Add-on:VideoExtras#Images:_Thumbnails.2C_Icons_and_Fanart|icons/fanart/thumbnails]] or giving detailed [[Add-on:VideoExtras#NFO_Files|titles or plots]]. However, this is a quickstart guide, and you should take a look at the rest of the wiki for those features.
 
 
== Using VideoExtras ==
Now that you have [[Add-on:VideoExtras#Quickstart_Guide|configured]] VideoExtras, you can start using it. If you are using Confluence with the supplied [[Add-on:VideoExtras#Viewing_Your_Extras|Confluence update]] then any Movies or TV Shows that have extras will be highlighted with an overlay image:
<center> [[File:VideoExtras-ThumbnailOverlay.JPG|200px]]</center>
 Then if you navigate into the Video Information Screen you should see an Extras button available:
<center> [[File:VideoExtras-VideoInfoDialog.JPG|400px]]</center>
 Selecting this button will then result in seeing the list of extras available:
<center> [[File:VideoExtras-DetailedListScreen.JPG|400px]]</center>
 
 
== Video Extras Browser ==
The VideoExtras browser allows you to view all the Movies/Tv Shows/Music Videos that have extras, and then watch those extras. You can load the extras browser in the following ways:
# Via the [[Add-on:VideoExtras#Database|VideoExtras Settings screen]] "Database" -> "Browse Extras"
# From the Programs Menu -> VideoExtras
# Videos -> Addons -> VideoExtras
 
 
== Settings ==
This section details all the settings options for VideoExtras
==== Extras ====
{| border="0"
|- valign=top
|
:'''Extras Directory Name'''
::The name of the sub directory that stores all the extras files
:'''Search Nested Directories'''
::If directories below the selected TV Show or Movie should be searched for more extras. This is useful if you select a given TV Show and have all your seasons for that show in separate directories under that show. This means that all extras will be displayed when viewed via the root TV Show, and only the seasons extras if selected from inside a given season.
:'''Enable Extras with File Tag'''
::Finds extras based on a "tag", listing anything containing that tag
:'''Extras File Name Tag'''
::If "Enable Extras with File Tag" was enabled, this gives the name to search for as the tag
:'''Use Detailed List Screen'''
::Displays a more advanced listing screen which displays resume points and a watched flag
:'''Window to show after exiting detailed list'''
::(If detailed list screen is enabled) - Which screen to go to after exiting the detailed list screen, options are: "Video Selection", "Information", "Home"
:'''Menu to show after playing an extra'''
::(If detailed list screen is disabled) - Which screen to go to after playing an extra, options are: "Extras", "Video Selection", "Information", "Home"
:'''''Operations'''''
::
:'''Update advancedsettings.xml File'''
::Will update (or create if it does not already exist) the advancedsettings.xml file so that your extras files are not accidently read into the library and incorrectly detected as actual Movies or TV Shows
| [[File:VideoExtras-Settings1.JPG|400px]]
|}
==== File System ====
{| border="0"
|- valign=top
|
:'''Use Custom Extras Location'''
::If extras are not stored with the Movies/TV Shows, this allows them to be stored in a different directory structure.
:'''Path'''
::The path that the extras are located in (Only if ''"Use Custom Extras Location"'' is enabled)
:'''Custom Movies Sub-Folder'''
::The name of the folder under the ''"Path"'' where Movie extras are stored (Note: a directory with the movie name will be located under this directory containing the extras for that movie)
:'''Custom TV Shows Sub-Folder'''
::The name of the folder under the ''"Path"'' where TV Shows extras are stored (Note: a directory with the TV Show name will be located under this directory containing the extras for that TV Show)
:'''Custom Music Video Sub-Folder'''
::The name of the folder under the ''"Path"'' where Music Video extras are stored (Note: a directory with the Music Video name will be located under this directory containing the extras for that Music Video)
:'''''Debugging'''''
::
:'''Enable Debug logging'''
::Enables VideoExtras debug logging into the Kodi log file
| [[File:VideoExtras-Settings2.JPG|400px]]
|}
==== Database ====
{| border="0"
|- valign=top
|
:'''Enable Database Support'''
::Enables the use of the Extras stand-alone database, this enables the display and storing of data such as
:::* Which extras have been viewed already
:::* Resume playing an extra from the last stop point
:'''''Operations'''''
::
:'''Clean Database'''
::Clears the extras database (resets all play states for the extras) - Note: This does not do anything to the default Kodi database.
:'''Browse Extras'''
::Loads the Video Extras Browser plugin.
| [[File:VideoExtras-Settings3.JPG|400px]]
|}
==== Advanced ====
{| border="0"
|- valign=top
|
:'''Force Extras Button Display'''
::Will always display the "Extras" button on the Video Information screen (Normal behaviour is to only show the button if there are extra's detected for the given video.
:'''Exclude Files Regular Expression'''
::Regular expression for files that will be deemed "Not to be extras" even if there are present in the Extras directory.
:'''Allow caching of extras on startup'''
::Used to cache the video extras available so that it can be used for icon overlays in some skins, if you do not wish to see icon overlays (or do not use a skin that supports them) then disable this option.
:'''Use Custom Images'''
::Allows you to change the images used in the skin to highlight if extras exist (Note: Changing these values will only be visable after a restart of Kodi)
:'''- Overlay Image'''
::(If Use Custom Images is enabled) The image that is drawn over the top of the thumbnail/cover
:'''- List Image'''
::(If Use Custom Images is enabled) The image that is used when adding to a list
:'''''Operations'''''
::
:'''Update Confluence Skin'''
::Will add VideoExtras support to the default confluence skin
| [[File:VideoExtras-Settings4.JPG|400px]]
|}
 
 
== File Naming Convention ==
For your video extras files to be found they must follow a specific naming convention. VideoExtras currently supports extras videos from Movies, TV Shows and Music Videos. Here are the supported conventions:
 
=== Extras Folder ===
''(Recommended Method)''
 
If you put all of your movies in their own folder you can simply add an "Extras" sub folder and add all of your bonus content in that directory. (The name of this folder can be changed via the settings menu). The script will simply display the filename (without extension) in the UI. By default the list of videos will appear in alphabetical order.
 
=== Same Directory ===

If for some reason you don't want to create an "Extras" folder or you want to associate a bonus feature with a specific TV show episode there is an alternative naming convention. Simply use the same name as the file you want to associate the extra feature with and then append "-extras-". (This tag can be changed via the settings menu)
 
=== Remote Location ===

If you did not want your extras stored in the same directory structure as your Movies, TV Shows or Music Videos, then there is a settings option "Use Custom Extras Location" that can be set to point to a different location. The format of this location should have 3 directories at the top level: "Movies", "TvShows" and "MusicVideos". Under each of these should be directories (That match the name of the directories containing the Movies,TV Shows and Music Videos) containing the extras files.
 
e.g.

:Movies/Die Hard
:TvShows/Blake's 7
:TvShows/Blake's 7/Series 1
:TvShows/Blake's 7/Series 2

In this case, when clicking on the "TV Information" for the whole Blake's 7 Series you would see all files in "TvShows/Blake's 7" and the two sub-folders (if nested search is enabled), if viewing Episode Information for an episode in series 1 of Blake's 7 then you would only see the extras in "Blake's 7/Series 1"
 
 
With this method (based on where this root directory is), there may not be a need to add the "File Exclusions" section into [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings].
 
 

== XBMC File Exclusions ==

Since these are video files sprinkled in among all of your other video files we need to tell the xbmc scanner to ignore these files. If we don't then the scanner will try and match them up with one of the online sites and you probably won't be happy with the results. To do this we just need to add some new regular expressions to the [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings]. It is recommended to add these settings and reboot xbmc for them to take effect BEFORE any library scan takes place, so the scanner doesn't try to parse them.

<source lang="xml">
<advancedsettings>
<video>
<excludefromscan action="append">
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>/extras/</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludefromscan>
<excludetvshowsfromscan action="append">
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>/extras/</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludetvshowsfromscan>
</video>
</advancedsettings>
</source>

''In this example the default name "Extras" has been used for the directory containing the extras, if you have changed this in the settings, then this name should also be changed to match.''

Obs.:

1) If you executed a library scan before the regexps have been put in place and found extra material accidentally scanned to your library, you can either remove/rename the extra material and conduct a 'clean library' under XBMC video settings or, delete the video sources and rescan them again after the regexps are operating properly.

2) Beware that if any of your sources contains the word 'extras' in it, e.g. a source named 'Extrasy' or 'Extrascent', nothing new that you put in it will be scanned to the library. This is because that source matches the exclude rule RegExp:'Extras'. To solve this either rename your source or change the default name 'extras', which VideoExtras operates with, to anything different.
 
 

== Images: Thumbnails, Icons and Fanart ==
=== Custom Artwork ===
In order to have thumbnails or custom fanart images displayed on your Extras listings (and player overlay) you can either reference them via an NFO file (see NFO section), or by having the image in the same directory as the extras file. Images referenced via NFO (locally or remotely) will have priority over any other. Thumbnail/icon images in the same directory as extras will be picked up in the following order:

* <filename>.tbn/png/jpg
* <filename>-poster.tbn/png/jpg
* <filename>-thumb.tbn/png/jpg
* poster.tbn/png/jpg (assigns same thumb to all those extras without one)
* folder.tbn/png/jpg (assings same thumb to all those extras without one)

For fanart, the images are picked up in the following order :
* <filename>-fanart.tbn/png/jpg
* fanart.tbn/png/jpg

obs: should you experience image caching persistency of old <filename>-poster/thumb.ext after replacing them by new ones at folder level, this is due to the way XBMC handles the caching of certain images. If you need an immediate solution and don't want to wait for XBMC to cache the new images, there is a script available that solves this issue at database level [http://Just%20to%20help%20with%20the%20cleansing%20of%20thumbs%20cached%20in%20XBMC%20to%20allow%20VideoExtras%20to%20display%20updated%20thumbs%20for%20your%20extras here] called Texture Cache Maintenance utility by MilhouseVH. There aren't cases reported of image caching persistency when using the naming convention <filename>.tbn/png/jpg

=== Default Artwork ===
* '''If no custom fanart:''' fanart is automatically inherited from the parent video file, if there's any.
* '''If no custom thumb (poster):''' default thumb is VideoExtras image icon and will only be displayed in the video overlay whilst playing the extra and not in the extras list.
 
 

== NFO Files ==

The recommended method to give a name or sort order to your "Extras" is to add an NFO for each extra file. This follows the standard XBMC method of having the same name as the file with the extension being replaced with ".nfo" (Sitting in the same directory as the original file). This nfo can take any of the followoing formats (These are in line with the default XBMC behaviour), additional data in these files will be ignored as it is not relevant for the extras file. (Note: The only mandatory element is the "title")

=== Movie NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<movie>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<plot>Something happens</plot>
<thumb>thumbnail.jpg</thumb>
<fanart>background.jpg</fanart>
</movie>
</source>

=== TV Show NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<tvshow>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<plot>Something happens</plot>
<thumb>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</thumb>
<fanart>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</fanart>
</tvshow>
</source>

=== TV Episode NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<episodedetails>
<title>Who knows</title>
<season>2</season>
<episode>1</episode>
<plot>Something happens</plot>
<thumb>C:\MyThumbs\Who.Knows.tbn</thumb>
<fanart>C:\MyFanart\myart.png</fanart>
</episodedetails>
</source>

=== Legacy Naming Format ===
The following are the legacy naming formats, they are supported in the short term only to allow easy migration from DVDExtras to VideoExtras. (If an NFO file is specified, the settings in that file will be used)
 
 
By default the list of videos will appear in alphabetical order. If you would like to specify a custom order just start the filename with brackets containing the text to sort on. For example you could create files "[0]Deleted Scenes.mkv", "[1]Bloopers.mkv", and "[2]Behind The Scenes.mkv". In this case instead of sorting on the name it will sort on the numbers. The bracket portion of the filename will not be displayed in the UI.
 
 
For extras tagged on a per file basis (rather and all in a sub-directory) the name will be taken from anything after the extras tag. So append "-extras-Display name here" will result in the name "Display name here". To customize the order here you can use the same format as the extras folder. Example: "s01e01-extras-[99]Extended Pilot.mkv"
 
 
== "videoextras.nfo" Files ==

If you do not have your video extras files stored in a standard location (as already described in the previous sections) then it is possible to create a file with the name "videoextras.nfo" in the same directory as your Movie or TV Show. This file must be of the following format:

<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<videoextras>
<file>..\..\Extras\Extras01.mkv</file>
<directory>C:\Kodi\Sample-Data\Movies\Extras</directory>
</videoextras>
</source>

You can have multiple "file" or "directory" entries in the "videoextras.nfo" file (or none of one type). The "file" will result in just the given file being listed in the extras. The "directory" will result in the entire contents of the directory being listed.
=== Common extras content for Movie Sets ===
The videoextras.nfo's capabilities are useful to assign common extras content to movies within a set (collection), thus we would have only one physical copy of the 'Extras' folder somewhere whilst each videoextras.nfo is pointing at it.
 
 
== Skin Information ==
=== Skins With Build In Support ===
The following skins (except Confluence, since it requires the hooks) have built-in support for Video Extras , so require no user skin modifications:

{| class="wikitable"
|-
! Skin !! Hook Support !! Detailed Screen Support !! Detailed Screen Skin Location !! Hooks Location
|-
| [[Add-on:Confluence|Confluence]] || <center>No</center>|| <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/xbmc/xbmc/blob/master/addons/skin.confluence/720p/DialogVideoInfo.xml DialogVideoInfo.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=145080 Confluence Modified] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=139712 Immersive] || <center>Yes</center> || <center>Yes</center> || <center>Immersive</center> || <center>[https://github.com/Sranshaft/skin.immersive/blob/master/720p/DialogVideoInfo.xml DialogVideoInfo.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=165481 Xperience1080++] || <center>Yes</center> || <center>Yes</center> || <center>Xperience1080++</center> || <center></center>
|-
| [[Add-on:Aeon_MQ_5|Aeon MQ 5]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center></center>
|-
| [[Add-on:Aeon_Nox|Aeon Nox 5]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/BigNoid/Aeon-Nox/blob/master/1080i/custom_1119_ExtrasDialog.xml custom_1119_ExtrasDialog.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=185290 Aeon Nox 4.1.9.x] || <center>Yes</center> || <center>Yes</center> || <center>Aeon Nox 4.1.9.x</center> || <center></center>
|-
| [[Add-on:Rapier|Rapier]] || <center>Yes</center> || <center>Yes</center> || <center>Rapier</center> || <center></center>
|-
| [http://forum.xbmc.org/showthread.php?tid=170954 Artic mk. ii] || <center>Yes</center> || <center>Yes</center> || <center>Artic</center> || <center></center>
|-
| [[Add-on:Metropolis| Metropolis]] ([http://forum.xbmc.org/showthread.php?tid=99317&pid=1726112#pid1726112 coming soon!]) || <center></center> || <center></center> || <center></center> || <center></center>
|-
| [[Add-on:XTV-SAF| xTV-SAF]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center></center>
|-
| [[Add-on:Transparency!|Transparency!]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/ronie/skin.transparency/blob/master/720p/custom_DialogExtras.xml custom_DialogExtras.xml]</center>
|}
 
If your skin does not support the "Detailed List Screen", then you can either:
# Switch the "Detailed List Screen" off - reverting to the basic list dialog
# Convert the Window XML file in the addon and post a link to it in the forum.
# Use the default "Detailed List Screen" (May not fit in visually with the skin you are using)

Obs: due to a natural delay between the dates of release of possible latest features (and fixed issues too) and actual implementation of these updates in the supported skins, such as support for Music Videos, these skins may still require some manual changes as per [[Add-on:VideoExtras#Skin_Modifications|item 10.2]] in certain skins with built-in support.
 
 

=== Confluence Skin Support ===
A request has been made to the XBMC official repo to have VideoExtras included in the Confluence skin:
https://github.com/xbmc/xbmc/pull/4827
Unfortunately this did not get approved to go into the official repository.
 
 
Instead of this, there is an option that will update the Confluence skin for you in the settings. Just navigate to the [[Add-on:VideoExtras#Advanced|"Update Confluence Skin"]] operation in the VideoExtras settings.
 
 
Note: For this update to work, the directory containing the Confluence skin must have write permissions set. 
As Confluence is the default skin, it's directory is not user modifiable on non-Windows systems. 
To get around this, it is recommended to copy the Confluence skin's directory from it's existing location 
to the standard location for user installed add-ons: 
On Ubuntu Linux, the operation would be to copy the directory "/usr/share/kodi/addons/skin.confluence/" 
to "/home/<username>/.kodi/addons/". 
Upon restarting Kodi, you should now be able to use the "Update Confluence Skin" feature. 
 

=== Skin Modifications ===
A skin modification is required in order to see the extras button in the UI and enjoy all the features. This is a fairly simple process but will depend on your selected skin. The file that needs modified is DialogVideoInfo.xml. This is the code needed for the default confluence skin.

Add to the top of the file (after <window>):
<source lang="xml">
<onload condition="System.HasAddon(script.videoextras)">
XBMC.RunScript(script.videoextras,check,"$INFO[ListItem.FilenameAndPath]")</onload>
</source>

Add to near the foot of the file after the last control statement:

<source lang="xml">
<control type="button" id="105">
<description>Extras</description>
<include>ButtonInfoDialogsCommonValues</include>
<label>Extras</label>
<onclick>XBMC.RunScript(script.videoextras,display,"$INFO[ListItem.FilenameAndPath]")</onclick>
<visible>System.HasAddon(script.videoextras)
+ [Container.Content(movies) | Container.Content(episodes) | Container.Content(TVShows)
| Container.Content(musicvideos)]
+ IsEmpty(Window(movieinformation).Property("HideVideoExtrasButton"))</visible>
</control>
</source>
You should be able to use something similar for other skins.

==== Location of XML ====
The DialogVideoInfo.xml's location listed by skin:
;Confluence
* '''Ubuntu Linux:''' /home/<username>/.xbmc/addons/skin.confluence/720p/
* '''Ubuntu Linux (alternative):''': /usr/share/xbmc/addons/skin.confluence/720p/
* '''OS X:''' /Applications/XBMC.app/Contents/Resources/XBMC/addons/skin.confluence/720p
* '''Windows 7/8.1:''' Program Files (x86)\XBMC\addons\skin.confluence\720p
;Aeon Nox 4
* '''Ubuntu Linux:''' /home/<username>/.xbmc/addons/skin.aeon.nox/1080i/
* '''Windows 7/8.1:''' Program Files (x86)\XBMC\addons\skin.aeon.nox\1080i\

Obs.: Remember to create a backup of any file before altering it i.e. DialogVideoInfo.xml.old.

=== Icon Overlay on Video List Screen (Advanced Skinners Only) ===
If you are a skinner and wish to add support for some form of indication that a Movie/TV Show has extras, there is a way, it is not perfect but should get the overlays working. The first part is that you need to have "Allow caching of extras on startup" enabled in the VideoExtras settings. You then need the following in your skin:

<source lang="xml">
<control type="image">
<posx>950</posx>
<posy>14</posy>
<width>16</width>
<height>16</height>
<texture fallback="blank.png">$INFO[ListItem.DBID,special://profile/addon_data/script.videoextras/movies/,.png]</texture>
<visible>System.HasAddon(script.videoextras) + Window.IsVisible(Videos) + Container.Content(Movies)</visible>
</control>
</source>

This example would possibly be added to the confluence skin at line 554 to add an icon to movies on the "biglist" screen. There are 3 different values that can be used:

{| class="wikitable"
|-
| movies || Container.Content(Movies)
|-
| tvshows|| Container.Content(TVShows)
|-
| musicvideos|| Container.Content(MusicVideos)
|}

Where the first column supplies the value used in the <texture> element, and the second for the <visible> element.
 
 
There is a default image that is used to represent the existance of Video Extras, but this can be overridden by the skin by putting a file called "videoextras_overlay.png" in the skins "media" directory, or by updating the [[Add-on:VideoExtras#Advanced|VideoExtras settings]].
 
 
IMPORTANT: This is for advanced skinners only, please only post on the forum if you '''own the skin you are trying to update''' - this is because it will require lots of changes to patch an existing skin, and this feature is only intended to support skins that will support VideoExtras "Out Of The Box".
 
 

=== Request To Skinners (Detailed List Screen) ===
VideoExtras uses a custom window to show the extras, I have written the Window XML files for Confluence. With the large array of different skins available it is not possible to write versions for every skin. If you would be willing to support Video Extras I would really like to include a skin specific Window XML file for your skin and would be greatful for any contribution.
 
The files are very small, so hopefully will not take long to convert for your skin.
 
 

== Known Issues ==
=== Cast List In Summary Screen Not Populated ===
There is a known issue that when you return from the detailed list screen that shows the extras back to the summary screen, the Cast section is not populated, the following was posted for this, but there is no solution:
http://forum.kodi.tv/showthread.php?tid=173502
 
 

== Debugging ==
If reporting a problem, please also provide a debug log. To do this you need to enable BOTH:
* XBMC [[Settings/System#Debugging|logging]] from the main setting menu
* VideoExtras debug from the VideoExtras addon settings menu
Please do not paste the log into the forum thread, just link to it.
 
 
== Donations ==
If you have found VideoExtras useful and would like to help support future development and bug fixes, then please feel free to make a small donation. Any donations made will be put towards hardware to enable support and development on different platforms (I can currently only test Windows - however I would like to be able to verify changes on Android and Mac - and this is what donations would go towards)
 
 
Please use the link on the top of the [http://forum.xbmc.org/showthread.php?tid=178717 VideoExtras Forum]
 
 
''Note:'' Donations will not make any difference to the level of support I will give people on the forum - this project is Open Source - and is completely free!!
 
 

[[Category:Frodo add-on repository]]
[[Category:Gotham add-on repository]]
[[Category:Helix add-on repository]]

Add-on:VideoExtras

2015-01-10T19:09:16Z

Rich.T.: /* Confluence Skin Support */

{{Addon
|Name=VideoExtras
|provider-name=robwebset
|ID=script.videoextras
|latest-version=1.2.1
|extension point=xbmc.python.script
|provides=
|Summary=Add Video Extras to your Movies and TV shows.
|Description=Provides a way to add Video Extras to your Video library. Look at the wiki for setup instructions.
|Platform=all
|Language=
|License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991
|Forum=http://forum.kodi.tv/showthread.php?tid=214289
|Website=
|Source=http://robwebset.googlecode.com/svn/trunk/script.videoextras/
|Email=
|broken=
|icon url=http://mirrors.kodi.tv/addons/gotham/script.videoextras/icon.png}}


 
== Introduction ==
VideoExtras is an addon to allow you to store, list and play the "extras" for a given Movie or TV Series. (i.e. The extras that often come on DVD's or Blu-Rays)

 
== Forum and Issue Report Pages ==
If you have any questions, found an issue to report or would just like to know a little more you can take part in the forum discussions at:

:[http://forum.kodi.tv/showthread.php?tid=214289 VideoExtras Forum]

 
== Quickstart Guide ==
This Quickstart guide is aimed at first time users of VideoExtras, who also have some freedom to re-arrange their video content to fit best with VideoExtras.
==== Install VideoExtras ====
VideoExtras is in the official repo, so you should be able to install it like any other addon.
==== Arranging Your Video Files ====
Although VideoExtras will support most structures (with various configuration changes), the easiest and best structure is as follows:

:''../<Movie Name>/movie-name.avi''
:''../<Movie Name>/Extras/extras-name-1.avi''
:''../<Movie Name>/Extras/extras-name-2.avi''
:''...''
More details of extras setup can be found in the [[Add-on:VideoExtras#File_Naming_Convention|File Naming Convention Section]]
==== Stopping The Extras Being Scanned Into Your Library ====
Now that you have copied your Extras files into the correct directories, you do not want them to be accidently picked up/scanned as a Movie or TV Series in their own right. To stop this you need to add "excludes" into the advancedsettings.xml file. This can be done for you by click on the [[Add-on:VideoExtras#Extras|"Update advancedsettings.xml File"]] operation on the first tab of the VideoExtras settings, or you could always do it yourself [[Add-on:VideoExtras#XBMC_File_Exclusions|manually]].
==== Scanning Media Into Your Library ====
Once you have updated the advancedsettings.xml file it should now be safe to perform any scans you wish to pull media into your library. At this point, the scanner should skip over any Extras files.
==== Viewing Your Extras ====
In order to view the Extras you have now stored with your Movies or TV Shows you will need one of the following 2 things:
* To update the default Confluence Skin, this can either be done [[Add-on:VideoExtras#Skin_Modifications|manually]] or by navigating to the Advanced tab of the VideoExtras settings and clicking on [[Add-on:VideoExtras#Advanced|"Update Confluence Skin"]].
* Use one of the non default [[Add-on:VideoExtras#Skins_With_Build_In_Support|skins that has built in support]] for VideoExtras
==== You Are Now Up And Running ====
That's it! You should now be able to navigate to your extras by either going to the Video Information Dialog for the given video, or by going via: ''[[Add-on:VideoExtras#Video_Extras_Browser|Videos -> Addons -> VideoExtras]]''
 
There are plenty more things you can do to improve your user experience such as adding [[Add-on:VideoExtras#Images:_Thumbnails.2C_Icons_and_Fanart|icons/fanart/thumbnails]] or giving detailed [[Add-on:VideoExtras#NFO_Files|titles or plots]]. However, this is a quickstart guide, and you should take a look at the rest of the wiki for those features.
 
 
== Using VideoExtras ==
Now that you have [[Add-on:VideoExtras#Quickstart_Guide|configured]] VideoExtras, you can start using it. If you are using Confluence with the supplied [[Add-on:VideoExtras#Viewing_Your_Extras|Confluence update]] then any Movies or TV Shows that have extras will be highlighted with an overlay image:
<center> [[File:VideoExtras-ThumbnailOverlay.JPG|200px]]</center>
 Then if you navigate into the Video Information Screen you should see an Extras button available:
<center> [[File:VideoExtras-VideoInfoDialog.JPG|400px]]</center>
 Selecting this button will then result in seeing the list of extras available:
<center> [[File:VideoExtras-DetailedListScreen.JPG|400px]]</center>
 
 
== Video Extras Browser ==
The VideoExtras browser allows you to view all the Movies/Tv Shows/Music Videos that have extras, and then watch those extras. You can load the extras browser in the following ways:
# Via the [[Add-on:VideoExtras#Database|VideoExtras Settings screen]] "Database" -> "Browse Extras"
# From the Programs Menu -> VideoExtras
# Videos -> Addons -> VideoExtras
 
 
== Settings ==
This section details all the settings options for VideoExtras
==== Extras ====
{| border="0"
|- valign=top
|
:'''Extras Directory Name'''
::The name of the sub directory that stores all the extras files
:'''Search Nested Directories'''
::If directories below the selected TV Show or Movie should be searched for more extras. This is useful if you select a given TV Show and have all your seasons for that show in separate directories under that show. This means that all extras will be displayed when viewed via the root TV Show, and only the seasons extras if selected from inside a given season.
:'''Enable Extras with File Tag'''
::Finds extras based on a "tag", listing anything containing that tag
:'''Extras File Name Tag'''
::If "Enable Extras with File Tag" was enabled, this gives the name to search for as the tag
:'''Use Detailed List Screen'''
::Displays a more advanced listing screen which displays resume points and a watched flag
:'''Window to show after exiting detailed list'''
::(If detailed list screen is enabled) - Which screen to go to after exiting the detailed list screen, options are: "Video Selection", "Information", "Home"
:'''Menu to show after playing an extra'''
::(If detailed list screen is disabled) - Which screen to go to after playing an extra, options are: "Extras", "Video Selection", "Information", "Home"
:'''''Operations'''''
::
:'''Update advancedsettings.xml File'''
::Will update (or create if it does not already exist) the advancedsettings.xml file so that your extras files are not accidently read into the library and incorrectly detected as actual Movies or TV Shows
| [[File:VideoExtras-Settings1.JPG|400px]]
|}
==== File System ====
{| border="0"
|- valign=top
|
:'''Use Custom Extras Location'''
::If extras are not stored with the Movies/TV Shows, this allows them to be stored in a different directory structure.
:'''Path'''
::The path that the extras are located in (Only if ''"Use Custom Extras Location"'' is enabled)
:'''Custom Movies Sub-Folder'''
::The name of the folder under the ''"Path"'' where Movie extras are stored (Note: a directory with the movie name will be located under this directory containing the extras for that movie)
:'''Custom TV Shows Sub-Folder'''
::The name of the folder under the ''"Path"'' where TV Shows extras are stored (Note: a directory with the TV Show name will be located under this directory containing the extras for that TV Show)
:'''Custom Music Video Sub-Folder'''
::The name of the folder under the ''"Path"'' where Music Video extras are stored (Note: a directory with the Music Video name will be located under this directory containing the extras for that Music Video)
:'''''Debugging'''''
::
:'''Enable Debug logging'''
::Enables VideoExtras debug logging into the Kodi log file
| [[File:VideoExtras-Settings2.JPG|400px]]
|}
==== Database ====
{| border="0"
|- valign=top
|
:'''Enable Database Support'''
::Enables the use of the Extras stand-alone database, this enables the display and storing of data such as
:::* Which extras have been viewed already
:::* Resume playing an extra from the last stop point
:'''''Operations'''''
::
:'''Clean Database'''
::Clears the extras database (resets all play states for the extras) - Note: This does not do anything to the default Kodi database.
:'''Browse Extras'''
::Loads the Video Extras Browser plugin.
| [[File:VideoExtras-Settings3.JPG|400px]]
|}
==== Advanced ====
{| border="0"
|- valign=top
|
:'''Force Extras Button Display'''
::Will always display the "Extras" button on the Video Information screen (Normal behaviour is to only show the button if there are extra's detected for the given video.
:'''Exclude Files Regular Expression'''
::Regular expression for files that will be deemed "Not to be extras" even if there are present in the Extras directory.
:'''Allow caching of extras on startup'''
::Used to cache the video extras available so that it can be used for icon overlays in some skins, if you do not wish to see icon overlays (or do not use a skin that supports them) then disable this option.
:'''Use Custom Images'''
::Allows you to change the images used in the skin to highlight if extras exist (Note: Changing these values will only be visable after a restart of Kodi)
:'''- Overlay Image'''
::(If Use Custom Images is enabled) The image that is drawn over the top of the thumbnail/cover
:'''- List Image'''
::(If Use Custom Images is enabled) The image that is used when adding to a list
:'''''Operations'''''
::
:'''Update Confluence Skin'''
::Will add VideoExtras support to the default confluence skin
| [[File:VideoExtras-Settings4.JPG|400px]]
|}
 
 
== File Naming Convention ==
For your video extras files to be found they must follow a specific naming convention. VideoExtras currently supports extras videos from Movies, TV Shows and Music Videos. Here are the supported conventions:
 
=== Extras Folder ===
''(Recommended Method)''
 
If you put all of your movies in their own folder you can simply add an "Extras" sub folder and add all of your bonus content in that directory. (The name of this folder can be changed via the settings menu). The script will simply display the filename (without extension) in the UI. By default the list of videos will appear in alphabetical order.
 
=== Same Directory ===

If for some reason you don't want to create an "Extras" folder or you want to associate a bonus feature with a specific TV show episode there is an alternative naming convention. Simply use the same name as the file you want to associate the extra feature with and then append "-extras-". (This tag can be changed via the settings menu)
 
=== Remote Location ===

If you did not want your extras stored in the same directory structure as your Movies, TV Shows or Music Videos, then there is a settings option "Use Custom Extras Location" that can be set to point to a different location. The format of this location should have 3 directories at the top level: "Movies", "TvShows" and "MusicVideos". Under each of these should be directories (That match the name of the directories containing the Movies,TV Shows and Music Videos) containing the extras files.
 
e.g.

:Movies/Die Hard
:TvShows/Blake's 7
:TvShows/Blake's 7/Series 1
:TvShows/Blake's 7/Series 2

In this case, when clicking on the "TV Information" for the whole Blake's 7 Series you would see all files in "TvShows/Blake's 7" and the two sub-folders (if nested search is enabled), if viewing Episode Information for an episode in series 1 of Blake's 7 then you would only see the extras in "Blake's 7/Series 1"
 
 
With this method (based on where this root directory is), there may not be a need to add the "File Exclusions" section into [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings].
 
 

== XBMC File Exclusions ==

Since these are video files sprinkled in among all of your other video files we need to tell the xbmc scanner to ignore these files. If we don't then the scanner will try and match them up with one of the online sites and you probably won't be happy with the results. To do this we just need to add some new regular expressions to the [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings]. It is recommended to add these settings and reboot xbmc for them to take effect BEFORE any library scan takes place, so the scanner doesn't try to parse them.

<source lang="xml">
<advancedsettings>
<video>
<excludefromscan action="append">
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>/extras/</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludefromscan>
<excludetvshowsfromscan action="append">
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>/extras/</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludetvshowsfromscan>
</video>
</advancedsettings>
</source>

''In this example the default name "Extras" has been used for the directory containing the extras, if you have changed this in the settings, then this name should also be changed to match.''

Obs.:

1) If you executed a library scan before the regexps have been put in place and found extra material accidentally scanned to your library, you can either remove/rename the extra material and conduct a 'clean library' under XBMC video settings or, delete the video sources and rescan them again after the regexps are operating properly.

2) Beware that if any of your sources contains the word 'extras' in it, e.g. a source named 'Extrasy' or 'Extrascent', nothing new that you put in it will be scanned to the library. This is because that source matches the exclude rule RegExp:'Extras'. To solve this either rename your source or change the default name 'extras', which VideoExtras operates with, to anything different.
 
 

== Images: Thumbnails, Icons and Fanart ==
=== Custom Artwork ===
In order to have thumbnails or custom fanart images displayed on your Extras listings (and player overlay) you can either reference them via an NFO file (see NFO section), or by having the image in the same directory as the extras file. Images referenced via NFO (locally or remotely) will have priority over any other. Thumbnail/icon images in the same directory as extras will be picked up in the following order:

* <filename>.tbn/png/jpg
* <filename>-poster.tbn/png/jpg
* <filename>-thumb.tbn/png/jpg
* poster.tbn/png/jpg (assigns same thumb to all those extras without one)
* folder.tbn/png/jpg (assings same thumb to all those extras without one)

For fanart, the images are picked up in the following order :
* <filename>-fanart.tbn/png/jpg
* fanart.tbn/png/jpg

obs: should you experience image caching persistency of old <filename>-poster/thumb.ext after replacing them by new ones at folder level, this is due to the way XBMC handles the caching of certain images. If you need an immediate solution and don't want to wait for XBMC to cache the new images, there is a script available that solves this issue at database level [http://Just%20to%20help%20with%20the%20cleansing%20of%20thumbs%20cached%20in%20XBMC%20to%20allow%20VideoExtras%20to%20display%20updated%20thumbs%20for%20your%20extras here] called Texture Cache Maintenance utility by MilhouseVH. There aren't cases reported of image caching persistency when using the naming convention <filename>.tbn/png/jpg

=== Default Artwork ===
* '''If no custom fanart:''' fanart is automatically inherited from the parent video file, if there's any.
* '''If no custom thumb (poster):''' default thumb is VideoExtras image icon and will only be displayed in the video overlay whilst playing the extra and not in the extras list.
 
 

== NFO Files ==

The recommended method to give a name or sort order to your "Extras" is to add an NFO for each extra file. This follows the standard XBMC method of having the same name as the file with the extension being replaced with ".nfo" (Sitting in the same directory as the original file). This nfo can take any of the followoing formats (These are in line with the default XBMC behaviour), additional data in these files will be ignored as it is not relevant for the extras file. (Note: The only mandatory element is the "title")

=== Movie NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<movie>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<plot>Something happens</plot>
<thumb>thumbnail.jpg</thumb>
<fanart>background.jpg</fanart>
</movie>
</source>

=== TV Show NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<tvshow>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<plot>Something happens</plot>
<thumb>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</thumb>
<fanart>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</fanart>
</tvshow>
</source>

=== TV Episode NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<episodedetails>
<title>Who knows</title>
<season>2</season>
<episode>1</episode>
<plot>Something happens</plot>
<thumb>C:\MyThumbs\Who.Knows.tbn</thumb>
<fanart>C:\MyFanart\myart.png</fanart>
</episodedetails>
</source>

=== Legacy Naming Format ===
The following are the legacy naming formats, they are supported in the short term only to allow easy migration from DVDExtras to VideoExtras. (If an NFO file is specified, the settings in that file will be used)
 
 
By default the list of videos will appear in alphabetical order. If you would like to specify a custom order just start the filename with brackets containing the text to sort on. For example you could create files "[0]Deleted Scenes.mkv", "[1]Bloopers.mkv", and "[2]Behind The Scenes.mkv". In this case instead of sorting on the name it will sort on the numbers. The bracket portion of the filename will not be displayed in the UI.
 
 
For extras tagged on a per file basis (rather and all in a sub-directory) the name will be taken from anything after the extras tag. So append "-extras-Display name here" will result in the name "Display name here". To customize the order here you can use the same format as the extras folder. Example: "s01e01-extras-[99]Extended Pilot.mkv"
 
 
== "videoextras.nfo" Files ==

If you do not have your video extras files stored in a standard location (as already described in the previous sections) then it is possible to create a file with the name "videoextras.nfo" in the same directory as your Movie or TV Show. This file must be of the following format:

<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<videoextras>
<file>..\..\Extras\Extras01.mkv</file>
<directory>C:\Kodi\Sample-Data\Movies\Extras</directory>
</videoextras>
</source>

You can have multiple "file" or "directory" entries in the "videoextras.nfo" file (or none of one type). The "file" will result in just the given file being listed in the extras. The "directory" will result in the entire contents of the directory being listed.
=== Common extras content for Movie Sets ===
The videoextras.nfo's capabilities are useful to assign common extras content to movies within a set (collection), thus we would have only one physical copy of the 'Extras' folder somewhere whilst each videoextras.nfo is pointing at it.
 
 
== Skin Information ==
=== Skins With Build In Support ===
The following skins (except Confluence, since it requires the hooks) have built-in support for Video Extras , so require no user skin modifications:

{| class="wikitable"
|-
! Skin !! Hook Support !! Detailed Screen Support !! Detailed Screen Skin Location !! Hooks Location
|-
| [[Add-on:Confluence|Confluence]] || <center>No</center>|| <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/xbmc/xbmc/blob/master/addons/skin.confluence/720p/DialogVideoInfo.xml DialogVideoInfo.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=145080 Confluence Modified] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=139712 Immersive] || <center>Yes</center> || <center>Yes</center> || <center>Immersive</center> || <center>[https://github.com/Sranshaft/skin.immersive/blob/master/720p/DialogVideoInfo.xml DialogVideoInfo.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=165481 Xperience1080++] || <center>Yes</center> || <center>Yes</center> || <center>Xperience1080++</center> || <center></center>
|-
| [[Add-on:Aeon_MQ_5|Aeon MQ 5]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center></center>
|-
| [[Add-on:Aeon_Nox|Aeon Nox 5]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/BigNoid/Aeon-Nox/blob/master/1080i/custom_1119_ExtrasDialog.xml custom_1119_ExtrasDialog.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=185290 Aeon Nox 4.1.9.x] || <center>Yes</center> || <center>Yes</center> || <center>Aeon Nox 4.1.9.x</center> || <center></center>
|-
| [[Add-on:Rapier|Rapier]] || <center>Yes</center> || <center>Yes</center> || <center>Rapier</center> || <center></center>
|-
| [http://forum.xbmc.org/showthread.php?tid=170954 Artic mk. ii] || <center>Yes</center> || <center>Yes</center> || <center>Artic</center> || <center></center>
|-
| [[Add-on:Metropolis| Metropolis]] ([http://forum.xbmc.org/showthread.php?tid=99317&pid=1726112#pid1726112 coming soon!]) || <center></center> || <center></center> || <center></center> || <center></center>
|-
| [[Add-on:XTV-SAF| xTV-SAF]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center></center>
|-
| [[Add-on:Transparency!|Transparency!]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/ronie/skin.transparency/blob/master/720p/custom_DialogExtras.xml custom_DialogExtras.xml]</center>
|}
 
If your skin does not support the "Detailed List Screen", then you can either:
# Switch the "Detailed List Screen" off - reverting to the basic list dialog
# Convert the Window XML file in the addon and post a link to it in the forum.
# Use the default "Detailed List Screen" (May not fit in visually with the skin you are using)

Obs: due to a natural delay between the dates of release of possible latest features (and fixed issues too) and actual implementation of these updates in the supported skins, such as support for Music Videos, these skins may still require some manual changes as per [[Add-on:VideoExtras#Skin_Modifications|item 10.2]] in certain skins with built-in support.
 
 

=== Confluence Skin Support ===
A request has been made to the XBMC official repo to have VideoExtras included in the Confluence skin:
https://github.com/xbmc/xbmc/pull/4827
Unfortunately this did not get approved to go into the official repository.
 
 
Instead of this, there is an option that will update the Confluence skin for you in the settings. Just navigate to the [[Add-on:VideoExtras#Advanced|"Update Confluence Skin"]] operation in the VideoExtras settings.
 
 
Note: For this update to work, the directory containing the Confluence skin must have write permissions set.
As Confluence is the default skin, it's directory is not user modifiable on non-Windows systems.
To get around this, it is recommended to copy the Confluence skin's directory from it's existing location
to the standard location for user installed add-ons:
On Ubuntu Linux, the operation would be to copy the directory "/usr/share/kodi/addons/skin.confluence/"
to "/home/<username>/.kodi/addons/".
Upon restarting Kodi, you should now be able to use the "Update Confluence Skin" feature.
 

=== Skin Modifications ===
A skin modification is required in order to see the extras button in the UI and enjoy all the features. This is a fairly simple process but will depend on your selected skin. The file that needs modified is DialogVideoInfo.xml. This is the code needed for the default confluence skin.

Add to the top of the file (after <window>):
<source lang="xml">
<onload condition="System.HasAddon(script.videoextras)">
XBMC.RunScript(script.videoextras,check,"$INFO[ListItem.FilenameAndPath]")</onload>
</source>

Add to near the foot of the file after the last control statement:

<source lang="xml">
<control type="button" id="105">
<description>Extras</description>
<include>ButtonInfoDialogsCommonValues</include>
<label>Extras</label>
<onclick>XBMC.RunScript(script.videoextras,display,"$INFO[ListItem.FilenameAndPath]")</onclick>
<visible>System.HasAddon(script.videoextras)
+ [Container.Content(movies) | Container.Content(episodes) | Container.Content(TVShows)
| Container.Content(musicvideos)]
+ IsEmpty(Window(movieinformation).Property("HideVideoExtrasButton"))</visible>
</control>
</source>
You should be able to use something similar for other skins.

==== Location of XML ====
The DialogVideoInfo.xml's location listed by skin:
;Confluence
* '''Ubuntu Linux:''' /home/<username>/.xbmc/addons/skin.confluence/720p/
* '''Ubuntu Linux (alternative):''': /usr/share/xbmc/addons/skin.confluence/720p/
* '''OS X:''' /Applications/XBMC.app/Contents/Resources/XBMC/addons/skin.confluence/720p
* '''Windows 7/8.1:''' Program Files (x86)\XBMC\addons\skin.confluence\720p
;Aeon Nox 4
* '''Ubuntu Linux:''' /home/<username>/.xbmc/addons/skin.aeon.nox/1080i/
* '''Windows 7/8.1:''' Program Files (x86)\XBMC\addons\skin.aeon.nox\1080i\

Obs.: Remember to create a backup of any file before altering it i.e. DialogVideoInfo.xml.old.

=== Icon Overlay on Video List Screen (Advanced Skinners Only) ===
If you are a skinner and wish to add support for some form of indication that a Movie/TV Show has extras, there is a way, it is not perfect but should get the overlays working. The first part is that you need to have "Allow caching of extras on startup" enabled in the VideoExtras settings. You then need the following in your skin:

<source lang="xml">
<control type="image">
<posx>950</posx>
<posy>14</posy>
<width>16</width>
<height>16</height>
<texture fallback="blank.png">$INFO[ListItem.DBID,special://profile/addon_data/script.videoextras/movies/,.png]</texture>
<visible>System.HasAddon(script.videoextras) + Window.IsVisible(Videos) + Container.Content(Movies)</visible>
</control>
</source>

This example would possibly be added to the confluence skin at line 554 to add an icon to movies on the "biglist" screen. There are 3 different values that can be used:

{| class="wikitable"
|-
| movies || Container.Content(Movies)
|-
| tvshows|| Container.Content(TVShows)
|-
| musicvideos|| Container.Content(MusicVideos)
|}

Where the first column supplies the value used in the <texture> element, and the second for the <visible> element.
 
 
There is a default image that is used to represent the existance of Video Extras, but this can be overridden by the skin by putting a file called "videoextras_overlay.png" in the skins "media" directory, or by updating the [[Add-on:VideoExtras#Advanced|VideoExtras settings]].
 
 
IMPORTANT: This is for advanced skinners only, please only post on the forum if you '''own the skin you are trying to update''' - this is because it will require lots of changes to patch an existing skin, and this feature is only intended to support skins that will support VideoExtras "Out Of The Box".
 
 

=== Request To Skinners (Detailed List Screen) ===
VideoExtras uses a custom window to show the extras, I have written the Window XML files for Confluence. With the large array of different skins available it is not possible to write versions for every skin. If you would be willing to support Video Extras I would really like to include a skin specific Window XML file for your skin and would be greatful for any contribution.
 
The files are very small, so hopefully will not take long to convert for your skin.
 
 

== Known Issues ==
=== Cast List In Summary Screen Not Populated ===
There is a known issue that when you return from the detailed list screen that shows the extras back to the summary screen, the Cast section is not populated, the following was posted for this, but there is no solution:
http://forum.kodi.tv/showthread.php?tid=173502
 
 

== Debugging ==
If reporting a problem, please also provide a debug log. To do this you need to enable BOTH:
* XBMC [[Settings/System#Debugging|logging]] from the main setting menu
* VideoExtras debug from the VideoExtras addon settings menu
Please do not paste the log into the forum thread, just link to it.
 
 
== Donations ==
If you have found VideoExtras useful and would like to help support future development and bug fixes, then please feel free to make a small donation. Any donations made will be put towards hardware to enable support and development on different platforms (I can currently only test Windows - however I would like to be able to verify changes on Android and Mac - and this is what donations would go towards)
 
 
Please use the link on the top of the [http://forum.xbmc.org/showthread.php?tid=178717 VideoExtras Forum]
 
 
''Note:'' Donations will not make any difference to the level of support I will give people on the forum - this project is Open Source - and is completely free!!
 
 

[[Category:Frodo add-on repository]]
[[Category:Gotham add-on repository]]
[[Category:Helix add-on repository]]

Add-on:VideoExtras

2015-01-10T19:07:25Z

Rich.T.: /* Confluence Skin Support */

{{Addon
|Name=VideoExtras
|provider-name=robwebset
|ID=script.videoextras
|latest-version=1.2.1
|extension point=xbmc.python.script
|provides=
|Summary=Add Video Extras to your Movies and TV shows.
|Description=Provides a way to add Video Extras to your Video library. Look at the wiki for setup instructions.
|Platform=all
|Language=
|License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991
|Forum=http://forum.kodi.tv/showthread.php?tid=214289
|Website=
|Source=http://robwebset.googlecode.com/svn/trunk/script.videoextras/
|Email=
|broken=
|icon url=http://mirrors.kodi.tv/addons/gotham/script.videoextras/icon.png}}


 
== Introduction ==
VideoExtras is an addon to allow you to store, list and play the "extras" for a given Movie or TV Series. (i.e. The extras that often come on DVD's or Blu-Rays)

 
== Forum and Issue Report Pages ==
If you have any questions, found an issue to report or would just like to know a little more you can take part in the forum discussions at:

:[http://forum.kodi.tv/showthread.php?tid=214289 VideoExtras Forum]

 
== Quickstart Guide ==
This Quickstart guide is aimed at first time users of VideoExtras, who also have some freedom to re-arrange their video content to fit best with VideoExtras.
==== Install VideoExtras ====
VideoExtras is in the official repo, so you should be able to install it like any other addon.
==== Arranging Your Video Files ====
Although VideoExtras will support most structures (with various configuration changes), the easiest and best structure is as follows:

:''../<Movie Name>/movie-name.avi''
:''../<Movie Name>/Extras/extras-name-1.avi''
:''../<Movie Name>/Extras/extras-name-2.avi''
:''...''
More details of extras setup can be found in the [[Add-on:VideoExtras#File_Naming_Convention|File Naming Convention Section]]
==== Stopping The Extras Being Scanned Into Your Library ====
Now that you have copied your Extras files into the correct directories, you do not want them to be accidently picked up/scanned as a Movie or TV Series in their own right. To stop this you need to add "excludes" into the advancedsettings.xml file. This can be done for you by click on the [[Add-on:VideoExtras#Extras|"Update advancedsettings.xml File"]] operation on the first tab of the VideoExtras settings, or you could always do it yourself [[Add-on:VideoExtras#XBMC_File_Exclusions|manually]].
==== Scanning Media Into Your Library ====
Once you have updated the advancedsettings.xml file it should now be safe to perform any scans you wish to pull media into your library. At this point, the scanner should skip over any Extras files.
==== Viewing Your Extras ====
In order to view the Extras you have now stored with your Movies or TV Shows you will need one of the following 2 things:
* To update the default Confluence Skin, this can either be done [[Add-on:VideoExtras#Skin_Modifications|manually]] or by navigating to the Advanced tab of the VideoExtras settings and clicking on [[Add-on:VideoExtras#Advanced|"Update Confluence Skin"]].
* Use one of the non default [[Add-on:VideoExtras#Skins_With_Build_In_Support|skins that has built in support]] for VideoExtras
==== You Are Now Up And Running ====
That's it! You should now be able to navigate to your extras by either going to the Video Information Dialog for the given video, or by going via: ''[[Add-on:VideoExtras#Video_Extras_Browser|Videos -> Addons -> VideoExtras]]''
 
There are plenty more things you can do to improve your user experience such as adding [[Add-on:VideoExtras#Images:_Thumbnails.2C_Icons_and_Fanart|icons/fanart/thumbnails]] or giving detailed [[Add-on:VideoExtras#NFO_Files|titles or plots]]. However, this is a quickstart guide, and you should take a look at the rest of the wiki for those features.
 
 
== Using VideoExtras ==
Now that you have [[Add-on:VideoExtras#Quickstart_Guide|configured]] VideoExtras, you can start using it. If you are using Confluence with the supplied [[Add-on:VideoExtras#Viewing_Your_Extras|Confluence update]] then any Movies or TV Shows that have extras will be highlighted with an overlay image:
<center> [[File:VideoExtras-ThumbnailOverlay.JPG|200px]]</center>
 Then if you navigate into the Video Information Screen you should see an Extras button available:
<center> [[File:VideoExtras-VideoInfoDialog.JPG|400px]]</center>
 Selecting this button will then result in seeing the list of extras available:
<center> [[File:VideoExtras-DetailedListScreen.JPG|400px]]</center>
 
 
== Video Extras Browser ==
The VideoExtras browser allows you to view all the Movies/Tv Shows/Music Videos that have extras, and then watch those extras. You can load the extras browser in the following ways:
# Via the [[Add-on:VideoExtras#Database|VideoExtras Settings screen]] "Database" -> "Browse Extras"
# From the Programs Menu -> VideoExtras
# Videos -> Addons -> VideoExtras
 
 
== Settings ==
This section details all the settings options for VideoExtras
==== Extras ====
{| border="0"
|- valign=top
|
:'''Extras Directory Name'''
::The name of the sub directory that stores all the extras files
:'''Search Nested Directories'''
::If directories below the selected TV Show or Movie should be searched for more extras. This is useful if you select a given TV Show and have all your seasons for that show in separate directories under that show. This means that all extras will be displayed when viewed via the root TV Show, and only the seasons extras if selected from inside a given season.
:'''Enable Extras with File Tag'''
::Finds extras based on a "tag", listing anything containing that tag
:'''Extras File Name Tag'''
::If "Enable Extras with File Tag" was enabled, this gives the name to search for as the tag
:'''Use Detailed List Screen'''
::Displays a more advanced listing screen which displays resume points and a watched flag
:'''Window to show after exiting detailed list'''
::(If detailed list screen is enabled) - Which screen to go to after exiting the detailed list screen, options are: "Video Selection", "Information", "Home"
:'''Menu to show after playing an extra'''
::(If detailed list screen is disabled) - Which screen to go to after playing an extra, options are: "Extras", "Video Selection", "Information", "Home"
:'''''Operations'''''
::
:'''Update advancedsettings.xml File'''
::Will update (or create if it does not already exist) the advancedsettings.xml file so that your extras files are not accidently read into the library and incorrectly detected as actual Movies or TV Shows
| [[File:VideoExtras-Settings1.JPG|400px]]
|}
==== File System ====
{| border="0"
|- valign=top
|
:'''Use Custom Extras Location'''
::If extras are not stored with the Movies/TV Shows, this allows them to be stored in a different directory structure.
:'''Path'''
::The path that the extras are located in (Only if ''"Use Custom Extras Location"'' is enabled)
:'''Custom Movies Sub-Folder'''
::The name of the folder under the ''"Path"'' where Movie extras are stored (Note: a directory with the movie name will be located under this directory containing the extras for that movie)
:'''Custom TV Shows Sub-Folder'''
::The name of the folder under the ''"Path"'' where TV Shows extras are stored (Note: a directory with the TV Show name will be located under this directory containing the extras for that TV Show)
:'''Custom Music Video Sub-Folder'''
::The name of the folder under the ''"Path"'' where Music Video extras are stored (Note: a directory with the Music Video name will be located under this directory containing the extras for that Music Video)
:'''''Debugging'''''
::
:'''Enable Debug logging'''
::Enables VideoExtras debug logging into the Kodi log file
| [[File:VideoExtras-Settings2.JPG|400px]]
|}
==== Database ====
{| border="0"
|- valign=top
|
:'''Enable Database Support'''
::Enables the use of the Extras stand-alone database, this enables the display and storing of data such as
:::* Which extras have been viewed already
:::* Resume playing an extra from the last stop point
:'''''Operations'''''
::
:'''Clean Database'''
::Clears the extras database (resets all play states for the extras) - Note: This does not do anything to the default Kodi database.
:'''Browse Extras'''
::Loads the Video Extras Browser plugin.
| [[File:VideoExtras-Settings3.JPG|400px]]
|}
==== Advanced ====
{| border="0"
|- valign=top
|
:'''Force Extras Button Display'''
::Will always display the "Extras" button on the Video Information screen (Normal behaviour is to only show the button if there are extra's detected for the given video.
:'''Exclude Files Regular Expression'''
::Regular expression for files that will be deemed "Not to be extras" even if there are present in the Extras directory.
:'''Allow caching of extras on startup'''
::Used to cache the video extras available so that it can be used for icon overlays in some skins, if you do not wish to see icon overlays (or do not use a skin that supports them) then disable this option.
:'''Use Custom Images'''
::Allows you to change the images used in the skin to highlight if extras exist (Note: Changing these values will only be visable after a restart of Kodi)
:'''- Overlay Image'''
::(If Use Custom Images is enabled) The image that is drawn over the top of the thumbnail/cover
:'''- List Image'''
::(If Use Custom Images is enabled) The image that is used when adding to a list
:'''''Operations'''''
::
:'''Update Confluence Skin'''
::Will add VideoExtras support to the default confluence skin
| [[File:VideoExtras-Settings4.JPG|400px]]
|}
 
 
== File Naming Convention ==
For your video extras files to be found they must follow a specific naming convention. VideoExtras currently supports extras videos from Movies, TV Shows and Music Videos. Here are the supported conventions:
 
=== Extras Folder ===
''(Recommended Method)''
 
If you put all of your movies in their own folder you can simply add an "Extras" sub folder and add all of your bonus content in that directory. (The name of this folder can be changed via the settings menu). The script will simply display the filename (without extension) in the UI. By default the list of videos will appear in alphabetical order.
 
=== Same Directory ===

If for some reason you don't want to create an "Extras" folder or you want to associate a bonus feature with a specific TV show episode there is an alternative naming convention. Simply use the same name as the file you want to associate the extra feature with and then append "-extras-". (This tag can be changed via the settings menu)
 
=== Remote Location ===

If you did not want your extras stored in the same directory structure as your Movies, TV Shows or Music Videos, then there is a settings option "Use Custom Extras Location" that can be set to point to a different location. The format of this location should have 3 directories at the top level: "Movies", "TvShows" and "MusicVideos". Under each of these should be directories (That match the name of the directories containing the Movies,TV Shows and Music Videos) containing the extras files.
 
e.g.

:Movies/Die Hard
:TvShows/Blake's 7
:TvShows/Blake's 7/Series 1
:TvShows/Blake's 7/Series 2

In this case, when clicking on the "TV Information" for the whole Blake's 7 Series you would see all files in "TvShows/Blake's 7" and the two sub-folders (if nested search is enabled), if viewing Episode Information for an episode in series 1 of Blake's 7 then you would only see the extras in "Blake's 7/Series 1"
 
 
With this method (based on where this root directory is), there may not be a need to add the "File Exclusions" section into [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings].
 
 

== XBMC File Exclusions ==

Since these are video files sprinkled in among all of your other video files we need to tell the xbmc scanner to ignore these files. If we don't then the scanner will try and match them up with one of the online sites and you probably won't be happy with the results. To do this we just need to add some new regular expressions to the [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings]. It is recommended to add these settings and reboot xbmc for them to take effect BEFORE any library scan takes place, so the scanner doesn't try to parse them.

<source lang="xml">
<advancedsettings>
<video>
<excludefromscan action="append">
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>/extras/</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludefromscan>
<excludetvshowsfromscan action="append">
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>/extras/</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludetvshowsfromscan>
</video>
</advancedsettings>
</source>

''In this example the default name "Extras" has been used for the directory containing the extras, if you have changed this in the settings, then this name should also be changed to match.''

Obs.:

1) If you executed a library scan before the regexps have been put in place and found extra material accidentally scanned to your library, you can either remove/rename the extra material and conduct a 'clean library' under XBMC video settings or, delete the video sources and rescan them again after the regexps are operating properly.

2) Beware that if any of your sources contains the word 'extras' in it, e.g. a source named 'Extrasy' or 'Extrascent', nothing new that you put in it will be scanned to the library. This is because that source matches the exclude rule RegExp:'Extras'. To solve this either rename your source or change the default name 'extras', which VideoExtras operates with, to anything different.
 
 

== Images: Thumbnails, Icons and Fanart ==
=== Custom Artwork ===
In order to have thumbnails or custom fanart images displayed on your Extras listings (and player overlay) you can either reference them via an NFO file (see NFO section), or by having the image in the same directory as the extras file. Images referenced via NFO (locally or remotely) will have priority over any other. Thumbnail/icon images in the same directory as extras will be picked up in the following order:

* <filename>.tbn/png/jpg
* <filename>-poster.tbn/png/jpg
* <filename>-thumb.tbn/png/jpg
* poster.tbn/png/jpg (assigns same thumb to all those extras without one)
* folder.tbn/png/jpg (assings same thumb to all those extras without one)

For fanart, the images are picked up in the following order :
* <filename>-fanart.tbn/png/jpg
* fanart.tbn/png/jpg

obs: should you experience image caching persistency of old <filename>-poster/thumb.ext after replacing them by new ones at folder level, this is due to the way XBMC handles the caching of certain images. If you need an immediate solution and don't want to wait for XBMC to cache the new images, there is a script available that solves this issue at database level [http://Just%20to%20help%20with%20the%20cleansing%20of%20thumbs%20cached%20in%20XBMC%20to%20allow%20VideoExtras%20to%20display%20updated%20thumbs%20for%20your%20extras here] called Texture Cache Maintenance utility by MilhouseVH. There aren't cases reported of image caching persistency when using the naming convention <filename>.tbn/png/jpg

=== Default Artwork ===
* '''If no custom fanart:''' fanart is automatically inherited from the parent video file, if there's any.
* '''If no custom thumb (poster):''' default thumb is VideoExtras image icon and will only be displayed in the video overlay whilst playing the extra and not in the extras list.
 
 

== NFO Files ==

The recommended method to give a name or sort order to your "Extras" is to add an NFO for each extra file. This follows the standard XBMC method of having the same name as the file with the extension being replaced with ".nfo" (Sitting in the same directory as the original file). This nfo can take any of the followoing formats (These are in line with the default XBMC behaviour), additional data in these files will be ignored as it is not relevant for the extras file. (Note: The only mandatory element is the "title")

=== Movie NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<movie>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<plot>Something happens</plot>
<thumb>thumbnail.jpg</thumb>
<fanart>background.jpg</fanart>
</movie>
</source>

=== TV Show NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<tvshow>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<plot>Something happens</plot>
<thumb>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</thumb>
<fanart>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</fanart>
</tvshow>
</source>

=== TV Episode NFO Format ===
<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<episodedetails>
<title>Who knows</title>
<season>2</season>
<episode>1</episode>
<plot>Something happens</plot>
<thumb>C:\MyThumbs\Who.Knows.tbn</thumb>
<fanart>C:\MyFanart\myart.png</fanart>
</episodedetails>
</source>

=== Legacy Naming Format ===
The following are the legacy naming formats, they are supported in the short term only to allow easy migration from DVDExtras to VideoExtras. (If an NFO file is specified, the settings in that file will be used)
 
 
By default the list of videos will appear in alphabetical order. If you would like to specify a custom order just start the filename with brackets containing the text to sort on. For example you could create files "[0]Deleted Scenes.mkv", "[1]Bloopers.mkv", and "[2]Behind The Scenes.mkv". In this case instead of sorting on the name it will sort on the numbers. The bracket portion of the filename will not be displayed in the UI.
 
 
For extras tagged on a per file basis (rather and all in a sub-directory) the name will be taken from anything after the extras tag. So append "-extras-Display name here" will result in the name "Display name here". To customize the order here you can use the same format as the extras folder. Example: "s01e01-extras-[99]Extended Pilot.mkv"
 
 
== "videoextras.nfo" Files ==

If you do not have your video extras files stored in a standard location (as already described in the previous sections) then it is possible to create a file with the name "videoextras.nfo" in the same directory as your Movie or TV Show. This file must be of the following format:

<source lang="xml">
<?xml version='1.0' encoding='UTF-8'?>
<videoextras>
<file>..\..\Extras\Extras01.mkv</file>
<directory>C:\Kodi\Sample-Data\Movies\Extras</directory>
</videoextras>
</source>

You can have multiple "file" or "directory" entries in the "videoextras.nfo" file (or none of one type). The "file" will result in just the given file being listed in the extras. The "directory" will result in the entire contents of the directory being listed.
=== Common extras content for Movie Sets ===
The videoextras.nfo's capabilities are useful to assign common extras content to movies within a set (collection), thus we would have only one physical copy of the 'Extras' folder somewhere whilst each videoextras.nfo is pointing at it.
 
 
== Skin Information ==
=== Skins With Build In Support ===
The following skins (except Confluence, since it requires the hooks) have built-in support for Video Extras , so require no user skin modifications:

{| class="wikitable"
|-
! Skin !! Hook Support !! Detailed Screen Support !! Detailed Screen Skin Location !! Hooks Location
|-
| [[Add-on:Confluence|Confluence]] || <center>No</center>|| <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/xbmc/xbmc/blob/master/addons/skin.confluence/720p/DialogVideoInfo.xml DialogVideoInfo.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=145080 Confluence Modified] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=139712 Immersive] || <center>Yes</center> || <center>Yes</center> || <center>Immersive</center> || <center>[https://github.com/Sranshaft/skin.immersive/blob/master/720p/DialogVideoInfo.xml DialogVideoInfo.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=165481 Xperience1080++] || <center>Yes</center> || <center>Yes</center> || <center>Xperience1080++</center> || <center></center>
|-
| [[Add-on:Aeon_MQ_5|Aeon MQ 5]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center></center>
|-
| [[Add-on:Aeon_Nox|Aeon Nox 5]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/BigNoid/Aeon-Nox/blob/master/1080i/custom_1119_ExtrasDialog.xml custom_1119_ExtrasDialog.xml]</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=185290 Aeon Nox 4.1.9.x] || <center>Yes</center> || <center>Yes</center> || <center>Aeon Nox 4.1.9.x</center> || <center></center>
|-
| [[Add-on:Rapier|Rapier]] || <center>Yes</center> || <center>Yes</center> || <center>Rapier</center> || <center></center>
|-
| [http://forum.xbmc.org/showthread.php?tid=170954 Artic mk. ii] || <center>Yes</center> || <center>Yes</center> || <center>Artic</center> || <center></center>
|-
| [[Add-on:Metropolis| Metropolis]] ([http://forum.xbmc.org/showthread.php?tid=99317&pid=1726112#pid1726112 coming soon!]) || <center></center> || <center></center> || <center></center> || <center></center>
|-
| [[Add-on:XTV-SAF| xTV-SAF]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center></center>
|-
| [[Add-on:Transparency!|Transparency!]] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center> || <center>[https://github.com/ronie/skin.transparency/blob/master/720p/custom_DialogExtras.xml custom_DialogExtras.xml]</center>
|}
 
If your skin does not support the "Detailed List Screen", then you can either:
# Switch the "Detailed List Screen" off - reverting to the basic list dialog
# Convert the Window XML file in the addon and post a link to it in the forum.
# Use the default "Detailed List Screen" (May not fit in visually with the skin you are using)

Obs: due to a natural delay between the dates of release of possible latest features (and fixed issues too) and actual implementation of these updates in the supported skins, such as support for Music Videos, these skins may still require some manual changes as per [[Add-on:VideoExtras#Skin_Modifications|item 10.2]] in certain skins with built-in support.
 
 

=== Confluence Skin Support ===
A request has been made to the XBMC official repo to have VideoExtras included in the Confluence skin:
https://github.com/xbmc/xbmc/pull/4827
Unfortunately this did not get approved to go into the official repository.
 
 
Instead of this, there is an option that will update the Confluence skin for you in the settings. Just navigate to the [[Add-on:VideoExtras#Advanced|"Update Confluence Skin"]] operation in the VideoExtras settings.
 
 
Note: For this update to work, the directory containing the Confluence skin must have write permissions set.
As Confluence is the default skin, it's directory is not user modifiable on non-Windows systems.
To get around this, it is recommended to copy the Confluence skin's directory from it's existing location
to the standard location for user installed add-ons:
On Ubuntu Linux, the operation would be to copy the directory "/usr/share/kodi/addons/skin.confluence/"
to "/home/<username>/.kodi/addons/".
Upon restarting Kodi, you should now be able to use the "Update Confluence Skin" feature.
 

=== Skin Modifications ===
A skin modification is required in order to see the extras button in the UI and enjoy all the features. This is a fairly simple process but will depend on your selected skin. The file that needs modified is DialogVideoInfo.xml. This is the code needed for the default confluence skin.

Add to the top of the file (after <window>):
<source lang="xml">
<onload condition="System.HasAddon(script.videoextras)">
XBMC.RunScript(script.videoextras,check,"$INFO[ListItem.FilenameAndPath]")</onload>
</source>

Add to near the foot of the file after the last control statement:

<source lang="xml">
<control type="button" id="105">
<description>Extras</description>
<include>ButtonInfoDialogsCommonValues</include>
<label>Extras</label>
<onclick>XBMC.RunScript(script.videoextras,display,"$INFO[ListItem.FilenameAndPath]")</onclick>
<visible>System.HasAddon(script.videoextras)
+ [Container.Content(movies) | Container.Content(episodes) | Container.Content(TVShows)
| Container.Content(musicvideos)]
+ IsEmpty(Window(movieinformation).Property("HideVideoExtrasButton"))</visible>
</control>
</source>
You should be able to use something similar for other skins.

==== Location of XML ====
The DialogVideoInfo.xml's location listed by skin:
;Confluence
* '''Ubuntu Linux:''' /home/<username>/.xbmc/addons/skin.confluence/720p/
* '''Ubuntu Linux (alternative):''': /usr/share/xbmc/addons/skin.confluence/720p/
* '''OS X:''' /Applications/XBMC.app/Contents/Resources/XBMC/addons/skin.confluence/720p
* '''Windows 7/8.1:''' Program Files (x86)\XBMC\addons\skin.confluence\720p
;Aeon Nox 4
* '''Ubuntu Linux:''' /home/<username>/.xbmc/addons/skin.aeon.nox/1080i/
* '''Windows 7/8.1:''' Program Files (x86)\XBMC\addons\skin.aeon.nox\1080i\

Obs.: Remember to create a backup of any file before altering it i.e. DialogVideoInfo.xml.old.

=== Icon Overlay on Video List Screen (Advanced Skinners Only) ===
If you are a skinner and wish to add support for some form of indication that a Movie/TV Show has extras, there is a way, it is not perfect but should get the overlays working. The first part is that you need to have "Allow caching of extras on startup" enabled in the VideoExtras settings. You then need the following in your skin:

<source lang="xml">
<control type="image">
<posx>950</posx>
<posy>14</posy>
<width>16</width>
<height>16</height>
<texture fallback="blank.png">$INFO[ListItem.DBID,special://profile/addon_data/script.videoextras/movies/,.png]</texture>
<visible>System.HasAddon(script.videoextras) + Window.IsVisible(Videos) + Container.Content(Movies)</visible>
</control>
</source>

This example would possibly be added to the confluence skin at line 554 to add an icon to movies on the "biglist" screen. There are 3 different values that can be used:

{| class="wikitable"
|-
| movies || Container.Content(Movies)
|-
| tvshows|| Container.Content(TVShows)
|-
| musicvideos|| Container.Content(MusicVideos)
|}

Where the first column supplies the value used in the <texture> element, and the second for the <visible> element.
 
 
There is a default image that is used to represent the existance of Video Extras, but this can be overridden by the skin by putting a file called "videoextras_overlay.png" in the skins "media" directory, or by updating the [[Add-on:VideoExtras#Advanced|VideoExtras settings]].
 
 
IMPORTANT: This is for advanced skinners only, please only post on the forum if you '''own the skin you are trying to update''' - this is because it will require lots of changes to patch an existing skin, and this feature is only intended to support skins that will support VideoExtras "Out Of The Box".
 
 

=== Request To Skinners (Detailed List Screen) ===
VideoExtras uses a custom window to show the extras, I have written the Window XML files for Confluence. With the large array of different skins available it is not possible to write versions for every skin. If you would be willing to support Video Extras I would really like to include a skin specific Window XML file for your skin and would be greatful for any contribution.
 
The files are very small, so hopefully will not take long to convert for your skin.
 
 

== Known Issues ==
=== Cast List In Summary Screen Not Populated ===
There is a known issue that when you return from the detailed list screen that shows the extras back to the summary screen, the Cast section is not populated, the following was posted for this, but there is no solution:
http://forum.kodi.tv/showthread.php?tid=173502
 
 

== Debugging ==
If reporting a problem, please also provide a debug log. To do this you need to enable BOTH:
* XBMC [[Settings/System#Debugging|logging]] from the main setting menu
* VideoExtras debug from the VideoExtras addon settings menu
Please do not paste the log into the forum thread, just link to it.
 
 
== Donations ==
If you have found VideoExtras useful and would like to help support future development and bug fixes, then please feel free to make a small donation. Any donations made will be put towards hardware to enable support and development on different platforms (I can currently only test Windows - however I would like to be able to verify changes on Android and Mac - and this is what donations would go towards)
 
 
Please use the link on the top of the [http://forum.xbmc.org/showthread.php?tid=178717 VideoExtras Forum]
 
 
''Note:'' Donations will not make any difference to the level of support I will give people on the forum - this project is Open Source - and is completely free!!
 
 

[[Category:Frodo add-on repository]]
[[Category:Gotham add-on repository]]
[[Category:Helix add-on repository]]

Add-on:VideoExtras

2014-03-16T20:33:07Z

Rich.T.: /* Skin Modifications */

{{Addon
|Name=VideoExtras
|provider-name=robwebset
|ID=script.videoextras
|latest-version=1.0.4
|extension point=xbmc.python.script
|provides=
|Summary=Add Video Extras to your Movies and TV shows.
|Description=Provides a way to add Video Extras to your Video library. Look at the wiki for setup instructions.
|Platform=all
|Language=
|License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991
|Forum=http://forum.xbmc.org/showthread.php?tid=178717
|Website=
|Source=http://robwebset.googlecode.com/svn/trunk/script.videoextras/
|Email=
|broken=
|icon url=http://mirrors.xbmc.org/addons/frodo/script.videoextras/icon.png}}


 
 
== Forum and Issue Report Pages ==
If you have any questions, found an issue to report or would just like to know a little more you can take part in the forum discussions at:

:[http://forum.xbmc.org/showthread.php?tid=178717 VideoExtras Forum]

If you find any bugs or have an enhancement requests, these can be recorded at the following location:

:[http://code.google.com/p/robwebset/issues/list VideoExtras Google Issue List]

 
 
== File Naming Convention ==
For your video extras files to be found they must follow a specific naming convention. Here are the supported conventions:
 
=== Extras Folder ===
''(Recommended Method)''
 
If you put all of your movies in their own folder you can simply add an "Extras" sub folder and add all of your bonus content in that directory. (The name of this folder can be changed via the settings menu). The script will simply display the filename (without extension) in the UI. By default the list of videos will appear in alphabetical order.
 
=== Same Directory ===

If for some reason you don't want to create an "Extras" folder or you want to associate a bonus feature with a specific TV show episode there is an alternative naming convention. Simply use the same name as the file you want to associate the extra feature with and then append "-extras-". (This tag can be changed via the settings menu)
 
=== Remote Location ===

If you did not want your extras stored in the same directory structure as your Movies or TV Shows, then there is a settings option "Use Custom Extras Location" that can be set to point to a different location. The format of this location should have 2 directories at the top level "Movies" and "TvShows". Under each of these should be directories (That match the name of the directories containing the Movie or TV Shows) containing the extras files.
 
e.g.

:Movies/Die Hard
:TvShows/Blake's 7
:TvShows/Blake's 7/Series 1
:TvShows/Blake's 7/Series 2

In this case, when clicking on the "TV Information" for the whole Blake's 7 Series you would see all files in "TvShows/Blake's 7" and the two sub-folders (if nested search is enabled), if viewing Episode Information for an episode in series 1 of Blake's 7 then you would only see the extras in "Blake's 7/Series 1"
 
 
With this method (based on where this root directory is), there may not be a need to add the "File Exclusions" section into [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings].
 
 
== XBMC File Exclusions ==

Since these are video files sprinkled in among all of your other video files we need to tell the xbmc scanner to ignore these files. If we don't then the scanner will try and match them up with one of the online sites and you probably won't be happy with the results. To do this we just need to add some new regular expressions to the [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings]. It is recommended to add these settings and reboot xbmc for them to take effect before adding the files to your library so the scanner doesn't try to parse them.

<source lang="xml">
<advancedsettings>
<video>
<excludefromscan>
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>Extras</regexp>
<regexp>/extras/</regexp>
<regexp>extras</regexp>
<regexp>-trailer</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludefromscan>
<excludetvshowsfromscan>
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>Extras</regexp>
<regexp>/extras/</regexp>
<regexp>extras</regexp>
<regexp>-trailer</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludetvshowsfromscan>
</video>
</advancedsettings>
</source>

In this example the default name "Extras" has been used for the directory containing the extras, if you have changed this in the settings, then this name should also be changed to match.

Obs.: beware that if any of your sources contains the word 'extras' in it, e.g. a source named 'Extrasy' or 'Extrascent', nothing new that you put in it will be scanned to the library. This is because that source matches the exclude rule RegExp:'Extras'. To solve this either rename your source or change the default name 'extras', which VideoExtras operates with, to anything different.
 
 

== Images: Thumbnails, Icons and Fanart ==
In order to have thumbnails or custom fanart images displayed on your Extras listings (and player overlay) you can either reference them via an NFO file (see NFO section), or by having the image in the same directory as the extras file. Images referenced via NFO (locally or remotely) will have priority over any other. Thumbnail/icon images in the same directory as extras will be picked up in the following order:

* <filename>.tbn/png/jpg
* <filename>-poster.tbn/png/jpg
* <filename>-thumb.tbn/png/jpg
* poster.tbn/png/jpg
* folder.tbn/png/jpg

For fanart, the images are picked up in the following order (if no custom fanart is specified, fanart is automatically inherited from the parent video file, if there's any):

* <filename>-fanart.tbn/png/jpg
* fanart.tbn/png/jpg

 
 
== NFO Files ==

The recommended method to give a name or sort order to your "Extras" is to add an NFO for each extra file. This follows the standard XBMC method of having the same name as the file with the extension being replaced with ".nfo" (Sitting in the same directory as the original file). This nfo can take any of the followoing formats (These are in line with the default XBMC behaviour), additional data in these files will be ignored as it is not relevant for the extras file.

=== Movie NFO Format ===
<source lang="xml">
<movie>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<thumb>thumbnail.jpg</thumb>
<fanart>background.jpg</fanart>
</movie>
</source>

=== TV Show NFO Format ===
<source lang="xml">
<tvshow>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<thumb>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</thumb>
<fanart>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</fanart>
</tvshow>
</source>

=== TV Episode NFO Format ===
<source lang="xml">
<episodedetails>
<title>Who knows</title>
<season>2</season>
<episode>1</episode>
<thumb>C:\MyThumbs\Who.Knows.tbn</thumb>
<fanart>C:\MyFanart\myart.png</fanart>
</episodedetails>
</source>

=== Legacy Naming Format ===
The following are the legacy naming formats, they are supported in the short term only to allow easy migration from DVDExtras to VideoExtras. (If an NFO file is specified, the settings in that file will be used)
 
 
By default the list of videos will appear in alphabetical order. If you would like to specify a custom order just start the filename with brackets containing the text to sort on. For example you could create files "[0]Deleted Scenes.mkv", "[1]Bloopers.mkv", and "[2]Behind The Scenes.mkv". In this case instead of sorting on the name it will sort on the numbers. The bracket portion of the filename will not be displayed in the UI.
 
 
For extras tagged on a per file basis (rather and all in a sub-directory) the name will be taken from anything after the extras tag. So append "-extras-Display name here" will result in the name "Display name here". To customize the order here you can use the same format as the extras folder. Example: "s01e01-extras-[99]Extended Pilot.mkv"
 
 
== Settings ==
This section details all the settings options for VideoExtras
=== Extras ===
:'''Extras Directory Name'''
::The name of the sub directory that stores all the extras files
:'''Search Nested Directories'''
::If directories below the selected TV Show or Movie should be searched for more extras. This is useful if you select a given TV Show and have all your seasons for that show in separate directories under that show. This means that all extras will be displayed when viewed via the root TV Show, and only the seasons extras if selected from inside a given season.
:'''Enable Extras with File Tag'''
::Finds extras based on a "tag", listing anything containing that tag
:'''Extras File Name Tag'''
::If "Enable Extras with File Tag" was enabled, this gives the name to search for as the tag
:'''Use Detailed List Screen'''
::Displays a more advanced listing screen which displays resume points and a watched flag
:'''Window to show after exiting detailed list'''
::(If detailed list screen is enabled) - Which screen to go to after exiting the detailed list screen, options are: "Video Selection", "Information", "Home"
:'''Menu to show after playing an extra'''
::(If detailed list screen is disabled) - Which screen to go to after playing an extra, options are: "Extras", "Video Selection", "Information", "Home"
=== File System ===
:'''Use Custom Extras Location'''
::If extras are not stored with the Movies/TV Shows, this allows them to be stored in a different directory structure.
:'''Path'''
::The path that the extras are located in (Only if ''"Use Custom Extras Location"'' is enabled)
:'''Custom Movies Sub-Folder'''
::The name of the folder under the ''"Path"'' where Movie extras are stored (Note: a directory with the movie name will be located under this directory containing the extras for that movie)
:'''Custom TV Shows Sub-Folder'''
::The name of the folder under the ''"Path"'' where TV Shows extras are stored (Note: a directory with the TV Show name will be located under this directory containing the extras for that TV Show)
=== Database ===
:'''Enable Database Support'''
::Enables the use of the Extras stand-alone database, this enables the display and storing of data such as
:::* Which extras have been viewed already
:::* Resume playing an extra from the last stop point
:'''Clean Database'''
::Clears the extras database (resets all play states for the extras) - Note: This does not do anything to the default XBMC database.
=== Advanced ===
:'''Force Extras Button Display'''
::Will always display the "Extras" button on the Video Information screen (Normal behaviour is to only show the button if there are extra's detected for the given video.
:'''Exclude Files Regular Expression'''
::Regular expression for files that will be deemed "Not to be extras" even if there are present in the Extras directory.
:'''Enable Debug logging'''
::Enables VideoExtras debug logging into the XBMC log file

 
 
== Skin Information ==
=== Skins With Build In Support ===
The following skins have built-in support for Video Extras, so require no user skin modifications:

{| class="wikitable"
|-
! Skin !! Hook Support !! Detailed Screen Support !! Detailed Screen Skin Location
|-
| [[Add-on:Confluence|Confluence]] || <center>No</center>|| <center>Yes</center> || <center>VideoExtras</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=145080 Confluence Modified] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=139712 Immersive] || <center>Yes</center> || <center>Yes</center> || <center>Immersive</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=165481 Xperience1080++] || <center>Yes</center> || <center>Yes</center> || <center>Xperience1080++</center>
|-
| [[Add-on:Aeon_MQ_5|Aeon MQ 5]] || <center>Yes</center> || <center>No</center> || <center>N/A</center>
|-
| [[Add-on:Rapier|Rapier]] || <center>Yes</center> || <center>Yes</center> || <center>Rapier</center>
|}

 
If your skin does not support the "Detailed List Screen", then you can either:
# Switch the "Detailed List Screen" off - reverting to the basic list dialog
# Convert the Window XML file in the addon and post a link to it in the forum.
# Use the default "Detailed List Screen" (May not fit in visually with the skin you are using)
 
 
=== Skin Modifications ===

A skin modification is required in order to see the extras in the UI. This is a fairly simple process but will depend on your selected skin. The file that needs modified is DialogVideoInfo.xml. This is the code needed for the default confluence skin.

To add an [Extras] button to the Confluence skin, edit DialogVideoInfo.xml in:

Ubuntu Linux: /home/<username>/.xbmc/addons/skin.confluence/720p/
OR if not found there, try: /usr/share/xbmc/addons/skin.confluence/720p/
Windows 7: C:\Program Files (x86)\XBMC\addons\skin.confluence\720p\

To add an [Extras] button to the Aeon Nox skin, edit DialogVideoInfo.xml in:

Ubuntu Linux: /home/<username>/.xbmc/addons/skin.aeon.nox/1080i/
Windows 7: C:\Program Files (x86)\XBMC\addons\skin.aeon.nox\1080i\

N.B. Remember to create a backup of any file before altering it i.e. DialogVideoInfo.xml.old.

Add to the top of the file (after <window>):
<source lang="xml">
<onload condition="System.HasAddon(script.videoextras)">
XBMC.RunScript(script.videoextras,check,"$INFO[ListItem.FilenameAndPath]")</onload>
</source>

Add to near the foot of the file after the last control statement:

<source lang="xml">
<control type="button" id="105">
<description>Extras</description>
<include>ButtonInfoDialogsCommonValues</include>
<label>Extras</label>
<onclick>XBMC.RunScript(script.videoextras,display,"$INFO[ListItem.FilenameAndPath]")</onclick>
<visible>System.HasAddon(script.videoextras)
+ [Container.Content(movies) | Container.Content(episodes) | Container.Content(TVShows)]
+ IsEmpty(Window(movieinformation).Property("HideVideoExtrasButton"))</visible>
</control>
</source>
 
You should be able to use something similar for other skins.
 
 
Alterations for other (non confluence) skins:
{| class="wikitable"
|-
! Skin Name !! Changes Different from Confluence
|-
| Aeon Nox 4.x || As per confluence but change "ButtonInfoDialogsCommonValues" to "DialogVideoInfoButton"
|}
 
 

=== Note To Skinners (Optional Feature) ===
If you wish to add an overlay or flag against TV Shows or Movies so that you can see if a given selection has any Extras without going into the Information Dialog, then a call can be made to:

<source lang="xml">
<onload condition="System.HasAddon(script.videoextras)">
XBMC.RunScript(script.videoextras,hasExtras,flag,"$INFO[ListItem.FilenameAndPath]")</onload>
</source>

This will result in the current window (or dialog) getting a property set on it with the name matching "flag" with the value set to "true" if there are extras for the given FilenameAndPath. (No flag will be set if there are no extras)
 
 

=== Request To Skinners (Detailed List Screen) ===
VideoExtras uses a custom window to show the extras, I have written the Window XML files for Confluence. With the large array of different skins available it is not possible to write versions for every skin. If you would be willing to support Video Extras I would really like to include a skin specific Window XML file for your skin and would be greatful for any contribution.
 
The files are very small, so hopefully will not take long to convert for your skin.
 
 

== Debugging ==
If reporting a problem, please also provide a debug log. To do this you need to enable BOTH:
* XBMC [[Settings/System#Debugging|logging]] from the main setting menu
* VideoExtras debug from the VideoExtras addon settings menu
Please do not paste the log into the forum thread, just link to it.
 
 
== Donations ==
If you have found VideoExtras useful and would like to help support future development and bug fixes, then please feel free to make a small donation. Any donations made will be put towards hardware to enable support and development on different platforms (I can currently only test Windows - however I would like to be able to verify changes on Android and Mac - and this is what donations would go towards)
 
 
Please use the link on the top of the [http://forum.xbmc.org/showthread.php?tid=178717 VideoExtras Forum]
 
 
''Note:'' Donations will not make any difference to the level of support I will give people on the forum - this project is Open Source - and is completely free!! Also, this plugin is built on top of XBMC - so please donate to that first.
 
 
== Thanks ==
Thank you to everyone who has assisted with the development of this add-on, From suggestions to testing. Most of all to brentosmith who originally wrote [[Add-on:DVD_Extras|DVDExtras]], the precursor to VideoExtras, although the current VideoExtras doesn't look anything like the original [[Add-on:DVD_Extras|DVDExtras]] it was his original idea.

[[Category:Frodo add-on repository]]

Add-on:VideoExtras

2014-03-16T20:28:04Z

Rich.T.: Added OS paths for DialogVideoInfo.xml in section: Skin Modifications

{{Addon
|Name=VideoExtras
|provider-name=robwebset
|ID=script.videoextras
|latest-version=1.0.4
|extension point=xbmc.python.script
|provides=
|Summary=Add Video Extras to your Movies and TV shows.
|Description=Provides a way to add Video Extras to your Video library. Look at the wiki for setup instructions.
|Platform=all
|Language=
|License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991
|Forum=http://forum.xbmc.org/showthread.php?tid=178717
|Website=
|Source=http://robwebset.googlecode.com/svn/trunk/script.videoextras/
|Email=
|broken=
|icon url=http://mirrors.xbmc.org/addons/frodo/script.videoextras/icon.png}}


 
 
== Forum and Issue Report Pages ==
If you have any questions, found an issue to report or would just like to know a little more you can take part in the forum discussions at:

:[http://forum.xbmc.org/showthread.php?tid=178717 VideoExtras Forum]

If you find any bugs or have an enhancement requests, these can be recorded at the following location:

:[http://code.google.com/p/robwebset/issues/list VideoExtras Google Issue List]

 
 
== File Naming Convention ==
For your video extras files to be found they must follow a specific naming convention. Here are the supported conventions:
 
=== Extras Folder ===
''(Recommended Method)''
 
If you put all of your movies in their own folder you can simply add an "Extras" sub folder and add all of your bonus content in that directory. (The name of this folder can be changed via the settings menu). The script will simply display the filename (without extension) in the UI. By default the list of videos will appear in alphabetical order.
 
=== Same Directory ===

If for some reason you don't want to create an "Extras" folder or you want to associate a bonus feature with a specific TV show episode there is an alternative naming convention. Simply use the same name as the file you want to associate the extra feature with and then append "-extras-". (This tag can be changed via the settings menu)
 
=== Remote Location ===

If you did not want your extras stored in the same directory structure as your Movies or TV Shows, then there is a settings option "Use Custom Extras Location" that can be set to point to a different location. The format of this location should have 2 directories at the top level "Movies" and "TvShows". Under each of these should be directories (That match the name of the directories containing the Movie or TV Shows) containing the extras files.
 
e.g.

:Movies/Die Hard
:TvShows/Blake's 7
:TvShows/Blake's 7/Series 1
:TvShows/Blake's 7/Series 2

In this case, when clicking on the "TV Information" for the whole Blake's 7 Series you would see all files in "TvShows/Blake's 7" and the two sub-folders (if nested search is enabled), if viewing Episode Information for an episode in series 1 of Blake's 7 then you would only see the extras in "Blake's 7/Series 1"
 
 
With this method (based on where this root directory is), there may not be a need to add the "File Exclusions" section into [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings].
 
 
== XBMC File Exclusions ==

Since these are video files sprinkled in among all of your other video files we need to tell the xbmc scanner to ignore these files. If we don't then the scanner will try and match them up with one of the online sites and you probably won't be happy with the results. To do this we just need to add some new regular expressions to the [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings]. It is recommended to add these settings and reboot xbmc for them to take effect before adding the files to your library so the scanner doesn't try to parse them.

<source lang="xml">
<advancedsettings>
<video>
<excludefromscan>
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>Extras</regexp>
<regexp>/extras/</regexp>
<regexp>extras</regexp>
<regexp>-trailer</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludefromscan>
<excludetvshowsfromscan>
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>Extras</regexp>
<regexp>/extras/</regexp>
<regexp>extras</regexp>
<regexp>-trailer</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludetvshowsfromscan>
</video>
</advancedsettings>
</source>

In this example the default name "Extras" has been used for the directory containing the extras, if you have changed this in the settings, then this name should also be changed to match.

Obs.: beware that if any of your sources contains the word 'extras' in it, e.g. a source named 'Extrasy' or 'Extrascent', nothing new that you put in it will be scanned to the library. This is because that source matches the exclude rule RegExp:'Extras'. To solve this either rename your source or change the default name 'extras', which VideoExtras operates with, to anything different.
 
 

== Images: Thumbnails, Icons and Fanart ==
In order to have thumbnails or custom fanart images displayed on your Extras listings (and player overlay) you can either reference them via an NFO file (see NFO section), or by having the image in the same directory as the extras file. Images referenced via NFO (locally or remotely) will have priority over any other. Thumbnail/icon images in the same directory as extras will be picked up in the following order:

* <filename>.tbn/png/jpg
* <filename>-poster.tbn/png/jpg
* <filename>-thumb.tbn/png/jpg
* poster.tbn/png/jpg
* folder.tbn/png/jpg

For fanart, the images are picked up in the following order (if no custom fanart is specified, fanart is automatically inherited from the parent video file, if there's any):

* <filename>-fanart.tbn/png/jpg
* fanart.tbn/png/jpg

 
 
== NFO Files ==

The recommended method to give a name or sort order to your "Extras" is to add an NFO for each extra file. This follows the standard XBMC method of having the same name as the file with the extension being replaced with ".nfo" (Sitting in the same directory as the original file). This nfo can take any of the followoing formats (These are in line with the default XBMC behaviour), additional data in these files will be ignored as it is not relevant for the extras file.

=== Movie NFO Format ===
<source lang="xml">
<movie>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<thumb>thumbnail.jpg</thumb>
<fanart>background.jpg</fanart>
</movie>
</source>

=== TV Show NFO Format ===
<source lang="xml">
<tvshow>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<thumb>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</thumb>
<fanart>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</fanart>
</tvshow>
</source>

=== TV Episode NFO Format ===
<source lang="xml">
<episodedetails>
<title>Who knows</title>
<season>2</season>
<episode>1</episode>
<thumb>C:\MyThumbs\Who.Knows.tbn</thumb>
<fanart>C:\MyFanart\myart.png</fanart>
</episodedetails>
</source>

=== Legacy Naming Format ===
The following are the legacy naming formats, they are supported in the short term only to allow easy migration from DVDExtras to VideoExtras. (If an NFO file is specified, the settings in that file will be used)
 
 
By default the list of videos will appear in alphabetical order. If you would like to specify a custom order just start the filename with brackets containing the text to sort on. For example you could create files "[0]Deleted Scenes.mkv", "[1]Bloopers.mkv", and "[2]Behind The Scenes.mkv". In this case instead of sorting on the name it will sort on the numbers. The bracket portion of the filename will not be displayed in the UI.
 
 
For extras tagged on a per file basis (rather and all in a sub-directory) the name will be taken from anything after the extras tag. So append "-extras-Display name here" will result in the name "Display name here". To customize the order here you can use the same format as the extras folder. Example: "s01e01-extras-[99]Extended Pilot.mkv"
 
 
== Settings ==
This section details all the settings options for VideoExtras
=== Extras ===
:'''Extras Directory Name'''
::The name of the sub directory that stores all the extras files
:'''Search Nested Directories'''
::If directories below the selected TV Show or Movie should be searched for more extras. This is useful if you select a given TV Show and have all your seasons for that show in separate directories under that show. This means that all extras will be displayed when viewed via the root TV Show, and only the seasons extras if selected from inside a given season.
:'''Enable Extras with File Tag'''
::Finds extras based on a "tag", listing anything containing that tag
:'''Extras File Name Tag'''
::If "Enable Extras with File Tag" was enabled, this gives the name to search for as the tag
:'''Use Detailed List Screen'''
::Displays a more advanced listing screen which displays resume points and a watched flag
:'''Window to show after exiting detailed list'''
::(If detailed list screen is enabled) - Which screen to go to after exiting the detailed list screen, options are: "Video Selection", "Information", "Home"
:'''Menu to show after playing an extra'''
::(If detailed list screen is disabled) - Which screen to go to after playing an extra, options are: "Extras", "Video Selection", "Information", "Home"
=== File System ===
:'''Use Custom Extras Location'''
::If extras are not stored with the Movies/TV Shows, this allows them to be stored in a different directory structure.
:'''Path'''
::The path that the extras are located in (Only if ''"Use Custom Extras Location"'' is enabled)
:'''Custom Movies Sub-Folder'''
::The name of the folder under the ''"Path"'' where Movie extras are stored (Note: a directory with the movie name will be located under this directory containing the extras for that movie)
:'''Custom TV Shows Sub-Folder'''
::The name of the folder under the ''"Path"'' where TV Shows extras are stored (Note: a directory with the TV Show name will be located under this directory containing the extras for that TV Show)
=== Database ===
:'''Enable Database Support'''
::Enables the use of the Extras stand-alone database, this enables the display and storing of data such as
:::* Which extras have been viewed already
:::* Resume playing an extra from the last stop point
:'''Clean Database'''
::Clears the extras database (resets all play states for the extras) - Note: This does not do anything to the default XBMC database.
=== Advanced ===
:'''Force Extras Button Display'''
::Will always display the "Extras" button on the Video Information screen (Normal behaviour is to only show the button if there are extra's detected for the given video.
:'''Exclude Files Regular Expression'''
::Regular expression for files that will be deemed "Not to be extras" even if there are present in the Extras directory.
:'''Enable Debug logging'''
::Enables VideoExtras debug logging into the XBMC log file

 
 
== Skin Information ==
=== Skins With Build In Support ===
The following skins have built-in support for Video Extras, so require no user skin modifications:

{| class="wikitable"
|-
! Skin !! Hook Support !! Detailed Screen Support !! Detailed Screen Skin Location
|-
| [[Add-on:Confluence|Confluence]] || <center>No</center>|| <center>Yes</center> || <center>VideoExtras</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=145080 Confluence Modified] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=139712 Immersive] || <center>Yes</center> || <center>Yes</center> || <center>Immersive</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=165481 Xperience1080++] || <center>Yes</center> || <center>Yes</center> || <center>Xperience1080++</center>
|-
| [[Add-on:Aeon_MQ_5|Aeon MQ 5]] || <center>Yes</center> || <center>No</center> || <center>N/A</center>
|-
| [[Add-on:Rapier|Rapier]] || <center>Yes</center> || <center>Yes</center> || <center>Rapier</center>
|}

 
If your skin does not support the "Detailed List Screen", then you can either:
# Switch the "Detailed List Screen" off - reverting to the basic list dialog
# Convert the Window XML file in the addon and post a link to it in the forum.
# Use the default "Detailed List Screen" (May not fit in visually with the skin you are using)
 
 
=== Skin Modifications ===

A skin modification is required in order to see the extras in the UI. This is a fairly simple process but will depend on your selected skin. The file that needs modified is DialogVideoInfo.xml. This is the code needed for the default confluence skin.

To add an [Extras] button to the Confluence skin, edit DialogVideoInfo.xml in:

Ubuntu Linux: /home/<username>/.xbmc/addons/skin.confluence/720p/
Windows 7: C:\Program Files (x86)\XBMC\addons\skin.confluence\720p\

To add an [Extras] button to the Aeon Nox skin, edit DialogVideoInfo.xml in:

Ubuntu Linux: /home/<username>/.xbmc/addons/skin.aeon.nox/1080i/
Windows 7: C:\Program Files (x86)\XBMC\addons\skin.aeon.nox\1080i\

N.B. Remember to create a backup of any file before altering it i.e. DialogVideoInfo.xml.old.

Add to the top of the file (after <window>):
<source lang="xml">
<onload condition="System.HasAddon(script.videoextras)">
XBMC.RunScript(script.videoextras,check,"$INFO[ListItem.FilenameAndPath]")</onload>
</source>

Add to near the foot of the file after the last control statement:

<source lang="xml">
<control type="button" id="105">
<description>Extras</description>
<include>ButtonInfoDialogsCommonValues</include>
<label>Extras</label>
<onclick>XBMC.RunScript(script.videoextras,display,"$INFO[ListItem.FilenameAndPath]")</onclick>
<visible>System.HasAddon(script.videoextras)
+ [Container.Content(movies) | Container.Content(episodes) | Container.Content(TVShows)]
+ IsEmpty(Window(movieinformation).Property("HideVideoExtrasButton"))</visible>
</control>
</source>
 
You should be able to use something similar for other skins.
 
 
Alterations for other (non confluence) skins:
{| class="wikitable"
|-
! Skin Name !! Changes Different from Confluence
|-
| Aeon Nox 4.x || As per confluence but change "ButtonInfoDialogsCommonValues" to "DialogVideoInfoButton"
|}
 
 
=== Note To Skinners (Optional Feature) ===
If you wish to add an overlay or flag against TV Shows or Movies so that you can see if a given selection has any Extras without going into the Information Dialog, then a call can be made to:

<source lang="xml">
<onload condition="System.HasAddon(script.videoextras)">
XBMC.RunScript(script.videoextras,hasExtras,flag,"$INFO[ListItem.FilenameAndPath]")</onload>
</source>

This will result in the current window (or dialog) getting a property set on it with the name matching "flag" with the value set to "true" if there are extras for the given FilenameAndPath. (No flag will be set if there are no extras)
 
 

=== Request To Skinners (Detailed List Screen) ===
VideoExtras uses a custom window to show the extras, I have written the Window XML files for Confluence. With the large array of different skins available it is not possible to write versions for every skin. If you would be willing to support Video Extras I would really like to include a skin specific Window XML file for your skin and would be greatful for any contribution.
 
The files are very small, so hopefully will not take long to convert for your skin.
 
 

== Debugging ==
If reporting a problem, please also provide a debug log. To do this you need to enable BOTH:
* XBMC [[Settings/System#Debugging|logging]] from the main setting menu
* VideoExtras debug from the VideoExtras addon settings menu
Please do not paste the log into the forum thread, just link to it.
 
 
== Donations ==
If you have found VideoExtras useful and would like to help support future development and bug fixes, then please feel free to make a small donation. Any donations made will be put towards hardware to enable support and development on different platforms (I can currently only test Windows - however I would like to be able to verify changes on Android and Mac - and this is what donations would go towards)
 
 
Please use the link on the top of the [http://forum.xbmc.org/showthread.php?tid=178717 VideoExtras Forum]
 
 
''Note:'' Donations will not make any difference to the level of support I will give people on the forum - this project is Open Source - and is completely free!! Also, this plugin is built on top of XBMC - so please donate to that first.
 
 
== Thanks ==
Thank you to everyone who has assisted with the development of this add-on, From suggestions to testing. Most of all to brentosmith who originally wrote [[Add-on:DVD_Extras|DVDExtras]], the precursor to VideoExtras, although the current VideoExtras doesn't look anything like the original [[Add-on:DVD_Extras|DVDExtras]] it was his original idea.

[[Category:Frodo add-on repository]]

Add-on:VideoExtras

2014-01-01T18:36:44Z

Rich.T.: Added Links

{{Addon
|Name=VideoExtras
|provider-name=robwebset
|ID=script.videoextras
|latest-version=1.0.1
|extension point=xbmc.python.script
|provides=
|Summary=Add Video Extras to your Movies and TV shows.
|Description=Provides a way to add Video Extras to your Video library. Look at the wiki for setup instructions.
|Platform=all
|Language=
|License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991
|Forum=http://forum.xbmc.org/showthread.php?tid=178717
|Website=
|Source=http://robwebset.googlecode.com/svn/trunk/script.videoextras/
|Email=
|broken=
|icon url=http://mirrors.xbmc.org/addons/frodo/script.videoextras/icon.png}}


 
 
== Forum and Issue Report Pages ==
If you have any questions, found an issue to report or would just like to know a little more you can take part in the forum discussions at:

:[http://forum.xbmc.org/showthread.php?tid=178717 VideoExtras Forum]

If you find any bugs or have an enhancement requests, these can be recorded at the following location:

:[http://code.google.com/p/robwebset/issues/list VideoExtras Google Issue List]

 
 
== File Naming Convention ==
For your video extras files to be found they must follow a specific naming convention. Here are the supported conventions:
 
=== Extras Folder ===
''(Recommended Method)''
 
If you put all of your movies in their own folder you can simply add an "Extras" sub folder and add all of your bonus content in that directory. (The name of this folder can be changed via the settings menu). The script will simply display the filename (without extension) in the UI. By default the list of videos will appear in alphabetical order.
 
=== Same Directory ===

If for some reason you don't want to create an "Extras" folder or you want to associate a bonus feature with a specific TV show episode there is an alternative naming convention. Simply use the same name as the file you want to associate the extra feature with and then append "-extras-". (This tag can be changed via the settings menu)
 
=== Remote Location ===

If you did not want your extras stored in the same directory structure as your Movies or TV Shows, then there is a settings option "Use Custom Extras Location" that can be set to point to a different location. The format of this location should have 2 directories at the top level "Movies" and "TvShows". Under each of these should be directories (That match the name of the directories containing the Movie or TV Shows) containing the extras files.
 
e.g.

:Movies/Die Hard
:TvShows/Blake's 7
:TvShows/Blake's 7/Series 1
:TvShows/Blake's 7/Series 2

In this case, when clicking on the "TV Information" for the whole Blake's 7 Series you would see all files in "TvShows/Blake's 7" and the two sub-folders (if nested search is enabled), if viewing Episode Information for an episode in series 1 of Blake's 7 then you would only see the extras in "Blake's 7/Series 1"
 
 
With this method (based on where this root directory is), there may not be a need to add the "File Exclusions" section into [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings].
 
 
== XBMC File Exclusions ==

Since these are video files sprinkled in among all of your other video files we need to tell the xbmc scanner to ignore these files. If we don't then the scanner will try and match them up with one of the online sites and you probably won't be happy with the results. To do this we just need to add some new regular expressions to the [http://wiki.xbmc.org/index.php?title=Advancedsettings.xml advanced settings]. It is recommended to add these settings and reboot xbmc for them to take effect before adding the files to your library so the scanner doesn't try to parse them.

<source lang="xml">
<advancedsettings>
<video>
<excludefromscan>
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>Extras</regexp>
<regexp>/extras/</regexp>
<regexp>extras</regexp>
<regexp>-trailer</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludefromscan>
<excludetvshowsfromscan>
<regexp>-extras-</regexp>
<regexp>/Extras/</regexp>
<regexp>Extras</regexp>
<regexp>/extras/</regexp>
<regexp>extras</regexp>
<regexp>-trailer</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
<regexp>[\\/]extras[\\/]</regexp>
</excludetvshowsfromscan>
</video>
</advancedsettings>
</source>

In this example the default name "Extras" has been used for the directory containing the extras, if you have changed this in the settings, then this name should also be changed to match.
 
 

== Images: Thumbnails, Icons and Fanart ==
In order to have thumbnails or custom fanart images displayed on your Extras listings (and player overlay) you can either reference them via an NFO file (see NFO section), or by having the image in the same directory as the extras file. Images referenced via NFO (locally or remotely) will have priority over any other. Thumbnail/icon images in the same directory as extras will be picked up in the following order:

* <filename>.tbn/png/jpg
* <filename>-poster.tbn/png/jpg
* <filename>-thumb.tbn/png/jpg
* poster.tbn/png/jpg
* folder.tbn/png/jpg

For fanart, the images are picked up in the following order (if no custom fanart is specified, fanart is automatically inherited from the parent video file, if there's any):

* <filename>-fanart.tbn/png/jpg
* fanart.tbn/png/jpg

 
 
== NFO Files ==

The recommended method to give a name or sort order to your "Extras" is to add an NFO for each extra file. This follows the standard XBMC method of having the same name as the file with the extension being replaced with ".nfo" (Sitting in the same directory as the original file). This nfo can take any of the followoing formats (These are in line with the default XBMC behaviour), additional data in these files will be ignored as it is not relevant for the extras file.

=== Movie NFO Format ===
<source lang="xml">
<movie>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<thumb>thumbnail.jpg</thumb>
<fanart>background.jpg</fanart>
</movie>
</source>

=== TV Show NFO Format ===
<source lang="xml">
<tvshow>
<title>Who knows</title>
<sorttitle>Who knows 1</sorttitle>
<thumb>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</thumb>
<fanart>http://forum.xbmc.org/images/xbmc/xbmc-lettering.png</fanart>
</tvshow>
</source>

=== TV Episode NFO Format ===
<source lang="xml">
<episodedetails>
<title>Who knows</title>
<season>2</season>
<episode>1</episode>
<thumb>C:\MyThumbs\Who.Knows.tbn</thumb>
<fanart>C:\MyFanart\myart.png</fanart>
</episodedetails>
</source>

=== Legacy Naming Format ===
The following are the legacy naming formats, they are supported in the short term only to allow easy migration from DVDExtras to VideoExtras. (If an NFO file is specified, the settings in that file will be used)
 
 
By default the list of videos will appear in alphabetical order. If you would like to specify a custom order just start the filename with brackets containing the text to sort on. For example you could create files "[0]Deleted Scenes.mkv", "[1]Bloopers.mkv", and "[2]Behind The Scenes.mkv". In this case instead of sorting on the name it will sort on the numbers. The bracket portion of the filename will not be displayed in the UI.
 
 
For extras tagged on a per file basis (rather and all in a sub-directory) the name will be taken from anything after the extras tag. So append "-extras-Display name here" will result in the name "Display name here". To customize the order here you can use the same format as the extras folder. Example: "s01e01-extras-[99]Extended Pilot.mkv"
 
 
== Settings ==
This section details all the settings options for VideoExtras
=== Extras ===
:'''Extras Directory Name'''
::The name of the sub directory that stores all the extras files
:'''Search Nested Directories'''
::If directories below the selected TV Show or Movie should be searched for more extras. This is useful if you select a given TV Show and have all your seasons for that show in separate directories under that show. This means that all extras will be displayed when viewed via the root TV Show, and only the seasons extras if selected from inside a given season.
:'''Enable Extras with File Tag'''
::Finds extras based on a "tag", listing anything containing that tag
:'''Extras File Name Tag'''
::If "Enable Extras with File Tag" was enabled, this gives the name to search for as the tag
:'''Use Detailed List Screen'''
::Displays a more advanced listing screen which displays resume points and a watched flag
:'''Window to show after exiting detailed list'''
::(If detailed list screen is enabled) - Which screen to go to after exiting the detailed list screen, options are: "Video Selection", "Information", "Home"
:'''Menu to show after playing an extra'''
::(If detailed list screen is disabled) - Which screen to go to after playing an extra, options are: "Extras", "Video Selection", "Information", "Home"
=== File System ===
:'''Use Custom Extras Location'''
::If extras are not stored with the Movies/TV Shows, this allows them to be stored in a different directory structure.
:'''Path'''
::The path that the extras are located in (Only if ''"Use Custom Extras Location"'' is enabled)
:'''Custom Movies Sub-Folder'''
::The name of the folder under the ''"Path"'' where Movie extras are stored (Note: a directory with the movie name will be located under this directory containing the extras for that movie)
:'''Custom TV Shows Sub-Folder'''
::The name of the folder under the ''"Path"'' where TV Shows extras are stored (Note: a directory with the TV Show name will be located under this directory containing the extras for that TV Show)
=== Database ===
:'''Enable Database Support'''
::Enables the use of the Extras stand-alone database, this enables the display and storing of data such as
:::* Which extras have been viewed already
:::* Resume playing an extra from the last stop point
:'''Clean Database'''
::Clears the extras database (resets all play states for the extras) - Note: This does not do anything to the default XBMC database.
=== Advanced ===
:'''Force Extras Button Display'''
::Will always display the "Extras" button on the Video Information screen (Normal behaviour is to only show the button if there are extra's detected for the given video.
:'''Exclude Files Regular Expression'''
::Regular expression for files that will be deemed "Not to be extras" even if there are present in the Extras directory.
:'''Enable Debug logging'''
::Enables VideoExtras debug logging into the XBMC log file

 
 
== Skin Information ==
=== Skins With Build In Support ===
The following skins have built-in support for Video Extras, so require no user skin modifications:

{| class="wikitable"
|-
! Skin !! Hook Support !! Detailed Screen Support !! Detailed Screen Skin Location
|-
| [[Add-on:Confluence|Confluence]] || <center>No</center>|| <center>Yes</center> || <center>VideoExtras</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=145080 Confluence Modified] || <center>Yes</center> || <center>Yes</center> || <center>VideoExtras</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=139712 Immersive] || <center>Yes</center> || <center>Yes</center> || <center>Immersive</center>
|-
| [http://forum.xbmc.org/showthread.php?tid=165481 Xperience1080++] || <center>Yes</center> || <center>Yes</center> || <center>Xperience1080++</center>
|-
| [[Add-on:Aeon_MQ_5|Aeon MQ 5]] || <center>Yes</center> || <center>No</center> || <center>N/A</center>
|-
| [[Add-on:Rapier|Rapier]] || <center>Yes</center> || <center>Yes</center> || <center>Rapier</center>
|}

 
If your skin does not support the "Detailed List Screen", then you can either:
# Switch the "Detailed List Screen" off - reverting to the basic list dialog
# Convert the Window XML file in the addon and post a link to it in the forum.
 
 
=== Skin Modifications ===

A skin modification is required in order to see the extras in the UI. This is a fairly simple process but will depend on your selected skin. The file that needs modified is DialogVideoInfo.xml. This is the code needed for the default confluence skin.

Add to the top of the file (after <window>):
<source lang="xml">
<onload condition="System.HasAddon(script.videoextras)">
XBMC.RunScript(script.videoextras,check,"$INFO[ListItem.FilenameAndPath]")</onload>
</source>

Add to near the foot of the file after the last control statement:

<source lang="xml">
<control type="button" id="105">
<description>Extras</description>
<include>ButtonInfoDialogsCommonValues</include>
<label>Extras</label>
<onclick>XBMC.RunScript(script.videoextras,display,"$INFO[ListItem.FilenameAndPath]")</onclick>
<visible>System.HasAddon(script.videoextras)
+ [Container.Content(movies) | Container.Content(episodes) | Container.Content(TVShows)]
+ IsEmpty(Window(movieinformation).Property("HideVideoExtrasButton"))</visible>
</control>
</source>
 
You should be able to use something similar for other skins.
 
 
Alterations for other (non confluence) skins:
{| class="wikitable"
|-
! Skin Name !! Changes Different from Confluence
|-
| Aeon Nox 4.x || As per confluence but change "ButtonInfoDialogsCommonValues" to "DialogVideoInfoButton"
|}
 
 
=== Note To Skinners (Optional Feature) ===
If you wish to add an overlay or flag against TV Shows or Movies so that you can see if a given selection has any Extras without going into the Information Dialog, then a call can be made to:

<source lang="xml">
<onload condition="System.HasAddon(script.videoextras)">
XBMC.RunScript(script.videoextras,hasExtras,flag,"$INFO[ListItem.FilenameAndPath]")</onload>
</source>

This will result in the current window (or dialog) getting a property set on it with the name matching "flag" with the value set to "true" if there are extras for the given FilenameAndPath. (No flag will be set if there are no extras)
 
 

=== Request To Skinners (Detailed List Screen) ===
VideoExtras uses a custom window to show the extras, I have written the Window XML files for Confluence. With the large array of different skins available it is not possible to write versions for every skin. If you would be willing to support Video Extras I would really like to include a skin specific Window XML file for your skin and would be greatful for any contribution.
 
The files are very small, so hopefully will not take long to convert for your skin.
 
 

== Debugging ==
If reporting a problem, please also provide a debug log. To do this you need to enable BOTH:
* XBMC [[Settings/System#Debugging|logging]] from the main setting menu
* VideoExtras debug from the VideoExtras addon settings menu
Please do not paste the log into the forum thread, just link to it.
 
 
== Thanks ==
Thank you to everyone who has assisted with the development of this add-on, From suggestions to testing. Most of all to brentosmith who originally wrote [[Add-on:DVD_Extras|DVDExtras]], the precursor to VideoExtras, although the current VideoExtras doesn't look anything like the original [[Add-on:DVD_Extras|DVDExtras]] it was his original idea.

[[Category:Frodo add-on repository]]

Unofficial add-on repositories

2013-09-07T07:47:07Z

Rich.T.: /* Unofficial repositories */

__NOTOC__
XBMC includes an interface to browse remote repositories from where add-ons can be retrieved. The model is similar to the way many current [http://en.wikipedia.org/wiki/Linux Linux] [http://en.wikipedia.org/wiki/Linux_distribution distributions] work, whereby there is a main repository that is the default, and and additional ones may be added by the user. XBMC has two official repositories that are included by default (XBMC.org Add-ons and XBMC.org PVR Add-ons) and are maintained by the [[Team XBMC|XBMC team]] (''Team XBMC'').

== Information for add-on developers ==
# Consider applying to have your add-on included in [[Official add-on repository]].
# If it does not meet the required conditions, consider contacting an owner of an existing unofficial repository and ask if they would be happy to let you distribute your add-on from there.
# You can also create your own repository. See [[HOW-TO:Create a repository for add-ons]] or [[Add-on repositories]], and then add it to the table below for it to show up in the Repositories Installer Add-on.

== How to install additional add-on repositories ==
You can install an individual repository using these instructions: '''[[Add-ons#How to install from a ZIP file]]'''

Another way to install any repository from this list is to just install the '''[[passion:plugin.program.repo.installer|Repositories Installer Add-on]]'''. Once that add-on is installed, you can then install other repositories from within XBMC by browsing to Programs, open the installer and install any repositories you like. You will need to restart XBMC for them to be accessible.

To access the contents of the newly installed repository browse to System > Add-ons > Get Add-ons.

== Unofficial repositories ==
{{Note|
* When adding to the table, try to keep the description as ''short'' and ''accurate'' as possible.
* Also please try to keep it ''alphabetically'' organized according to the ''name column''.}} 
{|border="1" cellpadding="2" cellspacing="0" width="100%"
|-
!Name
!Description
!Owner
!Installable ZIP
!Icons
|-
|[http://code.google.com/p/xbmc-adult/ Adult Add-ons]
|The definitive source for adult oriented add-ons
|Xbmc-Adult
|[http://xbmc-adult.googlecode.com/files/repository.xbmc-adult.zip repository.xbmc-adult.zip]
|[http://wiki.xbmc.org/images/e/e9/Adult_xbmc.png]
|-
|[http://code.google.com/p/mod-skin/ Aeon MQ3/4 Skin Repo]
|Home of the 'Aeon MQ 3/4' skin
|MarcosQui
|[https://mod-skin.googlecode.com/files/repository.mq.zip repository.mq.zip]
|[http://wiki.xbmc.org/images/8/8b/Aeon_MQ2.jpg]
|-
|[http://code.google.com/p/xbmc-repo-agx/ agx's repo]
|Pridetube (Adult/Gay) Addon
|agx
|[http://xbmc-repo-agx.googlecode.com/files/xbmc-repo-agx-1.0.0.zip xbmc-repo-agx-1.0.0.zip]
|[http://xbmc-repo-agx.googlecode.com/git/repository.xbmc-repo-agx/icon.png]
|-
|[http://code.google.com/p/apple-tv2-xbmc/ AJ Video Add-ons]
|Misc video, cricket and Indian specific add-ons that all work on ATV2
|AJ
|[http://apple-tv2-xbmc.googlecode.com/files/repository.googlecode.apple-tv2-xbmc.zip repository.googlecode.apple-tv2-xbmc.zip]
|[http://wiki.xbmc.org/images/c/c8/AJ_Video_Add-ons.png]
|-
|[https://github.com/ampedandwired/ampedandwired-xbmc-repo/ Ampedandwired's Add-ons]
|Rdio addon and others
|ampedandwired
|[https://github.com/ampedandwired/ampedandwired-xbmc-repo/raw/master/repo/repository.ampedandwired/repository.ampedandwired-1.0.0.zip repository.ampedandwired-1.0.0.zip]
|
|-
| [https://github.com/marius-muja/plugin.video.canada.on.demand marius-muja's] fork based on [http://brosemer.org/~odin/xbmc-addons/ Andrepl's] outdated add-on.
|Hosts Canada On Demand plugin w/ 30+ Canadian streaming sites.
|marius-muja, Andrepl
|[https://github.com/marius-muja/plugin.video.canada.on.demand/zipball/master Canada.On.Demand.zip]
|[http://wiki.xbmc.org/images/0/03/Andrepl%27s_Add-ons.png]
|-
|[https://github.com/Angelscry/plugin.program.advanced.launcher Angelscry Add-ons]
|Host of the Advanced Launcher Add-on
|Angelscry
|[http://www.gwenael.org/Repository/repository.angelscry.xbmc-plugins/repository.angelscry.xbmc-plugins-1.2.2.zip repository.angelscry.xbmc-plugins-1.2.2.zip]
|[http://wiki.xbmc.org/images/e/e4/Angelscry_Add-ons.png]
|-
|[https://github.com/hadynz/repository.arabic.xbmc-addons Arabic XBMC Add-on Repository]
|Add-ons for Arabic users
|Hadynz
|[https://github.com/downloads/hadynz/repository.arabic.xbmc-addons/repository.arabic.xbmc-addons-1.0.0.zip repository.arabic.xbmc-addons-1.0.0.zip]
|
|-
|[http://code.google.com/p/xbmc-repo-balinus/ Balinus Repo]
|Host of the Shade skin for Eden
|Balinus
|[http://xbmc-repo-balinus.googlecode.com/files/xbmc-repo-balinus.zip xbmc-repo-balinus-1.0.0.zip]
|
|-
|[http://code.google.com/p/xperience1080/ Black's Repo]
|Xperience1080 skin for nightly builds
|'Black
|[http://xperience1080.googlecode.com/svn/trunk/repository.blacks.zip repository.blacks.zip]
|
|-
|[http://code.google.com/p/bluecop-xbmc-repo/ Bluecop's Repo]
|Misc video add-ons that BlueCop is updating
|BlueCop
|[http://bluecop-xbmc-repo.googlecode.com/files/repository.bluecop.xbmc-plugins.zip repository.bluecop.xbmc-plugins.zip]
|
|-
|[http://code.google.com/p/bossanova808-xbmc-addons/ Bossanova808's Repo]
|XSqueeze - Squeezebox controller/player for XBMC
|Bossanova808
|[http://bossanova808-xbmc-addons.googlecode.com/git/repository-downloads/repository.bossanova808/repository.bossanova808-0.1.6.zip repository.bossanova808.zip]
|[http://bossanova808-xbmc-addons.googlecode.com/git/staging/repository.bossanova808/icon.png]
|-
|[https://code.google.com/p/carb0s-repo/ carb0's Repo]
|NHL Gamecenter Addon
|carb0
|[http://carb0s-repo.googlecode.com/svn/repository.carb0s.zip carb0s-repo.googlecode.com/svn/repository.carb0s.zip]
|
|-
|[http://code.google.com/p/xbmc-catchuptv-au/ CatchUpTV AU Plugins]
|Australian Catchup TV Plugins
|Adammw111
|[https://code.google.com/p/xbmc-catchuptv-au/downloads/list?q=label:repo-installer repository.googlecode.xbmc-catchuptv-au.zip]
|[http://wiki.xbmc.org/images/b/ba/CatchUpTV_AU_Plugins.png]
|-
|[http://code.google.com/p/xbmc-addons-chinese/ Chinese Add-ons Dharma]
|Add-ons for Chinese users
|Taxigps
|[http://xbmc-addons-chinese.googlecode.com/files/repository.googlecode.xbmc-addons-chinese-dharma.zip repository.googlecode.xbmc-addons-chinese-dharma.zip]
|[http://wiki.xbmc.org/images/e/eb/Chinese_Add-ons.png]
|-
|[http://code.google.com/p/xbmc-addons-chinese/ Chinese Add-ons Eden]
|Add-ons for Chinese users
|Taxigps
|[http://xbmc-addons-chinese.googlecode.com/files/repository.googlecode.xbmc-addons-chinese-eden.zip repository.googlecode.xbmc-addons-chinese-eden.zip]
|[http://wiki.xbmc.org/images/e/eb/Chinese_Add-ons.png]
|-
|[http://code.google.com/p/cirrus-extended-repo/ Cirrus Extended Skin]
|Home of the 'Cirrus Extended' skin
|Malexx
|[http://cirrus-extended-repo.googlecode.com/files/xbmc.repro.malexx.zip xbmc.repro.malexx.zip]
|[http://wiki.xbmc.org/images/c/cb/Cirrus_Extended_Skin.png]
|-
|[http://code.google.com/p/xbmc-czech/ Czech Add-ons]
|Add-ons for Czech users
|Tomas.zemres
|[http://xbmc-czech.googlecode.com/files/repository.xbmc-czech.sf.net-0.1.zip repository.xbmc-czech.sf.net-1.0.zip]
|
|-
|[http://code.google.com/p/dandar3-xbmc-addons/ Dandar3 Add-ons]
|Video, picture and program add-ons
|Dan Dare
|[http://dandar3-xbmc-addons.googlecode.com/files/repository.googlecode.dandar3-xbmc-addons.zip repository.googlecode.dandar3-xbmc-addons.zip]
|[http://wiki.xbmc.org/images/e/eb/Chinese_Add-ons.png]
|-
|[http://code.google.com/p/divingmules-repo/ Divingmule Add-ons]
|General Add-ons
|Divingmule
|[http://divingmules-repo.googlecode.com/files/repository.divingmule.addons.zip repository.divingmule.addons.zip]
|
|-
|[http://www.wuala.com/djtoll/xbmcdjtoll/Joggler/Skin/screens/ Djtoll Add-ons]
|Add-on for Joggler - a new skin designed for touch interface with touchscreens
|Djtoll
|[http://content.wuala.com/contents/autobaderborn/xbmcdjtoll/root/xbmc.repo.djtoll.zip xbmc.repo.djtoll.zip]
|[http://wiki.xbmc.org/images/5/55/Djtoll.png]
|-
|[http://code.google.com/p/dmd-xbmc/ DMD-XBMC Add-ons]
|Czech and Slovak TV Archive addons
|derby00
|[https://dmd-xbmc.googlecode.com/files/repository.dmd-xbmcv2.googlecode.com.zip repository.dmd-xbmcv2.googlecode.com.zip]
|
|-
|[https://github.com/Eldorados/eldorado-xbmc-addons/ Eldorado Add-ons]
|General Add-ons
|Eldorado
|[https://github.com/downloads/Eldorados/eldorado-xbmc-addons/repository.eldorado-1.0.2.zip repository.eldorado.zip]
|
|-
|[http://code.google.com/u/112633704571599530507/ Hitchers Repo]
|Host of 'Alaska Revisited', 'XeeBo' and 'Foundation' skins, plus the iPlayer video add-on
|Hitcher
|[http://dl.dropbox.com/u/19745842/Repo/xbmc.repo.hitcher/xbmc.repo.hitcher-4.0.0.zip xbmc.repo.hitcher]
|[http://wiki.xbmc.org/images/f/fc/Hitchers_Repo.png]
|-
|[https://code.google.com/p/hybrid-development-repo/ Hybrid Development Repo]
|Hosts the test builds of the skins Hybrid, Confluence Vertical and Confluence Customizable Mod.
|Mudislander
|[https://hybrid-development-repo.googlecode.com/files/xbmc.repo.hybrid-1.0.0.zip xbmc.repo.hybrid-1.0.0.zip]
|[http://www.brucesplace.me.uk/hybridscreenshots/icon.png]
|-
|[https://github.com/IICUX/xbmc-iptv-plugin/ IPTV Addons]
|Repository for IPTV plugins
|George Popovich (IICUX)
|[https://github.com/IICUX/xbmc-iptv-plugin/blob/master/repository.iptv.plugins.zip?raw=true repository.iptv.plugins.zip]
|
|-
|[http://code.google.com/p/izexbmcaddons/ iZE Add-ons]
|General add-ons
|iZE
|[http://izexbmcaddons.googlecode.com/files/repository.googlecode.izexbmcaddons.zip repository.googlecode.izexbmcaddons.zip]
|[http://wiki.xbmc.org/images/b/b7/IZE_Add-ons.png]
|-
|[https://github.com/xbmc-now/japanese-xbmc-addons Japanese XBMC Addons]
| Download and install Japanese addons
|xbmc_now
|[https://raw.github.com/xbmc-now/japanese-xbmc-addons/master/repo/repository.japanese/repository.japanese-1.0.0.zip repository.japanese.zip]
|[https://raw.github.com/xbmc-now/japanese-xbmc-addons/master/repo/repository.japanese/icon.png]
|-
|[http://code.google.com/p/xbmc-focus/ Jeroen's Repository]
|Home of the reFocus skin
|Jeroen
|[http://xbmc-focus.googlecode.com/files/repository.jeroen.zip repository.jeroen.zip]
|[http://i.imgur.com/kH0Tg.png]
|-
|[https://github.com/Karrade/xbmc-repo Karrade's Addons]
|Home of TV Promos
|Karrade
|[https://github.com/Karrade/xbmc-repo/blob/master/repo/repository.karrade/repository.karrade.zip?raw=true repository.karrade.zip]
|[https://github.com/Karrade/xbmc-repo/raw/master/repo/repository.karrade/icon.png]
|-
|[http://code.google.com/p/xbmc-korea-addons/ Korean Add-ons]
|Add-ons for Korean users
|Xbmc Korea
|[http://xbmc-korea-addons.googlecode.com/files/repository.xbmc-korea.com-1.0.6.zip repository.xbmc-korea.com-1.0.6.zip]
|[http://wiki.xbmc.org/images/a/ac/Korean_Add-ons.png]
|-
|[https://github.com/kuruoujou/kuroshi-xbmc-repo/ Kuroshi's XBMC Repository]
|Home of XBMAL and (maybe) others
|Kuroshi
|[https://github.com/kuruoujou/kuroshi-xbmc-repo/raw/master/repository.kuroshi/repository.kuroshi-1.0.0.zip repository.kuroshi-1.0.0.zip]
|[http://wiki.xbmc.org/images/9/96/Icon.png]
|-
|[http://github.com/lucifurious/xbmc-webinterface.diablo/ Lucifurious Repo]
|Web Interface Repository (My custom and standard)
|Lucifurious
|(Coming Soon!)
|[http://wiki.xbmc.org/images/e/e5/Luxeria_Add-ons.png]
|-
|[http://code.google.com/p/luxeria-repository/ Luxeria Add-ons]
|General add-ons including dvd and bluray ripper
|Linuxluemmel
|[http://luxeria-repository.googlecode.com/files/repository.luxeria.zip repository.luxeria.zip]
|[http://wiki.xbmc.org/images/e/e5/Luxeria_Add-ons.png]
|-
|[http://code.google.com/p/xbmc-addon-repository/ Maruchan's Add-ons]
|General add-ons
|Orokara
|[http://xbmc-addon-repository.googlecode.com/files/repository.unofficial.addons.zip repository.unofficial.addons.zip]
|
|-
|[http://code.google.com/p/xbmc-development-with-passion/ MaxMustermann's Add-ons]
|General add-ons
|MaxMustermann
|[http://xbmc-development-with-passion.googlecode.com/files/repository.MaxMustermann.xbmc-1.0.1.ForRepoInstaller.zip repository.MaxMustermann.xbmc-1.0.1.ForRepoInstaller.zip]
|
|-
|[http://code.google.com/p/membrane-xbmc-repo/ membrane's repository]
|Various video and music streaming addons
|membrane
|[http://membrane-xbmc-repo.googlecode.com/files/repository.membrane.xbmc-plugins.zip repository.membrane.xbmc-plugins.zip]
|
|-
|[http://www.mindmade.org/xbmc.php Mindmade Add-ons]
|Add-ons from mindmade.org including Swiss specific
|Andreas Wetzel
|[http://www.mindmade.org/files/repository.mindmade.zip repository.mindmade.zip]
|[http://wiki.xbmc.org/images/6/6a/Mindmade_Add-ons.png]
|-
|[https://github.com/mortstar/repository-mortstar-addons Mortstar's repo]
|Includes IMDb+Rotten Tomatoes scraper and Spotimc
|Mortstar
|[http://github.com/mortstar/repository-mortstar-addons/raw/master/repository.mortstar.addons-1.2.0.zip repository.mortstar.addons.zip]
|[http://wiki.xbmc.org/images/9/96/Icon.png]
|-
|[http://code.google.com/p/mossy-xbmc-repo/ Mossy's Eden repo]
|Irish TV Player and 4oD (working update of Nibor's version)
|Mossy
|[http://mossy-xbmc-repo.googlecode.com/git-history/eden/release/repository.mossy/repository.mossy.zip repository.mossy.zip]
|[http://mossy-xbmc-repo.googlecode.com/git-history/eden/release/repository.mossy/icon.png]
|-
|[http://code.google.com/p/mossy-xbmc-repo/ Mossy's Frodo repo]
|Irish TV Player and 4oD (working update of Nibor's version)
|Mossy
|[http://mossy-xbmc-repo.googlecode.com/git/release/repository.mossy/repository.mossy.zip repository.mossy.zip]
|[http://mossy-xbmc-repo.googlecode.com/git/release/repository.mossy/icon.png]
|-
|[http://code.google.com/p/sparetime/ Nixa's Add-ons]
|General video add-ons
|Nixa
|[http://sparetime.googlecode.com/files/repository.googlecode.sparetime.zip repository.googlecode.sparetime.zip]
|[http://wiki.xbmc.org/images/c/c8/AJ_Video_Add-ons.png]
|-
|[http://code.google.com/p/xbmc-addons/ Nukas Add-ons]
|General add-ons
|Nuka1195
|[http://xbmc-addons.googlecode.com/svn/packages/repository.googlecode.xbmc-addons.zip repository.googlecode.xbmc-addons.zip]
|[http://wiki.xbmc.org/images/e/eb/Chinese_Add-ons.png]
|-
|[http://killdash9.github.com/xbmc-parental-controls/ Parental Controls Add-on]
|A self-updating parental controls addon.
|killdash9
|[https://github.com/downloads/killdash9/xbmc-parental-controls/script.video.parentalcontrols-1.5.3.zip script.video.parentalcontrols-1.5.3.zip]
|[https://raw.github.com/killdash9/xbmc-parental-controls/master/script.video.parentalcontrols/icon.png]
|-
|[http://passion-xbmc.org/addons/ Passion-XBMC Repo]
|General add-ons, including games, from passion-xbmc.org
|Team Passion-XBMC
|[http://passion-xbmc.org/addons/Download.php/repository.passion.xbmc.org/repository.passion.xbmc.org-2.0.2.zip repository.passion.xbmc.org-2.0.2.zip]
|[http://wiki.xbmc.org/images/f/fd/NIxa%27s_Add-ons.png]
|-
|[http://skins.smartplus.cz/pedja-xbmc/ Pecinko's Repo]
|Quartz skin repository ''(Inactive)''
|Pecinko
|[http://skins.smartplus.cz/pedja-xbmc/download/xbmc.repo.pecinkos-1.0.0.zip xbmc.repo.pecinkos.zip] ''(Dead)''
|
|-
|[https://github.com/pieh/pieh-xbmc-addons pieh Add-on Repository]
|RSS clients for xbmc
|pieh
|[https://github.com/downloads/pieh/pieh-xbmc-addons/repository.pieh.zip repository.pieh.zip]
|
|-
|[https://github.com/hippojay/repository.plexbmc.addons PleXBMC repository]
|Plex integration for xbmc
|hippojay
|[http://erlandssson.nu/repository.plexbmc.addons/xbmc.repo.plexbmc/xbmc.repo.plexbmc-1.0.0.zip xbmc.repo.plexbmc-1.0.0.zip]
|
|-
|[https://github.com/TsUPeR/xbmc-repo Popeye's Repo]
|Addons for streaming video files via Usenet connections, addons include Pneumatic and Newznab
|Popeye
|[https://raw.github.com/TsUPeR/xbmc-repo/master/repo/repository.popeye/repository.popeye-1.0.1.zip repository.popeye-1.0.1.zip]
|
|-
|[https://github.com/vikjon0 QF Add-ons]
|Add-ons for XBMC-Live and Linux
|Vikjon0
|[https://github.com/vikjon0/qf-xbmc-addons/raw/master/repo/repository.qf.addons/repository.qf.addons-1.0.1.zip repository.qf.addons-1.0.1.zip]
|[http://wiki.xbmc.org/images/c/cf/QF_Add-ons.png]
|-
|[http://code.google.com/p/queeup/ Queeup Add-ons]
|General add-ons
|Queeup
|[http://queeup.googlecode.com/files/repository.queeup-1.0.2.zip repository.queeup-1.0.2.zip]
|[http://wiki.xbmc.org/images/3/36/Queeup_Add-ons.png]
|-
|[https://github.com/rasjani/xbmc-rasjanisrepo Rasjani's Repo]
|Finnish & English addons
|rasjani
|[http://www.pcuf.fi/~rasjani/xbmc-rasjanisrepo/repository.rasjanisrepo.xbmc/repository.rasjanisrepo.xbmc-1.0.0.zip repository.rasjanisrepo.xbmc-1.0.0.zip]
|[http://www.pcuf.fi/~rasjani/xbmc-rasjanisrepo/repository.rasjanisrepo.xbmc/icon.png]
|-
|[http://code.google.com/p/ruuks-repo/ ruuk's repo]
|Latest versions of Forum Browser, flickr, Facebook Media, WebViewer, Plugin Slideshow Screensaver, X-Note (Evernote), ShareSocial etc...
|ruuk
|[http://ruuks-repo.googlecode.com/files/ruuk.addon.repository-1.0.0.zip ruuk.addon.repository-1.0.0.zip]
|[http://code.google.com/p/ruuks-repo/source/browse/trunk/repo/ruuk.addon.repository/icon.png]
|-
|[http://sastatv.com Sastatv Repository]
|Live streams and OnDemand media from all over subcontinent
|Sastatv
|[http://sastatv.com/repository.sasatv.addons.zip repository.sasatv.addons.zip]
|[http://sastatv.com/icon.png]
|-
|[https://github.com/ScudLee/scudlee-xbmc-addons ScudLee's Add-on Repository]
|AniDB.net scraper mods
|ScudLee
|[https://github.com/downloads/ScudLee/scudlee-xbmc-addons/repository.scudlee-1.0.0.zip repository.scudlee-1.0.0.zip]
|[https://raw.github.com/ScudLee/scudlee-xbmc-addons/master/repository.scudlee/icon.png]
|-
|[http://code.google.com/p/sd-xbmc/ SD XBMC Repository]
|Add-ons for Polish users
|Plesken
|[http://sd-xbmc.googlecode.com/files/repository.sd-xbmc.org-1.0.1.zip repository.sd-xbmc.org-1.0.1.zip]
|
|-
|[http://code.google.com/p/seppius-xbmc-repo/ Seppius RU Add-ons]
|Add-ons for Russian users
|Seppius
|[http://seppius-xbmc-repo.googlecode.com/files/repository.seppius.zip repository.seppius.zip]
|[http://wiki.xbmc.org/images/b/b2/Seppius_RU_Add-ons.png]
|-
|[http://code.google.com/p/sickbeard-xbmc/ Sickbeard integration into XBMC]
|Repository for downloading the Sickbeard XBMC plugin
|Zach Moore
|[http://sickbeard-xbmc.googlecode.com/files/repository.sickbeard.xbmc-plugins.zip repository.sickbeard.xbmc-plugins.zip]
|[http://i.imgur.com/ogZWC.png]
|-
|[https://github.com/brentosmith/ SmithGeek XBMC Repositories]
|Repositories containing the DVDExtras add-on for associating DVD/BluRay bonus features with movies and TV shows. Theme music support is included.
|Brent Smith
|[https://github.com/brentosmith/xbmc-dvdextras/archive/master.zip master.zip]
|[https://github.com/brentosmith/xbmc-addons/blob/master/Releases/script.dvdextras/icon.png]
|-
|[http://code.google.com/p/smuto/ smuto Repository]
|Add-ons for Polish users
|smuto
|[http://smuto.googlecode.com/files/repository.smuto-1.2.1.zip repository.smuto-1.2.1.zip]
|[http://wiki.xbmc.org/images/1/1e/Smuto.png]
|-
|[http://code.google.com/p/plugin/ stacked Add-on Repository]
|Video Add-ons: PBS, Revision3, TMZ, G4TV, ESPN Video, NBA Video, and Trailer Addict
|stacked
|[http://plugin.googlecode.com/files/repository.stacked.xbmc.addons.zip repository.stacked.xbmc.addons.zip]
|[http://plugin.googlecode.com/git/icon.png]
|-
|[http://dl.dropbox.com/u/112011567/xbmc/ t0mcat Addons]
|Addons by t0mcat - The first one is for displaying the Videoblog of the german vocal-pop group WiseGuys
|t0mcat
|[http://dl.dropbox.com/u/112011567/xbmc/repository.t0mcat.zip repository.t0mcat.zip]
|[http://dl.dropbox.com/u/112011567/xbmc/addons/plugin.video.wiseguys.videoblog/icon.png]
|-
|[https://github.com/t0mm0/t0mm0-xbmc-plugins t0mm0 Addons]
|Addons by t0mm0
|t0mm0
|[https://github.com/downloads/t0mm0/t0mm0-xbmc-plugins/repository.t0mm0-1.0.3.zip repository.t0mm0-1.0.3.zip]
|
|-
|[http://code.google.com/p/repothn/ THN's Addons]
|Addons by THN
|THN
|[http://repothn.googlecode.com/files/repository.googlecode.repothn.zip repository.googlecode.repothn.zip]
|
|-
|[http://code.google.com/p/turkishxbmcscraper/ Turkish Add-ons]
|Add-ons & Scraper for Turkish users
|Drascom
|[http://turkishxbmcscraper.googlecode.com/files/repository.drascom.xbmc-plugins.zip repository.drascom.xbmc-plugins.zip]
|
|-
|[http://code.google.com/p/xbmc-tvshack/ Tvshack Repo]
|Host of the TV Shack add-on
|Pedro Guedes
|[http://xbmc-tvshack.googlecode.com/files/repository.googlecode.xbmc-tvshack.zip repository.googlecode.xbmc-tvshack.zip]
|
|-
|[https://code.google.com/p/urlxl-repo/ urlXL XBMC Addon Repo]
|Cruncyroll Takeout Addon + Dependencies
|Yoshi of the Wire
|[https://urlxl-repo.googlecode.com/files/repository.urlXL.zip repository.urlXL.zip]
|
|-
|[https://github.com/diegofn/wiiego-xbmc-addons/ Wiiego Add-ons]
|Add-ons as Terra Sonora Audio Service (Listen music for free)
|Wiiego
|[https://github.com/diegofn/wiiego-xbmc-addons/blob/master/repo/repository.wiiego/repository.wiiego-1.0.1.zip?raw=true repository.wiiego-1.0.1.zip]
|[https://github.com/diegofn/wiiego-xbmc-addons/raw/master/repo/repository.wiiego/icon.png]
|-
|[http://code.google.com/p/xbmc-doplnky/ XBMC Doplnky]
|Video addons for czech and slovak users
| lzoubek
|[http://xbmc-doplnky.googlecode.com/files/repository.xbmc.doplnky-1.0.3.zip repository.xbmc.doplnky-1.0.3.zip]
|[https://github.com/lzoubek/xbmc-doplnky/raw/master/repository.xbmc.doplnky/icon.png]
|-
|[http://code.google.com/p/repository-xbmcnerds/ XBMCNerds Add-ons]
|General Addons, Cirrus Extended
|TeamXBMCNerds / mad-max
|[http://www.xbmcnerds.com/index.php?page=DownloadDBFileDownload&dataID=100]
|[http://wiki.xbmc.org/images/1/1f/Xbmcnerds.png]
|-
|[http://code.google.com/p/xbmc-dpstream/ Xbxl Addon]
|French video addon : Dpstream
|Xbxl
|[http://xbmc-dpstream.googlecode.com/files/repository.xbxl.zip repository.xbxl.zip]
|
|-
|[http://code.google.com/p/xot-uzg/ XOT:Uzg Add-on]
|Host of an add-on for online TV streaming sites
|Basje
|[http://www.rieter.net/ext/?uri=http://xot.hamans.com/net.rieter.xot.repository-1.0.1.zip net.rieter.xot.repository-1.0.1.zip]
|[http://wiki.xbmc.org/images/7/75/XOTUzg_Add-on.png]
|-
|[https://github.com/Xycl Xycl Add-ons]
| WDR Rockpalast concerts, My Pictures Database and ListenLive.eu
|Xycl
|[https://github.com/Xycl/repository.xycl.addons/raw/master/repository.xycl.addons/repository.xycl.addons-1.0.9.zip repository.xycl.addons.zip]
|[https://github.com/Xycl/repository.xycl.addons/raw/master/repository.xycl.addons/icon.png]
|}

Unofficial add-on repositories

2013-09-07T07:43:55Z

Rich.T.: /* Unofficial repositories */

__NOTOC__
XBMC includes an interface to browse remote repositories from where add-ons can be retrieved. The model is similar to the way many current [http://en.wikipedia.org/wiki/Linux Linux] [http://en.wikipedia.org/wiki/Linux_distribution distributions] work, whereby there is a main repository that is the default, and and additional ones may be added by the user. XBMC has two official repositories that are included by default (XBMC.org Add-ons and XBMC.org PVR Add-ons) and are maintained by the [[Team XBMC|XBMC team]] (''Team XBMC'').

== Information for add-on developers ==
# Consider applying to have your add-on included in [[Official add-on repository]].
# If it does not meet the required conditions, consider contacting an owner of an existing unofficial repository and ask if they would be happy to let you distribute your add-on from there.
# You can also create your own repository. See [[HOW-TO:Create a repository for add-ons]] or [[Add-on repositories]], and then add it to the table below for it to show up in the Repositories Installer Add-on.

== How to install additional add-on repositories ==
You can install an individual repository using these instructions: '''[[Add-ons#How to install from a ZIP file]]'''

Another way to install any repository from this list is to just install the '''[[passion:plugin.program.repo.installer|Repositories Installer Add-on]]'''. Once that add-on is installed, you can then install other repositories from within XBMC by browsing to Programs, open the installer and install any repositories you like. You will need to restart XBMC for them to be accessible.

To access the contents of the newly installed repository browse to System > Add-ons > Get Add-ons.

== Unofficial repositories ==
{{Note|
* When adding to the table, try to keep the description as ''short'' and ''accurate'' as possible.
* Also please try to keep it ''alphabetically'' organized according to the ''name column''.}} 
{|border="1" cellpadding="2" cellspacing="0" width="100%"
|-
!Name
!Description
!Owner
!Installable ZIP
!Icons
|-
|[http://code.google.com/p/xbmc-adult/ Adult Add-ons]
|The definitive source for adult oriented add-ons
|Xbmc-Adult
|[http://xbmc-adult.googlecode.com/files/repository.xbmc-adult.zip repository.xbmc-adult.zip]
|[http://wiki.xbmc.org/images/e/e9/Adult_xbmc.png]
|-
|[http://code.google.com/p/mod-skin/ Aeon MQ3/4 Skin Repo]
|Home of the 'Aeon MQ 3/4' skin
|MarcosQui
|[https://mod-skin.googlecode.com/files/repository.mq.zip repository.mq.zip]
|[http://wiki.xbmc.org/images/8/8b/Aeon_MQ2.jpg]
|-
|[http://code.google.com/p/xbmc-repo-agx/ agx's repo]
|Pridetube (Adult/Gay) Addon
|agx
|[http://xbmc-repo-agx.googlecode.com/files/xbmc-repo-agx-1.0.0.zip xbmc-repo-agx-1.0.0.zip]
|[http://xbmc-repo-agx.googlecode.com/git/repository.xbmc-repo-agx/icon.png]
|-
|[http://code.google.com/p/apple-tv2-xbmc/ AJ Video Add-ons]
|Misc video, cricket and Indian specific add-ons that all work on ATV2
|AJ
|[http://apple-tv2-xbmc.googlecode.com/files/repository.googlecode.apple-tv2-xbmc.zip repository.googlecode.apple-tv2-xbmc.zip]
|[http://wiki.xbmc.org/images/c/c8/AJ_Video_Add-ons.png]
|-
|[https://github.com/ampedandwired/ampedandwired-xbmc-repo/ Ampedandwired's Add-ons]
|Rdio addon and others
|ampedandwired
|[https://github.com/ampedandwired/ampedandwired-xbmc-repo/raw/master/repo/repository.ampedandwired/repository.ampedandwired-1.0.0.zip repository.ampedandwired-1.0.0.zip]
|
|-
| [https://github.com/marius-muja/plugin.video.canada.on.demand marius-muja's] fork based on [http://brosemer.org/~odin/xbmc-addons/ Andrepl's] outdated add-on.
|Hosts Canada On Demand plugin w/ 30+ Canadian streaming sites.
|marius-muja, Andrepl
|[https://github.com/marius-muja/plugin.video.canada.on.demand/zipball/master Canada.On.Demand.zip]
|[http://wiki.xbmc.org/images/0/03/Andrepl%27s_Add-ons.png]
|-
|[https://github.com/Angelscry/plugin.program.advanced.launcher Angelscry Add-ons]
|Host of the Advanced Launcher Add-on
|Angelscry
|[http://www.gwenael.org/Repository/repository.angelscry.xbmc-plugins/repository.angelscry.xbmc-plugins-1.2.2.zip repository.angelscry.xbmc-plugins-1.2.2.zip]
|[http://wiki.xbmc.org/images/e/e4/Angelscry_Add-ons.png]
|-
|[https://github.com/hadynz/repository.arabic.xbmc-addons Arabic XBMC Add-on Repository]
|Add-ons for Arabic users
|Hadynz
|[https://github.com/downloads/hadynz/repository.arabic.xbmc-addons/repository.arabic.xbmc-addons-1.0.0.zip repository.arabic.xbmc-addons-1.0.0.zip]
|
|-
|[http://code.google.com/p/xbmc-repo-balinus/ Balinus Repo]
|Host of the Shade skin for Eden
|Balinus
|[http://xbmc-repo-balinus.googlecode.com/files/xbmc-repo-balinus.zip xbmc-repo-balinus-1.0.0.zip]
|
|-
|[http://code.google.com/p/xperience1080/ Black's Repo]
|Xperience1080 skin for nightly builds
|'Black
|[http://xperience1080.googlecode.com/svn/trunk/repository.blacks.zip repository.blacks.zip]
|
|-
|[http://code.google.com/p/bluecop-xbmc-repo/ Bluecop's Repo]
|Misc video add-ons that BlueCop is updating
|BlueCop
|[http://bluecop-xbmc-repo.googlecode.com/files/repository.bluecop.xbmc-plugins.zip repository.bluecop.xbmc-plugins.zip]
|
|-
|[http://code.google.com/p/bossanova808-xbmc-addons/ Bossanova808's Repo]
|XSqueeze - Squeezebox controller/player for XBMC
|Bossanova808
|[http://bossanova808-xbmc-addons.googlecode.com/git/repository-downloads/repository.bossanova808/repository.bossanova808-0.1.6.zip repository.bossanova808.zip]
|[http://bossanova808-xbmc-addons.googlecode.com/git/staging/repository.bossanova808/icon.png]
|-
|[https://code.google.com/p/carb0s-repo/ carb0's Repo]
|NHL Gamecenter Addon
|carb0
|[http://carb0s-repo.googlecode.com/svn/repository.carb0s.zip carb0s-repo.googlecode.com/svn/repository.carb0s.zip]
|
|-
|[http://code.google.com/p/xbmc-catchuptv-au/ CatchUpTV AU Plugins]
|Australian Catchup TV Plugins
|Adammw111
|[https://code.google.com/p/xbmc-catchuptv-au/downloads/list?q=label:repo-installer repository.googlecode.xbmc-catchuptv-au.zip]
|[http://wiki.xbmc.org/images/b/ba/CatchUpTV_AU_Plugins.png]
|-
|[http://code.google.com/p/xbmc-addons-chinese/ Chinese Add-ons Dharma]
|Add-ons for Chinese users
|Taxigps
|[http://xbmc-addons-chinese.googlecode.com/files/repository.googlecode.xbmc-addons-chinese-dharma.zip repository.googlecode.xbmc-addons-chinese-dharma.zip]
|[http://wiki.xbmc.org/images/e/eb/Chinese_Add-ons.png]
|-
|[http://code.google.com/p/xbmc-addons-chinese/ Chinese Add-ons Eden]
|Add-ons for Chinese users
|Taxigps
|[http://xbmc-addons-chinese.googlecode.com/files/repository.googlecode.xbmc-addons-chinese-eden.zip repository.googlecode.xbmc-addons-chinese-eden.zip]
|[http://wiki.xbmc.org/images/e/eb/Chinese_Add-ons.png]
|-
|[http://code.google.com/p/cirrus-extended-repo/ Cirrus Extended Skin]
|Home of the 'Cirrus Extended' skin
|Malexx
|[http://cirrus-extended-repo.googlecode.com/files/xbmc.repro.malexx.zip xbmc.repro.malexx.zip]
|[http://wiki.xbmc.org/images/c/cb/Cirrus_Extended_Skin.png]
|-
|[http://code.google.com/p/xbmc-czech/ Czech Add-ons]
|Add-ons for Czech users
|Tomas.zemres
|[http://xbmc-czech.googlecode.com/files/repository.xbmc-czech.sf.net-0.1.zip repository.xbmc-czech.sf.net-1.0.zip]
|
|-
|[http://code.google.com/p/dandar3-xbmc-addons/ Dandar3 Add-ons]
|Video, picture and program add-ons
|Dan Dare
|[http://dandar3-xbmc-addons.googlecode.com/files/repository.googlecode.dandar3-xbmc-addons.zip repository.googlecode.dandar3-xbmc-addons.zip]
|[http://wiki.xbmc.org/images/e/eb/Chinese_Add-ons.png]
|-
|[http://code.google.com/p/divingmules-repo/ Divingmule Add-ons]
|General Add-ons
|Divingmule
|[http://divingmules-repo.googlecode.com/files/repository.divingmule.addons.zip repository.divingmule.addons.zip]
|
|-
|[http://www.wuala.com/djtoll/xbmcdjtoll/Joggler/Skin/screens/ Djtoll Add-ons]
|Add-on for Joggler - a new skin designed for touch interface with touchscreens
|Djtoll
|[http://content.wuala.com/contents/autobaderborn/xbmcdjtoll/root/xbmc.repo.djtoll.zip xbmc.repo.djtoll.zip]
|[http://wiki.xbmc.org/images/5/55/Djtoll.png]
|-
|[http://code.google.com/p/dmd-xbmc/ DMD-XBMC Add-ons]
|Czech and Slovak TV Archive addons
|derby00
|[https://dmd-xbmc.googlecode.com/files/repository.dmd-xbmcv2.googlecode.com.zip repository.dmd-xbmcv2.googlecode.com.zip]
|
|-
|[https://github.com/Eldorados/eldorado-xbmc-addons/ Eldorado Add-ons]
|General Add-ons
|Eldorado
|[https://github.com/downloads/Eldorados/eldorado-xbmc-addons/repository.eldorado-1.0.2.zip repository.eldorado.zip]
|
|-
|[http://code.google.com/u/112633704571599530507/ Hitchers Repo]
|Host of 'Alaska Revisited', 'XeeBo' and 'Foundation' skins, plus the iPlayer video add-on
|Hitcher
|[http://dl.dropbox.com/u/19745842/Repo/xbmc.repo.hitcher/xbmc.repo.hitcher-4.0.0.zip xbmc.repo.hitcher]
|[http://wiki.xbmc.org/images/f/fc/Hitchers_Repo.png]
|-
|[https://code.google.com/p/hybrid-development-repo/ Hybrid Development Repo]
|Hosts the test builds of the skins Hybrid, Confluence Vertical and Confluence Customizable Mod.
|Mudislander
|[https://hybrid-development-repo.googlecode.com/files/xbmc.repo.hybrid-1.0.0.zip xbmc.repo.hybrid-1.0.0.zip]
|[http://www.brucesplace.me.uk/hybridscreenshots/icon.png]
|-
|[https://github.com/IICUX/xbmc-iptv-plugin/ IPTV Addons]
|Repository for IPTV plugins
|George Popovich (IICUX)
|[https://github.com/IICUX/xbmc-iptv-plugin/blob/master/repository.iptv.plugins.zip?raw=true repository.iptv.plugins.zip]
|
|-
|[http://code.google.com/p/izexbmcaddons/ iZE Add-ons]
|General add-ons
|iZE
|[http://izexbmcaddons.googlecode.com/files/repository.googlecode.izexbmcaddons.zip repository.googlecode.izexbmcaddons.zip]
|[http://wiki.xbmc.org/images/b/b7/IZE_Add-ons.png]
|-
|[https://github.com/xbmc-now/japanese-xbmc-addons Japanese XBMC Addons]
| Download and install Japanese addons
|xbmc_now
|[https://raw.github.com/xbmc-now/japanese-xbmc-addons/master/repo/repository.japanese/repository.japanese-1.0.0.zip repository.japanese.zip]
|[https://raw.github.com/xbmc-now/japanese-xbmc-addons/master/repo/repository.japanese/icon.png]
|-
|[http://code.google.com/p/xbmc-focus/ Jeroen's Repository]
|Home of the reFocus skin
|Jeroen
|[http://xbmc-focus.googlecode.com/files/repository.jeroen.zip repository.jeroen.zip]
|[http://i.imgur.com/kH0Tg.png]
|-
|[https://github.com/Karrade/xbmc-repo Karrade's Addons]
|Home of TV Promos
|Karrade
|[https://github.com/Karrade/xbmc-repo/blob/master/repo/repository.karrade/repository.karrade.zip?raw=true repository.karrade.zip]
|[https://github.com/Karrade/xbmc-repo/raw/master/repo/repository.karrade/icon.png]
|-
|[http://code.google.com/p/xbmc-korea-addons/ Korean Add-ons]
|Add-ons for Korean users
|Xbmc Korea
|[http://xbmc-korea-addons.googlecode.com/files/repository.xbmc-korea.com-1.0.6.zip repository.xbmc-korea.com-1.0.6.zip]
|[http://wiki.xbmc.org/images/a/ac/Korean_Add-ons.png]
|-
|[https://github.com/kuruoujou/kuroshi-xbmc-repo/ Kuroshi's XBMC Repository]
|Home of XBMAL and (maybe) others
|Kuroshi
|[https://github.com/kuruoujou/kuroshi-xbmc-repo/raw/master/repository.kuroshi/repository.kuroshi-1.0.0.zip repository.kuroshi-1.0.0.zip]
|[http://wiki.xbmc.org/images/9/96/Icon.png]
|-
|[http://github.com/lucifurious/xbmc-webinterface.diablo/ Lucifurious Repo]
|Web Interface Repository (My custom and standard)
|Lucifurious
|(Coming Soon!)
|[http://wiki.xbmc.org/images/e/e5/Luxeria_Add-ons.png]
|-
|[http://code.google.com/p/luxeria-repository/ Luxeria Add-ons]
|General add-ons including dvd and bluray ripper
|Linuxluemmel
|[http://luxeria-repository.googlecode.com/files/repository.luxeria.zip repository.luxeria.zip]
|[http://wiki.xbmc.org/images/e/e5/Luxeria_Add-ons.png]
|-
|[http://code.google.com/p/xbmc-addon-repository/ Maruchan's Add-ons]
|General add-ons
|Orokara
|[http://xbmc-addon-repository.googlecode.com/files/repository.unofficial.addons.zip repository.unofficial.addons.zip]
|
|-
|[http://code.google.com/p/xbmc-development-with-passion/ MaxMustermann's Add-ons]
|General add-ons
|MaxMustermann
|[http://xbmc-development-with-passion.googlecode.com/files/repository.MaxMustermann.xbmc-1.0.1.ForRepoInstaller.zip repository.MaxMustermann.xbmc-1.0.1.ForRepoInstaller.zip]
|
|-
|[http://code.google.com/p/membrane-xbmc-repo/ membrane's repository]
|Various video and music streaming addons
|membrane
|[http://membrane-xbmc-repo.googlecode.com/files/repository.membrane.xbmc-plugins.zip repository.membrane.xbmc-plugins.zip]
|
|-
|[http://www.mindmade.org/xbmc.php Mindmade Add-ons]
|Add-ons from mindmade.org including Swiss specific
|Andreas Wetzel
|[http://www.mindmade.org/files/repository.mindmade.zip repository.mindmade.zip]
|[http://wiki.xbmc.org/images/6/6a/Mindmade_Add-ons.png]
|-
|[https://github.com/mortstar/repository-mortstar-addons Mortstar's repo]
|Includes IMDb+Rotten Tomatoes scraper and Spotimc
|Mortstar
|[http://github.com/mortstar/repository-mortstar-addons/raw/master/repository.mortstar.addons-1.2.0.zip repository.mortstar.addons.zip]
|[http://wiki.xbmc.org/images/9/96/Icon.png]
|-
|[http://code.google.com/p/mossy-xbmc-repo/ Mossy's Eden repo]
|Irish TV Player and 4oD (working update of Nibor's version)
|Mossy
|[http://mossy-xbmc-repo.googlecode.com/git-history/eden/release/repository.mossy/repository.mossy.zip repository.mossy.zip]
|[http://mossy-xbmc-repo.googlecode.com/git-history/eden/release/repository.mossy/icon.png]
|-
|[http://code.google.com/p/mossy-xbmc-repo/ Mossy's Frodo repo]
|Irish TV Player and 4oD (working update of Nibor's version)
|Mossy
|[http://mossy-xbmc-repo.googlecode.com/git/release/repository.mossy/repository.mossy.zip repository.mossy.zip]
|[http://mossy-xbmc-repo.googlecode.com/git/release/repository.mossy/icon.png]
|-
|[http://code.google.com/p/sparetime/ Nixa's Add-ons]
|General video add-ons
|Nixa
|[http://sparetime.googlecode.com/files/repository.googlecode.sparetime.zip repository.googlecode.sparetime.zip]
|[http://wiki.xbmc.org/images/c/c8/AJ_Video_Add-ons.png]
|-
|[http://code.google.com/p/xbmc-addons/ Nukas Add-ons]
|General add-ons
|Nuka1195
|[http://xbmc-addons.googlecode.com/svn/packages/repository.googlecode.xbmc-addons.zip repository.googlecode.xbmc-addons.zip]
|[http://wiki.xbmc.org/images/e/eb/Chinese_Add-ons.png]
|-
|[http://killdash9.github.com/xbmc-parental-controls/ Parental Controls Add-on]
|A self-updating parental controls addon.
|killdash9
|[https://github.com/downloads/killdash9/xbmc-parental-controls/script.video.parentalcontrols-1.5.3.zip script.video.parentalcontrols-1.5.3.zip]
|[https://raw.github.com/killdash9/xbmc-parental-controls/master/script.video.parentalcontrols/icon.png]
|-
|[http://passion-xbmc.org/addons/ Passion-XBMC Repo]
|General add-ons, including games, from passion-xbmc.org
|Team Passion-XBMC
|[http://passion-xbmc.org/addons/Download.php/repository.passion.xbmc.org/repository.passion.xbmc.org-2.0.2.zip repository.passion.xbmc.org-2.0.2.zip]
|[http://wiki.xbmc.org/images/f/fd/NIxa%27s_Add-ons.png]
|-
|[http://skins.smartplus.cz/pedja-xbmc/ Pecinko's Repo]
|Quartz skin repository ''(Inactive)''
|Pecinko
|[http://skins.smartplus.cz/pedja-xbmc/download/xbmc.repo.pecinkos-1.0.0.zip xbmc.repo.pecinkos.zip] ''(Dead)''
|
|-
|[https://github.com/pieh/pieh-xbmc-addons pieh Add-on Repository]
|RSS clients for xbmc
|pieh
|[https://github.com/downloads/pieh/pieh-xbmc-addons/repository.pieh.zip repository.pieh.zip]
|
|-
|[https://github.com/hippojay/repository.plexbmc.addons PleXBMC repository]
|Plex integration for xbmc
|hippojay
|[http://erlandssson.nu/repository.plexbmc.addons/xbmc.repo.plexbmc/xbmc.repo.plexbmc-1.0.0.zip xbmc.repo.plexbmc-1.0.0.zip]
|
|-
|[https://github.com/TsUPeR/xbmc-repo Popeye's Repo]
|Addons for streaming video files via Usenet connections, addons include Pneumatic and Newznab
|Popeye
|[https://raw.github.com/TsUPeR/xbmc-repo/master/repo/repository.popeye/repository.popeye-1.0.1.zip repository.popeye-1.0.1.zip]
|
|-
|[https://github.com/vikjon0 QF Add-ons]
|Add-ons for XBMC-Live and Linux
|Vikjon0
|[https://github.com/vikjon0/qf-xbmc-addons/raw/master/repo/repository.qf.addons/repository.qf.addons-1.0.1.zip repository.qf.addons-1.0.1.zip]
|[http://wiki.xbmc.org/images/c/cf/QF_Add-ons.png]
|-
|[http://code.google.com/p/queeup/ Queeup Add-ons]
|General add-ons
|Queeup
|[http://queeup.googlecode.com/files/repository.queeup-1.0.2.zip repository.queeup-1.0.2.zip]
|[http://wiki.xbmc.org/images/3/36/Queeup_Add-ons.png]
|-
|[https://github.com/rasjani/xbmc-rasjanisrepo Rasjani's Repo]
|Finnish & English addons
|rasjani
|[http://www.pcuf.fi/~rasjani/xbmc-rasjanisrepo/repository.rasjanisrepo.xbmc/repository.rasjanisrepo.xbmc-1.0.0.zip repository.rasjanisrepo.xbmc-1.0.0.zip]
|[http://www.pcuf.fi/~rasjani/xbmc-rasjanisrepo/repository.rasjanisrepo.xbmc/icon.png]
|-
|[http://code.google.com/p/ruuks-repo/ ruuk's repo]
|Latest versions of Forum Browser, flickr, Facebook Media, WebViewer, Plugin Slideshow Screensaver, X-Note (Evernote), ShareSocial etc...
|ruuk
|[http://ruuks-repo.googlecode.com/files/ruuk.addon.repository-1.0.0.zip ruuk.addon.repository-1.0.0.zip]
|[http://code.google.com/p/ruuks-repo/source/browse/trunk/repo/ruuk.addon.repository/icon.png]
|-
|[http://sastatv.com Sastatv Repository]
|Live streams and OnDemand media from all over subcontinent
|Sastatv
|[http://sastatv.com/repository.sasatv.addons.zip repository.sasatv.addons.zip]
|[http://sastatv.com/icon.png]
|-
|[https://github.com/ScudLee/scudlee-xbmc-addons ScudLee's Add-on Repository]
|AniDB.net scraper mods
|ScudLee
|[https://github.com/downloads/ScudLee/scudlee-xbmc-addons/repository.scudlee-1.0.0.zip repository.scudlee-1.0.0.zip]
|[https://raw.github.com/ScudLee/scudlee-xbmc-addons/master/repository.scudlee/icon.png]
|-
|[http://code.google.com/p/sd-xbmc/ SD XBMC Repository]
|Add-ons for Polish users
|Plesken
|[http://sd-xbmc.googlecode.com/files/repository.sd-xbmc.org-1.0.1.zip repository.sd-xbmc.org-1.0.1.zip]
|
|-
|[http://code.google.com/p/seppius-xbmc-repo/ Seppius RU Add-ons]
|Add-ons for Russian users
|Seppius
|[http://seppius-xbmc-repo.googlecode.com/files/repository.seppius.zip repository.seppius.zip]
|[http://wiki.xbmc.org/images/b/b2/Seppius_RU_Add-ons.png]
|-
|[http://code.google.com/p/sickbeard-xbmc/ Sickbeard integration into XBMC]
|Repository for downloading the Sickbeard XBMC plugin
|Zach Moore
|[http://sickbeard-xbmc.googlecode.com/files/repository.sickbeard.xbmc-plugins.zip repository.sickbeard.xbmc-plugins.zip]
|[http://i.imgur.com/ogZWC.png]
|-
|[https://github.com/brentosmith/ SmithGeek XBMC Repositories]
|Repositories containing the DVDExtras add-on for associating DVD/BluRay bonus features with movies and TV shows. Theme music support is included.
|Brent Smith
|[https://github.com/brentosmith/xbmc-dvdextras/archive/master.zip]
|[https://github.com/brentosmith/xbmc-addons/blob/master/Releases/script.dvdextras/icon.png]
|-
|[http://code.google.com/p/smuto/ smuto Repository]
|Add-ons for Polish users
|smuto
|[http://smuto.googlecode.com/files/repository.smuto-1.2.1.zip repository.smuto-1.2.1.zip]
|[http://wiki.xbmc.org/images/1/1e/Smuto.png]
|-
|[http://code.google.com/p/plugin/ stacked Add-on Repository]
|Video Add-ons: PBS, Revision3, TMZ, G4TV, ESPN Video, NBA Video, and Trailer Addict
|stacked
|[http://plugin.googlecode.com/files/repository.stacked.xbmc.addons.zip repository.stacked.xbmc.addons.zip]
|[http://plugin.googlecode.com/git/icon.png]
|-
|[http://dl.dropbox.com/u/112011567/xbmc/ t0mcat Addons]
|Addons by t0mcat - The first one is for displaying the Videoblog of the german vocal-pop group WiseGuys
|t0mcat
|[http://dl.dropbox.com/u/112011567/xbmc/repository.t0mcat.zip repository.t0mcat.zip]
|[http://dl.dropbox.com/u/112011567/xbmc/addons/plugin.video.wiseguys.videoblog/icon.png]
|-
|[https://github.com/t0mm0/t0mm0-xbmc-plugins t0mm0 Addons]
|Addons by t0mm0
|t0mm0
|[https://github.com/downloads/t0mm0/t0mm0-xbmc-plugins/repository.t0mm0-1.0.3.zip repository.t0mm0-1.0.3.zip]
|
|-
|[http://code.google.com/p/repothn/ THN's Addons]
|Addons by THN
|THN
|[http://repothn.googlecode.com/files/repository.googlecode.repothn.zip repository.googlecode.repothn.zip]
|
|-
|[http://code.google.com/p/turkishxbmcscraper/ Turkish Add-ons]
|Add-ons & Scraper for Turkish users
|Drascom
|[http://turkishxbmcscraper.googlecode.com/files/repository.drascom.xbmc-plugins.zip repository.drascom.xbmc-plugins.zip]
|
|-
|[http://code.google.com/p/xbmc-tvshack/ Tvshack Repo]
|Host of the TV Shack add-on
|Pedro Guedes
|[http://xbmc-tvshack.googlecode.com/files/repository.googlecode.xbmc-tvshack.zip repository.googlecode.xbmc-tvshack.zip]
|
|-
|[https://code.google.com/p/urlxl-repo/ urlXL XBMC Addon Repo]
|Cruncyroll Takeout Addon + Dependencies
|Yoshi of the Wire
|[https://urlxl-repo.googlecode.com/files/repository.urlXL.zip repository.urlXL.zip]
|
|-
|[https://github.com/diegofn/wiiego-xbmc-addons/ Wiiego Add-ons]
|Add-ons as Terra Sonora Audio Service (Listen music for free)
|Wiiego
|[https://github.com/diegofn/wiiego-xbmc-addons/blob/master/repo/repository.wiiego/repository.wiiego-1.0.1.zip?raw=true repository.wiiego-1.0.1.zip]
|[https://github.com/diegofn/wiiego-xbmc-addons/raw/master/repo/repository.wiiego/icon.png]
|-
|[http://code.google.com/p/xbmc-doplnky/ XBMC Doplnky]
|Video addons for czech and slovak users
| lzoubek
|[http://xbmc-doplnky.googlecode.com/files/repository.xbmc.doplnky-1.0.3.zip repository.xbmc.doplnky-1.0.3.zip]
|[https://github.com/lzoubek/xbmc-doplnky/raw/master/repository.xbmc.doplnky/icon.png]
|-
|[http://code.google.com/p/repository-xbmcnerds/ XBMCNerds Add-ons]
|General Addons, Cirrus Extended
|TeamXBMCNerds / mad-max
|[http://www.xbmcnerds.com/index.php?page=DownloadDBFileDownload&dataID=100]
|[http://wiki.xbmc.org/images/1/1f/Xbmcnerds.png]
|-
|[http://code.google.com/p/xbmc-dpstream/ Xbxl Addon]
|French video addon : Dpstream
|Xbxl
|[http://xbmc-dpstream.googlecode.com/files/repository.xbxl.zip repository.xbxl.zip]
|
|-
|[http://code.google.com/p/xot-uzg/ XOT:Uzg Add-on]
|Host of an add-on for online TV streaming sites
|Basje
|[http://www.rieter.net/ext/?uri=http://xot.hamans.com/net.rieter.xot.repository-1.0.1.zip net.rieter.xot.repository-1.0.1.zip]
|[http://wiki.xbmc.org/images/7/75/XOTUzg_Add-on.png]
|-
|[https://github.com/Xycl Xycl Add-ons]
| WDR Rockpalast concerts, My Pictures Database and ListenLive.eu
|Xycl
|[https://github.com/Xycl/repository.xycl.addons/raw/master/repository.xycl.addons/repository.xycl.addons-1.0.9.zip repository.xycl.addons.zip]
|[https://github.com/Xycl/repository.xycl.addons/raw/master/repository.xycl.addons/icon.png]
|}