Media flags: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
>Mad-max
No edit summary
Line 2: Line 2:
==== What are Media Flags? ====
==== What are Media Flags? ====


Media Flags are icons at XBMC that displays information (video resolution, audio format/channels, video source, ...) from the media file of a Movie or a TV Show.
Media Flags are icons at XBMC that displays the meta-information from the media file of a movie, TV show or music title.


[[File:ConfluenceMediaFlags.jpg|700px|thumb|none|Media Flags at skin Confluence: 1080, h264, dts, 5.1, 16:9 and Blu-Ray Disc]]
[[File:ConfluenceMediaFlags.jpg|700px|thumb|none|Media Flags at skin Confluence: 1080, h264, dts, 5.1, 16:9 and Blu-Ray Disc]]
[[File:media_flags_music.png|700px|thumb|none|Media Flags in music-section]]


Every skin can handle the media flags different!


==== Where does XBMC get the Information for Media Flags? ====
==== Where does XBMC get the Information for Media Flags? ====


XBMC tries to read the media information from the media file, after it was added to the Library (video Resolution, audio format/channels, codec).
XBMC tries to read the meta information from the media file, after it was added to the Library.
This meta information can be queried by the built-in [[InfoLabels]] in order to display it in the skin.<br />
Example-code for a resolution-flag in Confluence:
<blockquote>
<control type="image"><br />
    <description>Video rez Image</description><br />
    <width>55</width><br />
    <height>35</height><br />
    <aspectratio align="right">keep</aspectratio><br />
    <texture>$INFO[ListItem.VideoResolution,flagging/video/,.png]</texture><br />
</control><br />
</blockquote>


DVD-Images (.iso, .img, etc) need to be played one time to get media information.
===== Video Flags =====
The category video flags provides images for the following properties:<br />


===== video flags =====
* Resolution: SD, HD, 720p, 1080p, 480p, 576p ...


Most skins display the video resolution in flags like SD, 720 or 1080
* Format: DivX, XviD, h264, x264, wmv, mpeg2video ...


* Format: DivX, XviD, h264, x264, ...
* Aspect ratio: 4:3, 16:9, 2.35:1 ...


* Aspect ratio: 4:3, 16:9, 2.35:1
'''NOTE: What exact kind of video flag is provided depends on the skin you are using!'''


===== audio flags =====
===== Audio Flags =====
The category audio flags provides images for the following properties:<br />


* Channels: mono, 2ch, 5ch, ...
* Channels: 1.0, 2.0, 5.1, 7.1 ...
* Format: AC3, DTS, mp3, ...


* Format: AC3, DTS, mp3, flac, DTS-HD MasterAudio ...


===== media source =====
'''NOTE: What exact kind of audio flag is provided depends on the skin you are using!'''


Some skins have flags for the video source of a media file. This information are obtained from the the filename (or the directoryname, if 'Use Folder Names For Lookup' were set at [[Set Content (Video Library)|Set Content]])
===== Media Source =====
 
Most skins have flags for the video source of a media file. This information are obtained from the the filename or the directoryname.


Media can be flagged with following media source flags:
Media can be flagged with following media source flags:
Line 40: Line 55:
* '''HDTV''', if the filename contains HDTV or PDTV.
* '''HDTV''', if the filename contains HDTV or PDTV.


===== special or custom flags =====
As an alternative you can set your folder structure to fit the keywords above:<br />
 
* '''C:\Videos\DVDR\Movie1...'''    on Windows<br />
Some skins have special or custom flags:
* '''/mnt/dev1/videos/bluray/movie1'''    on Linux<br />
 
