From Official Kodi Wiki
Jump to: navigation, search
Home icon grey.png   ▶ Video library ▶ Playback ▶ 3D

Starting in v13, Kodi supports a number of passive 3D video formats such as SBS, TAB, anaglyph or interlaced. This support extends to the Kodi GUI including subtitles and on-screen-controls.


1 Limitations

1.1 MVC software decoding not supported

Kodi does not yet support software video decoding of MVC (Multiview Video Coding) encoded 3D videos, which is the format most commonly used in raw Blu-ray 3D backups/rips (and on original Blu-ray Disc media with stereoscopic video.

However, hardware decoding of MVC (Multiview Video Coding) encoded 3D videos is supported in Kodi on some platforms/operating-systems if the device drivers and hardware supports it, like it does for the Raspberry Pi. For hardware decoding Kodi relies on the SoC/VPU/GPU chipset hardware manufacturer to add support for this to their SDK (Software Developer Kits) and for the media player box manufacturers to implement that into their API, firmware, kernel, and/or device drivers images as needed.

For software video decoding Kodi depends on the third-party decoder libraries from the (ffmpeg.org) project as well as code from its sister-project Libav (libav.org). The fact is that Kodi developers will not be ablle to add support software video decoding of MVC encoded 3D videos until the developers of those upstream projects have written and added code for it first, and those projects are just like Kodi also non-profit organizations run by volunteers working for free so it is impossible to estimate when (if ever) someone will write and add code for MVC decoding support to FFmpeg and/or Libav (which is needed before it can be added to Kodi).

For some Kodi forum discussion please see: http://forum.kodi.tv/showthread.php?tid=227862 or for more information read the wikipedia article about MVC (Multiview Video Coding)

Developers might also want to read this development-oriented description written by the Libav (and FFmpeg) developers on their wiki here: http://wiki.libav.org/Blueprint/MVC as well as a very descriptive blog-post which explains why software video decoding of MVC is so hard to code into FFmpeg/Libav: http://blogs.gentoo.org/lu_zero/2014/04/04/the-road-to-mvc/ (posted by Luca Barbato and Vittorio who have been two of the lead developers in the FFmpeg and Libav projects for the past 10-years).

2 Interface and menus

Incomplete.png INCOMPLETE:
This page or section is incomplete. Please add information or correct uncertain data which is marked with a ?
Over-under 3D.png

3 How Kodi does 3D detection

Kodi has three ways to detect whether a videofile is a 3D video. These methods are checked in the following order:

3.1 Embedded streaminfo

First, Kodi tries to detect the stereoscopic mode for a video when extracting streamdetails from the videofile.

One of the supported fields is the 'Stereomode' field in the Matroska specification: http://matroska.org/technical/specs/index.html#StereoMode

3.2 Manual selection

When playing a video, you can bring up the video settings dialog to manually select the stereoscopic mode.

If you've done this before, Kodi will remember this setting and use it as the second method to detect the stereoscopic mode of a videofile.

3.3 Video filenames flags

The third and final method is detection through the filename of the video.

Kodi uses regular expressions to check for certain flags in the filename.

In order to properly detect the stereomode, two tags need to be present in the filename. First, a '3D' tag has to be present that matches the following regex: [-. _]3d[-. _]

In addition to this, either a 'SBS' tag [-. _]h?sbs[-. _] or a 'TAB' flag [-. _]h?tab[-. _] must be present in the filename.

You can customize these regular expressions through the Advancedsettings.xml file.

Regex matching is done case-insensitive, so for example either .3d. and .3D. will work.

Note: the tags need be be surrounded be either a hyphen -, space  , dot . or underscore _.

See the table below for some examples:

3D Stereoscopic side-by-side Stereoscopic top-and-bottom
.3D. .sbs. .tab.
-3d- .SBS. .TAB.
3d .HSBS. .HTAB.
_3d_ -hsbs- -htab-
.3D- _sbs_ _tab_
.3D sbs tab
Filename examples
  • moviename (year).3d.hsbs.mkv
  • moviename 3d sbs.mkv
  • moviename.3D-HTAB.mkv
  • moviename-3D.sbs-720p.mkv

For other filename flags examples.

4 Subtitiles


5 Platform specific info

5.1 General

  • Hardware acceleration is not provided for full SBS or full TAB movies, meaning users will need playback hardware with adequate CPU power.
  • Kodi's "window mode" in Settings -> System -> Video output must use normal "Full screen" and not "Full screen window".

5.2 Windows

  • "3D Stereoscopic Support" in the video driver settings must be turned off.

5.3 ARM (Android, iOS, Raspberry Pi)

  • 3D modes anaglyph and interlaced are not currently supported on ARM platforms (such as Android, iOS, Raspberry Pi, or other linux-based ARM distros) due to those platforms using OpenGLES rather than OpenGL or DirectX.

6 Other guides

7 See also

Personal tools

Wiki help