https://kodi.wiki/api.php?action=feedcontributions&user=WhikiDude&feedformat=atomOfficial Kodi Wiki - User contributions [en]2024-03-28T19:29:31ZUser contributionsMediaWiki 1.39.6https://kodi.wiki/index.php?title=Music_tagging&diff=166963Music tagging2019-05-14T11:22:48Z<p>WhikiDude: Corrected a couple of spelling errors</p>
<hr />
<div>{{MusicLibraryCreate}}<br />
{{mininav|[[Music library]]}}<br />
<br />
<br />
= Introduction =<br />
This page provides the following information:<br />
<br />
*How the Music section differs from the Video section of {{kodi}}<br />
*The recommended method to organise your music files <br />
*The recommended method for tagging your music files<br />
*Explanation of some commonly misunderstood Music File Tags<br />
*The Audio Files and Tags that {{kodi}} reads and uses<br />
<br />
<br />
<br />
= Understanding the Music Library =<br />
<section begin="understanding" />There is a fundamental differences between video library operation and the music library operation: <br />
*The video library is based on using the filenames or folder names to obtain online data. If they are incorrectly named, then there are no scraper results and there will be no library entry.<br />
*'''The music library is based on scanning tags embedded in the music files.''' It ignores the folder names and structure and file names. Proper tagging is essential to ensure the library is populated correctly. Having slight variations in the tags for artist and album names could mean duplicated and unwanted entries.<section end="understanding" /><br />
<br />
<br />
<br />
= Folder and File Structure =<br />
Although {{kodi}} ignores the folder structure and the names of the folders and files, the structure of your folders is important as it affects the operation of other functions such as Import/Export, nfo files and Artwork. For example, if you have all your music files in one folder (which is possible), then you lose the ability to use local nfo files, local artwork, and the import/export module will not function correctly.<br />
<br />
The following is {{kodi}} '''best practice'''. Remember use a layout that is nice for you, but '''tag accurately.'''<br />
<br />
<br />
<br />
== Files ==<br />
Song files require suitable tagging for use in {{kodi}}. While {{kodi}} can scan minimal tags into the library, it can lead to errors in the library and subsequent scraping. We recommend music files are tagged with MusicBrainz as detailed below.<br />
<br />
Remember that {{kodi}} does not extract any information from the filename, so the filename is your choice.<br />
<br />
<br />
<br />
== Folders ==<br />
{{kodi}} is quite flexible with the folder structure. The diagram below is an '''example'''. You should group your albums in a manner that makes sense to you.<br />
<br />
To ensure {{kodi}} and other add-on processes can function efficently and correctly, the following is recommended.<br />
*Songs from the same album should be in the one folder<br />
*If there is more than one disk in the release, each disk should be in a sub-folder containing the songs from that disk<br />
<br />
<br />
The following is a typical folder structure:<br />
<br />
f:\ ....................................(root)<br />
|__Artist Information ..................(Artist Information Folder)<br />
|<br />
|__Artist Music .......................(source folder)<br />
| |__ Madonna ........................(artist folder)<br />
| | |__ Beautiful Stranger (1999) ..(album folder)<br />
| | | |__ Song 1<br />
| | | |__ Song 2<br />
| | | |__ Song 3 etc<br />
| | |__ Bedtime Stories (1994) .....(album folder)<br />
| | | |__ Song 1<br />
| | | |__ Song 2<br />
| | | |__ Song 3 etc<br />
| | |__ Like A Prayer (1989) .......(album folder)<br />
| | | |__ Song 1<br />
| | | |__ Song 2<br />
| | | |__ Song 3 etc<br />
| |__ Simply Red .....................(artist folder)<br />
| |__ Picture Book (1985) ........(album folder)<br />
| |__ Song 1<br />
| |__ Song 2<br />
| |__ Song 3 etc<br />
|<br />
|__Compilations .......................(Source)<br />
| |__ Essential Eighties .............(album folder)<br />
| | |__ Song 1<br />
| | |__ Song 2<br />
| | |__ Song 3 etc<br />
| |__ 100% Hits- Best of 2005 ........(album folder)<br />
| |__ Song 1<br />
| |__ Song 2<br />
| |__ Song 3 etc<br />
|<br />
|__Classical ..........................(Source)<br />
|<br />
|__Audiobooks .........................(Source)<br />
<br />
<br />
<br />
== Sources ==<br />
A source folder contains your media collection- in this case Music. This folder is then set as a Source in {{kodi}} which enables {{kodi}} to access your Music. <br />
<br />
In the diagram from the previous section ''Artist Music, Compilations, Classical'' and ''Audiobooks'' are Sources.<br />
<br />
Setting and Scanning of Sources is covered in detail in the next step of the guide. <br />
<br />
<br />
<br />
= Tagging =<br />
Most music files purchased or ripped by your favourite software have only minimal metadata embedded. Normally this is not a problem and works very well on simple music players.<br />
<br /><br /><br />
{{kodi}}, being an advanced and feature rich player, requires greater accuracy with the embedded tags. Any slight variance in, for example, the Album name between the tracks from the same album will see multiple entries in the library for that Album. It is not uncommon to have a single album split into three similarly named albums. Also true for Artists. It is for this reason that there is a separation of the Scanning and Scraping processes for Music. The initial scan allows you to find and correct errors in tagging, before scraping.<br />
<br /><br /><br />
This table has examples of errors in tagging, which will cause duplicated entries in the library...<br />
<br />
{|class="prettytable"<br />
!Similar Name 1 || Similar Name 2 || Note<br />
|-<br />
|György Ligeti || Gyorgy Ligeti || Accented and unaccented names will create duplicate entries<br />
|-<br />
|The Best of || The Very Best Of || Inconsistent naming between songs of the same album and/or artist will cause duplicated entries<br />
|-<br />
|Madonna || Madonnna || Spelling mistakes will cause duplicated entries for albums and/or artists<br />
|-<br />
|Sting || Sting and The Police || Seen as two separate and unrelated Artists<br />
|}<br />
<br />
As {{kodi}} scans your music collection, it copies the data contained in those tags into the {{kodi}} music database. The benefits of this are:<br />
*Once the scan is complete, the tags are not accessed again<br />
*All information is now obtained from the database. This has the benefit of dramatically increasing efficency and speed when navigating the library.<br />
*Now that a database entry exists, you are able to scrape additional information from online sources. This is covered later in the guide.<br />
<br />
<br />
<br />
== MusicBrainz ==<br />
'''{{kodi}} has strong support for MusicBrainz tagging. It is highly recommended that users tag their music files using MusicBrainz Picard.'''<br />
<br />
'''MusicBrainz Picard''' is the music file tagger software that can access the MusicBrainz database to locate metadata to embed into your music files. MBIDs are useful because names are not unique. The bigger and more diverse your music collection is, the more likely you will encounter Artists with the same name. <br />
<br />
The advantages of tagging with MusicBrainz are:<br />
*They allow you to have different artists with the same name in your library e.g. "John Williams" the classical guitarist and "John Williams" the film music composer and conductor.<br />
*They negate inconsistencies in artist naming e.g. having "Peter Tchaikovsky" on some albums and "Piotr Czajkowski" on others<br />
*They allow you to have more than one release of an album in your library e.g. the normal and deluxe editions of an album<br />
*They clearly identify the artist and album in ways that names alone can not. This can then be used to accurately scrape additional artist and album information and locate the correct artwork<br />
*They allow the scraping process to be more efficient, otherwise an extra call is made to try and get an mbid first to use at the scraping sites, and each request from Musicbrainz must be throttled to 1 per sec which will slow the scraping process.<br />
<br />
<br />
Below is a screenshot of the main screen of the Picard software. A brief description of the layout as follows.<br />
<br />
*Top Left Box- Folder listing of your music collection<br />
*Top Centre Box- Albums are dragged and dropped here in preparation for matching and tagging. Pressing ''Lookup'' (greyed out) will commence the lookup process<br />
*Top Right Box- Matching albums are displayed here and your songs are overlayed. In the screenshot, songs 01, 08 and 09 have been matched to the suggested album. If all songs match and you agree the correct album was located, simply pressing Save will tag the album with the tags displayed in the Bottom Tag Box.<br />
*Bottom Tag Box - Selecting a song from the Top Right Box will display all available tag fields (left column), the current tags in the music file (Original Value column) and the MusicBrainz tags to be embedded in the music file (right column).<br />
<br />
The example in the image below shows the following:<br />
*Most tags are missing (original value column)<br />
*The top three yellow entries are incorrect (original value column) and the corrections are in the right column<br />
*The green entries in the right column indicate new tags to be embedded<br />
*The black entries at the bottom of the list indicate no change to the existing tags as they are correct or not used by MusicBrainz.<br />
<br />
<br />
<gallery mode="packed" widths="1000px" heights="563px"><br />
File:MusicBrainzPicard01.jpg<br />
</gallery><br />
<br />
<br />
Although Picard is very easy to use, you must avoid blindly accepting everything offered by the software. It is important that you confirm the correct album was located. Due to the global nature of the database, there are many releases for a single album. These releases differ between countries, usually due to copyright requirements. This may lead you to inadvertendly select the incorrect release for your album, even though it is named exactly the same. The differences between releases may be as simple as different song ordering or the inclusion of additional bonus tracks.<br />
<br />
For the best tagging experience set the correct options in Picard, particularly the "Clear Existing Tags" option in settings. This option means that any old tags that may cause issues are wiped, preserving only the musicbrainz tagging. It will also be wise to tag using ID3v2.4 compatibility.<br />
<br />
<gallery mode="packed" widths="500px" heights="283px"><br />
File:Picard options.jpg<br />
</gallery><br />
<br />
<br />
== albumartists ==<br />
{{Kodi}} requires the '''albumartists''' tag to correctly handle multiple album artists on the same album. This tag is not a default tag in MusicBrainz Picard and other tagging software. <ref> https://forum.kodi.tv/showthread.php?tid=334729&pid=2760161#pid2760161 </ref><br />
<br />
To include this tag add a new script under ''Options > Options > Scripting > Add new script'' and include the following code...<br />
<syntaxhighlight lang="xml"><br />
$setmulti(albumartists,%_albumartists%)<br />
</syntaxhighlight><br />
<br />
<gallery mode="packed" widths="500px" heights="283px"><br />
File:Picard Script.JPG<br />
</gallery><br />
<br />
<br />
Once the music files are tagged, avoid modifying the MusicBrainz tags unless you clearly understand the relationship of the MBID's and the other related tags. For example, embedding MBID tags, but then editing the Artist tag or Album Artist tag will result in incorrect entries in the library.<br />
<br />
For example:<br />
*If you need to change the artist or album artist tag you also have to edit the matching artist mbid tag and album artist mbid tag. <br />
*If Kodi finds a release mbid it will expect the artist mbid tags to also be present.<br />
<br />
<br />
:'''''See: [https://musicbrainz.org/ MusicBrainz Website]'''''<br />
:'''''See: [https://picard.musicbrainz.org/ MusicBrainz Picard Software]'''''<br />
<br />
<br />
<br />
----<br />
<center>{{red|'''The remainder of this page deals with special use cases or provides information for technical interest and reference only. It can be safely disregarded if these do not apply to you'''}}</center><br />
----<br />
<br />
<br />
<br />
<div style="{{linear-gradient|left|#f5d3ff, #12b2e7}}">{{next|[[Adding_music_to_the_library|Scanning Music into Library]]}} </div><br />
<br />
<br />
<br />
= Ripping CD's =<br />
{{main|Ripping CDs}}<br />
{{#lst:Ripping CDs|intro}}<br />
<br />
There is no requirement to use the {{Kodi}} CD Ripper. If you are comfortable using other ripping software, then we recommend you continue using that software.<br />
<br />
<br />
<br />
= Cue Sheets =<br />
{{#lst:Cue_sheets|intro}}<br />
<br />
{{kodi}} does provide basic support for using cue sheets to define individual tracks when an entire CD has been ripped into a single music file. However the information provided by the cue sheet standard is much more limited than that of standard tagging, hence to enjoy the full music library features it is recommended that tracks are ripped into separate files and fully tagged.<br />
<br /><br />
{{red|If you do not use Cue Sheets you can safely move onto the next step.}}<br />
<br /><br />
;{{see also|Cue_sheets}}<br />
<br />
<br />
<br />
= Streams =<br />
{{#lst:Internet_video_and_audio_streams|intro}}<br />
<br />
;{{see also|Internet_video_and_audio_streams}}<br />
<br />
<br />
<br />
= Technical Explanation: File tags =<br />
For many categories, such as genres and artists, {{kodi}} supports multiple values in the one field. By default it uses the character sequence " / " to divide the entry into multiple values. This divider may be changed via [[advancedsettings.xml]].<br />
<br />
<br />
== Resolving Compilations and Multiple Artists ==<br />
{{red|Applies to v17 and below. v18 introduced the [[Artist information folder]] which solved these problems. You are encouraged to update to v18}}<br />
<br />
{{kodi}} reads the ''Album Artist'' tag in ID3, Ogg, APE and MP4 tags and uses it if available to assign an artist to the album (independently of the track's artist information). This is the "Album Artist" tag (in ID3 this is represented by the "TPE2" tag; in vorbiscomment (ogg) files "ALBUMARTIST", "ALBUM ARTIST" and "ENSEMBLE" are all supported). Multiple artists for either a track or album artist can be specified in "Artist1 / Artist2 / Artist3" format.<br />
<br />
If no ''Album Artist'' tag exists, {{kodi}} will use the first (primary) artist from the tracks as the ''Album Artist''. Essentially we do a string comparison of all the track artists, and assign the common artists as the ''Album artist''. This is generally the TPE1 tag in ID3.<br />
<br />
As many users don't yet use the ''Album Artist'' tag, {{kodi}} has an additional filter system for identifying compilation albums, where each track normally has a different artist. As {{kodi}} scans a folder, it does the following:<br />
# Identifies albums based on ''Album'' name alone in the folder and groups the songs that have the same ''Album'' name together as an album.<br />
# Runs through each album's assigned songs. If there is 2 or more tracks with the same ''Track'' number, the group of songs must come from 2 or more albums, so the ''Album'' name is ruled out as a possible compilation.<br />
# If any of the songs assigned to the ''Album'' name have an ''Album Artist'' tag, then {{kodi}} assumes the user knows what they're doing, and this album is also ruled out from being a compilation.<br />
# If two or more songs assigned to the ''Album'' name then have different primary artists, then the ''Album'' name is considered to be a group of songs from a compilation, and the ''Various Artists''" tag is assigned as the album artist.<br />
# Otherwise, if all the songs have the same primary artist but don't have the same full artist list (eg a song or two has an additional artist) then the album is assigned the primary artist as it's ''Album Artist'', and we assume the additional artists are guest artists.<br />
<br />
<br />
<br />
== Ratings in ID3 tags ==<br />
Ratings in ID3 tags are read via the POPM field, and (if this doesn't exist) in a custom (TXXX) field named "RATING". For the RATING field, we accept 1-5 as valid ratings. For the POPM field things are more complicated, as there is no established standard in place. We currently most closely respect what Mediamonkey does, and also have some support for what Windows Media Player 11 does. The POPM tag takes a value from 0..255, with 0 meaning no rating, 1 the worst, and 255 the best. We currently map these as follows:<br />
<br />
{| class="prettytable"<br />
|- <br />
!'''POPM value''' || '''Star rating'''<br />
|- <br />
|0 ||<br />
|- <br />
|1 || '''*''' This is a special case for Windows Media Player<br />
|- <br />
| 2-8 || <br />
|- <br />
|9-49 || '''*'''<br />
|- <br />
|50-113 ||'''**'''<br />
|- <br />
|114-167 || '''***'''<br />
|- <br />
|168-218 || '''****'''<br />
|- <br />
|219-255 ||'''*****'''<br />
|}<br />
<br />
<br />
<br />
= Audio Formats & Tags =<br />
<br />
<br />
<br />
== Supported Audio Formats ==<br />
Although the list of playable formats is quite comprehensive, it is not accurate to say that every {{kodi}} installation will play every format. The ability to play some of the more obscure formats will depend upon the version of {{kodi}} and the operating system in use. Some formats will require the installation of add-ons.<br />
<br />
{{#lst:Advancedsettings.xml|musicextensions}}<br />
<br />
;{{See also|Advancedsettings.xml}}<br />
<br />
<br />
<br />
== Supported Metadata Containers ==<br />
The following metadata containers are supported by {{kodi}}<br />
<br />
{| class="prettytable"<br />
|-<br />
! Metadata Container || Note<br />
|-<br />
|[[wikipedia:APEv2 tag|APEv2 tag]] ||<br />
|-<br />
|[[wikipedia:Advanced_Systems_Format|ASF]] ||<br />
|-<br />
|Generic Tag || A generic tag for basic data from other odd file types<br />
|-<br />
|[[wikipedia:ID3|ID3]] || v1, v2.3 and v2.4<br />
|-<br />
|[[wikipedia:MPEG-4 Part 14#Metadata|MP4]] ||<br />
|-<br />
|[https://xiph.org/ Xiph.org] || Vorbis Comments<br />
|}<br />
<br />
<br />
<br />
== Common File & Tag Combination ==<br />
You will notice that not all the tags listed in the section ''Supported Audio Formats'' above are listed in the following table. Those formats that are ommitted do not have provision to support embedded tags. If your collection contains any of these unsupported formats, you will be unable to scan the music into the library. Your options are:<br />
#Convert your audio file to a supported format and tag using MusicBrainz Picard. (recommended)<br />
#Access your music via the File Manager or via File View<br />
<br />
{{kodi}} supports the following common Audio File and Tag Formats <br />
<br />
{| class="wikitable sortable" style="text-align:center;"<br />
|-<br />
!| Metadata container<br />
!| Additional Filename extensions<br />
|-<br />
| [[wikipedia:APEv2 tag|APEv2 tag]] || ape, mp3, aac, wv, mpc<br />
|-<br />
| [[wikipedia:Advanced_Systems_Format|ASF]] || asf, wmv, wma<br />
|-<br />
| Generic Tag || it, mod, module, nst, wow, s3m, xm<br />
|-<br />
| [[wikipedia:ID3|ID3 v1]] || mp3, aac<br />
|-<br />
| [[wikipedia:ID3|ID3 v2]] || mp3, aac, tta, aif, aiff, wav, flac<br />
|-<br />
| iTunes [[wikipedia:MPEG-4 Part 14#Metadata|MP4]] || .3g2 .m4a .m4b .m4p .m4r .m4v .mp4<br />
|-<br />
|[https://xiph.org/ Xiph.org] || flac, oga, ogg, opus<br />
|}<br />
<br />
Note:<br />
*FLAC files- xiph tags override id3v2 tags <br />
*mp3 files can have either id3 or APE tags<br />
*mka, dsf, dff - ID3v2 format read but are handled by ffmpeg tag reader and it does not support all tags from IDE standard)<br />
<br />
<br />
<br />
== Tags {{kodi}} reads ==<br />
{{kodi}} will scan the following tags embedded in the music file. The column ''{{kodi}} Version'' indicates the version of {{kodi}} that the tag was introduced, and will work in subsequent versions.<br />
<br />
<section begin="TagTable" /><br />
{| class="wikitable sortable" style="text-align:center;"<br />
|-<br />
! style="text-align:left;"| {{kodi}} Version<br />
! Vorbis (.Flac)<br />
! ID3v2 (.mp3)<br />
! APE<br />
! MP4<br />
! ASF<br />
|-<br />
|v16<br />
|ARTIST<br />
|TPE1<br />
|ARTIST<br />
|\251ART<br />
|Author<br />
|-<br />
|v16<br />
|ARTISTS<br />
|ARTISTS<br />
|ARTISTS<br />
| ----:com.apple.iTunes:ARTISTS<br />
| <br />
|-<br />
|v16<br />
|ALBUMARTIST or ALBUM ARTIST<br />
|TPE2 OR ALBUMARTIST or ALBUM ARTIST<br />
|ALBUMARTIST or ALBUM ARTIST<br />
|aART<br />
|WM/AlbumArtist<br />
|-<br />
|v16<br />
|ALBUMARTISTS or ALBUM ARTISTS<br />
|ALBUMARTISTS or ALBUM ARTISTS<br />
|ALBUMARTISTS or ALBUM ARTISTS<br />
| ----:com.apple.iTunes:ALBUMARTISTS<br />
|<br />
|-<br />
|v16<br />
|ALBUM<br />
|TALB<br />
|ALBUM<br />
|\251alb<br />
|WM/AlbumTitle<br />
|-<br />
|v16<br />
|TITLE<br />
|TIT2<br />
|TITLE<br />
|\251nam<br />
|<br />
|-<br />
|v16<br />
|TRACKNUMBER<br />
|TRCK<br />
|TRACKNUMBER or TRACK<br />
|trkn<br />
|WM/TrackNumber or WM/Track<br />
|-<br />
|v16<br />
|DISCNUMBER<br />
|TPOS<br />
|DISCNUMBER or DISC<br />
|disk<br />
|WM/PartOfSet<br />
|-<br />
|v16<br />
|YEAR<br />
|TYER<br />
|YEAR<br />
|\251day<br />
|WM/Year<br />
|-<br />
|v16<br />
|DATE<br />
|TDRC, TDRL<br />
|DATE<br />
|<br />
|<br />
|-<br />
|v16<br />
|GENRE<br />
|TCON<br />
|GENRE<br />
|\251gen<br />
|WM/Genre<br />
|-<br />
|v16<br />
|MOOD<br />
|TMOO OR TXXX:MOOD<br />
|MOOD<br />
| ----:com.apple.iTunes:MOOD<br />
|WM/Mood<br />
|-<br />
|v16<br />
|COMMENT<br />
|COMM<br />
|COMMENT<br />
|\251cmt<br />
|(COMMENT)<br />
|-<br />
|v16<br />
|CUESHEET<br />
|<br />
|CUESHEET<br />
|<br />
|<br />
|-<br />
|v16<br />
|COMPILATION<br />
|TCMP<br />
|COMPILATION<br />
|cpil<br />
|<br />
|-<br />
|v16<br />
|LYRICS<br />
|USLT<br />
|LYRICS<br />
|<br />
|<br />
|-<br />
|v16<br />
|REPLAYGAIN_TRACK_GAIN<br />
|REPLAYGAIN_TRACK_GAIN<br />
|REPLAYGAIN_TRACK_GAIN<br />
| ----:com.apple.iTunes:replaygain_track_gain<br />
|replaygain_track_gain<br />
|-<br />
|v16<br />
|REPLAYGAIN_ALBUM_GAIN<br />
|REPLAYGAIN_ALBUM_GAIN<br />
|REPLAYGAIN_ALBUM_GAIN<br />
| ----:com.apple.iTunes:replaygain_album_gain<br />
|replaygain_album_gain<br />
|-<br />
|v16<br />
|REPLAYGAIN_TRACK_PEAK<br />
|REPLAYGAIN_TRACK_PEAK<br />
|REPLAYGAIN_TRACK_PEAK<br />
| ----:com.apple.iTunes:replaygain_track_peak<br />
|replaygain_track_peak<br />
|-<br />
|v16<br />
|REPLAYGAIN_ALBUM_PEAK<br />
|REPLAYGAIN_ALBUM_PEAK<br />
|REPLAYGAIN_ALBUM_PEAK<br />
| ----:com.apple.iTunes:replaygain_album_peak<br />
|replaygain_album_peak<br />
|-<br />
|v16<br />
|REPLAYGAIN_ALBUM_PEAK<br />
|REPLAYGAIN_ALBUM_PEAK<br />
|REPLAYGAIN_ALBUM_PEAK<br />
| ----:com.apple.iTunes:replaygain_album_peak<br />
|replaygain_album_peak<br />
|-<br />
|v16<br />
|MUSICBRAINZ_ARTISTID<br />
|MUSICBRAINZ ARTIST ID<br />
|MUSICBRAINZ_ARTISTID<br />
| ----:com.apple.iTunes:MusicBrainz Artist Id<br />
|MusicBrainz/Artist Id<br />
|-<br />
|v16<br />
|MUSICBRAINZ_ALBUMARTISTID<br />
|MUSICBRAINZ ALBUM ARTIST ID<br />
|MUSICBRAINZ_ALBUMARTISTID<br />
| ----:com.apple.iTunes:MusicBrainz Album Artist Id<br />
|MusicBrainz/Album Artist Id<br />
|-<br />
|v16<br />
|MUSICBRAINZ_ALBUMARTIST<br />
|MUSICBRAINZ ALBUM ARTIST<br />
|MUSICBRAINZ_ALBUMARTIST<br />
| ----:com.apple.iTunes:MusicBrainz Album Artist<br />
|MusicBrainz/Album Artist<br />
|-<br />
|v16<br />
|MUSICBRAINZ_ALBUMID<br />
|MUSICBRAINZ ALBUM ID<br />
|MUSICBRAINZ_ALBUMID<br />
| ----:com.apple.iTunes:MusicBrainz Album Id<br />
|MusicBrainz/Album Id<br />
|-<br />
|v16<br />
|MUSICBRAINZ_TRACKID<br />
|UFID<br />
|MUSICBRAINZ_TRACKID<br />
| ----:com.apple.iTunes:MusicBrainz Track Id<br />
|<br />
|-<br />
|v16<br />
|RATING<br />
|POPM<br />
|<br />
| <br />
|<br />
|-<br />
|v16<br />
|METADATA_BLOCK_PICTURE or COVERART or COVERARTMIME<br />
|APIC<br />
|<br />
|covr<br />
|WM/Picture<br />
|-<br />
|v17<br />
|COMPOSER<br />
|TCOM<br />
|COMPOSER<br />
|\251wrt<br />
|WM/Composer<br />
|-<br />
|v17<br />
|CONDUCTOR<br />
|TPE3<br />
|CONDUCTOR<br />
| ----:com.apple.iTunes:CONDUCTOR<br />
|WM/Conductor<br />
|-<br />
|v17<br />
|LYRICIST<br />
|TEXT<br />
|LYRICIST<br />
| ----:com.apple.iTunes:LYRICIST<br />
|WM/Writer<br />
|-<br />
|v17<br />
|REMIXER or MIXARTIST<br />
|TPE4<br />
|REMIXER or MIXARTIST<br />
| ----:com.apple.iTunes:REMIXER<br />
|WM/ModifiedBy<br />
|-<br />
|v17<br />
|ENSEMBLE<br />
|(TIPL) or TXXX:Ensemble<br />
|ENSEMBLE<br />
|<br />
|<br />
|-<br />
|v17<br />
|ARRANGER<br />
|(TIPL)<br />
|ARRANGER<br />
|<br />
|<br />
|-<br />
|v17<br />
|ENGINEER<br />
|(TIPL)<br />
|ENGINEER<br />
| ----:com.apple.iTunes:ENGINEER<br />
|WM/Engineer<br />
|-<br />
|v17<br />
|PRODUCER<br />
|(TIPL)<br />
|PRODUCER<br />
| ----:com.apple.iTunes:PRODUCER<br />
|WM/Producer<br />
|-<br />
|v17<br />
|DJMIXER<br />
|(TIPL)<br />
|DJMIXER<br />
| ----:com.apple.iTunes:DJMIXER<br />
|WM/DJMixer<br />
|-<br />
|v17<br />
|MIXER<br />
|(TIPL)<br />
|MIXER<br />
| ----:com.apple.iTunes:MIXER<br />
|WM/Mixer<br />
|-<br />
|v17<br />
|PERFORMER<br />
|TMCL<br />
|PERFORMER<br />
|<br />
|<br />
|-<br />
|v17<br />
|LABEL<br />
|TPUB<br />
|LABEL<br />
| ----:com.apple.iTunes:LABEL<br />
|WM/Publisher<br />
|-<br />
|v17<br />
|RELEASETYPE<br />
|MUSICBRAINZ ALBUM TYPE<br />
|MUSICBRAINZ_ALBUMTYPE<br />
| ---:com.apple.iTunes:MusicBrainz Album Type<br />
|MusicBrainz/Album Type<br />
|-<br />
|v18<br />
|ARTISTSORT<br />
|TSOP<br />
|ARTISTSORT<br />
| <br />
|WM/ArtistSortOrder<br />
|-<br />
|v18<br />
|ALBUMARTISTSORT<br />
|TS02<br />
|ALBUMARTISTSORT<br />
|soaa<br />
|WM/AlbumArtistSortOrder<br />
|-<br />
|v18<br />
|COMPOSERSORT<br />
|TSOC<br />
|COMPOSERSORT<br />
|soco<br />
|WM/ComposerSortOrder<br />
|-<br />
|v18<br />
|WRITER<br />
|WRITER<br />
|WRITER<br />
|<br />
|-<br />
|}<br />
<section end="TagTable" /><br />
<br />
<br />
= References =<br />
<references /><br />
<br />
<br />
<br />
{{Top}}<br />
<br />
<div style="{{linear-gradient|left|#f5d3ff, #12b2e7}}">{{next|[[Adding_music_to_the_library|Scanning Music into Library]]}} </div><br />
<br />
<br />
{{updated|18}}<br />
[[Category:FAQ]]<br />
[[Category:Index]]<br />
[[Category:Guides]]<br />
[[Category:Manual]]<br />
[[Category:First time user]]<br />
[[Category:Music library]]<br />
[[Category:Advanced topics]]<br />
[[Category:Quick Start Guide]]</div>WhikiDudehttps://kodi.wiki/index.php?title=Releases&diff=166960Releases2019-05-12T13:41:22Z<p>WhikiDude: </p>
<hr />
<div>{{mininav| [[Kodi]] {{l2| [[Development]] }} }}<br />
<br />
{{see also|Changelogs}}<br />
<br />
== Release history ==<br />
<br />
This is a release history with condensed changelogs for the most important added or removed notable new features, functions, and changed in each stable version of {{kodi}}.<br />
<br />
{| class="prettytable"<br />
|-<br />
! colspan="2"| Legend<br />
|-<br />
| style="background:salmon;"| Red<br />
| Old releases<br />
|-<br />
| style="background:#a0e75a;"| Green<br />
| Current release<br />
|-<br />
| style="background:skyBlue;"| Blue<br />
| Future releases<br />
|}<br />
<br />
{| class="prettytable"<br />
|-<br />
! Version<br />
! Release date<br />
! [[Codename]]<br />
! Significant changes<br />
! XBMC Live based on<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 1.0.0<br />
| 29 June 2004<br />
| {{n/a}}<br />
|<br />
* Total rewrite of the source code from [[Xbox Media Player|XBMP (Xbox Media Player)]]<br />
|{{n/a}}<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 1.1.0<br />
| 18 October 2004<br />
| {{n/a}}<br />
|<br />
* ITU H.261, creative labs yuv (cyuv), supermac cinepak (cvid), quicktime, on2 vp4, 3ivx d4 / 3vi1 mpeg-4 video support<br />
* Container support for nsa, raw audio in .mov, .ac3, .dts and dts-wav<br />
* Zoom/stretch options: zoom, stretch 4x3 or 14x9 or 16x9, original size, custom<br />
* Volume control<br />
* Tags parsing and display for wma, m4a, mp4 and aac (mpeg-4 audio) audio-files<br />
* International-language fonts for subtitles via ttf-fonts<br />
* Audio CD Ripper, backup cdda's to hdd in wav, ogg or mp3 (lame) format<br />
* Karaoke cdg-file and audio cue sheets (.cue) support<br />
* iIunes music shares via DAAP (network stream from Apple iTunes)<br />
* XBMC's xbmsp-client code updated to support "auto-discovery of xbmsp servers"<br />
* Auto-temperature and fan-speed control options<br />
* Network-configuration and setup via GUI<br />
* Emergency recovery console (enables the ftp-server during fatal errors)<br />
* Profiles for settings<br />
* Mouse support and virtual-keyboard<br />
* LCD-display output extended to also support xaddons lcd-mods and xecuter3 lcd<br />
| {{n/a}}<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 2.0.0<br />
| {{nowrap|29 September 2006}}<br />
| {{n/a}}<br />
|<br />
* Reworked skinning engine.<br />
* DVD-Video menu/navigation support (with ISO/IMG image parsing) through internally developed core<br />
* RAR/ZIP archive parsing<br />
* New audio/music-player (PAPlayer) with crossfade, gapless playback and ReplayGain support<br />
* Karaoke CDG-file display<br />
* Xored Trainer Engine (gaming-cheats) (not ported from Xbox)<br />
* XLink Kai (online-gaming) front-end (depreciated)<br />
* Added iTunes 6.x DAAP and UPnP-client<br />
* Read-only support for FAT12/16/32 formatted USB Mass Storage Devices up to 4GB in size<br />
* Brand new "skinnable" 3D visualizer.<br />
| {{n/a}}<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 8.10<br />
| 15 November 2008<br />
| Atlantis<br />
|<br />
* Cross platform support adding support for Linux, Mac OS X, and Windows<br />
* Brand new High Definition skin “PM3.HD”<br />
* "XBMC Live" bootable CD with unified hard disk/USB flash disk installer<br />
* The XBMC profile<br />
* Integration of iTunes and iPhoto media (OS X exclusive).<br />
| Ubuntu 8.10<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 9.04<br />
| 6 May 2009<br />
| Babylon<br />
|<br />
* PPC (PowerPC) support for Mac OS X (PowerPC G4 or later)<br />
* VDPAU (Nvidia's Video Decode and Presentation API for Unix)<br />
* New Karaoke features<br />
* Officially dropped support for Xbox<br />
* Updated codecs and major bug-fixes for DVD-Video playback core<br />
* More Media Info Scrapers<br />
* Improved FanArt support<br />
* Revamped skinning engine<br />
| Ubuntu 9.04<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 9.11<br />
| 24 December 2009<br />
| Camelot<br />
|<br />
* Revamped user interface via the new default skin “Confluence“<br />
* DirectX support by default for the Windows platform<br />
* A complete reorganization of the settings menus uniformed across skins<br />
* Automatic video information extraction<br />
* Out of the box support for new remotes<br />
* Smoother video playback performance<br />
* All scrapers updated<br />
* Increased subtitle and Karaoke lyric support<br />
* Support for CoreAudio API (OS X exclusive)<br />
* AC3 and DTS digital audio pass-through to SP/DIF on Apple TV (thanks to CoreAudio)<br />
| Ubuntu 9.10<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 10.0<br />10.1<br />
| 18 December 2010<br />10 March 2011<br />
| Dharma<br />
|<br />
* Unified Addon framework<br />
* Addon Browser GUI for installation and management of third-party addons, skin, and scripts<br />
* Team XBMC's official Addons Repository with Addon FanArt support<br />
* Update Notifications<br />
* Movie Sets (option to group movie collections)<br />
* WebM/VP8 codec<br />
* Gesture support to XBMC's GUI Engine<br />
* Unencrypted Blu-ray Disc support<br />
* Broadcom Crystal HD video acceleration support (All Platforms)<br />
* Windows Touch API support (Windows 7 touch features and functions)<br />
* DXVA 2.0 (DirectX Video Acceleration) (Windows Vista/7 exclusive)<br />
* WASAPI (Windows Audio Session API) for raw bitstream output (Windows Vista/7 exclusive)<br />
* High-Quality Bicubic and Lanczos Upscalers (Video Resamplers) as Direct3D HLSL (Windows Vista/7 exclusive) and OpenGL GLSL Shaders<br />
* Direct3D port of the OpenGL Spectrum 3D Audio Visualization for DirectX (Windows Vista/7 exclusive)<br />
* AVisual Studio 2010 Express edition and Visual Studio 2010 non-Express edition support (Windows Vista/7 exclusive)<br />
* ARM processor architecture (Linux exclusive)<br />
* VAAPI (Video Acceleration API) support (Linux exclusive)<br />
* OpenMAX Video Acceleration support (Linux exclusive)<br />
* NEON (ARM) Video Acceleration support (Linux exclusive)<br />
* Apple VDADecoder Video Acceleration support (OS X exclusive requires Snow Leopard and NVIDIA 9400 or later)<br />
* OpenGL ES 2.0 compliance<br />
* JSON-RPC, JSON API<br />
* RTMPE and RTMPTE<br />
* Microhttpd Web Server replaces old GoAhead and Spyce code<br />
* SSH file transfer protocol (sftp) via libssh<br />
* MySQL database backend<br />
| Ubuntu 10.04<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 11.0<br />
| 24 March 2012<br />
| Eden<br />
|<br />
{{main|XBMC v11 (Eden) changelog|Eden API changes}}<br />
* iOS port for Apple TV 2G, iPhone, iPod Touch, and iPad<br />
* [[Dirty regions]] rendering for texture support to skinning engine<br />
* Efficiency improvements to reduce high cpu/gpu usage<br />
* Default skin changed to a horizontal home layout<br />
* New RenderCapture type to the Python script framework<br />
* Combined Files and Library mode for videos<br />
* Playback of ISO image files for Blu-ray Disc support<br />
* Slingbox playback over the network support<br />
* Peripheral manager controller under settings<br />
* Consumer Electronics Control (CEC) support for HDMI<br />
* Improved Apple VDADecoder Video Acceleration support<br />
* Improved Touch / Gesture API and Mouse support<br />
* Improved ARM processor architecture support<br />
* Improved OpenMAX Video Decoding Acceleration support<br />
* Improved OpenGL ES and EGL support<br />
* Improved JSON-RPC API compliant with JSON-RPC 2.0 specs<br />
* Improved VDPAU performance<br />
* VDPAU HQ Upscaling support (require NVIDIA's capable GPU)<br />
* H.264 accelerated video decoding via Apple's VideoToolBox API<br />
* JPEG accelerated video decoding via Apple's VideoToolBox API<br />
* Added basic DRC (Dynamic Range Compression) volume limiter<br />
* [[AirPlay|AirPlay/AirTunes]] target support<br />
* Extended Addons API adding extension points for Service Addons<br />
* Ability for all addons to provide their own web interface<br />
* Removed native weather forecast scraper, use weather add-ons instead<br />
* Added support for multiple simultaneous HID device mappings<br />
* FFmpeg upgraded (libavformat and libavcodec)<br />
| Lubuntu 11.10<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 12.0<br />12.1<br />12.2<br />12.3<br />
| 29 January 2013<br />18 March 2013<br />3 May 2013<br />{{nowrap|24 December 2013}}<br />
| Frodo<br />
|<br />
{{main|XBMC v12 (Frodo) changelog|Frodo API changes}}<br />
* Added unified [[PVR|Live TV and PVR frontend]] with a common EPG and DVR (Digital Video Recording) client GUI<br />
* Added unified PVR backend framework and API for multiple [[PVR/Backend|PVR backend software]] from third-parties<br />
* Initial [http://en.wikipedia.org/wiki/Android_%28operating_system%29 Android (operating system)] port with multi-architecture platform support<br />
* Initial [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] port for FreeBSD, PC-BSD, and other similar BSD platforms<br />
* Added unified "[[AudioEngine]]" audio abstraction framework with an API and platform sinks<br />
* Added dedicated AMLPlayer video player for hardware accelerated video decoding on [[AMLogic devices|Amlogic]]<br />
* Added dedicated OMXPlayer video player for hardware accelerated video decoding via OpenMAX IL API<br />
* [http://en.wikipedia.org/wiki/ARM_architecture#Advanced_SIMD_.28NEON.29 NEON (Advanced SIMD instruction set)] CPU acceleration support for the ARM architecture<br />
* Improved ARM processor architecture ([http://www.pivosgroup.com/xios.html Pivos XIOS DS] and [[Raspberry Pi]] as reference devices)<br />
* Improved OpenGL ES and EGL support ([http://www.pivosgroup.com/xios.html Pivos XIOS DS] and [[Raspberry Pi]] as reference devices)<br />
* Added ability to run a split display resolution for GUI and video playback on embedded platforms[http://github.com/xbmc/xbmc/pull/1467]<br />
* Enabled [[Dirty regions|Dirty Regions]] rendering to redraw whole screen on single dirty region by default on all platforms[http://github.com/xbmc/xbmc/pull/1426][http://xbmc.org/theuni/2011/06/19/working-with-dirty-regions/]<br />
* Added 64-bit build support Mac OS X to match the existing 64-bit support for Linux<br />
* Improved [http://en.wikipedia.org/wiki/HDMI#CEC|HDMI CEC (Consumer Electronics Control)] support for [http://libcec.pulse-eight.com/ Pulse-Eight's LibCEC]<br />
* Library customization that allows for custom video nodes<br />
* Added [[Advanced Library Filtering]] for Movies, TV Shows, Music Videos, and Music views<br />
* Improved [[Smart playlists|Smart Playlist]] for Advanced Library Filtering<br />
* Added custom [[video library tags]] for Movies, TV Shows and Music Videos to simplify sets with scraping<br />
* Added support for both banner and poster video art types simultaneously[http://github.com/xbmc/xbmc/pull/1575]<br />
* Added storing of "Episode ID" for First Aired, DVD Episode Number, and Absolute Number sort order<br />
* Added support for exporting video art as JPG or PNG rather than TBN file extension<br />
* Switched to [http://en.wikipedia.org/wiki/TagLib TagLib] for reading metadata embedded into audio files<br />
* Better library database handling for faster browsing<br />
* Improved image and texture caching for GUI speedup<br />
* Improved Touch / Gesture API support for touchscreen interfaces<br />
* Added HLS (HTTP Live Streaming) and M3U8 (Extended M3U) playlist support<br />
* Added WebSocket support for JSON-RPC and to Addons API[http://github.com/xbmc/xbmc/pull/511]<br />
* Added image transformation handler for resizing images on-the-fly over JSON-RPC and WebServer API<br />
* Added basic support for PVR / EPG extensions and notifications over the JSON-RPC API<br />
* Added SmartPlaylist Extensions and Extended Filtering in JSON-RPC[http://github.com/xbmc/xbmc/pull/1258]<br />
* Added support for screensavers written in Python programming language<br />
* Added ability to [http://github.com/xbmc/xbmc/pull/901 extend XBMC's native Python API by writing C++ code generated] via [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 Groovy] and [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 SWIG]<br />
* Blu-ray Disc HDMV menu support (but not BD-J / BD-Live menus)[http://github.com/xbmc/xbmc/pull/464]<br />
* Improved deinterlacing "Weave" method for playback of interlaced video when upscaling<br />
* Improved performance of the default Web Interface (complete rewrite of JavaScript loading)<br />
* Improved AirPlay / AirTunes target support<br />
* Improved the Audio-CD ripper that now works as a background task job<br />
* Improved international language file translations system that are powered by Transifex[http://xbmc.org/blittan/2012/10/30/dear-addon-and-skin-developers/]<br />
* Added a Test Suite based on [http://code.google.com/p/googletest/ Google C++ Testing Framework] to make regression testing easier<br />
* Added support controlling external XBMC and third-party UPnP/DLNA instances over UPnP<br />
* Upgraded [http://www.plutinosoft.com/platinum Plutinosoft's Platinum (libplatinum)] UPnP and DNLA libraries<br />
* Upgraded [http://en.wikipedia.org/wiki/FFmpeg FFmpeg's libavcodec and libavformat] audio/video cedec and demuxer libraries<br />
* Removed the old HTTP API in favour of the new JSON-RPC API<br />
| Lubuntu 12.10<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 13.0<br />13.1<br />13.2<br />
| 4 May 2014<br />5 June 2014<br />17 August 2014<br />
| Gotham<br />
|<br />
{{main|XBMC v13 (Gotham) changelog|Gotham API changes}}<br />
* Added much improved PVR / EPG and Live TV interface in XBMC's GUI skinning engine (already in use in Confluence)<br />
* Added improved PVR / DVR timeshift support to pause Live TV (note that each PVR backend still need to support timeshifting)<br />
* Added much improved PVR / EPG extensions and notifications support over the JSON-RPC API<br />
* Improved PVR front-end with Live TV and EPG specific windows, plus PVR stuff in OSD and GUI settings in Confluence skin<br />
* Added, updated, and improved PVR backend clients addons for many popular third-party external [[PVR backend]] platforms:<br />
** [[PVR/Testing|PVR Demo Client]] dummy addon with fake backend from Team-XBMC for skin development and regression testing<br />
** [[PVR/Backend/IPTV|IPTV (IPTV Simple Client)]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/Tvheadend|Tvheadend]] PVR Addon backend clients maintained and available from XBMC's community<br />
** [[PVR/Backend/NextPVR|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/Njoy|Njoy Digital (N7)]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/MediaPortal|MediaPortal]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/MythTV|MythTV]] PVR Addon backend client maintained and available from the XBMC's community<br />
** [[PVR/Backend/VDR|VDR (Video Disk Recorder)]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/VUPlus|Vu+ / Enigma2 / Dreambox]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/ForTheRecord|Argus TV / ForTheRecord]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[DVBLink]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/DVBViewer|DVBViewer]] PVR Addon backend client maintained and available from XBMC's community<br />
* Added option for allowing skins to query directories (e.g. plugins) to fill static content<br />
* Added a Monitor class to receive JSON-RPC notifications directly through the Python bindings<br />
* Added announce function and register addon for announcements to the Add-ons API<br />
* Added new Built-In function to control state of attached HDMI CEC device via Add-ons API<br />
* Added support for XBMC's Python interface to use native keyboard if possible (currently only iOS) <br />
* Added support for addon binary reading and writing via a "buffer" class usable from addons<br />
* Added WOL (Wake-on-LAN) with send magic packet function to the Add-ons API<br />
* Improved the ability to [http://github.com/xbmc/xbmc/pull/901 extend XBMC's native Python API by writing C++ code generated] via [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 Groovy] and [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 SWIG]<br />
* Improved Addons API for homebrew DIY RGB LED [http://en.wikipedia.org/wiki/Ambilight Ambilight] clone client software such as [[Add-on:XBMC Boblight|Boblight]]<br />
* Added support for customizable menu structure for home and beyond<br />
* Added Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) to XBMC's GUI skinning engine<br />
* Added Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) for Subtitles when in 3D mode<br />
* Added a simple Movie Set management to GUI for Edit/Clear Set and Add/Remove Set members<br />
* Added option support for both banner and poster music art types simultaneously<br />
* Added picture tags metadata info accessible for skins or addons developers<br />
* Added further optimizations to XBMC's GUI engine for faster rendering on low resource embedded devices<br />
* Improved touch and gesture support for all platforms, and also improved the default touch screen skin ([[Touched]])<br />
* Added [http://github.com/xbmc/xbmc/pull/2040 ImageFactory implementation] with factory to abstract different image libraries and hardware acceleration<br />
* Improved [[Dirty regions|Dirty Regions]] rendering on all platforms<br />
* Refactored settings system to consist of XML files containing descriptions of every setting<br />
* Added support for H.264 (including [[Hi10P]]) multi-threaded video decoding when software decoder on CPU is used<br />
* Added support for Forced Subtitles ("forced flag") in external subtitle files<br />
* Added support for video playback of SageTV recordings <br />
* Added unified buffering capability to video and overlay renderers for all internal players<br />
* Upgraded FFmpeg (libavcodec and libavformat) audio/video codec and demuxer libraries to [http://www.ffmpeg.org/download.html#release_1.2 FFmpeg 1.2 (rev e820e3a)]<br />
* Added extensive MusicBrainz tags support to the Music Library and Database<br />
* Added ability to queue list of items / add items to a playlist without playing them<br />
* Improved and extended [[Smart playlists|Smart Playlists]] functionality<br />
* Added support for scanning videos SFTP and SSH sources so can scrape metadata<br />
* Added support for write-enabled WebDAV (delete/rename/write files and directories)<br />
* Added "Add art" button to video artwork selection dialog<br />
* Added support for "last played" sort option to the TV Show GUI<br />
* Added support for OGG cover art extraction to TagLib<br />
* Added option support for exporting music art as JPEG or PNG rather than TBN file extension<br />
* Improved performance for SQL database queries for faster browsing<br />
* Added theaudiodb.com music video scraper as new default for music videos<br />
* Added new cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] sink as the default for XBMC's [[AudioEngine]]<br />
* Added ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems<br />
* Added PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop<br />
* Added OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD, PC-BSD, and similar Unix based systems<br />
* Added AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]<br />
* Added Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]<br />
* Added DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Added WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Added Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for Mac OS X and iOS<br />
* Added support for CoreAudio AudioEngine to OS notifications for device changes on Mac OS X and iOS<br />
* Added support for "Play to" and controlling remote XBMC / DLNA instance over UPnP<br />
* Added new "Fishbmc" audio visualization addon (only OpenGL versions for Linux and Mac OS X for now)<br />
* Added GUI settings levels for Basic, Standard, Advanced, Expert (defaults to "Standard")<br />
* Added support and GUI settings for SOCKS 4/4a/5 proxy types and remote DNS<br />
* Added possibility to define help descriptions ("I" key) for every setting in GUI settings<br />
* Added option to set auto login of a specific user profile via the GUI<br />
* Added CPU / GPU frequency and temperature for all supported Linux platforms<br />
* Added support to allow key IDs in keyboard.xml to be in hexadecimal format<br />
* Upgraded DVD-Video navigation and playback libraries (libdvdnav, libdvdread, and libdvdcss)<br />
* Upgraded SAMBA client to version 3.6.x adding full support for SMB 2.0 and SMB 2.1 protocols<br />
* Added initial support for running libxbmc.so headless (without GUI) as a background service / deamon<br />
* Added a generic and user-mappable cross-platform touch input system<br />
* Improved [http://en.wikipedia.org/wiki/HDMI#CEC|HDMI CEC (Consumer Electronics Control)] support for [http://libcec.pulse-eight.com/ Pulse-Eight's LibCEC]<br />
* Moved subtitle addon core handling to core and added native support for subtitle plugin services<br />
* Updated community maintained translations to over 60+ languages to date for XBMC via [[Translation System|Transifex Translation System]]<br />
* Added first full (and stable) XBMC for [[Android]] port with multi-architecture platform support (supports ARM, MIPS, and x86)<br />
* Added built-in command for addons and skins to execute Android apps with optional params via applicationmanager<br />
* Added support to allow landscape and reverse landscape orientation of XBMC GUI on Android<br />
* Added MediaCodec API (Android 4.1 API level 16) software rendering implementation support to XBMC's DVDPlayer<br />
* Added StageFright API (Android 4.0 API level 14) hardware rendering implementation support to XBMC<br />
* Added OpenMAX Video Acceleration API support for OpenMAX AL API on Android via StageFright and MediaCodec<br />
* Improved the dedicated AMLPlayer video player for hardware accelerated video decoding on [[AMLogic devices|Amlogic]]<br />
* Added external player (external player launcher) support on Android<br />
* Added native volume control for Android from within XBMC<br />
* Improved [http://en.wikipedia.org/wiki/ARM_architecture#Advanced_SIMD_.28NEON.29 NEON (Advanced SIMD instruction set)] CPU acceleration support for ARM architecture<br />
* Improved XBMC support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms<br />
* Improved VDPAU (NVIDIA) Hardware Acceleration Video Decoding support on BSD<br />
* Improved VAAPI (Video Acceleration API) Hardware Acceleration Video Decoding support on BSD<br />
* Added VA-API (libva) support for decoding videos with larger resolutions than 1080p (such as 4K resolution)<br />
* Improved ARM processor architecture ([http://www.pivosgroup.com/xios.html Pivos XIOS DS] and [[Raspberry Pi]] as reference devices)<br />
* Improved OpenGL ES and EGL support ([http://www.pivosgroup.com/xios.html Pivos XIOS DS] and [[Raspberry Pi]] as reference devices)<br />
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)<br />
* Improved VDPAU (NVIDIA) Hardware Video Acceleration and its upscaling/deinterlacing capabilities<br />
* Improved OpenMAX Video Acceleration API support for Linux (using Raspberry Pi as reference hardware)<br />
* Added RenderCapture implementation to Linux for Raspberry Pi for Ambilight addons<br />
* Added support for OpenMAX pipeline to handle JPEG decode/resize/convert/encode to texture on Raspberry Pi<br />
* Added support for hardware assisted video decoding of MJPEG, VP6, VP8 and Ogg Theora on Raspberry Pi<br />
* Added support for Fast Forward and Rewind video up 4x to OpenMAX (OMXPlayer) on Linux for Raspberry Pi<br />
* Added support multi-channel PCM audio output over HDMI to OpenMAX (OMXPlayer) on Linux for Raspberry Pi<br />
* Added screenshot implementation to Linux for Raspberry Pi that includes the video layer<br />
* Added hot-plug support for Linux input devices, such as Bluetooth remotes and keyboards<br />
* Improved AMD/Intel x86-64 64-bit (AMD64 / IA-64t CPU architectures) support under Linux<br />
* Removed dependencies of SDL (Simple DirectMedia Layer) for windowing and event handling on X11<br />
* Added support for native media control bar and play background music on iOS<br />
* Added adaptions for developing XBMC on non-jailbroken iSO devices (for development only, not to release on App Store)<br />
* Improved XBMC support for OS X 10.9 (Mavericks)<br />
* Added support for copy and paste to and from clipboard with command key<br />
* Added support for Pixel Shader based HQ (High Quality) scalers for DXVA renderer on Windows<br />
* Added hybrid shutdown option on Windows 8 (which in turn enables quick boot)<br />
* Removed Windows XP support (as from now XBMC for Windows requires at least Vista or later)<br />
| Lubuntu 14.04<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 14.0<br />14.1<br />14.2<br />
| 23 December 2014<br />1 February 2015<br />28 March 2015<br />
| Helix<br />
|<br />
{{main| Kodi v14 (Helix) changelog |Helix API changes}}<br />
* Renamed and rebranded to Kodi Media Center (from XBMC Media Center)<br />
* Improved PVR, EPG, and OSD frontend GUI in Kodi and extended the PVR API to support more features and functions<br />
* Improved PVR / EPG and Live TV interface in Kodi's GUI skinning engine (already in use in Confluence)<br />
* Improved PVR / DVR timeshift support to pause Live TV (note that each PVR backend still need to support timeshifting)<br />
* Improved PVR / EPG extensions and notifications support over the JSON-RPC API<br />
* Updated and improved PVR backend clients addons for many popular third-party external PVR backend platforms:<br />
* PVR Demo Client dummy addon with fake (method stub) backend for skin development and regression testing<br />
* IPTV (IPTV Simple Client) PVR Addon backend client maintained and available from Kodi's community<br />
* Tvheadend PVR Addon backend clients maintained and available from Kodi's community<br />
* NextPVR (former GB-PVR) PVR Addon backend client maintained and available from Kodi's community<br />
* Njoy Digital (N7) PVR Addon backend client maintained and available from Kodi's community<br />
* MediaPortal PVR Addon backend client maintained and available from Kodi's community<br />
* MythTV PVR Addon backend client maintained and available from the Kodi's community<br />
* VDR (Video Disk Recorder) PVR Addon backend client maintained and available from Kodi's community<br />
* Enigma2 / Vu+ / Dreambox PVR Addon backend client maintained and available from Kodi's community<br />
* Argus TV / ForTheRecord PVR Addon backend client maintained and available from Kodi's community<br />
* WMC (Windows Media Center) PVR Addon backend client maintained and available from Kodi's community<br />
* DVBLink PVR Addon backend client maintained and available from Kodi's community<br />
* DVBViewer PVR Addon backend client maintained and available from Kodi's community<br />
* Added framework support for binary addons (inc. closed source proprietary addons) for audio encoder codecs<br />
* Added support for audio encoder codecs via a binary addons and move Vorbis, LAME, Flac and WAV audio encoders to addons<br />
* Added capability for Text-to-Speech screen readers addons for visual impaired<br />
* Improved the ability to extend Kodi's native Python API by writing C++ code generated via Groovy and SWIG<br />
* Improved Addons API for homebrew DIY RGB LED Ambilight clone client software such as Boblight<br />
* Improved Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) to Kodi's GUI skinning engine<br />
* Improved Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) for Subtitles when in 3D mode<br />
* Added support for HEVC (High Efficiency Video Coding) a.k.a. H.265 software video decoding<br />
* Improved support for H.264 (including Hi10P) multi-threaded video decoding when software decoder on CPU is used<br />
* Upgraded FFmpeg (libavcodec and libavformat) audio/video codec libraries to release version FFmpeg 2.2)<br />
* Removed FFmpeg from from the Kodi code tree, making it easier to compile/build separately<br />
* Improved network and file system reading when scanning files and searching for subtitles<br />
* Improved MusicBrainz tags support to the Music Library and Database<br />
* Improved and extended Smart Playlists functionality<br />
* Improved performance for SQL database queries for faster library browsing<br />
* Updated music, movies, tv shows, and music video scrapers for Kodi from the community<br />
* Added support for Planar Formats and PTS audio synchronization from player in ActiveAE<br />
* Improved the default cross-platform event driven active state machine pattern ActiveAE (Kodi's AudioEngine)<br />
* Improved ALSA sink for ActiveAE for Linux Desktop and generic Linux based Embedded Systems<br />
* Improved PulseAudio sink for ActiveAE for Linux Desktop<br />
* Improved OSS (Open Sound System) sink for ActiveAE for BSD, like FreeBSD and similar BSD Unix based systems<br />
* Improved AUDIOTRACK sink for ActiveAE for Amlogic<br />
* Improved Pi Audio sink for ActiveAE for Raspberry Pi<br />
* Improved DirectSound sink for ActiveAE for Windows<br />
* Improved WASAPI sink for ActiveAE for Windows<br />
* Improved CoreAudio sink for ActiveAE for Mac OS X and iOS<br />
* Improved Darwin sink for ActiveAE for Mac OS X and iOS<br />
* Improved CEC (Consumer Electronics Control) support for Pulse-Eight's LibCEC<br />
* Upgraded DVD-Video navigation and playback libraries (libdvdnav, libdvdread, and libdvdcss)<br />
* Upgraded SAMBA client to version 3.6.x for improved support for SMB and CIFS protocols<br />
* Updated community maintained translations to over 60+ languages to date for Kodi via Transifex Translation System<br />
* Improved MediaCodec API video decoding implementations support for Android 4.1 (API level 16) and later<br />
* Improved StageFright API video decoding implementations support for Android 4.0 (API level 14)<br />
* Improved the dedicated AMLCodec hardware accelerated video decoding support for AMLogic devices<br />
* Improved NEON (Advanced SIMD instruction set) CPU acceleration support for ARM architecture<br />
* Improved Kodi support for BSD (operating system) on FreeBSD, PC-BSD, and other similar BSD platforms<br />
* Added initial optional X11 support on EGL (EGL-X11) based systems on Linux, full-screen mode only<br />
* Added native XvBA accelerated video decoding for AMD/ATI GPUs on Linux<br />
* Improved ARM processor architecture (using WeTek Play and Raspberry Pi as reference devices)<br />
* Improved OpenGL ES and EGL support (using WeTek Play and Raspberry Pi as reference devices)<br />
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)<br />
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)<br />
* Improved OpenMAX Video Acceleration API support for Linux (using Raspberry Pi as reference hardware)<br />
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on AMLogic devices<br />
* Improved AMD/Intel x86-64 64-bit (AMD64 / IA-64t CPU architectures) support under Linux<br />
* Upgraded SDL (Simple DirectMedia Layer) from version 1.2 to 2.0 for improved input-support on Linux<br />
* Removed dependencies of SDL (Simple DirectMedia Layer) for windowing and event handling on X11<br />
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)<br />
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X<br />
* Improved DXVA (DirectX Video Acceleration) support (requires DXVA compatible hardware and drivers)<br />
* Upgraded Kodi for Windows and binary addons to compile with Microsoft Visual Studio 2013 by default<br />
<br />
| <br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 15.0<br />15.1<br />15.2<br />
| 21 July 2015<br />16 August 2015<br />19 October 2015<br />
| Isengard<br />
|<br />
{{main| Kodi v15 (Isengard) changelog |Isengard API changes}}<br />
* Added possibility to use multiple PVR clients for different PVR backends at the same time<br />
* Improved PVR, EPG, and OSD frontend GUI in Kodi and extended the PVR API to support more features and functions<br />
* Improved PVR API and database adding many new EPG and Channel properties<br />
* Improved PVR / DVR timeshift support to pause Live TV (note that each PVR backend still need to support timeshifting)<br />
* Improved PVR / EPG extensions and notifications support over the JSON-RPC API<br />
* Improved Closed Captions (CC) support for Live TV<br />
* Improved the "GlobalSearch" (service addon) function by adding EPG search support<br />
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:<br />
** [[PVR/Testing|PVR Demo Client]] dummy addon with fake (method stub) backend for skin development and regression testing<br />
** [[PVR/Backend/IPTV|IPTV (IPTV Simple Client)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/Tvheadend|Tvheadend]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/NextPVR|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/Njoy|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/MediaPortal|MediaPortal]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/MythTV|MythTV]] PVR Addon backend client maintained and available from the Kodi's community<br />
** [[PVR/Backend/VDR|VDR (Video Disk Recorder)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/VUPlus|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/ForTheRecord|Argus TV / ForTheRecord]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[DVBLink]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/DVBViewer|DVBViewer]] PVR Addon backend client maintained and available from Kodi's community<br />
* Removed internal MythTV VFS client code in favour of its external PVR Client Addons<br />
* Removed internal VDR (VTP) VFS client code in favour of its external PVR Client Addons<br />
* Removed internal Tvheadend (HTSP) VFS client code in favour of its external PVR Client Addons<br />
* Removed internal TuxBox (Dreambox/DBox2/Vu+/Enigma1/2) VFS client code in favor of external PVR Client Addons<br />
* Removed internal ReplayTV (DirectTV) VFS client code since its old and was no longer being maintained by anyone<br />
* Removed internal SlingBox VFS client code since its old and is no longer being maintained by anyone<br />
* Improved Addon Manager frontend GUI in Kodi, adding support for categorization, new manager layout and more<br />
* Added initial integration for binary addons support and changing the Kodi build system around it<br />
* Added framework support for binary addons for audio decoder and audio encoder codecs<br />
* Extend Addons API to support binary addons for audio decoder and audio encoder codecs<br />
* Added support for context-menu addons for skinners and addon developers<br />
* Added option for addons scripts to check status of DPMS energy saving functions of underlying OS<br />
* Improved the ability to [http://github.com/xbmc/xbmc/pull/901 extend Kodi's native Python API by writing C++ code generated] via [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 Groovy] and [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 SWIG]<br />
* Improved Addons API for homebrew DIY RGB LED [[Ambient lighting]] (Ambilight clone) client software such as [[Add-on:XBMC Boblight|Boblight]]<br />
* Improved addon management at Kodi version upgrade by immediately fetch updates from repository after upgrade<br />
* Added support for context-menu addons for skinners and addon developers<br />
* Added support Sound Addons for skins instead of including sound files within each skin.<br />
* Improved PVR / EPG / Live TV and context menus interfaces in Kodi's GUI skinning engine (already used in Confluence)<br />
* Added support for Language Addons, moving internal Language translation files into external Language Addons<br />
* Added an accessibility settings section to provide one configuration area for the visually and hearing impaired<br />
* Added further optimizations to Kodi's GUI engine for faster rendering on low resource embedded devices<br />
* Added new icon types and missing icons to Confluence<br />
* Added PVR and EPG support to the Re-Touched (touchscreen friendly) skin<br />
* Improved [[Dirty regions|Dirty Regions]] rendering on all platforms<br />
* Improved Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) to Kodi's GUI skinning engine<br />
* Improved Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) for Subtitles when in 3D mode<br />
* Improved navigation of video audio tracks and subtitle selection lists<br />
* Improved touch and gesture support for all platforms, and also improved the default touch screen skin ([[Add-on:Re-Touched|Re-Touched]])<br />
* Improved and expanded the internationalization options and regional configuration settings in the GUI<br />
* Improved GUI settings configuration levels for Basic, Standard, Advanced, Expert (defaults to "Standard")<br />
* Improved selection when installing new skins <br />
* Update the default bold and regular Roboto TTF fonts from Google <br />
* Updated keyboard layout for many languages<br />
* Restructured settings windows and descriptions for almost every setting and configuration<br />
* Removed legacy code to backwards compatibility for skins made pre-Frodo (XBMC 11.0)<br />
* Added adaptive skipping/seeking through audio and video playback, also known as "[[skip steps]]"<br />
* Improved support for H.264 (including [[Hi10P]]) multi-threaded video decoding when software decoder on CPU is used<br />
* Improved Stereoscopic 3D playback with video playlist switching when playlists have 2D and 3D videos<br />
* Added support for MK3D (Matroska 3D) video extensions and enable double cache by default on these videos<br />
* Added a Chapter Selector Window with visual thumbnails shows thumbs on where to skip to in video<br />
* Added support for Closed Captions (CC) in CEA-608 and CEA-708 formats (ATSC Closed Caption)<br />
* Added support for external subtitles over UPnP / DNLA through the settings section<br />
* Upgraded FFmpeg (libavcodec and libavformat) libraries to release version [http://www.ffmpeg.org/download.html#release_2.6.2 FFmpeg 2.6.2]<br />
* Remove certain audio codecs from core and made them into audio decoder and audio encoder add-ons<br />
* Disabled hardware video decoding of MPEG-2 videos with Standard Definition resolution by default<br />
* Added support for [[Music_nodes| music nodes]] that can defined views that are used to organize your media from the music menu<br />
* Added support for marking as watched during other library operations like “update library” when scanning sources<br />
* Added support for allowing different sort orders for different sort methods<br />
* Added ability to jump to first unwatched episode in TV section by default<br />
* Added support to rescrape season art for newly added seasons<br />
* Improved MusicBrainz tags support to the Music Library and Database<br />
* Improved and extended [[Smart playlists|Smart Playlists]] functionality<br />
* Improved performance for SQL database queries for faster library browsing<br />
* Updated music, movies, tv shows, and music video scrapers for Kodi<br />
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])<br />
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems<br />
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop<br />
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems<br />
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]<br />
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]<br />
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS<br />
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS<br />
* Added new audio visualization addons (only OpenGL versions for Linux and OS X for now)?<br />
* Improved display of CPU / GPU frequency and temperature for all supported platforms<br />
* Improved keymap for music playback, as while in full screen pressing select/ok button will now show the OSD<br />
* Added support for [[wikipedia:WSGI|WSGI (Web Server Gateway Interface)]] to extend the Python Script support in Kodi's integrated webserver<br />
* Added support for JSONP for JSON-RPC requests to Kodi's integrated webserver<br />
* Added support for image resizing to Kodi's integrated webserver<br />
* Improved webserver caching control<br />
* Improved the JSON-RPC API<br />
* Improved the the integrated UPnP Media Server and Client<br />
* Changed Kodi application code base to C++11<br />
* Improved [[CEC|HDMI CEC (Consumer Electronics Control)]] support for [http://libcec.pulse-eight.com/ Pulse-Eight's LibCEC]<br />
* Upgraded HDMI-CEC libraries code from Pulse-Eight to [http://raw.githubusercontent.com/Pulse-Eight/libcec/master/ChangeLog LibCEC release version 3.0.0]<br />
* Upgraded DVD-Video navigation and playback libraries (libdvdnav, libdvdread, and libdvdcss)<br />
* Upgraded SAMBA client code library to version 3.6.12 for improved support for SMB/CIFS protocol<br />
* Updated community maintained translations to over 60+ languages to date for Kodi via [[Translation System|Transifex Translation System]]<br />
* Removed internal DAAP VFS client code for iIunes 6.x music shares (network stream from older Apple iTunes)<br />
* Removal AFP filesystem support from Kodi's VFS (Virtual File System)<br />
* Improved code stability and performance as well as general code clean-up in all areas<br />
* Improved MediaCodec API video decoding implementations support for Android 4.2 (API level 17) and later<br />
* Improved the dedicated AMLCodec hardware accelerated video decoding support for [[Amlogic]] devices<br />
* Added automatic refresh rate switching support for video playback on Android 5.0 and later (>= API 21), including Android TV<ref>http://github.com/anssih/xbmc/commits/android/refreshrate_wip WIP refreshrate</ref><br />
* Added support for HEVC hardware decoding for MediaCodec API in Android 4.4.2 and later when the VPU supports it<br />
* Added support for HEVC hardware decoding on [[Amlogic]] SoCs in Android 4.4.2 and later when the VPU supports it<br />
* Added support for UltraHD decoding / 4K resolution output on [[Amlogic]] SoCs in Android when HW supports it<br />
* Added support for screenshot and video bookmarks on [[Amlogic]] SoCs hardware<br />
* Added support for LCD/VFD display panel output on [[Amlogic]] SoCs hardware<br />
* Added support for de-interlacing using BOB deinterlace method on Android<br />
* Added support for 7.1 channels PCM playback<br />
* Added support for system handling of audio volume on Android<br />
* Moved to Android API 17 as minimum with SDK 14 and NDK 10e, meaning at least Android 4.2 is now required<br />
* Improved [http://en.wikipedia.org/wiki/ARM_architecture#Advanced_SIMD_.28NEON.29 NEON (Advanced SIMD instruction set)] CPU acceleration support for ARM architecture<br />
* Removed the dependency for root/SU access permission rights on Android<br />
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms<br />
* Added MIPS processor architecture support for Linux (Imagination Technologies MIPS Creator CI20 as reference)<br />
* Added support for HEVC hardware video decoding on [[Amlogic]] SoCs when the VPU supports it<br />
* Added support for UltraHD decoding / 4K resolution output on [[Amlogic]] SoCs in Android when HW supports it<br />
* Added support for screenshot and video bookmarks on [[Amlogic]] SoCs hardware<br />
* Added support for LCD/VFD display panel output on [[Amlogic]] SoCs hardware<br />
* Improved video accelerated decoding on [[Freescale|Freescale i.MX 6]] based devices<br />
* Improved ARM processor architecture (using [[WeTek Play]] and [[Raspberry Pi]] as reference devices)<br />
* Improved OpenGL ES and EGL support (using [[WeTek Play]] and [[Raspberry Pi]] as reference devices)<br />
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)<br />
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)<br />
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)<br />
* Improved OpenMAX Video Acceleration API support for Linux (using Raspberry Pi as reference hardware)<br />
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on [[Amlogic]] devices<br />
* Improved AMD/Intel x86-64 64-bit (AMD64 / IA-64t CPU architectures) support under Linux<br />
* Removed dependencies of SDL (Simple DirectMedia Layer) for everything but hardware abstraction for input devices<br />
* Improve Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)<br />
* Moved to iOS 8.1 SDK, minimum iOS 5.1 is now required, this removes support for Apple TV 2 builds<br />
* Improve Apple VDADecoder Video Acceleration support for (Mac) OS X<br />
* Added Kodi support for OS X 10.10 "Yosemite" from Apple<br />
* Moved to OS X 10.10 SDK, meaning minimum (Mac) OS X 10.7 Lion is now required, and no more 32-bit builds<br />
* Improved DXVA/DXVA2 (DirectX Video Acceleration) support (requires DXVA/DXVA2 compatible hardware and drivers)<br />
* Added support for HEVC hardware video decoding via DXVA on Windows when hardware and driver supports exist<br />
* ?<br />
|<br />
| <br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 16.0<br />16.1<br />
| 20 February 2016<br />24 April 2016<br />
| Jarvis<br />
|<br />
{{main| Kodi v16 (Jarvis) changelog |Jarvis API changes}}<br />
<br />
* Added support for handling RDS Radio signals via PVR and EPG frontend<br />
* Added support for PVR addons to handle RDS radio signals in UECP and Rass formats<br />
* Added FM Radio receiver based upon RTL-SDR as PVR Addon backend client<br />
* Added support to PVR API for Scheduling Recordings of TV Shows (EPG based DVR Timers for "Series Recording")<br />
* Added option for PVR clients and backends to add timeshift indicator to the Video OSD for Live TV<br />
* Added support to show channels without EPG data in PVR guide window<br />
* Added 'Play recording' context menu option if an EPG entry has an associated (PVR) recording<br />
* Added enhancement and impovements to the PVR API (example series/episode metadata, timer and recording status)<br />
* Updated Kodi's PVR Addon API version to 4.0.0 for Kodi v16 (Jarvis)<br />
* Improved EPG association by broadcast ID<br />
* Improved speedup reading EPG from database<br />
* Changed activations of PVR windows so they are only available if PVR is enabled<br />
* Changed "Add timer" as renamed to "Record", and renamed "Add custom timer" to just "Add timer"<br />
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:<br />
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing<br />
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community<br />
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community<br />
* Added support for allowing skins and resource addons to be activated via info dialog<br />
* Added support for disabling auto-updates per addon from the info panel dialog<br />
* Added automatic dependency handling for binary addons<br />
* Improved add-on update and rollback support by adding ability to choose only a specific repo<br />
* Improved capabilities for downgrading of addons by supporting multiple versions in same repository<br />
* Improved bootstrap buildsystem for binary addons to support arbitrary meta repositories<br />
* Improved the ability to [http://github.com/xbmc/xbmc/pull/901 extend Kodi's native Python API by writing C++ code generated] via [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 Groovy] and [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 SWIG]<br />
* Updated the Groovy (code generator) library to 2.4.4<br />
* Moved some binary (RSXS) Screensavers and Audio Visualizations (Vis) to addons<br />
* Moved the addon rollback feature to the update dialog and list all available versions there<br />
* Updated GUI ABI version 15 as minimum setting any skin before Kodi 15.0 (Isengard) as incompatible<br />
* Update guilib ABI (for libgui) to version 5.10.0<br />
* Changed saving of skin settings which are now stored as separate files<br />
* Added support for Animated GIF images to loadable for any kind of textures, e.g. Posters and FanArt<br />
* Added support for image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)<br />
* Added support for sound resource addons (skin effect sounds for button clicks, transitions, etc.)<br />
* Added new dialogs for managning and settings for digital sound processing addons (Audio DSP plugins)<br />
* Added new dialog to display RDS Radio information under PVR windows<br />
* Added option for skinners to add a timeshift indicator to the Video OSD for Live TV<br />
* Added skinning support to enable editing of user-ratings from skins frontend<br />
* Added support of <depth> tag for stereoscopic (3D) effect for controls to GUI engine for skins<br />
* Added stereoscopic (3D) depth support for the Confluence skin<br />
* Added the use of image resource addons for updating weather fanart images in Confluence<br />
* Added 'Events' to the Confluence homescreen 'System' submenu<br />
* Added EPG to search results window (add to PVR search results window in Confluence)<br />
* Added new infolabel that can be used to display fanart for moviesets inside a movie set<br />
* Added new infolabels that can display audio/subtitle properties for all available streams<br />
* Added new infolabels for displaying user ratings<br />
* Added support for skins to use a lightweight font<br />
* Added toggle switch to visually mark dirty regions to help skinners optimize and troubleshoot skins<br />
* Added support for sortby and sortorder attributes to the <content> element<br />
* Added ability in guilib to visualize control hitrects when tagged<br />
* Added option to conditionally include files to allow skinners to conditionally include a file<br />
* Added option for skins to show separate icons for empty and full DVD-ROM drives<br />
* Added support for specifying the image scaling algorithm for image resizing/caching<br />
* Added new on-screen keyboard layouts for; Chinese, Korean, English QWERTZ, Czech QWERTZ and QWERTY<br />
* Updated keyboard layout for some languages and added a new keyboard layouts for a few languages<br />
* Improved default quality setting of image scaling algorithm for image resizing/caching<br />
* Improved skinning PVR section by reduceing amount of dialogs and simplify skinning Live TV and EPG windows<br />
* Improved skin reloading in case theme/color/font is not default<br />
* Improved touch and gesture support for all platforms, and also improved the default touch screen skin ([[Add-on:Re-Touched|Re-Touched]])<br />
* Removed skin XML files for Karaoke support as the feature has been removed from Kodi's core<br />
* Removed native TvTunes support from Confluence since they changed into a paid-only service<br />
* Added support for lossless software decode of DTS-HD tracks/streams in videos using libdcadec<br />
* Added support to utilize pixel aspect ratio from SAR (Storage Aspect Ratio) tags in MKV containers<br />
* Improved Stereoscopic 3D playback with video playlist switching when playlists have 2D and 3D videos<br />
* Improved and enhanced Blu-ray support (including updated libbluray dependecies)<br />
* Upgraded FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_2.8.5 FFmpeg 2.8.5]<br />
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons<br />
* Unified the music library and files view (similar to how its done in video library already)<br />
* Added option for for user ratings of video items and editing userratings from the GUI frontend<br />
* Added support for set overview (plot) in movie sets in the video library<br />
* Added setting for to not group movies into a movie set in the video library if it contains a single item<br />
* Added event logging which among others shows which files did not get added to library<br />
* Added genre to television series episode view in the video library<br />
* Added support for Audio and Subtitle Track Count to Smart Playlist selections in the video library<br />
* Added support to sort by top albums by play count in the music library<br />
* Added support for sorting dynamic directory listings from content<br />
* Added a FFmpeg tag loader that can read additional metadata from more media containers<br />
* Added support to use the new FFmpeg tag loader for reading tags from .DSP files<br />
* Added support to use the new FFmpeg tag loader for reading tags from .MKA files<br />
* Added support for the MusicBrainz "ARTISTS" tag in id3v2, ape, xiph for music files<br />
* Added ability to fetch season year from video database based on first aired episode<br />
* Updated music, movies, tv shows, and music video scrapers for Kodi<br />
* Added initial support for [http://forum.kodi.tv/forumdisplay.php?fid=235 Audio DSP] (Digital Signal Processing) plugins and addons for Kodi's [[AudioEngine]]<br />
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])<br />
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems<br />
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop<br />
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems<br />
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]<br />
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]<br />
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS<br />
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS<br />
* Added initial support for AirPlay from iOS 9 music streaming capability<br />
* Added own lists for audio, subtitle and sub download languages<br />
* Added ability to open the SmartPlayListEditor for a given playlist<br />
* Added "long-press" support to extend the functionality of a single button on a remote control<br />
* Improved code stability and performance as well as general code clean-up in many core areas<br />
* Improved the the integrated UPnP / DNLA Media Server and Client<br />
* Improved AirPlay compatibility suppor for iOS 8 (via updated libshairplay)<br />
* Improved Kodi's JSON-RPC API<br />
* Improved [[CEC|HDMI CEC (Consumer Electronics Control)]] support for [http://libcec.pulse-eight.com/ Pulse-Eight's LibCEC]<br />
* Updated community maintained translations to over 60+ languages to date for Kodi via [[Translation System|Transifex Translation System]]<br />
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile binary addons)<br />
* Removed support for the current karaoke implmenetation from the core as it was not being maintained<br />
* Added experimental pass-through support for Dolby Digital (AC3) audio<br />
* Added experimental pass-through support for Dolby TrueHD audio (if supported by underlying hardware & firmware)<br />
* Added experimental pass-through support for DTS audio<br />
* Added experimental pass-through support for DTS-HD Master Audio (if supported by underlying hardware & firmware)<br />
* Added software decode support of Dolby Digital Plus (DD+/E-AC3/EC-3) to PCM audio output<br />
* Added proper implementation of Surface Rendering going thru EGL for video decoded with Android's MediaCodec API<br />
* Added proper implementation of handling MEDIA keys support on Android<br />
* Improved MediaCodec API video decoding implementations support for Android 4.2 (API level 17) and later<br />
* Improved automatic refresh rate switching support for video playback on Android 5.0 and later (>= API 21), inc. Android TV<br />
* Improved support for UltraHD decoding / 4K resolution output when HW supports it<br />
* Improved playback of HEVC, VC-1 / WMV 9, and VP9 hardware video decoding when using Android's MediaCodec API<br />
* Improved display of other Android apps while browsing these under Kodi as application launcher<br />
* Improved audio output by decouple Kodi and system volume which removes double audio volume slider<br />
* Improved touch-screen keymapping for Android based platforms for better gesture support<br />
* Improved [http://en.wikipedia.org/wiki/ARM_architecture#Advanced_SIMD_.28NEON.29 NEON (Advanced SIMD instruction set)] CPU acceleration support for ARM architecture<br />
* Removed support for hardware video decoding via Android StageFright library (libstagefright)<br />
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms<br />
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)<br />
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)<br />
* Added multi-touch support, and improved touch and gesture support on Linux<br />
* Added support for HEVC hardware video decoding via [[wikipedia:VAAPI|VAAPI]] API when the VPU and drivers supports it<br />
* Added support for HEVC hardware video decoding via [[wikipedia:VDPAU|VDPAU]] API when the VPU and drivers supports<br />
* Improved rendering GUI (including OSD) at a different resolution than video playback plane<br />
* Improved automatic refresh rate switching support for video playback<br />
* Improved EGL rendering on Amlogic by implement 480cvbs/i/p and 576cvbs/i/p modes<br />
* Improved SQLite file access performance on Raspberry Pi using MMAP acceleration<br />
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it<br />
* Improved video accelerated decoding on [[Freescale|Freescale i.MX 6]] based devices<br />
* Improved ARM processor architecture (using [[WeTek Play]] and [[Raspberry Pi]] as reference devices)<br />
* Improved OpenGL ES and EGL support (using [[WeTek Play]] and [[Raspberry Pi]] as reference devices)<br />
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)<br />
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)<br />
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)<br />
* Improved OpenMAX Video Acceleration API support for Linux (using Raspberry Pi as reference hardware)<br />
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on [[Amlogic]] devices<br />
* Improved AMD/Intel x86-64 64-bit (AMD64 / IA-64t CPU architectures) support under Linux<br />
* Added support for iOS 9.0 by adding support for compiling Kodi with Xcode 7 IDE and iOS SDK 9.0<br />
* Moved to iOS 8.4 SDK and Xcode 6.4 IDE as default which added support for iOS 8.4<br />
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)<br />
* Improved touch and gesture support for iOS based iDevice platforms (iPad, iPod, and iPhone)<br />
* Removed support for compiling Apple TV 2 builds<br />
* Removed iOS 5.1 (iPad 1) compatiibility as it was required to add iOS 9<br />
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X<br />
* Added support for compiling Kodi with Xcode 7 IDE and OS X 10.11 SDK<br />
* Updated the whole rendering system on Microsoft Windows platforms to DirectX 11 and Direct3D 11 native support<br />
* Added support for caching font vertices on GPU side (requires Windows 8 and DirectX 11 device drivers)<br />
* Added support for hardware based Stereoscopic 3D (requires Windows 8 and DirectX 11 device drivers)<br />
* Added support for interleaved Stereoscopic 3D mode on Windows platforms (requires DirectX 11 device drivers)<br />
* Added support for checkerboard Stereoscopic 3D mode on Windows platforms (requires DirectX 11 device drivers)<br />
* Improved DXVA/DXVA2 rendering and decoding on Windows (when using DirectX 11 device drivers)<br />
* Improved support for HEVC hardware video decoding via DXVA on Windows when hardware and driver supports exist<br />
* ?<br />
|<br />
| <br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 17.0<br />17.1<br />17.2<br />17.3<br />17.4<br />17.5<br />17.6<br />
| 5 February 2017<br />23 March 2017<br />21 May 2017<br />24 May 2017<br />22 August 2017<br />24 October 2017<br />15 November 2017<br />
| Krypton<br />
|<br />
{{main| Kodi v17 (Krypton) changelog |Krypton API changes}}<br />
|<br />
|-<br />
| style="white-space:nowrap; background:#a0e75a;"| 18.0<br />18.1<br />18.2<br />
| 29 January 2019<br />11 February 2019<br />22 April 2019<br />
| Leia<br />
<br />
|<br />
{{main| Kodi v18 (Leia) changelog |Leia API changes}}<br />
29 December 2017 - XBox One v18 Alpha released to Windows Store<br />
<br />
* Retroplayer gaming and associated game control support<br />
* Digital Rights Management decryption support<br />
* Music Library – new ways to explore and enjoy your music collection<br />
* Live TV improvements, including support for new back-ends<br />
* Binary addon support and the binary addon repository<br />
* Android Leanback and voice control<br />
* Playback improvements (audio and video), including improved Blu-ray support<br />
|<br />
|-<br />
| style="white-space:nowrap; background:skyblue;"| 19.0<br />
| TBA<br />
| M***<br />
|<br />
|-<br />
|}<br />
<br />
== Codename history ==<br />
{{see|Codename history}}<br />
<br />
== References ==<br />
<references/><br />
<br />
[[Category:Kodi]]<br />
[[Category:Development]]</div>WhikiDudehttps://kodi.wiki/index.php?title=Releases&diff=166959Releases2019-05-12T13:30:24Z<p>WhikiDude: Added references to 18.1, 18.2</p>
<hr />
<div>{{mininav| [[Kodi]] {{l2| [[Development]] }} }}<br />
<br />
{{see also|Changelogs}}<br />
<br />
== Release history ==<br />
<br />
This is a release history with condensed changelogs for the most important added or removed notable new features, functions, and changed in each stable version of {{kodi}}.<br />
<br />
{| class="prettytable"<br />
|-<br />
! colspan="2"| Legend<br />
|-<br />
| style="background:salmon;"| Red<br />
| Old releases<br />
|-<br />
| style="background:#a0e75a;"| Green<br />
| Current release<br />
|-<br />
| style="background:skyBlue;"| Blue<br />
| Future releases<br />
|}<br />
<br />
{| class="prettytable"<br />
|-<br />
! Version<br />
! Release date<br />
! [[Codename]]<br />
! Significant changes<br />
! XBMC Live based on<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 1.0.0<br />
| 29 June 2004<br />
| {{n/a}}<br />
|<br />
* Total rewrite of the source code from [[Xbox Media Player|XBMP (Xbox Media Player)]]<br />
|{{n/a}}<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 1.1.0<br />
| 18 October 2004<br />
| {{n/a}}<br />
|<br />
* ITU H.261, creative labs yuv (cyuv), supermac cinepak (cvid), quicktime, on2 vp4, 3ivx d4 / 3vi1 mpeg-4 video support<br />
* Container support for nsa, raw audio in .mov, .ac3, .dts and dts-wav<br />
* Zoom/stretch options: zoom, stretch 4x3 or 14x9 or 16x9, original size, custom<br />
* Volume control<br />
* Tags parsing and display for wma, m4a, mp4 and aac (mpeg-4 audio) audio-files<br />
* International-language fonts for subtitles via ttf-fonts<br />
* Audio CD Ripper, backup cdda's to hdd in wav, ogg or mp3 (lame) format<br />
* Karaoke cdg-file and audio cue sheets (.cue) support<br />
* iIunes music shares via DAAP (network stream from Apple iTunes)<br />
* XBMC's xbmsp-client code updated to support "auto-discovery of xbmsp servers"<br />
* Auto-temperature and fan-speed control options<br />
* Network-configuration and setup via GUI<br />
* Emergency recovery console (enables the ftp-server during fatal errors)<br />
* Profiles for settings<br />
* Mouse support and virtual-keyboard<br />
* LCD-display output extended to also support xaddons lcd-mods and xecuter3 lcd<br />
| {{n/a}}<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 2.0.0<br />
| {{nowrap|29 September 2006}}<br />
| {{n/a}}<br />
|<br />
* Reworked skinning engine.<br />
* DVD-Video menu/navigation support (with ISO/IMG image parsing) through internally developed core<br />
* RAR/ZIP archive parsing<br />
* New audio/music-player (PAPlayer) with crossfade, gapless playback and ReplayGain support<br />
* Karaoke CDG-file display<br />
* Xored Trainer Engine (gaming-cheats) (not ported from Xbox)<br />
* XLink Kai (online-gaming) front-end (depreciated)<br />
* Added iTunes 6.x DAAP and UPnP-client<br />
* Read-only support for FAT12/16/32 formatted USB Mass Storage Devices up to 4GB in size<br />
* Brand new "skinnable" 3D visualizer.<br />
| {{n/a}}<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 8.10<br />
| 15 November 2008<br />
| Atlantis<br />
|<br />
* Cross platform support adding support for Linux, Mac OS X, and Windows<br />
* Brand new High Definition skin “PM3.HD”<br />
* "XBMC Live" bootable CD with unified hard disk/USB flash disk installer<br />
* The XBMC profile<br />
* Integration of iTunes and iPhoto media (OS X exclusive).<br />
| Ubuntu 8.10<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 9.04<br />
| 6 May 2009<br />
| Babylon<br />
|<br />
* PPC (PowerPC) support for Mac OS X (PowerPC G4 or later)<br />
* VDPAU (Nvidia's Video Decode and Presentation API for Unix)<br />
* New Karaoke features<br />
* Officially dropped support for Xbox<br />
* Updated codecs and major bug-fixes for DVD-Video playback core<br />
* More Media Info Scrapers<br />
* Improved FanArt support<br />
* Revamped skinning engine<br />
| Ubuntu 9.04<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 9.11<br />
| 24 December 2009<br />
| Camelot<br />
|<br />
* Revamped user interface via the new default skin “Confluence“<br />
* DirectX support by default for the Windows platform<br />
* A complete reorganization of the settings menus uniformed across skins<br />
* Automatic video information extraction<br />
* Out of the box support for new remotes<br />
* Smoother video playback performance<br />
* All scrapers updated<br />
* Increased subtitle and Karaoke lyric support<br />
* Support for CoreAudio API (OS X exclusive)<br />
* AC3 and DTS digital audio pass-through to SP/DIF on Apple TV (thanks to CoreAudio)<br />
| Ubuntu 9.10<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 10.0<br />10.1<br />
| 18 December 2010<br />10 March 2011<br />
| Dharma<br />
|<br />
* Unified Addon framework<br />
* Addon Browser GUI for installation and management of third-party addons, skin, and scripts<br />
* Team XBMC's official Addons Repository with Addon FanArt support<br />
* Update Notifications<br />
* Movie Sets (option to group movie collections)<br />
* WebM/VP8 codec<br />
* Gesture support to XBMC's GUI Engine<br />
* Unencrypted Blu-ray Disc support<br />
* Broadcom Crystal HD video acceleration support (All Platforms)<br />
* Windows Touch API support (Windows 7 touch features and functions)<br />
* DXVA 2.0 (DirectX Video Acceleration) (Windows Vista/7 exclusive)<br />
* WASAPI (Windows Audio Session API) for raw bitstream output (Windows Vista/7 exclusive)<br />
* High-Quality Bicubic and Lanczos Upscalers (Video Resamplers) as Direct3D HLSL (Windows Vista/7 exclusive) and OpenGL GLSL Shaders<br />
* Direct3D port of the OpenGL Spectrum 3D Audio Visualization for DirectX (Windows Vista/7 exclusive)<br />
* AVisual Studio 2010 Express edition and Visual Studio 2010 non-Express edition support (Windows Vista/7 exclusive)<br />
* ARM processor architecture (Linux exclusive)<br />
* VAAPI (Video Acceleration API) support (Linux exclusive)<br />
* OpenMAX Video Acceleration support (Linux exclusive)<br />
* NEON (ARM) Video Acceleration support (Linux exclusive)<br />
* Apple VDADecoder Video Acceleration support (OS X exclusive requires Snow Leopard and NVIDIA 9400 or later)<br />
* OpenGL ES 2.0 compliance<br />
* JSON-RPC, JSON API<br />
* RTMPE and RTMPTE<br />
* Microhttpd Web Server replaces old GoAhead and Spyce code<br />
* SSH file transfer protocol (sftp) via libssh<br />
* MySQL database backend<br />
| Ubuntu 10.04<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 11.0<br />
| 24 March 2012<br />
| Eden<br />
|<br />
{{main|XBMC v11 (Eden) changelog|Eden API changes}}<br />
* iOS port for Apple TV 2G, iPhone, iPod Touch, and iPad<br />
* [[Dirty regions]] rendering for texture support to skinning engine<br />
* Efficiency improvements to reduce high cpu/gpu usage<br />
* Default skin changed to a horizontal home layout<br />
* New RenderCapture type to the Python script framework<br />
* Combined Files and Library mode for videos<br />
* Playback of ISO image files for Blu-ray Disc support<br />
* Slingbox playback over the network support<br />
* Peripheral manager controller under settings<br />
* Consumer Electronics Control (CEC) support for HDMI<br />
* Improved Apple VDADecoder Video Acceleration support<br />
* Improved Touch / Gesture API and Mouse support<br />
* Improved ARM processor architecture support<br />
* Improved OpenMAX Video Decoding Acceleration support<br />
* Improved OpenGL ES and EGL support<br />
* Improved JSON-RPC API compliant with JSON-RPC 2.0 specs<br />
* Improved VDPAU performance<br />
* VDPAU HQ Upscaling support (require NVIDIA's capable GPU)<br />
* H.264 accelerated video decoding via Apple's VideoToolBox API<br />
* JPEG accelerated video decoding via Apple's VideoToolBox API<br />
* Added basic DRC (Dynamic Range Compression) volume limiter<br />
* [[AirPlay|AirPlay/AirTunes]] target support<br />
* Extended Addons API adding extension points for Service Addons<br />
* Ability for all addons to provide their own web interface<br />
* Removed native weather forecast scraper, use weather add-ons instead<br />
* Added support for multiple simultaneous HID device mappings<br />
* FFmpeg upgraded (libavformat and libavcodec)<br />
| Lubuntu 11.10<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 12.0<br />12.1<br />12.2<br />12.3<br />
| 29 January 2013<br />18 March 2013<br />3 May 2013<br />{{nowrap|24 December 2013}}<br />
| Frodo<br />
|<br />
{{main|XBMC v12 (Frodo) changelog|Frodo API changes}}<br />
* Added unified [[PVR|Live TV and PVR frontend]] with a common EPG and DVR (Digital Video Recording) client GUI<br />
* Added unified PVR backend framework and API for multiple [[PVR/Backend|PVR backend software]] from third-parties<br />
* Initial [http://en.wikipedia.org/wiki/Android_%28operating_system%29 Android (operating system)] port with multi-architecture platform support<br />
* Initial [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] port for FreeBSD, PC-BSD, and other similar BSD platforms<br />
* Added unified "[[AudioEngine]]" audio abstraction framework with an API and platform sinks<br />
* Added dedicated AMLPlayer video player for hardware accelerated video decoding on [[AMLogic devices|Amlogic]]<br />
* Added dedicated OMXPlayer video player for hardware accelerated video decoding via OpenMAX IL API<br />
* [http://en.wikipedia.org/wiki/ARM_architecture#Advanced_SIMD_.28NEON.29 NEON (Advanced SIMD instruction set)] CPU acceleration support for the ARM architecture<br />
* Improved ARM processor architecture ([http://www.pivosgroup.com/xios.html Pivos XIOS DS] and [[Raspberry Pi]] as reference devices)<br />
* Improved OpenGL ES and EGL support ([http://www.pivosgroup.com/xios.html Pivos XIOS DS] and [[Raspberry Pi]] as reference devices)<br />
* Added ability to run a split display resolution for GUI and video playback on embedded platforms[http://github.com/xbmc/xbmc/pull/1467]<br />
* Enabled [[Dirty regions|Dirty Regions]] rendering to redraw whole screen on single dirty region by default on all platforms[http://github.com/xbmc/xbmc/pull/1426][http://xbmc.org/theuni/2011/06/19/working-with-dirty-regions/]<br />
* Added 64-bit build support Mac OS X to match the existing 64-bit support for Linux<br />
* Improved [http://en.wikipedia.org/wiki/HDMI#CEC|HDMI CEC (Consumer Electronics Control)] support for [http://libcec.pulse-eight.com/ Pulse-Eight's LibCEC]<br />
* Library customization that allows for custom video nodes<br />
* Added [[Advanced Library Filtering]] for Movies, TV Shows, Music Videos, and Music views<br />
* Improved [[Smart playlists|Smart Playlist]] for Advanced Library Filtering<br />
* Added custom [[video library tags]] for Movies, TV Shows and Music Videos to simplify sets with scraping<br />
* Added support for both banner and poster video art types simultaneously[http://github.com/xbmc/xbmc/pull/1575]<br />
* Added storing of "Episode ID" for First Aired, DVD Episode Number, and Absolute Number sort order<br />
* Added support for exporting video art as JPG or PNG rather than TBN file extension<br />
* Switched to [http://en.wikipedia.org/wiki/TagLib TagLib] for reading metadata embedded into audio files<br />
* Better library database handling for faster browsing<br />
* Improved image and texture caching for GUI speedup<br />
* Improved Touch / Gesture API support for touchscreen interfaces<br />
* Added HLS (HTTP Live Streaming) and M3U8 (Extended M3U) playlist support<br />
* Added WebSocket support for JSON-RPC and to Addons API[http://github.com/xbmc/xbmc/pull/511]<br />
* Added image transformation handler for resizing images on-the-fly over JSON-RPC and WebServer API<br />
* Added basic support for PVR / EPG extensions and notifications over the JSON-RPC API<br />
* Added SmartPlaylist Extensions and Extended Filtering in JSON-RPC[http://github.com/xbmc/xbmc/pull/1258]<br />
* Added support for screensavers written in Python programming language<br />
* Added ability to [http://github.com/xbmc/xbmc/pull/901 extend XBMC's native Python API by writing C++ code generated] via [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 Groovy] and [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 SWIG]<br />
* Blu-ray Disc HDMV menu support (but not BD-J / BD-Live menus)[http://github.com/xbmc/xbmc/pull/464]<br />
* Improved deinterlacing "Weave" method for playback of interlaced video when upscaling<br />
* Improved performance of the default Web Interface (complete rewrite of JavaScript loading)<br />
* Improved AirPlay / AirTunes target support<br />
* Improved the Audio-CD ripper that now works as a background task job<br />
* Improved international language file translations system that are powered by Transifex[http://xbmc.org/blittan/2012/10/30/dear-addon-and-skin-developers/]<br />
* Added a Test Suite based on [http://code.google.com/p/googletest/ Google C++ Testing Framework] to make regression testing easier<br />
* Added support controlling external XBMC and third-party UPnP/DLNA instances over UPnP<br />
* Upgraded [http://www.plutinosoft.com/platinum Plutinosoft's Platinum (libplatinum)] UPnP and DNLA libraries<br />
* Upgraded [http://en.wikipedia.org/wiki/FFmpeg FFmpeg's libavcodec and libavformat] audio/video cedec and demuxer libraries<br />
* Removed the old HTTP API in favour of the new JSON-RPC API<br />
| Lubuntu 12.10<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 13.0<br />13.1<br />13.2<br />
| 4 May 2014<br />5 June 2014<br />17 August 2014<br />
| Gotham<br />
|<br />
{{main|XBMC v13 (Gotham) changelog|Gotham API changes}}<br />
* Added much improved PVR / EPG and Live TV interface in XBMC's GUI skinning engine (already in use in Confluence)<br />
* Added improved PVR / DVR timeshift support to pause Live TV (note that each PVR backend still need to support timeshifting)<br />
* Added much improved PVR / EPG extensions and notifications support over the JSON-RPC API<br />
* Improved PVR front-end with Live TV and EPG specific windows, plus PVR stuff in OSD and GUI settings in Confluence skin<br />
* Added, updated, and improved PVR backend clients addons for many popular third-party external [[PVR backend]] platforms:<br />
** [[PVR/Testing|PVR Demo Client]] dummy addon with fake backend from Team-XBMC for skin development and regression testing<br />
** [[PVR/Backend/IPTV|IPTV (IPTV Simple Client)]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/Tvheadend|Tvheadend]] PVR Addon backend clients maintained and available from XBMC's community<br />
** [[PVR/Backend/NextPVR|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/Njoy|Njoy Digital (N7)]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/MediaPortal|MediaPortal]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/MythTV|MythTV]] PVR Addon backend client maintained and available from the XBMC's community<br />
** [[PVR/Backend/VDR|VDR (Video Disk Recorder)]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/VUPlus|Vu+ / Enigma2 / Dreambox]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/ForTheRecord|Argus TV / ForTheRecord]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[DVBLink]] PVR Addon backend client maintained and available from XBMC's community<br />
** [[PVR/Backend/DVBViewer|DVBViewer]] PVR Addon backend client maintained and available from XBMC's community<br />
* Added option for allowing skins to query directories (e.g. plugins) to fill static content<br />
* Added a Monitor class to receive JSON-RPC notifications directly through the Python bindings<br />
* Added announce function and register addon for announcements to the Add-ons API<br />
* Added new Built-In function to control state of attached HDMI CEC device via Add-ons API<br />
* Added support for XBMC's Python interface to use native keyboard if possible (currently only iOS) <br />
* Added support for addon binary reading and writing via a "buffer" class usable from addons<br />
* Added WOL (Wake-on-LAN) with send magic packet function to the Add-ons API<br />
* Improved the ability to [http://github.com/xbmc/xbmc/pull/901 extend XBMC's native Python API by writing C++ code generated] via [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 Groovy] and [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 SWIG]<br />
* Improved Addons API for homebrew DIY RGB LED [http://en.wikipedia.org/wiki/Ambilight Ambilight] clone client software such as [[Add-on:XBMC Boblight|Boblight]]<br />
* Added support for customizable menu structure for home and beyond<br />
* Added Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) to XBMC's GUI skinning engine<br />
* Added Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) for Subtitles when in 3D mode<br />
* Added a simple Movie Set management to GUI for Edit/Clear Set and Add/Remove Set members<br />
* Added option support for both banner and poster music art types simultaneously<br />
* Added picture tags metadata info accessible for skins or addons developers<br />
* Added further optimizations to XBMC's GUI engine for faster rendering on low resource embedded devices<br />
* Improved touch and gesture support for all platforms, and also improved the default touch screen skin ([[Touched]])<br />
* Added [http://github.com/xbmc/xbmc/pull/2040 ImageFactory implementation] with factory to abstract different image libraries and hardware acceleration<br />
* Improved [[Dirty regions|Dirty Regions]] rendering on all platforms<br />
* Refactored settings system to consist of XML files containing descriptions of every setting<br />
* Added support for H.264 (including [[Hi10P]]) multi-threaded video decoding when software decoder on CPU is used<br />
* Added support for Forced Subtitles ("forced flag") in external subtitle files<br />
* Added support for video playback of SageTV recordings <br />
* Added unified buffering capability to video and overlay renderers for all internal players<br />
* Upgraded FFmpeg (libavcodec and libavformat) audio/video codec and demuxer libraries to [http://www.ffmpeg.org/download.html#release_1.2 FFmpeg 1.2 (rev e820e3a)]<br />
* Added extensive MusicBrainz tags support to the Music Library and Database<br />
* Added ability to queue list of items / add items to a playlist without playing them<br />
* Improved and extended [[Smart playlists|Smart Playlists]] functionality<br />
* Added support for scanning videos SFTP and SSH sources so can scrape metadata<br />
* Added support for write-enabled WebDAV (delete/rename/write files and directories)<br />
* Added "Add art" button to video artwork selection dialog<br />
* Added support for "last played" sort option to the TV Show GUI<br />
* Added support for OGG cover art extraction to TagLib<br />
* Added option support for exporting music art as JPEG or PNG rather than TBN file extension<br />
* Improved performance for SQL database queries for faster browsing<br />
* Added theaudiodb.com music video scraper as new default for music videos<br />
* Added new cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] sink as the default for XBMC's [[AudioEngine]]<br />
* Added ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems<br />
* Added PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop<br />
* Added OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD, PC-BSD, and similar Unix based systems<br />
* Added AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]<br />
* Added Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]<br />
* Added DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Added WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Added Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for Mac OS X and iOS<br />
* Added support for CoreAudio AudioEngine to OS notifications for device changes on Mac OS X and iOS<br />
* Added support for "Play to" and controlling remote XBMC / DLNA instance over UPnP<br />
* Added new "Fishbmc" audio visualization addon (only OpenGL versions for Linux and Mac OS X for now)<br />
* Added GUI settings levels for Basic, Standard, Advanced, Expert (defaults to "Standard")<br />
* Added support and GUI settings for SOCKS 4/4a/5 proxy types and remote DNS<br />
* Added possibility to define help descriptions ("I" key) for every setting in GUI settings<br />
* Added option to set auto login of a specific user profile via the GUI<br />
* Added CPU / GPU frequency and temperature for all supported Linux platforms<br />
* Added support to allow key IDs in keyboard.xml to be in hexadecimal format<br />
* Upgraded DVD-Video navigation and playback libraries (libdvdnav, libdvdread, and libdvdcss)<br />
* Upgraded SAMBA client to version 3.6.x adding full support for SMB 2.0 and SMB 2.1 protocols<br />
* Added initial support for running libxbmc.so headless (without GUI) as a background service / deamon<br />
* Added a generic and user-mappable cross-platform touch input system<br />
* Improved [http://en.wikipedia.org/wiki/HDMI#CEC|HDMI CEC (Consumer Electronics Control)] support for [http://libcec.pulse-eight.com/ Pulse-Eight's LibCEC]<br />
* Moved subtitle addon core handling to core and added native support for subtitle plugin services<br />
* Updated community maintained translations to over 60+ languages to date for XBMC via [[Translation System|Transifex Translation System]]<br />
* Added first full (and stable) XBMC for [[Android]] port with multi-architecture platform support (supports ARM, MIPS, and x86)<br />
* Added built-in command for addons and skins to execute Android apps with optional params via applicationmanager<br />
* Added support to allow landscape and reverse landscape orientation of XBMC GUI on Android<br />
* Added MediaCodec API (Android 4.1 API level 16) software rendering implementation support to XBMC's DVDPlayer<br />
* Added StageFright API (Android 4.0 API level 14) hardware rendering implementation support to XBMC<br />
* Added OpenMAX Video Acceleration API support for OpenMAX AL API on Android via StageFright and MediaCodec<br />
* Improved the dedicated AMLPlayer video player for hardware accelerated video decoding on [[AMLogic devices|Amlogic]]<br />
* Added external player (external player launcher) support on Android<br />
* Added native volume control for Android from within XBMC<br />
* Improved [http://en.wikipedia.org/wiki/ARM_architecture#Advanced_SIMD_.28NEON.29 NEON (Advanced SIMD instruction set)] CPU acceleration support for ARM architecture<br />
* Improved XBMC support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms<br />
* Improved VDPAU (NVIDIA) Hardware Acceleration Video Decoding support on BSD<br />
* Improved VAAPI (Video Acceleration API) Hardware Acceleration Video Decoding support on BSD<br />
* Added VA-API (libva) support for decoding videos with larger resolutions than 1080p (such as 4K resolution)<br />
* Improved ARM processor architecture ([http://www.pivosgroup.com/xios.html Pivos XIOS DS] and [[Raspberry Pi]] as reference devices)<br />
* Improved OpenGL ES and EGL support ([http://www.pivosgroup.com/xios.html Pivos XIOS DS] and [[Raspberry Pi]] as reference devices)<br />
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)<br />
* Improved VDPAU (NVIDIA) Hardware Video Acceleration and its upscaling/deinterlacing capabilities<br />
* Improved OpenMAX Video Acceleration API support for Linux (using Raspberry Pi as reference hardware)<br />
* Added RenderCapture implementation to Linux for Raspberry Pi for Ambilight addons<br />
* Added support for OpenMAX pipeline to handle JPEG decode/resize/convert/encode to texture on Raspberry Pi<br />
* Added support for hardware assisted video decoding of MJPEG, VP6, VP8 and Ogg Theora on Raspberry Pi<br />
* Added support for Fast Forward and Rewind video up 4x to OpenMAX (OMXPlayer) on Linux for Raspberry Pi<br />
* Added support multi-channel PCM audio output over HDMI to OpenMAX (OMXPlayer) on Linux for Raspberry Pi<br />
* Added screenshot implementation to Linux for Raspberry Pi that includes the video layer<br />
* Added hot-plug support for Linux input devices, such as Bluetooth remotes and keyboards<br />
* Improved AMD/Intel x86-64 64-bit (AMD64 / IA-64t CPU architectures) support under Linux<br />
* Removed dependencies of SDL (Simple DirectMedia Layer) for windowing and event handling on X11<br />
* Added support for native media control bar and play background music on iOS<br />
* Added adaptions for developing XBMC on non-jailbroken iSO devices (for development only, not to release on App Store)<br />
* Improved XBMC support for OS X 10.9 (Mavericks)<br />
* Added support for copy and paste to and from clipboard with command key<br />
* Added support for Pixel Shader based HQ (High Quality) scalers for DXVA renderer on Windows<br />
* Added hybrid shutdown option on Windows 8 (which in turn enables quick boot)<br />
* Removed Windows XP support (as from now XBMC for Windows requires at least Vista or later)<br />
| Lubuntu 14.04<br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 14.0<br />14.1<br />14.2<br />
| 23 December 2014<br />1 February 2015<br />28 March 2015<br />
| Helix<br />
|<br />
{{main| Kodi v14 (Helix) changelog |Helix API changes}}<br />
* Renamed and rebranded to Kodi Media Center (from XBMC Media Center)<br />
* Improved PVR, EPG, and OSD frontend GUI in Kodi and extended the PVR API to support more features and functions<br />
* Improved PVR / EPG and Live TV interface in Kodi's GUI skinning engine (already in use in Confluence)<br />
* Improved PVR / DVR timeshift support to pause Live TV (note that each PVR backend still need to support timeshifting)<br />
* Improved PVR / EPG extensions and notifications support over the JSON-RPC API<br />
* Updated and improved PVR backend clients addons for many popular third-party external PVR backend platforms:<br />
* PVR Demo Client dummy addon with fake (method stub) backend for skin development and regression testing<br />
* IPTV (IPTV Simple Client) PVR Addon backend client maintained and available from Kodi's community<br />
* Tvheadend PVR Addon backend clients maintained and available from Kodi's community<br />
* NextPVR (former GB-PVR) PVR Addon backend client maintained and available from Kodi's community<br />
* Njoy Digital (N7) PVR Addon backend client maintained and available from Kodi's community<br />
* MediaPortal PVR Addon backend client maintained and available from Kodi's community<br />
* MythTV PVR Addon backend client maintained and available from the Kodi's community<br />
* VDR (Video Disk Recorder) PVR Addon backend client maintained and available from Kodi's community<br />
* Enigma2 / Vu+ / Dreambox PVR Addon backend client maintained and available from Kodi's community<br />
* Argus TV / ForTheRecord PVR Addon backend client maintained and available from Kodi's community<br />
* WMC (Windows Media Center) PVR Addon backend client maintained and available from Kodi's community<br />
* DVBLink PVR Addon backend client maintained and available from Kodi's community<br />
* DVBViewer PVR Addon backend client maintained and available from Kodi's community<br />
* Added framework support for binary addons (inc. closed source proprietary addons) for audio encoder codecs<br />
* Added support for audio encoder codecs via a binary addons and move Vorbis, LAME, Flac and WAV audio encoders to addons<br />
* Added capability for Text-to-Speech screen readers addons for visual impaired<br />
* Improved the ability to extend Kodi's native Python API by writing C++ code generated via Groovy and SWIG<br />
* Improved Addons API for homebrew DIY RGB LED Ambilight clone client software such as Boblight<br />
* Improved Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) to Kodi's GUI skinning engine<br />
* Improved Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) for Subtitles when in 3D mode<br />
* Added support for HEVC (High Efficiency Video Coding) a.k.a. H.265 software video decoding<br />
* Improved support for H.264 (including Hi10P) multi-threaded video decoding when software decoder on CPU is used<br />
* Upgraded FFmpeg (libavcodec and libavformat) audio/video codec libraries to release version FFmpeg 2.2)<br />
* Removed FFmpeg from from the Kodi code tree, making it easier to compile/build separately<br />
* Improved network and file system reading when scanning files and searching for subtitles<br />
* Improved MusicBrainz tags support to the Music Library and Database<br />
* Improved and extended Smart Playlists functionality<br />
* Improved performance for SQL database queries for faster library browsing<br />
* Updated music, movies, tv shows, and music video scrapers for Kodi from the community<br />
* Added support for Planar Formats and PTS audio synchronization from player in ActiveAE<br />
* Improved the default cross-platform event driven active state machine pattern ActiveAE (Kodi's AudioEngine)<br />
* Improved ALSA sink for ActiveAE for Linux Desktop and generic Linux based Embedded Systems<br />
* Improved PulseAudio sink for ActiveAE for Linux Desktop<br />
* Improved OSS (Open Sound System) sink for ActiveAE for BSD, like FreeBSD and similar BSD Unix based systems<br />
* Improved AUDIOTRACK sink for ActiveAE for Amlogic<br />
* Improved Pi Audio sink for ActiveAE for Raspberry Pi<br />
* Improved DirectSound sink for ActiveAE for Windows<br />
* Improved WASAPI sink for ActiveAE for Windows<br />
* Improved CoreAudio sink for ActiveAE for Mac OS X and iOS<br />
* Improved Darwin sink for ActiveAE for Mac OS X and iOS<br />
* Improved CEC (Consumer Electronics Control) support for Pulse-Eight's LibCEC<br />
* Upgraded DVD-Video navigation and playback libraries (libdvdnav, libdvdread, and libdvdcss)<br />
* Upgraded SAMBA client to version 3.6.x for improved support for SMB and CIFS protocols<br />
* Updated community maintained translations to over 60+ languages to date for Kodi via Transifex Translation System<br />
* Improved MediaCodec API video decoding implementations support for Android 4.1 (API level 16) and later<br />
* Improved StageFright API video decoding implementations support for Android 4.0 (API level 14)<br />
* Improved the dedicated AMLCodec hardware accelerated video decoding support for AMLogic devices<br />
* Improved NEON (Advanced SIMD instruction set) CPU acceleration support for ARM architecture<br />
* Improved Kodi support for BSD (operating system) on FreeBSD, PC-BSD, and other similar BSD platforms<br />
* Added initial optional X11 support on EGL (EGL-X11) based systems on Linux, full-screen mode only<br />
* Added native XvBA accelerated video decoding for AMD/ATI GPUs on Linux<br />
* Improved ARM processor architecture (using WeTek Play and Raspberry Pi as reference devices)<br />
* Improved OpenGL ES and EGL support (using WeTek Play and Raspberry Pi as reference devices)<br />
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)<br />
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)<br />
* Improved OpenMAX Video Acceleration API support for Linux (using Raspberry Pi as reference hardware)<br />
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on AMLogic devices<br />
* Improved AMD/Intel x86-64 64-bit (AMD64 / IA-64t CPU architectures) support under Linux<br />
* Upgraded SDL (Simple DirectMedia Layer) from version 1.2 to 2.0 for improved input-support on Linux<br />
* Removed dependencies of SDL (Simple DirectMedia Layer) for windowing and event handling on X11<br />
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)<br />
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X<br />
* Improved DXVA (DirectX Video Acceleration) support (requires DXVA compatible hardware and drivers)<br />
* Upgraded Kodi for Windows and binary addons to compile with Microsoft Visual Studio 2013 by default<br />
<br />
| <br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 15.0<br />15.1<br />15.2<br />
| 21 July 2015<br />16 August 2015<br />19 October 2015<br />
| Isengard<br />
|<br />
{{main| Kodi v15 (Isengard) changelog |Isengard API changes}}<br />
* Added possibility to use multiple PVR clients for different PVR backends at the same time<br />
* Improved PVR, EPG, and OSD frontend GUI in Kodi and extended the PVR API to support more features and functions<br />
* Improved PVR API and database adding many new EPG and Channel properties<br />
* Improved PVR / DVR timeshift support to pause Live TV (note that each PVR backend still need to support timeshifting)<br />
* Improved PVR / EPG extensions and notifications support over the JSON-RPC API<br />
* Improved Closed Captions (CC) support for Live TV<br />
* Improved the "GlobalSearch" (service addon) function by adding EPG search support<br />
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:<br />
** [[PVR/Testing|PVR Demo Client]] dummy addon with fake (method stub) backend for skin development and regression testing<br />
** [[PVR/Backend/IPTV|IPTV (IPTV Simple Client)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/Tvheadend|Tvheadend]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/NextPVR|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/Njoy|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/MediaPortal|MediaPortal]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/MythTV|MythTV]] PVR Addon backend client maintained and available from the Kodi's community<br />
** [[PVR/Backend/VDR|VDR (Video Disk Recorder)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/VUPlus|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/ForTheRecord|Argus TV / ForTheRecord]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[DVBLink]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[PVR/Backend/DVBViewer|DVBViewer]] PVR Addon backend client maintained and available from Kodi's community<br />
* Removed internal MythTV VFS client code in favour of its external PVR Client Addons<br />
* Removed internal VDR (VTP) VFS client code in favour of its external PVR Client Addons<br />
* Removed internal Tvheadend (HTSP) VFS client code in favour of its external PVR Client Addons<br />
* Removed internal TuxBox (Dreambox/DBox2/Vu+/Enigma1/2) VFS client code in favor of external PVR Client Addons<br />
* Removed internal ReplayTV (DirectTV) VFS client code since its old and was no longer being maintained by anyone<br />
* Removed internal SlingBox VFS client code since its old and is no longer being maintained by anyone<br />
* Improved Addon Manager frontend GUI in Kodi, adding support for categorization, new manager layout and more<br />
* Added initial integration for binary addons support and changing the Kodi build system around it<br />
* Added framework support for binary addons for audio decoder and audio encoder codecs<br />
* Extend Addons API to support binary addons for audio decoder and audio encoder codecs<br />
* Added support for context-menu addons for skinners and addon developers<br />
* Added option for addons scripts to check status of DPMS energy saving functions of underlying OS<br />
* Improved the ability to [http://github.com/xbmc/xbmc/pull/901 extend Kodi's native Python API by writing C++ code generated] via [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 Groovy] and [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 SWIG]<br />
* Improved Addons API for homebrew DIY RGB LED [[Ambient lighting]] (Ambilight clone) client software such as [[Add-on:XBMC Boblight|Boblight]]<br />
* Improved addon management at Kodi version upgrade by immediately fetch updates from repository after upgrade<br />
* Added support for context-menu addons for skinners and addon developers<br />
* Added support Sound Addons for skins instead of including sound files within each skin.<br />
* Improved PVR / EPG / Live TV and context menus interfaces in Kodi's GUI skinning engine (already used in Confluence)<br />
* Added support for Language Addons, moving internal Language translation files into external Language Addons<br />
* Added an accessibility settings section to provide one configuration area for the visually and hearing impaired<br />
* Added further optimizations to Kodi's GUI engine for faster rendering on low resource embedded devices<br />
* Added new icon types and missing icons to Confluence<br />
* Added PVR and EPG support to the Re-Touched (touchscreen friendly) skin<br />
* Improved [[Dirty regions|Dirty Regions]] rendering on all platforms<br />
* Improved Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) to Kodi's GUI skinning engine<br />
* Improved Stereoscopic 3D rendering support (Side-by-Side, Top-Bottom, and Anaglyph) for Subtitles when in 3D mode<br />
* Improved navigation of video audio tracks and subtitle selection lists<br />
* Improved touch and gesture support for all platforms, and also improved the default touch screen skin ([[Add-on:Re-Touched|Re-Touched]])<br />
* Improved and expanded the internationalization options and regional configuration settings in the GUI<br />
* Improved GUI settings configuration levels for Basic, Standard, Advanced, Expert (defaults to "Standard")<br />
* Improved selection when installing new skins <br />
* Update the default bold and regular Roboto TTF fonts from Google <br />
* Updated keyboard layout for many languages<br />
* Restructured settings windows and descriptions for almost every setting and configuration<br />
* Removed legacy code to backwards compatibility for skins made pre-Frodo (XBMC 11.0)<br />
* Added adaptive skipping/seeking through audio and video playback, also known as "[[skip steps]]"<br />
* Improved support for H.264 (including [[Hi10P]]) multi-threaded video decoding when software decoder on CPU is used<br />
* Improved Stereoscopic 3D playback with video playlist switching when playlists have 2D and 3D videos<br />
* Added support for MK3D (Matroska 3D) video extensions and enable double cache by default on these videos<br />
* Added a Chapter Selector Window with visual thumbnails shows thumbs on where to skip to in video<br />
* Added support for Closed Captions (CC) in CEA-608 and CEA-708 formats (ATSC Closed Caption)<br />
* Added support for external subtitles over UPnP / DNLA through the settings section<br />
* Upgraded FFmpeg (libavcodec and libavformat) libraries to release version [http://www.ffmpeg.org/download.html#release_2.6.2 FFmpeg 2.6.2]<br />
* Remove certain audio codecs from core and made them into audio decoder and audio encoder add-ons<br />
* Disabled hardware video decoding of MPEG-2 videos with Standard Definition resolution by default<br />
* Added support for [[Music_nodes| music nodes]] that can defined views that are used to organize your media from the music menu<br />
* Added support for marking as watched during other library operations like “update library” when scanning sources<br />
* Added support for allowing different sort orders for different sort methods<br />
* Added ability to jump to first unwatched episode in TV section by default<br />
* Added support to rescrape season art for newly added seasons<br />
* Improved MusicBrainz tags support to the Music Library and Database<br />
* Improved and extended [[Smart playlists|Smart Playlists]] functionality<br />
* Improved performance for SQL database queries for faster library browsing<br />
* Updated music, movies, tv shows, and music video scrapers for Kodi<br />
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])<br />
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems<br />
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop<br />
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems<br />
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]<br />
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]<br />
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS<br />
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS<br />
* Added new audio visualization addons (only OpenGL versions for Linux and OS X for now)?<br />
* Improved display of CPU / GPU frequency and temperature for all supported platforms<br />
* Improved keymap for music playback, as while in full screen pressing select/ok button will now show the OSD<br />
* Added support for [[wikipedia:WSGI|WSGI (Web Server Gateway Interface)]] to extend the Python Script support in Kodi's integrated webserver<br />
* Added support for JSONP for JSON-RPC requests to Kodi's integrated webserver<br />
* Added support for image resizing to Kodi's integrated webserver<br />
* Improved webserver caching control<br />
* Improved the JSON-RPC API<br />
* Improved the the integrated UPnP Media Server and Client<br />
* Changed Kodi application code base to C++11<br />
* Improved [[CEC|HDMI CEC (Consumer Electronics Control)]] support for [http://libcec.pulse-eight.com/ Pulse-Eight's LibCEC]<br />
* Upgraded HDMI-CEC libraries code from Pulse-Eight to [http://raw.githubusercontent.com/Pulse-Eight/libcec/master/ChangeLog LibCEC release version 3.0.0]<br />
* Upgraded DVD-Video navigation and playback libraries (libdvdnav, libdvdread, and libdvdcss)<br />
* Upgraded SAMBA client code library to version 3.6.12 for improved support for SMB/CIFS protocol<br />
* Updated community maintained translations to over 60+ languages to date for Kodi via [[Translation System|Transifex Translation System]]<br />
* Removed internal DAAP VFS client code for iIunes 6.x music shares (network stream from older Apple iTunes)<br />
* Removal AFP filesystem support from Kodi's VFS (Virtual File System)<br />
* Improved code stability and performance as well as general code clean-up in all areas<br />
* Improved MediaCodec API video decoding implementations support for Android 4.2 (API level 17) and later<br />
* Improved the dedicated AMLCodec hardware accelerated video decoding support for [[Amlogic]] devices<br />
* Added automatic refresh rate switching support for video playback on Android 5.0 and later (>= API 21), including Android TV<ref>http://github.com/anssih/xbmc/commits/android/refreshrate_wip WIP refreshrate</ref><br />
* Added support for HEVC hardware decoding for MediaCodec API in Android 4.4.2 and later when the VPU supports it<br />
* Added support for HEVC hardware decoding on [[Amlogic]] SoCs in Android 4.4.2 and later when the VPU supports it<br />
* Added support for UltraHD decoding / 4K resolution output on [[Amlogic]] SoCs in Android when HW supports it<br />
* Added support for screenshot and video bookmarks on [[Amlogic]] SoCs hardware<br />
* Added support for LCD/VFD display panel output on [[Amlogic]] SoCs hardware<br />
* Added support for de-interlacing using BOB deinterlace method on Android<br />
* Added support for 7.1 channels PCM playback<br />
* Added support for system handling of audio volume on Android<br />
* Moved to Android API 17 as minimum with SDK 14 and NDK 10e, meaning at least Android 4.2 is now required<br />
* Improved [http://en.wikipedia.org/wiki/ARM_architecture#Advanced_SIMD_.28NEON.29 NEON (Advanced SIMD instruction set)] CPU acceleration support for ARM architecture<br />
* Removed the dependency for root/SU access permission rights on Android<br />
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms<br />
* Added MIPS processor architecture support for Linux (Imagination Technologies MIPS Creator CI20 as reference)<br />
* Added support for HEVC hardware video decoding on [[Amlogic]] SoCs when the VPU supports it<br />
* Added support for UltraHD decoding / 4K resolution output on [[Amlogic]] SoCs in Android when HW supports it<br />
* Added support for screenshot and video bookmarks on [[Amlogic]] SoCs hardware<br />
* Added support for LCD/VFD display panel output on [[Amlogic]] SoCs hardware<br />
* Improved video accelerated decoding on [[Freescale|Freescale i.MX 6]] based devices<br />
* Improved ARM processor architecture (using [[WeTek Play]] and [[Raspberry Pi]] as reference devices)<br />
* Improved OpenGL ES and EGL support (using [[WeTek Play]] and [[Raspberry Pi]] as reference devices)<br />
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)<br />
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)<br />
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)<br />
* Improved OpenMAX Video Acceleration API support for Linux (using Raspberry Pi as reference hardware)<br />
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on [[Amlogic]] devices<br />
* Improved AMD/Intel x86-64 64-bit (AMD64 / IA-64t CPU architectures) support under Linux<br />
* Removed dependencies of SDL (Simple DirectMedia Layer) for everything but hardware abstraction for input devices<br />
* Improve Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)<br />
* Moved to iOS 8.1 SDK, minimum iOS 5.1 is now required, this removes support for Apple TV 2 builds<br />
* Improve Apple VDADecoder Video Acceleration support for (Mac) OS X<br />
* Added Kodi support for OS X 10.10 "Yosemite" from Apple<br />
* Moved to OS X 10.10 SDK, meaning minimum (Mac) OS X 10.7 Lion is now required, and no more 32-bit builds<br />
* Improved DXVA/DXVA2 (DirectX Video Acceleration) support (requires DXVA/DXVA2 compatible hardware and drivers)<br />
* Added support for HEVC hardware video decoding via DXVA on Windows when hardware and driver supports exist<br />
* ?<br />
|<br />
| <br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 16.0<br />16.1<br />
| 20 February 2016<br />24 April 2016<br />
| Jarvis<br />
|<br />
{{main| Kodi v16 (Jarvis) changelog |Jarvis API changes}}<br />
<br />
* Added support for handling RDS Radio signals via PVR and EPG frontend<br />
* Added support for PVR addons to handle RDS radio signals in UECP and Rass formats<br />
* Added FM Radio receiver based upon RTL-SDR as PVR Addon backend client<br />
* Added support to PVR API for Scheduling Recordings of TV Shows (EPG based DVR Timers for "Series Recording")<br />
* Added option for PVR clients and backends to add timeshift indicator to the Video OSD for Live TV<br />
* Added support to show channels without EPG data in PVR guide window<br />
* Added 'Play recording' context menu option if an EPG entry has an associated (PVR) recording<br />
* Added enhancement and impovements to the PVR API (example series/episode metadata, timer and recording status)<br />
* Updated Kodi's PVR Addon API version to 4.0.0 for Kodi v16 (Jarvis)<br />
* Improved EPG association by broadcast ID<br />
* Improved speedup reading EPG from database<br />
* Changed activations of PVR windows so they are only available if PVR is enabled<br />
* Changed "Add timer" as renamed to "Record", and renamed "Add custom timer" to just "Add timer"<br />
* Added, updated, and improved PVR backend clients addons for all popular third-party external [[PVR backend]] platforms:<br />
** [[Add-on:PVR Demo Client|PVR Demo Client]] dummy addon with fake (method stub) [[PVR backend]] for [[PVR]] skinning and regression testing<br />
** [[Add-on:IPTV Simple Client|IPTV Simple Client]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:FilmOn PVR Client|FilmOn]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:Stalker Client|Stalker Middleware]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:HDHomeRun PVR|HDHomeRun]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:VU+ / Enigma2 Client|Enigma2 (Dreambox / Vu+ / DBox2)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:VBox TV Gateway PVR Client|VBox TV Gateway]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:Njoy N7 PVR Client|Njoy Digital (N7)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:PCTV Systems Client|PCTV Systems (Broadway)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:Tvheadend HTSP Client|Tvheadend HTSP Client]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:VDR VNSI Client|VDR VNSI Client]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:MythTV PVR Client|MythTV PVR Client]] Addon backend client maintained and available from the Kodi's community<br />
** [[Add-on:NextPVR PVR Client|NextPVR (former GB-PVR)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:Argus TV Client|Argus TV (former ForTheRecord)]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:DVBLink PVR Client|DVBLink PVR Client]] Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:DVBViewer Client|DVBViewer Client]] PVR Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:MediaPortal PVR Client|MediaPortal PVR Client]] Addon backend client maintained and available from Kodi's community<br />
** [[Add-on:PVR.WMC|WMC (Windows Media Center)]] PVR Addon backend client maintained and available from Kodi's community<br />
* Added support for allowing skins and resource addons to be activated via info dialog<br />
* Added support for disabling auto-updates per addon from the info panel dialog<br />
* Added automatic dependency handling for binary addons<br />
* Improved add-on update and rollback support by adding ability to choose only a specific repo<br />
* Improved capabilities for downgrading of addons by supporting multiple versions in same repository<br />
* Improved bootstrap buildsystem for binary addons to support arbitrary meta repositories<br />
* Improved the ability to [http://github.com/xbmc/xbmc/pull/901 extend Kodi's native Python API by writing C++ code generated] via [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 Groovy] and [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 SWIG]<br />
* Updated the Groovy (code generator) library to 2.4.4<br />
* Moved some binary (RSXS) Screensavers and Audio Visualizations (Vis) to addons<br />
* Moved the addon rollback feature to the update dialog and list all available versions there<br />
* Updated GUI ABI version 15 as minimum setting any skin before Kodi 15.0 (Isengard) as incompatible<br />
* Update guilib ABI (for libgui) to version 5.10.0<br />
* Changed saving of skin settings which are now stored as separate files<br />
* Added support for Animated GIF images to loadable for any kind of textures, e.g. Posters and FanArt<br />
* Added support for image resource addons (as example weather icons, weather fanart, studio logos, and genre icons)<br />
* Added support for sound resource addons (skin effect sounds for button clicks, transitions, etc.)<br />
* Added new dialogs for managning and settings for digital sound processing addons (Audio DSP plugins)<br />
* Added new dialog to display RDS Radio information under PVR windows<br />
* Added option for skinners to add a timeshift indicator to the Video OSD for Live TV<br />
* Added skinning support to enable editing of user-ratings from skins frontend<br />
* Added support of <depth> tag for stereoscopic (3D) effect for controls to GUI engine for skins<br />
* Added stereoscopic (3D) depth support for the Confluence skin<br />
* Added the use of image resource addons for updating weather fanart images in Confluence<br />
* Added 'Events' to the Confluence homescreen 'System' submenu<br />
* Added EPG to search results window (add to PVR search results window in Confluence)<br />
* Added new infolabel that can be used to display fanart for moviesets inside a movie set<br />
* Added new infolabels that can display audio/subtitle properties for all available streams<br />
* Added new infolabels for displaying user ratings<br />
* Added support for skins to use a lightweight font<br />
* Added toggle switch to visually mark dirty regions to help skinners optimize and troubleshoot skins<br />
* Added support for sortby and sortorder attributes to the <content> element<br />
* Added ability in guilib to visualize control hitrects when tagged<br />
* Added option to conditionally include files to allow skinners to conditionally include a file<br />
* Added option for skins to show separate icons for empty and full DVD-ROM drives<br />
* Added support for specifying the image scaling algorithm for image resizing/caching<br />
* Added new on-screen keyboard layouts for; Chinese, Korean, English QWERTZ, Czech QWERTZ and QWERTY<br />
* Updated keyboard layout for some languages and added a new keyboard layouts for a few languages<br />
* Improved default quality setting of image scaling algorithm for image resizing/caching<br />
* Improved skinning PVR section by reduceing amount of dialogs and simplify skinning Live TV and EPG windows<br />
* Improved skin reloading in case theme/color/font is not default<br />
* Improved touch and gesture support for all platforms, and also improved the default touch screen skin ([[Add-on:Re-Touched|Re-Touched]])<br />
* Removed skin XML files for Karaoke support as the feature has been removed from Kodi's core<br />
* Removed native TvTunes support from Confluence since they changed into a paid-only service<br />
* Added support for lossless software decode of DTS-HD tracks/streams in videos using libdcadec<br />
* Added support to utilize pixel aspect ratio from SAR (Storage Aspect Ratio) tags in MKV containers<br />
* Improved Stereoscopic 3D playback with video playlist switching when playlists have 2D and 3D videos<br />
* Improved and enhanced Blu-ray support (including updated libbluray dependecies)<br />
* Upgraded FFmpeg multimedia codec and demux libraries to stable branch release version [http://www.ffmpeg.org/download.html#release_2.8.5 FFmpeg 2.8.5]<br />
* Removed certain audio codecs from core and made them into audio decoder and audio encoder add-ons<br />
* Unified the music library and files view (similar to how its done in video library already)<br />
* Added option for for user ratings of video items and editing userratings from the GUI frontend<br />
* Added support for set overview (plot) in movie sets in the video library<br />
* Added setting for to not group movies into a movie set in the video library if it contains a single item<br />
* Added event logging which among others shows which files did not get added to library<br />
* Added genre to television series episode view in the video library<br />
* Added support for Audio and Subtitle Track Count to Smart Playlist selections in the video library<br />
* Added support to sort by top albums by play count in the music library<br />
* Added support for sorting dynamic directory listings from content<br />
* Added a FFmpeg tag loader that can read additional metadata from more media containers<br />
* Added support to use the new FFmpeg tag loader for reading tags from .DSP files<br />
* Added support to use the new FFmpeg tag loader for reading tags from .MKA files<br />
* Added support for the MusicBrainz "ARTISTS" tag in id3v2, ape, xiph for music files<br />
* Added ability to fetch season year from video database based on first aired episode<br />
* Updated music, movies, tv shows, and music video scrapers for Kodi<br />
* Added initial support for [http://forum.kodi.tv/forumdisplay.php?fid=235 Audio DSP] (Digital Signal Processing) plugins and addons for Kodi's [[AudioEngine]]<br />
* Improved the default cross-platform event driven active state machine pattern [[AudioEngine#ActiveAE|ActiveAE]] (Kodi's [[AudioEngine]])<br />
* Improved ALSA sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop and generic Linux based Embedded Systems<br />
* Improved PulseAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for Linux Desktop<br />
* Improved OSS (Open Sound System) sink for [[AudioEngine#ActiveAE|ActiveAE]] for BSD, like FreeBSD and similar BSD Unix based systems<br />
* Improved AUDIOTRACK sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Amlogic]]<br />
* Improved Pi Audio sink for [[AudioEngine#ActiveAE|ActiveAE]] for [[Raspberry Pi]]<br />
* Improved DirectSound sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Improved WASAPI sink for [[AudioEngine#ActiveAE|ActiveAE]] for Windows<br />
* Improved CoreAudio sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS<br />
* Improved Darwin sink for [[AudioEngine#ActiveAE|ActiveAE]] for (Mac) OS X and iOS<br />
* Added initial support for AirPlay from iOS 9 music streaming capability<br />
* Added own lists for audio, subtitle and sub download languages<br />
* Added ability to open the SmartPlayListEditor for a given playlist<br />
* Added "long-press" support to extend the functionality of a single button on a remote control<br />
* Improved code stability and performance as well as general code clean-up in many core areas<br />
* Improved the the integrated UPnP / DNLA Media Server and Client<br />
* Improved AirPlay compatibility suppor for iOS 8 (via updated libshairplay)<br />
* Improved Kodi's JSON-RPC API<br />
* Improved [[CEC|HDMI CEC (Consumer Electronics Control)]] support for [http://libcec.pulse-eight.com/ Pulse-Eight's LibCEC]<br />
* Updated community maintained translations to over 60+ languages to date for Kodi via [[Translation System|Transifex Translation System]]<br />
* Updated critical dependency libraries such as openssl, gnutls, and CMake (used to compile binary addons)<br />
* Removed support for the current karaoke implmenetation from the core as it was not being maintained<br />
* Added experimental pass-through support for Dolby Digital (AC3) audio<br />
* Added experimental pass-through support for Dolby TrueHD audio (if supported by underlying hardware & firmware)<br />
* Added experimental pass-through support for DTS audio<br />
* Added experimental pass-through support for DTS-HD Master Audio (if supported by underlying hardware & firmware)<br />
* Added software decode support of Dolby Digital Plus (DD+/E-AC3/EC-3) to PCM audio output<br />
* Added proper implementation of Surface Rendering going thru EGL for video decoded with Android's MediaCodec API<br />
* Added proper implementation of handling MEDIA keys support on Android<br />
* Improved MediaCodec API video decoding implementations support for Android 4.2 (API level 17) and later<br />
* Improved automatic refresh rate switching support for video playback on Android 5.0 and later (>= API 21), inc. Android TV<br />
* Improved support for UltraHD decoding / 4K resolution output when HW supports it<br />
* Improved playback of HEVC, VC-1 / WMV 9, and VP9 hardware video decoding when using Android's MediaCodec API<br />
* Improved display of other Android apps while browsing these under Kodi as application launcher<br />
* Improved audio output by decouple Kodi and system volume which removes double audio volume slider<br />
* Improved touch-screen keymapping for Android based platforms for better gesture support<br />
* Improved [http://en.wikipedia.org/wiki/ARM_architecture#Advanced_SIMD_.28NEON.29 NEON (Advanced SIMD instruction set)] CPU acceleration support for ARM architecture<br />
* Removed support for hardware video decoding via Android StageFright library (libstagefright)<br />
* Improved Kodi support for [http://en.wikipedia.org/wiki/Berkeley_Software_Distribution BSD (operating system)] on FreeBSD, PC-BSD, and other similar BSD platforms<br />
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)<br />
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)<br />
* Added multi-touch support, and improved touch and gesture support on Linux<br />
* Added support for HEVC hardware video decoding via [[wikipedia:VAAPI|VAAPI]] API when the VPU and drivers supports it<br />
* Added support for HEVC hardware video decoding via [[wikipedia:VDPAU|VDPAU]] API when the VPU and drivers supports<br />
* Improved rendering GUI (including OSD) at a different resolution than video playback plane<br />
* Improved automatic refresh rate switching support for video playback<br />
* Improved EGL rendering on Amlogic by implement 480cvbs/i/p and 576cvbs/i/p modes<br />
* Improved SQLite file access performance on Raspberry Pi using MMAP acceleration<br />
* Improved support for UltraHD decoding / 4K resolution output when hardware supports it<br />
* Improved video accelerated decoding on [[Freescale|Freescale i.MX 6]] based devices<br />
* Improved ARM processor architecture (using [[WeTek Play]] and [[Raspberry Pi]] as reference devices)<br />
* Improved OpenGL ES and EGL support (using [[WeTek Play]] and [[Raspberry Pi]] as reference devices)<br />
* Improved VAAPI (Video Acceleration API) support (requires VAAPI compatible hardware and drivers)<br />
* Improved VDPAU (NVIDIA) Hardware Video Acceleration (requires VDPAU compatible hardware and drivers)<br />
* Improved XvBA (AMD/ATI) Hardware Video Acceleration (requires XvBA compatible hardware and drivers)<br />
* Improved OpenMAX Video Acceleration API support for Linux (using Raspberry Pi as reference hardware)<br />
* Improved dedicated AMLCodec hardware accelerated video decoding support for Linux on [[Amlogic]] devices<br />
* Improved AMD/Intel x86-64 64-bit (AMD64 / IA-64t CPU architectures) support under Linux<br />
* Added support for iOS 9.0 by adding support for compiling Kodi with Xcode 7 IDE and iOS SDK 9.0<br />
* Moved to iOS 8.4 SDK and Xcode 6.4 IDE as default which added support for iOS 8.4<br />
* Improved Apple VDADecoder Video Acceleration support for iOS (on iPad, iPhone, and iPod iDevices)<br />
* Improved touch and gesture support for iOS based iDevice platforms (iPad, iPod, and iPhone)<br />
* Removed support for compiling Apple TV 2 builds<br />
* Removed iOS 5.1 (iPad 1) compatiibility as it was required to add iOS 9<br />
* Improved Apple VDADecoder Video Acceleration support for (Mac) OS X<br />
* Added support for compiling Kodi with Xcode 7 IDE and OS X 10.11 SDK<br />
* Updated the whole rendering system on Microsoft Windows platforms to DirectX 11 and Direct3D 11 native support<br />
* Added support for caching font vertices on GPU side (requires Windows 8 and DirectX 11 device drivers)<br />
* Added support for hardware based Stereoscopic 3D (requires Windows 8 and DirectX 11 device drivers)<br />
* Added support for interleaved Stereoscopic 3D mode on Windows platforms (requires DirectX 11 device drivers)<br />
* Added support for checkerboard Stereoscopic 3D mode on Windows platforms (requires DirectX 11 device drivers)<br />
* Improved DXVA/DXVA2 rendering and decoding on Windows (when using DirectX 11 device drivers)<br />
* Improved support for HEVC hardware video decoding via DXVA on Windows when hardware and driver supports exist<br />
* ?<br />
|<br />
| <br />
|-<br />
| style="white-space:nowrap; background:salmon;"| 17.0<br />17.1<br />17.2<br />17.3<br />17.4<br />17.5<br />17.6<br />
| 5 February 2017<br />23 March 2017<br />21 May 2017<br />24 May 2017<br />22 August 2017<br />24 October 2017<br />15 November 2017<br />
| Krypton<br />
|<br />
{{main| Kodi v17 (Krypton) changelog |Krypton API changes}}<br />
|<br />
|-<br />
| style="white-space:nowrap; background:#a0e75a;"| 18.0<br />18.1<br />18.2<br />
| 29 January 2019<br />11 February 2019<br />22 April 2019<br />
| Leia<br />
<br />
|<br />
{{main| Kodi v18 (Leia) changelog |Leia API changes}}<br />
29 December 2017 - XBox One v18 Alpha released to Windows Store<br />
|<br />
|-<br />
| style="white-space:nowrap; background:skyblue;"| 19.0<br />
| TBA<br />
| M***<br />
|<br />
|-<br />
|}<br />
<br />
== Codename history ==<br />
{{see|Codename history}}<br />
<br />
== References ==<br />
<references/><br />
<br />
[[Category:Kodi]]<br />
[[Category:Development]]</div>WhikiDudehttps://kodi.wiki/index.php?title=Settings/Media/Music&diff=165739Settings/Media/Music2019-04-28T16:15:18Z<p>WhikiDude: /* Default service for artist information */</p>
<hr />
<div>{{MusicLibraryCreate}}<br />
{{bigger|This category contains the settings for how information for music is collected, stored, shown and navigated.}}<br />
__TOC__<br />
<br />
<br />
<br />
== Creating Your Music Library ==<br />
Have you arrived at this page by following the Music Library Creation Guide? If yes, then all you are required to do is check that your settings match the default settings of Section 4. The images show the default settings.<br />
<br />
<br />
<br />
== All ==<br />
[[File:Settings_media_music_all.JPG|500px]]<br />
<br />
<br />
=== Track naming template ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Basic<br />
|- valign="top"<br />
| '''Description:'''<br />
| The track naming template is a format mask made up of certain mask characters that represent specific music data and simple format instructions like italic. The track naming template controls how names of songs are displayed in the UI '''when sorted by track number'''. In order to function properly, this requires tag reading to be enabled. The default setting is [%N.]%A-%T<br />
<section begin="Track naming template" /><br />
{| class="prettytable" <br />
|-<br />
! scope="row"| Music Data<br />
| TrackNumber || DiscNumber || Artist || Title || Album || Genre || Year || FileName || Duration || Date || Rating || File Size || User Rating<br />
|-<br />
! scope="row"| Mask Characters<br />
| style="text-align:center;" | %N <br />
| style="text-align:center;" | %S<br />
| style="text-align:center;" | %A<br />
| style="text-align:center;" | %T<br />
| style="text-align:center;" | %B<br />
| style="text-align:center;" | %G<br />
| style="text-align:center;" | %Y<br />
| style="text-align:center;" | %F<br />
| style="text-align:center;" | %D<br />
| style="text-align:center;" | %J<br />
| style="text-align:center;" | %R<br />
| style="text-align:center;" | %I<br />
| style="text-align:center;" | %r<br />
|}<br />
<section end="Track naming template" /><br />
{| class="prettytable" <br />
!colspan="2" style="width:150px; text-align:left" | Format Characters<br />
!style="width:10px; text-align:left;" |<br />
!colspan="2" style="text-align:left"| Usage Example<br />
|-<br />
! scope="row"| Bold <br />
| [[B]...[/B]] || <br />
| style="background-color:#d3d3d3;" | Raw tag <br />
| [%N] [[I]%A[/I]] - %B : [[B]%T[/B]]<br />
|-<br />
! scope="row"| Italic<br />
| [[I]...[/I]] || <br />
| style="background-color:#d3d3d3;" | Output <br />
| [track nr.] ''artist'' - album : '''title'''<br />
|}<br />
|}<br />
<br />
<br />
=== Search for thumbs on remote shares ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Advanced<br />
|- valign="top"<br />
| '''Description:'''<br />
| When this option is enabled, Kodi will search for thumbs on remote shares including DVD and CD. Due to the long seek/read times required to perform this function this will slow the listing of network folders quite dramatically (particularly if there are many items that have no thumbs). The default setting is enabled. The recommended setting is disabled<br />
|}<br />
<br />
<br />
== Files ==<br />
[[File:Settings_media_music_files.JPG|500px]]<br />
<br />
<br />
=== Enable tag reading ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| Read the tag information from song files. For large directories this can increase read time, especially over a network. This option affects the File View when using Kodi with music that has not been scanned into the library. This has no effect on the Library View. When enabled, tag reading will read the Music File Tags from every song. This will display the song name from the Music File tag but this process will slow down read time of large directories (particularly over a network). It is recommended that you can “Scan” your songs into the library by following the guide. This will read the tags of all songs in this directory (and it's sub-directories) and add the information to the database. Next time you go into that directory, Kodi will first look for the tag information in the database, which will speed up the directory loading. The default setting is Enabled.<br />
|}<br />
{{-}}<br />
<br />
<br />
<section begin="Settings Media Music Library" /><br />
== Library ==<br />
[[File:SettingsMediaMusic-leia2.jpg|500px]]<br />
<br />
<br />
=== Show "All items" entry ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Advanced<br />
|- valign="top"<br />
| '''Description:'''<br />
| Show "All items" entry in directory, e. g. "All albums" or "All seasons". The default setting is Enabled.<br />
|}<br />
<br />
<br />
=== Show song and album artists ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Basic<br />
|- valign="top"<br />
| '''Description:'''<br />
| When enabled, both song and album artists are shown. When disabled, only album artists are shown and artists that appear only on individual song from an album are excluded. In effect, Various Artist type albums will have no listings for Artists when disabled as there is not a single Album Artist. This is a personal choice. The default setting is Enabled.<br />
|}<br />
<br />
<br />
=== Use artist sortname when sorting by artist ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| When Enabled, this setting will change the Artist listing from the standard ''Taylor Swift'' to ''Swift, Taylor''<br />
|}<br />
<br />
<br />
=== Prefer online information ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| With this enabled, some artist and album data in the library, which has been derived from music file tags, will be overwritten by information that is downloaded from the scraper site or from a NFO file. For a list of library fields and tags that will be overwritten see [[NFO_files/Music]]. To clarify, this will not modify the Music File Tags, only the library entries. However this option is being deprecated, only enable if you are absolutely sure you want to do it and understand the consequences. It can not be used compensate for bad tagging of music files. The default setting is Disabled.<br />
|}<br />
<br />
<br />
=== Fetch additional information during updates ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Advanced<br />
|- valign="top"<br />
| '''Description:'''<br />
| Automatically fetches album and artist information via scrapers during scan. This can be a slow process if you have a large music collection. '''If this is the initial creation of your library, ensure this setting is disabled.''' The additional information can be run later from the Context Menu in the Artists and Albums listing. The default setting is Disabled<br />
|}<br />
<br />
<br />
=== Artist information folder ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| Select the folder where artist information (nfo files and images) should be saved. <br />
|-<br />
| '''See Also:'''<br />
| '''''[[Artist information folder]]'''''<br />
|}<br />
<br />
<br />
=== Prefer online album art ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| When no local album cover exists, online art will be used. Where neither is available, cover images embedded in music files will be used. <br />
|}<br />
<br />
<br />
=== Default provider for album information ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| Selects the default album information source, see the add-ons manager for options. The default setting is the Universal Album Scraper.<br />
|}<br />
<br />
=== Default provider for artist information ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| Selects the default artist information source. The default setting is the Universal Artist Scraper<br />
|}<br />
<section end="Settings Media Music Library" /><br />
<br />
<br />
{{Top}}<br />
<br />
{{updated|18}}<br />
[[Category:FAQ]]<br />
[[Category:Index]]<br />
[[Category:Guides]]<br />
[[Category:Manual]]<br />
[[Category:Karellen]]<br />
[[Category:First time user]]<br />
[[Category:Music library]]<br />
[[Category:Advanced topics]]<br />
[[Category:Quick Start Guide]]</div>WhikiDudehttps://kodi.wiki/index.php?title=Settings/Media/Music&diff=165738Settings/Media/Music2019-04-28T16:15:07Z<p>WhikiDude: /* Default service for album information */</p>
<hr />
<div>{{MusicLibraryCreate}}<br />
{{bigger|This category contains the settings for how information for music is collected, stored, shown and navigated.}}<br />
__TOC__<br />
<br />
<br />
<br />
== Creating Your Music Library ==<br />
Have you arrived at this page by following the Music Library Creation Guide? If yes, then all you are required to do is check that your settings match the default settings of Section 4. The images show the default settings.<br />
<br />
<br />
<br />
== All ==<br />
[[File:Settings_media_music_all.JPG|500px]]<br />
<br />
<br />
=== Track naming template ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Basic<br />
|- valign="top"<br />
| '''Description:'''<br />
| The track naming template is a format mask made up of certain mask characters that represent specific music data and simple format instructions like italic. The track naming template controls how names of songs are displayed in the UI '''when sorted by track number'''. In order to function properly, this requires tag reading to be enabled. The default setting is [%N.]%A-%T<br />
<section begin="Track naming template" /><br />
{| class="prettytable" <br />
|-<br />
! scope="row"| Music Data<br />
| TrackNumber || DiscNumber || Artist || Title || Album || Genre || Year || FileName || Duration || Date || Rating || File Size || User Rating<br />
|-<br />
! scope="row"| Mask Characters<br />
| style="text-align:center;" | %N <br />
| style="text-align:center;" | %S<br />
| style="text-align:center;" | %A<br />
| style="text-align:center;" | %T<br />
| style="text-align:center;" | %B<br />
| style="text-align:center;" | %G<br />
| style="text-align:center;" | %Y<br />
| style="text-align:center;" | %F<br />
| style="text-align:center;" | %D<br />
| style="text-align:center;" | %J<br />
| style="text-align:center;" | %R<br />
| style="text-align:center;" | %I<br />
| style="text-align:center;" | %r<br />
|}<br />
<section end="Track naming template" /><br />
{| class="prettytable" <br />
!colspan="2" style="width:150px; text-align:left" | Format Characters<br />
!style="width:10px; text-align:left;" |<br />
!colspan="2" style="text-align:left"| Usage Example<br />
|-<br />
! scope="row"| Bold <br />
| [[B]...[/B]] || <br />
| style="background-color:#d3d3d3;" | Raw tag <br />
| [%N] [[I]%A[/I]] - %B : [[B]%T[/B]]<br />
|-<br />
! scope="row"| Italic<br />
| [[I]...[/I]] || <br />
| style="background-color:#d3d3d3;" | Output <br />
| [track nr.] ''artist'' - album : '''title'''<br />
|}<br />
|}<br />
<br />
<br />
=== Search for thumbs on remote shares ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Advanced<br />
|- valign="top"<br />
| '''Description:'''<br />
| When this option is enabled, Kodi will search for thumbs on remote shares including DVD and CD. Due to the long seek/read times required to perform this function this will slow the listing of network folders quite dramatically (particularly if there are many items that have no thumbs). The default setting is enabled. The recommended setting is disabled<br />
|}<br />
<br />
<br />
== Files ==<br />
[[File:Settings_media_music_files.JPG|500px]]<br />
<br />
<br />
=== Enable tag reading ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| Read the tag information from song files. For large directories this can increase read time, especially over a network. This option affects the File View when using Kodi with music that has not been scanned into the library. This has no effect on the Library View. When enabled, tag reading will read the Music File Tags from every song. This will display the song name from the Music File tag but this process will slow down read time of large directories (particularly over a network). It is recommended that you can “Scan” your songs into the library by following the guide. This will read the tags of all songs in this directory (and it's sub-directories) and add the information to the database. Next time you go into that directory, Kodi will first look for the tag information in the database, which will speed up the directory loading. The default setting is Enabled.<br />
|}<br />
{{-}}<br />
<br />
<br />
<section begin="Settings Media Music Library" /><br />
== Library ==<br />
[[File:SettingsMediaMusic-leia2.jpg|500px]]<br />
<br />
<br />
=== Show "All items" entry ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Advanced<br />
|- valign="top"<br />
| '''Description:'''<br />
| Show "All items" entry in directory, e. g. "All albums" or "All seasons". The default setting is Enabled.<br />
|}<br />
<br />
<br />
=== Show song and album artists ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Basic<br />
|- valign="top"<br />
| '''Description:'''<br />
| When enabled, both song and album artists are shown. When disabled, only album artists are shown and artists that appear only on individual song from an album are excluded. In effect, Various Artist type albums will have no listings for Artists when disabled as there is not a single Album Artist. This is a personal choice. The default setting is Enabled.<br />
|}<br />
<br />
<br />
=== Use artist sortname when sorting by artist ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| When Enabled, this setting will change the Artist listing from the standard ''Taylor Swift'' to ''Swift, Taylor''<br />
|}<br />
<br />
<br />
=== Prefer online information ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| With this enabled, some artist and album data in the library, which has been derived from music file tags, will be overwritten by information that is downloaded from the scraper site or from a NFO file. For a list of library fields and tags that will be overwritten see [[NFO_files/Music]]. To clarify, this will not modify the Music File Tags, only the library entries. However this option is being deprecated, only enable if you are absolutely sure you want to do it and understand the consequences. It can not be used compensate for bad tagging of music files. The default setting is Disabled.<br />
|}<br />
<br />
<br />
=== Fetch additional information during updates ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Advanced<br />
|- valign="top"<br />
| '''Description:'''<br />
| Automatically fetches album and artist information via scrapers during scan. This can be a slow process if you have a large music collection. '''If this is the initial creation of your library, ensure this setting is disabled.''' The additional information can be run later from the Context Menu in the Artists and Albums listing. The default setting is Disabled<br />
|}<br />
<br />
<br />
=== Artist information folder ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| Select the folder where artist information (nfo files and images) should be saved. <br />
|-<br />
| '''See Also:'''<br />
| '''''[[Artist information folder]]'''''<br />
|}<br />
<br />
<br />
=== Prefer online album art ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| When no local album cover exists, online art will be used. Where neither is available, cover images embedded in music files will be used. <br />
|}<br />
<br />
<br />
=== Default provider for album information ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| Selects the default album information source, see the add-ons manager for options. The default setting is the Universal Album Scraper.<br />
|}<br />
<br />
=== Default service for artist information ===<br />
{|<br />
|- valign="top"<br />
| width=120px | {{nowrap|'''Settings level:'''}} <br />
| Standard<br />
|- valign="top"<br />
| '''Description:'''<br />
| Selects the default artist information source. The default setting is the Universal Artist Scraper<br />
|}<br />
<section end="Settings Media Music Library" /><br />
<br />
<br />
{{Top}}<br />
<br />
{{updated|18}}<br />
[[Category:FAQ]]<br />
[[Category:Index]]<br />
[[Category:Guides]]<br />
[[Category:Manual]]<br />
[[Category:Karellen]]<br />
[[Category:First time user]]<br />
[[Category:Music library]]<br />
[[Category:Advanced topics]]<br />
[[Category:Quick Start Guide]]</div>WhikiDudehttps://kodi.wiki/index.php?title=Scraping_Music&diff=165737Scraping Music2019-04-28T13:17:00Z<p>WhikiDude: /* Scrapers */</p>
<hr />
<div>{{MusicLibraryCreate}}<br />
{{mininav|[[Music library]]}}<br />
<br />
<br />
= Introduction =<br />
<section begin="intro"/>Music Scraping downloads additional information about the Artists and Albums in your library, as well as downloading any missing artwork. This step is optional, but if you choose to scrape, it must be performed after your music is Scanned into the library.<section end="intro"/><br />
<br />
The source of information for the scrape can be either:<br />
#An online source using one of the Kodi Scrapers<br />
#Local information from either '''''[[NFO files]]''''' or data in a '''''[[Import-export_library/Music|Single File]]''''' export. <br />
For this guide, it is assumed this is your first setup, so you will have no local files. The scraped data is being retrieved from an online source using the scrapers.<br />
<br />
v18 introduces a number of changes and improvements to scraping. The most prominent being the [[Artist information folder]]. Also new is the ability for {{kodi}} and the scrapers to download and cache Extended Artwork. These are covered below.<br />
<br />
<br />
= What is Scraped =<br />
If the information and artwork is available at the online site used by the active scrapers, the scraping process will download the additional data and artwork into your existing library. <br />
<br />
<br />
<br />
== Artists ==<br />
The below table details the '''additional''' information {{kodi}} scrapes into the library. This data cannot be scanned from tags.<br />
<br />
{|class="prettytable"<br />
|-<br />
! colspan="8" style=" background-color:#12b2e7; text-align:left;" | '''Artist Metadata'''<br />
|-<br />
| style=" width:150px; text-align:left;" | biography<br />
| style=" width:200px; text-align:left;" | birthday date and place<br />
| style=" width:200px; text-align:left;" | date and place died<br />
| style=" width:150px; text-align:left;" | disambiuation<br />
| style=" width:150px; text-align:left;" | discography<br />
| style=" width:150px; text-align:left;" | gender<br />
| style=" width:150px; text-align:left;" | genres<br />
| style=" width:150px; text-align:left;" | instruments<br />
|-<br />
| style=" width:200px; text-align:left;" | mbid's<br />
| style=" width:150px; text-align:left;" | moods<br />
| style=" width:150px; text-align:left;" | SortName<br />
| style=" width:150px; text-align:left;" | type<br />
| style=" width:200px; text-align:left;" | styles<br />
| style=" width:150px; text-align:left;" | years active<br />
| style=" width:150px; text-align:left;" | (band) formed <br />
| style=" width:150px; text-align:left;" | (band) disbanded <br />
|-<br />
! colspan="8" style=" background-color:#12b2e7; text-align:left;" | '''Artist Artwork'''<br />
|-<br />
| style=" width:150px; text-align:left;" | banner<br />
| style=" width:200px; text-align:left;" | clearart<br />
| style=" width:200px; text-align:left;" | clearlogo<br />
| style=" width:150px; text-align:left;" | fanart<br />
| style=" width:150px; text-align:left;" | fanart# (extrafanart)<br />
| style=" width:150px; text-align:left;" | folder (thumb)<br />
| style=" width:150px; text-align:left;" | landscape<br />
|}<br />
<br />
<br />
<br />
== Albums ==<br />
The below table details the '''additional''' information {{kodi}} scrapes into the library. This data cannot be scanned from tags.<br />
<br />
{|class="prettytable"<br />
|-<br />
! colspan="8" style=" background-color:#12b2e7; text-align:left;" | '''Album Metadata'''<br />
|-<br />
| style=" width:150px; text-align:left;" | moods<br />
| style=" width:150px; text-align:left;" | mbid's (artwork related)<br />
| style=" width:150px; text-align:left;" | musicbrainzreleasegroupid <br />
| style=" width:150px; text-align:left;" | rating<br />
| style=" width:150px; text-align:left;" | review<br />
| style=" width:150px; text-align:left;" | styles<br />
| style=" width:150px; text-align:left;" | theme<br />
| style=" width:150px; text-align:left;" | votes<br />
|-<br />
! colspan="8" style=" background-color:#12b2e7; text-align:left;" | '''Album Artwork'''<br />
|-<br />
| style=" width:150px; text-align:left;" | back<br />
| style=" width:150px; text-align:left;" | discart<br />
| style=" width:150px; text-align:left;" | fanart<br />
| style=" width:150px; text-align:left;" | folder (thumb)<br />
| style=" width:150px; text-align:left;" | spine<br />
|}<br />
<br />
<br />
== What is Overwritten ==<br />
Some information that has been scanned from music file tags can be overwritten with data derived from the scraping process. This can be useful if your tags are incomplete or outdated. It allows the library (not the music file tags) to be updated with current data.<br />
<br />
To allow this to occur, '''Enable''' the following setting. Leave it '''Disabled''' if you are happy with your music file tags.<br />
:'''''See: [[Settings/Media/Music#Prefer_online_information|Prefer Online Information]]'''''<br />
<br />
The two tables in the following link detail which entries can be overwritten for artists and albums.<br />
:'''''See: [[Music#Available_nfo_Tags|Available NFO Tags]]'''''<br />
<br />
<br />
<br />
= Scrapers =<br />
A number of scrapers are available to install, most catering to specific music genres.<br />
<br />
By default {{kodi}} uses the following scrapers<br />
*Artists- '''''[[Add-on:Universal_Artist_Scraper|Universal Artist Scraper]]'''''<br />
*Albums- '''''[[Add-on:Universal_Album_Scraper|Universal Album Scraper]]'''''<br />
<br />
These two scrapers will search MusicBrainz, last.fm, allmusic.com and amazon.de for metadata and fanart.tv, last.fm and allmusic.com for artwork. <br />
<br />
They are also the only two scrapers that currently download '''Extended Artwork'''.<br />
<br />
: '''''See also: List of [[:Category:Artist_scraper_add-ons| Artist Scrapers]]'''''<br />
<br />
: '''''See also: List of [[:Category:Album_scraper_add-ons| Album Scrapers]]'''''<br />
<br />
<br />
<br />
== Extended Artwork ==<br />
:{{main|Artwork}}<br />
<br />
New in v18 is the feature to scrape and cache extended artwork in the music (and video) library without the need for additional add-ons. This is still an experimental feature (to work out bugs). <ref>https://github.com/xbmc/xbmc/pull/13848</ref><br />
<br />
'''Basic''' Artwork consists of:<br />
*Artists- fanart, folder<br />
*Albums- folder<br />
<br />
'''Extended''' Artwork consists of:<br />
*Artists- banner, clearart, clearlogo, extra fanart, landscape<br />
*Albums- back, discart, spine<br />
<br />
<br />
To use this feature, there are two requirements as follows:<br />
<br />
;1. The following tags are required in the '''''[[advancedsettings.xml]]''''' file and {{kodi}} restarted before scraping extended artwork.<br />
<br />
<syntaxhighlight lang="xml" line='line'><br />
<advancedsettings><br />
<musiclibrary><br />
<artistextraart><br />
<arttype>banner</arttype><br />
<arttype>clearart</arttype><br />
<arttype>clearlogo</arttype><br />
<arttype>landscape</arttype><br />
<arttype>fanart1</arttype><br />
<arttype>fanart2</arttype><br />
<arttype>fanart3</arttype><br />
<arttype>fanart4</arttype><br />
</artistextraart><br />
<albumextraart><br />
<arttype>back</arttype><br />
<arttype>discart</arttype><br />
<arttype>spine</arttype><br />
</albumextraart><br />
</musiclibrary><br />
</advancedsettings><br />
</syntaxhighlight><br />
<br />
;2. Scraper Settings<br />
The default Universal Artist Scraper and Universal Album Scraper have been updated to scrape extended artwork. These settings are disabled by default and '''need to be enabled in the scraper settings''' pages.<br />
<br />
:'''''See: [[Add-on:Universal_Artist_Scraper|Universal Artist Scraper]]'''''<br><br />
:'''''See: [[Add-on:Universal_Album_Scraper|Universal Album Scraper]]'''''<br />
<br />
== Extra Fanart ==<br />
Extra Fanart was traditionally saved in the extrafanart folder. Additional fanart images were saved to this folder for use as a slideshow by a compatible skin, usually by utilising the Skin Helper Service add-on or the Artist Slideshow add-on. The downside to this method is the skin needs to read the extra fanart directly from the extrafanart folder. This requires hard drives to wake causing delays in the GUI while waiting for the drives to become accessible. Filenames are not important as the skin slideshow simply displayed any image file in the folder.<br />
<br />
v18 introduces caching of extra fanart, just like any other artwork in the library, and is also considered experimental. The advantages are quicker loading times and fewer wakings of hard disks. It is more difficult for skinners to implement this method.<br />
<br />
Only a few skins are currently supporting this method, but more skins will implement this in the future.<br />
<br />
There are three requirements to using this method...<br />
<br />
;1. Compatible Skin<br />
:Check with the skinner if this method is used by the skin.<br />
<br />
;2. advancedsettings.xml<br />
:Tags are required in the advancedsettings.xml file as shown in the previous section. <br />
<br />
;3. Saving Extra Fanart<br />
:The extra fanart must be saved alongside the other artwork (as shown in the image) with the following requirements:<br />
:*'''''fanart#''''' is Extra Fanart. As many or as few can be added, but there must be a corresponding whitelist entry in the advancedsettings.xml file as shown above.<br />
:*Do not zero pad the digits, ie use 1 not 01; use 12 not 012<br />
:*The Music Library does not support the use of the Extrafanart folder<br />
:*The Universal Artist Scraper does not download extra fanart. The extra fanart must be manually sourced and added to the Artist folder<br />
<br />
<gallery mode="packed" widths="500px" heights="283px"><br />
File:Artwork-FolderView01.jpg|Artist folder containing correctly named artwork<br />
</gallery><br />
<br />
= Performing the Scrape =<br />
The following two sections will guide you through the scrape process. Be aware that scraping Artist and Albums are two separate processes.<br />
<br />
<br />
== Artists ==<br />
<section begin="ScrapeArtists" /><gallery mode="packed" widths="500px" heights="283px"><br />
File:Estuary_home_music_files.png|Image 1<br />
File:Music-CategoryList.jpg|Image 2<br />
File:Music-ArtistContextMenu.jpg|Image 3<br />
</gallery><br />
<br />
To scrape additional information for Artists, follow these steps:<br />
<br />
#Select '''Music''' from the main menu (Image 1)<br />
#Select '''Artists''' from the category list (Image 2)<br />
#Highlight any Artist (Image 3)<br />
#Call up the '''[[Basic_controls#Context_Menu|Context Menu]]''' for the selected Artist (Image 3)<br />
#Select '''Query info for all artists''' (Image 3)<section end="ScrapeArtists" /><br />
<br />
Depending upon the size of your library, this process could take many hours. As an example, a library of around 900 artists required over three hours to complete the scrape. This is dependent on your internet connection and the load on the servers hosting the scraper database. It is best to perform the scrape overnight when {{kodi}} is not in use. <br />
<br />
Once complete, it should be run a second time to ensure "busy" responses were not received from the scraper site due to overloaded servers.<br />
<br />
<br />
== Albums ==<br />
<section begin="ScrapeAlbums" /><gallery mode="packed" widths="500px" heights="283px"><br />
File:Estuary_home_music_files.png|Image 1<br />
File:Music-CategoryList.jpg|Image 2<br />
File:Music-AlbumContextMenu.jpg|Image 3<br />
</gallery><br />
<br />
To scrape additional information for Albums, follow these steps:<br />
<br />
#Select '''Music''' from the main menu (Image 1)<br />
#Select '''Albums''' from the category list (Image 2)<br />
#Highlight any Album (Image 3)<br />
#Call up the '''[[Basic_controls#Context_Menu|Context Menu]]''' for the selected Album (Image 3)<br />
#Select '''Query info for all albums''' (Image 3) <section end="ScrapeAlbums" /><br />
<br />
Depending upon the size of your library, this process could take many hours. As an example, a library of around 300 albums required almost two hours to complete the scrape. This is dependent on your internet connection and the load on the servers hosting the scraper database. It is best to perform the scrape overnight when {{kodi}} is not in use. <br />
<br />
Once complete, the scrape should be run a second time to ensure "busy" responses were not received from the scraper site due to overloaded servers.<br />
<br />
<br />
<br />
= Unscraped Items =<br />
Unfortunately there are numerous<ref>https://en.wikipedia.org/wiki/List_of_online_music_databases</ref> <ref>https://yadg.cc/available-scrapers</ref> online music databases that contain artist and album information. Not all of them allow API access, and no one site is complete as every user has their preference of which site to update. Simply put, there is no IMDB or TheMovieDB equivelant for music, though ''discogs.com'' seems to be the largest of all the online databases.<br />
<br />
When browsing your library, it will become apparent that not all Artists or Albums had additional information scraped. When a scrape fails due to no data available your options are<br />
#Contribute back to the free sites used by the {{kodi}} scrapers and update missing and incorrect entries (preferred option)<br />
#Create [[NFO files]] which contain the additional information.<br />
<br />
If using the NFO files option, a quick guide is...<br />
<br />
#Create your [[Artist information folder]] without subfolders somewhere outside of your Music Source(s).<br />
#Set the [[Artist information folder]] in the '''''[[Settings/Media/Music#Artist_information_folder|Music Settings]]''''' page<br />
#Use the export option '''''[[Import-export_library/Music#Artist_folders_only|Artist Folders only]]''''' to create the artist subfolders<br />
#Locate artwork <br />
#*Artists- save it in the Artist's folder in the [[Artist information folder]], using the naming scheme displayed above<br />
#*Albums- save it in the Album folder containing the music files<br />
#Create [[NFO files]] and enter the additional data to be added to the library and<br />
#*Artists- save it in the Artist's folder in the [[Artist information folder]], named '''artist.nfo'''<br />
#*Albums- save it in the Album folder containing the music files and name it '''album.nfo'''<br />
#*See '''''[[NFO_files/Music|Music NFO files]]''''' for sample Artist and Album nfo files.<br />
#'''Refresh''' the new information into the library<br />
#*Artists... '''''[[Update_Music_Library#Refresh_Artist|Artist Refresh]]'''''<br />
#*Albums... '''''[[Update_Music_Library#Refresh_Album|Album Refresh]]'''''<br />
<br />
<br />
<br />
= End of Setup =<br />
'''Congratulations! You have reached the end of the second module of the Setup Guide.''' You should now have a fully functioning Music library full of information and artwork.<br />
<br />
The following steps in the guide will help you tweak and modify your library. There is no requirement for you to read on at this stage. Become comfortable with your new library. When you feel there is need for a change, come back to this guide and continue with the remaining modules. We do recommend you take care to backup your library.<br />
<br />
<br />
Display of scraped information using alternate skins:<br />
<gallery mode="packed" widths="500px" heights="283px"><br />
File:Music-AdditionalInfo03.jpg|Transparency!<br />
File:Music-AdditionalInfo01.jpg|Rapier<br />
File:Music-AdditionalInfo02.jpg|Aeon Nox<br />
File:Artwork-MusicBanner01.jpg|Aeon MQ7 mode<br />
File:Artwork-TS-clearart-AeonNox5modmaybe.jpg<br />
</gallery><br />
<br />
{{-}}<br />
<br />
<br />
<br />
----<br />
<center>{{red|'''The remainder of this page deals with special use cases or provides information for technical interest and reference only. It can be safely disregarded if these do not apply to you'''}}</center><br />
----<br />
<br />
<br />
<div style="{{linear-gradient|left|#f5d3ff, #12b2e7}}">{{next|[[Update_Music_Library|Update Music Library]]}} </div><br />
<br />
<br />
= Technical Details =<br />
'''Scraping of additional artist and album information does not happen when you run a library update (including when first adding a source) unless "Fetch additional info on update" is enabled.''' Currently this defaults to '''disabled'''. It is strongly recommended to keep this disabled for several reasons:<br />
*It allows you to perform the initial tag scan quickly. In v17 and below, when ''Fetch additional info on update'' is ''enabled'', the two steps happen immediately each album and artist is added. This slows down populating the library. It is a background task, but still gives the impression that it is taking a considerable time to populate the library. In reality it is slowed down by the online scraping, and not the local tag scanning. This will be changed in v18 where {{kodi}} will perform the initial tag scan then, once complete, will commence the online scrape.<br />
*The strategy of immediately scraping each album and artist as it is added can also have unwanted consequences. A common example involves compilation albums. Say for example you have both ''Fetch additional info on update'' and ''Show song and album artists'' as ''enabled'', and a folder called "Compilations" containing all your Various Artist compliation albums. As the processing takes place in alphabetical order, this folder gets processed ''before'' the albums of artists in folders beginning with a letter later in the alphabet. The additional information for the song artists from these compilation albums gets added to the library and scraped before the other albums by that artist had been scanned, and so any artist.nfo file is never found and applied.<br />
*Bad tagging makes a messy library and then the online scrape compounds errors and makes the library difficult to unscramble. It is far better for the user to perform the initial scan, find and fix the bad tags, then perform the on-line scrape knowing there will be no further errors.<br />
*Scraping online also often leaves many gaps on first pass, then the user has to manually ''query for all'' anyway, often several times, to fill these gaps. This was because lack of correct throttling, and general server overload has meant that online scraping often failed (seen in the log as ''503 server errors''). This is expected to be fixed for v18.<br />
<br />
<br />
<br />
= References =<br />
<references /><br />
<br />
<br />
<br />
<br />
{{Top}}<br />
<br />
<div style="{{linear-gradient|left|#f5d3ff, #12b2e7}}">{{next|[[Update_Music_Library|Update Music Library]]}} </div><br />
<br />
<br />
{{updated|18}}<br />
[[Category:FAQ]]<br />
[[Category:Index]]<br />
[[Category:Guides]]<br />
[[Category:Manual]]<br />
[[Category:Karellen]]<br />
[[Category:First time user]]<br />
[[Category:Music library]]<br />
[[Category:Advanced topics]]<br />
[[Category:Quick Start Guide]]</div>WhikiDudehttps://kodi.wiki/index.php?title=Scraping_Music&diff=165736Scraping Music2019-04-28T12:37:19Z<p>WhikiDude: /* Extended Artwork */</p>
<hr />
<div>{{MusicLibraryCreate}}<br />
{{mininav|[[Music library]]}}<br />
<br />
<br />
= Introduction =<br />
<section begin="intro"/>Music Scraping downloads additional information about the Artists and Albums in your library, as well as downloading any missing artwork. This step is optional, but if you choose to scrape, it must be performed after your music is Scanned into the library.<section end="intro"/><br />
<br />
The source of information for the scrape can be either:<br />
#An online source using one of the Kodi Scrapers<br />
#Local information from either '''''[[NFO files]]''''' or data in a '''''[[Import-export_library/Music|Single File]]''''' export. <br />
For this guide, it is assumed this is your first setup, so you will have no local files. The scraped data is being retrieved from an online source using the scrapers.<br />
<br />
v18 introduces a number of changes and improvements to scraping. The most prominent being the [[Artist information folder]]. Also new is the ability for {{kodi}} and the scrapers to download and cache Extended Artwork. These are covered below.<br />
<br />
<br />
= What is Scraped =<br />
If the information and artwork is available at the online site used by the active scrapers, the scraping process will download the additional data and artwork into your existing library. <br />
<br />
<br />
<br />
== Artists ==<br />
The below table details the '''additional''' information {{kodi}} scrapes into the library. This data cannot be scanned from tags.<br />
<br />
{|class="prettytable"<br />
|-<br />
! colspan="8" style=" background-color:#12b2e7; text-align:left;" | '''Artist Metadata'''<br />
|-<br />
| style=" width:150px; text-align:left;" | biography<br />
| style=" width:200px; text-align:left;" | birthday date and place<br />
| style=" width:200px; text-align:left;" | date and place died<br />
| style=" width:150px; text-align:left;" | disambiuation<br />
| style=" width:150px; text-align:left;" | discography<br />
| style=" width:150px; text-align:left;" | gender<br />
| style=" width:150px; text-align:left;" | genres<br />
| style=" width:150px; text-align:left;" | instruments<br />
|-<br />
| style=" width:200px; text-align:left;" | mbid's<br />
| style=" width:150px; text-align:left;" | moods<br />
| style=" width:150px; text-align:left;" | SortName<br />
| style=" width:150px; text-align:left;" | type<br />
| style=" width:200px; text-align:left;" | styles<br />
| style=" width:150px; text-align:left;" | years active<br />
| style=" width:150px; text-align:left;" | (band) formed <br />
| style=" width:150px; text-align:left;" | (band) disbanded <br />
|-<br />
! colspan="8" style=" background-color:#12b2e7; text-align:left;" | '''Artist Artwork'''<br />
|-<br />
| style=" width:150px; text-align:left;" | banner<br />
| style=" width:200px; text-align:left;" | clearart<br />
| style=" width:200px; text-align:left;" | clearlogo<br />
| style=" width:150px; text-align:left;" | fanart<br />
| style=" width:150px; text-align:left;" | fanart# (extrafanart)<br />
| style=" width:150px; text-align:left;" | folder (thumb)<br />
| style=" width:150px; text-align:left;" | landscape<br />
|}<br />
<br />
<br />
<br />
== Albums ==<br />
The below table details the '''additional''' information {{kodi}} scrapes into the library. This data cannot be scanned from tags.<br />
<br />
{|class="prettytable"<br />
|-<br />
! colspan="8" style=" background-color:#12b2e7; text-align:left;" | '''Album Metadata'''<br />
|-<br />
| style=" width:150px; text-align:left;" | moods<br />
| style=" width:150px; text-align:left;" | mbid's (artwork related)<br />
| style=" width:150px; text-align:left;" | musicbrainzreleasegroupid <br />
| style=" width:150px; text-align:left;" | rating<br />
| style=" width:150px; text-align:left;" | review<br />
| style=" width:150px; text-align:left;" | styles<br />
| style=" width:150px; text-align:left;" | theme<br />
| style=" width:150px; text-align:left;" | votes<br />
|-<br />
! colspan="8" style=" background-color:#12b2e7; text-align:left;" | '''Album Artwork'''<br />
|-<br />
| style=" width:150px; text-align:left;" | back<br />
| style=" width:150px; text-align:left;" | discart<br />
| style=" width:150px; text-align:left;" | fanart<br />
| style=" width:150px; text-align:left;" | folder (thumb)<br />
| style=" width:150px; text-align:left;" | spine<br />
|}<br />
<br />
<br />
== What is Overwritten ==<br />
Some information that has been scanned from music file tags can be overwritten with data derived from the scraping process. This can be useful if your tags are incomplete or outdated. It allows the library (not the music file tags) to be updated with current data.<br />
<br />
To allow this to occur, '''Enable''' the following setting. Leave it '''Disabled''' if you are happy with your music file tags.<br />
:'''''See: [[Settings/Media/Music#Prefer_online_information|Prefer Online Information]]'''''<br />
<br />
The two tables in the following link detail which entries can be overwritten for artists and albums.<br />
:'''''See: [[Music#Available_nfo_Tags|Available NFO Tags]]'''''<br />
<br />
<br />
<br />
= Scrapers =<br />
A number of scrapers are available to install, most catering to specific music genres.<br />
<br />
By default {{kodi}} uses the following scrapers<br />
*Artists- '''''[[Add-on:Universal_Artist_Scraper|Universal Artist Scraper]]'''''<br />
*Albums- '''''[[Add-on:Universal_Album_Scraper|Universal Album Scraper]]'''''<br />
<br />
These two scrapers will search MusicBrainz, last.fm, allmusic.com and amazon.de for metadata and fanart.tv, last.fm and allmusic.com for artwork. <br />
<br />
They are also the only two scrapers that currently downloads '''Extended Artwork'''.<br />
<br />
: '''''See also: List of [[:Category:Artist_scraper_add-ons| Artist Scrapers]]'''''<br />
<br />
: '''''See also: List of [[:Category:Album_scraper_add-ons| Album Scrapers]]'''''<br />
<br />
<br />
<br />
== Extended Artwork ==<br />
:{{main|Artwork}}<br />
<br />
New in v18 is the feature to scrape and cache extended artwork in the music (and video) library without the need for additional add-ons. This is still an experimental feature (to work out bugs). <ref>https://github.com/xbmc/xbmc/pull/13848</ref><br />
<br />
'''Basic''' Artwork consists of:<br />
*Artists- fanart, folder<br />
*Albums- folder<br />
<br />
'''Extended''' Artwork consists of:<br />
*Artists- banner, clearart, clearlogo, extra fanart, landscape<br />
*Albums- back, discart, spine<br />
<br />
<br />
To use this feature, there are two requirements as follows:<br />
<br />
;1. The following tags are required in the '''''[[advancedsettings.xml]]''''' file and {{kodi}} restarted before scraping extended artwork.<br />
<br />
<syntaxhighlight lang="xml" line='line'><br />
<advancedsettings><br />
<musiclibrary><br />
<artistextraart><br />
<arttype>banner</arttype><br />
<arttype>clearart</arttype><br />
<arttype>clearlogo</arttype><br />
<arttype>landscape</arttype><br />
<arttype>fanart1</arttype><br />
<arttype>fanart2</arttype><br />
<arttype>fanart3</arttype><br />
<arttype>fanart4</arttype><br />
</artistextraart><br />
<albumextraart><br />
<arttype>back</arttype><br />
<arttype>discart</arttype><br />
<arttype>spine</arttype><br />
</albumextraart><br />
</musiclibrary><br />
</advancedsettings><br />
</syntaxhighlight><br />
<br />
;2. Scraper Settings<br />
The default Universal Artist Scraper and Universal Album Scraper have been updated to scrape extended artwork. These settings are disabled by default and '''need to be enabled in the scraper settings''' pages.<br />
<br />
:'''''See: [[Add-on:Universal_Artist_Scraper|Universal Artist Scraper]]'''''<br><br />
:'''''See: [[Add-on:Universal_Album_Scraper|Universal Album Scraper]]'''''<br />
<br />
== Extra Fanart ==<br />
Extra Fanart was traditionally saved in the extrafanart folder. Additional fanart images were saved to this folder for use as a slideshow by a compatible skin, usually by utilising the Skin Helper Service add-on or the Artist Slideshow add-on. The downside to this method is the skin needs to read the extra fanart directly from the extrafanart folder. This requires hard drives to wake causing delays in the GUI while waiting for the drives to become accessible. Filenames are not important as the skin slideshow simply displayed any image file in the folder.<br />
<br />
v18 introduces caching of extra fanart, just like any other artwork in the library, and is also considered experimental. The advantages are quicker loading times and fewer wakings of hard disks. It is more difficult for skinners to implement this method.<br />
<br />
Only a few skins are currently supporting this method, but more skins will implement this in the future.<br />
<br />
There are three requirements to using this method...<br />
<br />
;1. Compatible Skin<br />
:Check with the skinner if this method is used by the skin.<br />
<br />
;2. advancedsettings.xml<br />
:Tags are required in the advancedsettings.xml file as shown in the previous section. <br />
<br />
;3. Saving Extra Fanart<br />
:The extra fanart must be saved alongside the other artwork (as shown in the image) with the following requirements:<br />
:*'''''fanart#''''' is Extra Fanart. As many or as few can be added, but there must be a corresponding whitelist entry in the advancedsettings.xml file as shown above.<br />
:*Do not zero pad the digits, ie use 1 not 01; use 12 not 012<br />
:*The Music Library does not support the use of the Extrafanart folder<br />
:*The Universal Artist Scraper does not download extra fanart. The extra fanart must be manually sourced and added to the Artist folder<br />
<br />
<gallery mode="packed" widths="500px" heights="283px"><br />
File:Artwork-FolderView01.jpg|Artist folder containing correctly named artwork<br />
</gallery><br />
<br />
<br />
= Performing the Scrape =<br />
The following two sections will guide you through the scrape process. Be aware that scraping Artist and Albums are two separate processes.<br />
<br />
<br />
== Artists ==<br />
<section begin="ScrapeArtists" /><gallery mode="packed" widths="500px" heights="283px"><br />
File:Estuary_home_music_files.png|Image 1<br />
File:Music-CategoryList.jpg|Image 2<br />
File:Music-ArtistContextMenu.jpg|Image 3<br />
</gallery><br />
<br />
To scrape additional information for Artists, follow these steps:<br />
<br />
#Select '''Music''' from the main menu (Image 1)<br />
#Select '''Artists''' from the category list (Image 2)<br />
#Highlight any Artist (Image 3)<br />
#Call up the '''[[Basic_controls#Context_Menu|Context Menu]]''' for the selected Artist (Image 3)<br />
#Select '''Query info for all artists''' (Image 3)<section end="ScrapeArtists" /><br />
<br />
Depending upon the size of your library, this process could take many hours. As an example, a library of around 900 artists required over three hours to complete the scrape. This is dependent on your internet connection and the load on the servers hosting the scraper database. It is best to perform the scrape overnight when {{kodi}} is not in use. <br />
<br />
Once complete, it should be run a second time to ensure "busy" responses were not received from the scraper site due to overloaded servers.<br />
<br />
<br />
== Albums ==<br />
<section begin="ScrapeAlbums" /><gallery mode="packed" widths="500px" heights="283px"><br />
File:Estuary_home_music_files.png|Image 1<br />
File:Music-CategoryList.jpg|Image 2<br />
File:Music-AlbumContextMenu.jpg|Image 3<br />
</gallery><br />
<br />
To scrape additional information for Albums, follow these steps:<br />
<br />
#Select '''Music''' from the main menu (Image 1)<br />
#Select '''Albums''' from the category list (Image 2)<br />
#Highlight any Album (Image 3)<br />
#Call up the '''[[Basic_controls#Context_Menu|Context Menu]]''' for the selected Album (Image 3)<br />
#Select '''Query info for all albums''' (Image 3) <section end="ScrapeAlbums" /><br />
<br />
Depending upon the size of your library, this process could take many hours. As an example, a library of around 300 albums required almost two hours to complete the scrape. This is dependent on your internet connection and the load on the servers hosting the scraper database. It is best to perform the scrape overnight when {{kodi}} is not in use. <br />
<br />
Once complete, the scrape should be run a second time to ensure "busy" responses were not received from the scraper site due to overloaded servers.<br />
<br />
<br />
<br />
= Unscraped Items =<br />
Unfortunately there are numerous<ref>https://en.wikipedia.org/wiki/List_of_online_music_databases</ref> <ref>https://yadg.cc/available-scrapers</ref> online music databases that contain artist and album information. Not all of them allow API access, and no one site is complete as every user has their preference of which site to update. Simply put, there is no IMDB or TheMovieDB equivelant for music, though ''discogs.com'' seems to be the largest of all the online databases.<br />
<br />
When browsing your library, it will become apparent that not all Artists or Albums had additional information scraped. When a scrape fails due to no data available your options are<br />
#Contribute back to the free sites used by the {{kodi}} scrapers and update missing and incorrect entries (preferred option)<br />
#Create [[NFO files]] which contain the additional information.<br />
<br />
If using the NFO files option, a quick guide is...<br />
<br />
#Create your [[Artist information folder]] without subfolders somewhere outside of your Music Source(s).<br />
#Set the [[Artist information folder]] in the '''''[[Settings/Media/Music#Artist_information_folder|Music Settings]]''''' page<br />
#Use the export option '''''[[Import-export_library/Music#Artist_folders_only|Artist Folders only]]''''' to create the artist subfolders<br />
#Locate artwork <br />
#*Artists- save it in the Artist's folder in the [[Artist information folder]], using the naming scheme displayed above<br />
#*Albums- save it in the Album folder containing the music files<br />
#Create [[NFO files]] and enter the additional data to be added to the library and<br />
#*Artists- save it in the Artist's folder in the [[Artist information folder]], named '''artist.nfo'''<br />
#*Albums- save it in the Album folder containing the music files and name it '''album.nfo'''<br />
#*See '''''[[NFO_files/Music|Music NFO files]]''''' for sample Artist and Album nfo files.<br />
#'''Refresh''' the new information into the library<br />
#*Artists... '''''[[Update_Music_Library#Refresh_Artist|Artist Refresh]]'''''<br />
#*Albums... '''''[[Update_Music_Library#Refresh_Album|Album Refresh]]'''''<br />
<br />
<br />
<br />
= End of Setup =<br />
'''Congratulations! You have reached the end of the second module of the Setup Guide.''' You should now have a fully functioning Music library full of information and artwork.<br />
<br />
The following steps in the guide will help you tweak and modify your library. There is no requirement for you to read on at this stage. Become comfortable with your new library. When you feel there is need for a change, come back to this guide and continue with the remaining modules. We do recommend you take care to backup your library.<br />
<br />
<br />
Display of scraped information using alternate skins:<br />
<gallery mode="packed" widths="500px" heights="283px"><br />
File:Music-AdditionalInfo03.jpg|Transparency!<br />
File:Music-AdditionalInfo01.jpg|Rapier<br />
File:Music-AdditionalInfo02.jpg|Aeon Nox<br />
File:Artwork-MusicBanner01.jpg|Aeon MQ7 mode<br />
File:Artwork-TS-clearart-AeonNox5modmaybe.jpg<br />
</gallery><br />
<br />
{{-}}<br />
<br />
<br />
<br />
----<br />
<center>{{red|'''The remainder of this page deals with special use cases or provides information for technical interest and reference only. It can be safely disregarded if these do not apply to you'''}}</center><br />
----<br />
<br />
<br />
<div style="{{linear-gradient|left|#f5d3ff, #12b2e7}}">{{next|[[Update_Music_Library|Update Music Library]]}} </div><br />
<br />
<br />
= Technical Details =<br />
'''Scraping of additional artist and album information does not happen when you run a library update (including when first adding a source) unless "Fetch additional info on update" is enabled.''' Currently this defaults to '''disabled'''. It is strongly recommended to keep this disabled for several reasons:<br />
*It allows you to perform the initial tag scan quickly. In v17 and below, when ''Fetch additional info on update'' is ''enabled'', the two steps happen immediately each album and artist is added. This slows down populating the library. It is a background task, but still gives the impression that it is taking a considerable time to populate the library. In reality it is slowed down by the online scraping, and not the local tag scanning. This will be changed in v18 where {{kodi}} will perform the initial tag scan then, once complete, will commence the online scrape.<br />
*The strategy of immediately scraping each album and artist as it is added can also have unwanted consequences. A common example involves compilation albums. Say for example you have both ''Fetch additional info on update'' and ''Show song and album artists'' as ''enabled'', and a folder called "Compilations" containing all your Various Artist compliation albums. As the processing takes place in alphabetical order, this folder gets processed ''before'' the albums of artists in folders beginning with a letter later in the alphabet. The additional information for the song artists from these compilation albums gets added to the library and scraped before the other albums by that artist had been scanned, and so any artist.nfo file is never found and applied.<br />
*Bad tagging makes a messy library and then the online scrape compounds errors and makes the library difficult to unscramble. It is far better for the user to perform the initial scan, find and fix the bad tags, then perform the on-line scrape knowing there will be no further errors.<br />
*Scraping online also often leaves many gaps on first pass, then the user has to manually ''query for all'' anyway, often several times, to fill these gaps. This was because lack of correct throttling, and general server overload has meant that online scraping often failed (seen in the log as ''503 server errors''). This is expected to be fixed for v18.<br />
<br />
<br />
<br />
= References =<br />
<references /><br />
<br />
<br />
<br />
<br />
{{Top}}<br />
<br />
<div style="{{linear-gradient|left|#f5d3ff, #12b2e7}}">{{next|[[Update_Music_Library|Update Music Library]]}} </div><br />
<br />
<br />
{{updated|18}}<br />
[[Category:FAQ]]<br />
[[Category:Index]]<br />
[[Category:Guides]]<br />
[[Category:Manual]]<br />
[[Category:Karellen]]<br />
[[Category:First time user]]<br />
[[Category:Music library]]<br />
[[Category:Advanced topics]]<br />
[[Category:Quick Start Guide]]</div>WhikiDude