Special Features is inspired by the upcoming Blu-ray features being introduced in Kodi 18. Given a properly structured 'Extras' directory, this addon will present all of the bonus videos, discs and alternate versions of the movies and tv shows in your library.
For Special Features to properly detect your extras, you wll need to create an 'Extras' folder in the root folder of each video that you want to add special features to.
eg.
The Pirates of the Caribbean\
>BDMV
>CERTIFICATE
>Extras
>poster.jpg
>fanart.jpg
This Extras folder can contain individual video clips, or full Blu-ray or DVD rips.
The Pirates of the Caribbean\Extras\
>Theactrical Trailer.mkv/mp4/ etc
>3D Verison\BDMV\index.bdmv
>Bonus Disc\VIDEO_TS\VIDEO_TS.IFO
There are currently two ways to access Special Features. The 'builtin' method is to simply access the 'Special Features' addon directly. If any special features are available, they will be presented in a video list.
The following skins currently provide official support for Special Features:
- AppTV
- Andromeda
- Arctic: Zephyr
- Black Glass Nova
- Chroma
- Eminence 2
- Eminence 2 mod Krypton
- Nebula
- Rapier
While the long-term goal is to see every skin supporting Special Features natively, for now patches are available for many of the official skins in the skin xml directory. The following skins are currently supported, with more being added as time permits:
- Aeon Nox Silvo
- Amber
- Bello 6
- Box
- Confluence
- Estuary
- FTV
- Fuse Neue
If you use one of these skins, you can add a handy button to video info pages for videos with Special Features by overwriting the files in your skin folder with the supplied patches. Don't see a patch for your favorite skin? Feel free to request it (or submit it yourself)!
Originally, Special Features were accessed through a context menu entry. This method was dropped to prevent adding to the existing clutter of context menus and in the hopes of providing a more intuitive, streamlined solution. However, given that patches are not available for all themes, the context menu is back as a togglable option.
Without tweaking your advanced settings, you will end up with all of your extras being unceremoniously dumped into your media library. To prevent this, it is recommended that you add the following block to your advancedsettings.xml file. The Advanced Settings file is not created by default, so you will likely have to add it yourself.
<advancedsettings>
<video>
<!-- VideoExtras: Section Start -->
<excludefromscan action="append">
<regexp>/Extras/</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
</excludefromscan>
<excludetvshowsfromscan action="append">
<regexp>/Extras/</regexp>
<regexp>[\\/]Extras[\\/]</regexp>
</excludetvshowsfromscan>
<!-- VideoExtras: Section End -->
</video>
</advancedsettings>
The optional SQL database option has been tested on MySQL 5.7 and MariaDB 10.2.
Assuming you already have MySQL setup and running, simply go to addon settings MySQL tab and fill in your information. It's as simple as that!
We recommend all users with support questions comment on our forum thread. GitHub is used for core development only, and is not the place to seek help or report non-developer issues.
Anyone is welcome to contribute to Special Features. Please read the guidelines for contributing to this repository.
There are various ways you can contribute:
- Raise an Issue on GitHub
- Send us a Pull Request with your bug fixes and/or new features