* Movie Studio
* TV Channel/Network
* [http://en.wikipedia.org/wiki/Motion_Picture_Association_of_America_film_rating_system MPAA film rating system] or the german [http://en.wikipedia.org/wiki/Freiwillige_Selbstkontrolle_der_Filmwirtschaft FSK] (Back Row Skin)
 
This information are obtained via the configured Scraper.


==== Which Skins support Media Flags? ====


< doesn't all skins from http://xbmc.org/skins/ have media flags? >
'''NOTE: What exact kind of source flag is provided depends on the skin you are using and its naming convention!'''


* Aeon
===== Custom Flags =====
* Confluence (XBMC default Skin since v9.11)
Most skins also have the ability to show media flags from [[InfoLabels]] that come not from the media file itself. These pieces of information are provided by the scraper that was used to scan the file to the library and can be:<br />
* Night
* Movie Studio: WarnerBros., 20th Century Fox, Universal ...
* Transparency!
* TV Channel/Network: HBO, ABC, FOX ...
* < much more >
* Rating: MPAA, FSK, UK-Rating ...


[[Category:To-Do]]
===== Special Notes =====
* Some file types (e.g. .iso) have to be played one time, before the media flags appear in the database<br />
* You can change the kind of media flag regardless of the file by editing the table [http://wiki.xbmc.org/index.php?title=Database#streamdetails streamdetails] in the XBMC database
[[Category:User-Interface]]

Revision as of 14:55, 16 November 2011

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

What are Media Flags?

Media Flags are icons at XBMC that displays the meta-information from the media file of a movie, TV show or music title.

Media Flags at skin Confluence: 1080, h264, dts, 5.1, 16:9 and Blu-Ray Disc
Media Flags in music-section


Where does XBMC get the Information for Media Flags?

XBMC tries to read the meta information from the media file, after it was added to the Library. This meta information can be queried by the built-in InfoLabels in order to display it in the skin.
Example-code for a resolution-flag in Confluence:

<control type="image">
<description>Video rez Image</description>
<width>55</width>
<height>35</height>
<aspectratio align="right">keep</aspectratio>
<texture>$INFO[ListItem.VideoResolution,flagging/video/,.png]</texture>
</control>

Video Flags

The category video flags provides images for the following properties:

  • Resolution: SD, HD, 720p, 1080p, 480p, 576p ...
  • Format: DivX, XviD, h264, x264, wmv, mpeg2video ...
  • Aspect ratio: 4:3, 16:9, 2.35:1 ...

NOTE: What exact kind of video flag is provided depends on the skin you are using!

Audio Flags

The category audio flags provides images for the following properties:

  • Channels: 1.0, 2.0, 5.1, 7.1 ...
  • Format: AC3, DTS, mp3, flac, DTS-HD MasterAudio ...

NOTE: What exact kind of audio flag is provided depends on the skin you are using!

Media Source

Most skins have flags for the video source of a media file. This information are obtained from the the filename or the directoryname.

Media can be flagged with following media source flags:

  • DVD, if the filename contains DVDR, DVDRIP, SDDVD, .iso or .ifo.
  • Blu-Ray Disc, if the filename contains BLURAY, BLU-RAY, BRRIP or BDRIP.
  • HDDVD, if the filename contains HDDVD.
  • SDTV, if the filename contains SDTV or TVRip.
  • HDTV, if the filename contains HDTV or PDTV.

As an alternative you can set your folder structure to fit the keywords above:

  • C:\Videos\DVDR\Movie1... on Windows
  • /mnt/dev1/videos/bluray/movie1 on Linux


NOTE: What exact kind of source flag is provided depends on the skin you are using and its naming convention!

Custom Flags

Most skins also have the ability to show media flags from InfoLabels that come not from the media file itself. These pieces of information are provided by the scraper that was used to scan the file to the library and can be:

  • Movie Studio: WarnerBros., 20th Century Fox, Universal ...
  • TV Channel/Network: HBO, ABC, FOX ...
  • Rating: MPAA, FSK, UK-Rating ...
Special Notes
  • Some file types (e.g. .iso) have to be played one time, before the media flags appear in the database
  • You can change the kind of media flag regardless of the file by editing the table streamdetails in the XBMC database