View source for Settings/Media/Music

{{MusicLibraryCreate}}
{{bigger|This category contains the settings for how information for music is collected, stored, shown and navigated.}}
__TOC__



== Creating Your Music Library ==
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.



== All ==
[[File:Settings_media_music_all.JPG|500px]]
{|
These settings apply to both File View mode and when viewing the music library.
|}
=== Track naming template ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Basic
|- valign="top"
| '''Description:'''
| 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 in File View mode, this requires tag reading to be enabled. The default setting is [%N.]%A-%T
<section begin="Track naming template" />
{| class="prettytable" 
|-
! scope="row"| Music Data
|  TrackNumber ||  DiscNumber ||  Artist ||  Title ||  Album ||  Genre ||  Year ||  FileName ||  Duration ||  Date ||  Rating ||  File Size ||  User Rating
|-
! scope="row"| Mask Characters
| style="text-align:center;" |  %N 
| style="text-align:center;" |  %S
| style="text-align:center;" |  %A
| style="text-align:center;" |  %T
| style="text-align:center;" |  %B
| style="text-align:center;" |  %G
| style="text-align:center;" |  %Y
| style="text-align:center;" |  %F
| style="text-align:center;" |  %D
| style="text-align:center;" |  %J
| style="text-align:center;" |  %R
| style="text-align:center;" |  %I
| style="text-align:center;" |  %r
|}
'''Note:''' The above table details the commonly used masks for the music library.
A full list can be found in the Master branch [https://github.com/xbmc/xbmc/blob/master/xbmc/utils/LabelFormatter.cpp#L66 here]. This Master list is a combined video and music library listing for the current Master branch which may be a newer Kodi version to the one you have installed.
<section end="Track naming template" />
{| class="prettytable" 
!colspan="2" style="width:150px; text-align:left" | Format Characters
!style="width:10px; text-align:left;" |
!colspan="2" style="text-align:left"| Usage Example
|-
! scope="row"| Bold 
|  [[B]...[/B]] || 
| style="background-color:#d3d3d3;" | Raw tag 
| [%N] [[I]%A[/I]] - %B : [[B]%T[/B]]
|-
! scope="row"| Italic
|  [[I]...[/I]] || 
| style="background-color:#d3d3d3;" | Output 
| [track nr.] ''artist'' - album : '''title'''
|}
|}


=== Search for thumbs on remote shares ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Advanced
|- valign="top"
| '''Description:'''
| 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
|}


== Files ==
[[File:Settings_media_music_files.JPG|500px]]
{|
These settings apply to File View mode only.
|}

=== Enable tag reading ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Standard
|- valign="top"
| '''Description:'''
| When viewing music files in File View read the embedded tag information (for those files that have not already been scanned into the library). When enabled File View will be able to display the song name along with other details rather than just the file name. However reading tags from every music file in real time can make viewing them slow, especially for folders with a lot of music files or when accessed over a network. It is recommended that you can “Scan” your songs into the library by following the guide. Among many advantages this will allow File View to show additional song details without having to re-read tags everytime. The default setting is Enabled.
|}
{{-}}


<section begin="Settings Media Music Library" />
== Library ==
[[File:SettingsMediaMusic-leia2.jpg|500px]]


=== Show "All items" entry ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Advanced
|- valign="top"
| '''Description:'''
| Show an "All items" entry on the music library screens, e. g. "All albums" or "All artists". The default setting is Enabled.
|}


=== Show song and album artists ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Basic
|- valign="top"
| '''Description:'''
| When enabled both song and album artists are shown. When disabled only album artists are shown,  artists that appear only on songs on compliation albums or as guest artist on an album by another artist are excluded. This effects what artists are shown when browsing the default artists node. Use is a personal choice. The default setting is Enabled.
|}


=== Use artist sortname when sorting by artist ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Standard
|- valign="top"
| '''Description:'''
| When Enabled, this setting will change the order Artists are listed in from using the name to using the sortname (if one has been provided in tagging). So for example ''Taylor Swift'' with a sort name of ''Swift, Taylor'' will be see in the ''S'' not the ''T''.
|}


=== Prefer online information ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Standard
|- valign="top"
| '''Description:'''
| With this enabled some artist and album data in the library, which had 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 themselves in any way, 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.
|}


=== Fetch additional information during updates ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Advanced
|- valign="top"
| '''Description:'''
| With this enabled album and artist information will be automatically fetched, via scrapers from remote sites or NFO files, as a final phase of library scanning. This can be a slow process if you have a large music collection. If this is the initial creation of your library, and you are unsure about the quality of your music file tagging, leave this setting disabled (rather than try to fetch extra data). The additional information can be fetched later from the Context Menu in the Artists and Albums listing. The default setting is Disabled.
|}


=== Artist information folder ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Standard
|- valign="top"
| '''Description:'''
| Select the folder where artist nfo files and local artwork are located. 
|-
| '''See Also:'''
| '''''[[Artist information folder]]'''''
|}


=== Prefer online album art ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Standard
|- valign="top"
| '''Description:'''
| With this enabled, when no local album cover exists online art will be used. Any cover images embedded in music files will only be used where neither local art nor online art is available. This is useful if the covers embedded in music files are low resolution and the user would prefer the higher quality results fetched by the album information provider. The default setting is Disabled.
|-
| '''See Also:'''
| '''''[[Music artwork#Library_Artwork_Source_Priority| Library Artwork Source Priority]]'''''
|}


=== Default provider for album information ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Standard
|- valign="top"
| '''Description:'''
| Selects the default album information provider, see the add-ons manager for options. The default setting is the Universal Album Scraper.
|}

=== Default provider for artist information ===
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}} 
| Standard
|- valign="top"
| '''Description:'''
| Selects the default artist information provider. The default setting is the Universal Artist Scraper
|}
<section end="Settings Media Music Library" />


{{Top}}

{{updated|18}}
[[Category:FAQ]]
[[Category:Index]]
[[Category:Guides]]
[[Category:Manual]]
[[Category:Karellen]]
[[Category:First time user]]
[[Category:Music library]]
[[Category:Advanced topics]]
[[Category:Quick Start Guide]]