Add-on:Extras

From Official Kodi Wiki
Jump to navigation Jump to search

Extras
icon.png

See this add-on on the kodi.tv showcase

Author: takoi

Type: Context menu items
Repo: Kodi.tv repo v20
Kodi.tv repo v19

License: GPL v3.0
Source: Source code
Summary: View extras and special features
Home icon grey.png   ▶ Add-ons ▶ Extras

Provides an easy way to browse and view movie and TV show extras. Extras can be accessed from the context menu in the video library.

By default, the add-on will look in the "Extras" sub-folder for content (can be changed in settings).

Tip: for how to avoid extras beings scraped to library, see http://kodi.wiki/view/Add-on:Extras

Installing

This add-on is installed from the Add-on browser located in Kodi as follows:

  1. Settings
  2. Add-ons
  3. Install from repository
  4. Context items
  5. Extras
  6. Install


Location of Extras folder

By default, the add-on will look for the directory named "Extras". The name of this folder can be changed in settings but you can only use one name. The location of the Extras folder is important as failing to locate the directory correctly will return an empty listing with only a youtube link.

Following are typical examples of correct placement


For Movies

The Extras folder must be located in the same directory as your video file. Some typical examples are listed below.

DVD structure preserved

...\Chronicles of Riddick\
...\Chronicles of Riddick\AUDIO_TS\
...\Chronicles of Riddick\VIDEO_TS\
...\Chronicles of Riddick\VIDEO_TS\Extras\

Bluray structure preserved

...\Lucy (2014)\
...\Lucy (2014)\BDMV\
...\Lucy (2014)\BDMV\Extras\
...\Lucy (2014)\CERTIFICATE\

This assumes you have index.bdmv or MovieObject.bdmv in the \BDMV\ directory. (sub-directories in the BDMV and Certificate directories are intentionally omitted)

Single movie files in separate directories (iso, mkv, mp4, etc)

...\Lucy (2014)\
...\Lucy (2014)\Extras\


For TV Shows

You are not able to use Extras per individual episode. Extras for a TV Show are located within the main TV Show directory.

All TV Show directory structures

...\Childhood's End
...\Childhood's End\Childhood's End S01E01
...\Childhood's End\Childhood's End S01E02
...\Childhood's End\Childhood's End S01E03
...\Childhood's End\Extras\


Example of Correct Implementation

If you have followed these instructions correctly, selecting Extra's from the Context Menu should return a display similar to this.


Preventing extras from being added to library

Extras are video files the same way the main feature movie is a video file. This may cause Kodi to see your Extras as additional movies. To prevent each Extras video file being scraped as a movie, and adding random or duplicated movies into your library, you must tell Kodi not to scrape the Extras folder.

A number of methods are available. A listing is found here Excluding directories/folders

To add <excludefromscan> code to advancedsettings.xml, simply copy and paste the following code into your advancedsettings.xml If you already have an advancedsettings.xml file, do not duplicate the <advancedsettings></advancedsettings> tags.

<advancedsettings>
  <video>
     <excludefromscan>
         <regexp>[-\._ ](extrafanart|trailer|extrathumbs)[-\._ ]</regexp>
     </excludefromscan>
     <excludefromlisting>
         <regexp>[-._ \\/](extrafanart|trailer|extrathumbs)[-._ \\/]</regexp>
     </excludefromlisting>
     <excludefromscan action="append">
         <regexp>/extras/</regexp>
         <regexp>[\\/]extras[\\/]</regexp>
     </excludefromscan>
     <excludetvshowsfromscan action="append">
         <regexp>/extras/</regexp>
         <regexp>[\\/]extras[\\/]</regexp>
     </excludetvshowsfromscan>
  </video>
</advancedsettings>

Usage

Extras is accessed via the Context Menu. To view Extras:

  1. Highlight the Movie or TV Show
  2. Select the Context Menu (“c” on a keyboard, right mouse click or appropriate button on your remote control)
  3. Select Extras
  4. Select the video file you would like to play

In previous versions it could also be accessed via the Movie Information page, but has been removed from v17.


Known Issues

Some users have noted that the list of Extras is ordered by File Creation Date and not alphabetically as is preferable.


Bug and issue reports

If you experience any issues with this add-on, click here and post details of the issue to seek further assistance.