# [Index] Section (JUKEBOX.INI)

- CoverArt — Sets the file masks used to search for cover art.
- DefaultAlbum — Sets the text to be used when no album name can be determined.
- DefaultArtist — Sets the text to be used when no artist name can be determined.
- FilenameCrop — Sets whether to attempt to crop track extraneous info from song names.
- MaxFolderDepth — Sets how deep to scan into the folder structure for songs
- OrphanControl — Sets how albums are split when there are too many tracks
- RunawayLimiter — Adjusts runaway limiter check for large databases
- SmartCrop — Deprecated; see FilenameCrop instead.
- SongPath — Sets the folder(s) in which to look for music.
- StrictAlbum — Lists album names that may be used by more than one artist.
- UpdateIndex — Sets whether to scan the index on startup.
- UseID3 — Sets whether to use ID3 information for song indexing.

The Index section sets parameters and preferences related to the indexing of song files.

[Index] CoverArt
CoverArt defines the order in which files are searched for cover art. Cover art is only used for CD skins at this time. The cover art found in the folder for the first song in an album is used.

Multiple CoverArt paths can be set, so they are specified as CoverArt1, CoverArt2, etc. Here, for example, are the CoverArt settings in the default JUKEBOX.INI:

>     CoverArt1 = folder.jpg
>     CoverArt2 = AlbumArt_{????????-????-????-????-????????????}_Large.jpg
>     CoverArt3 = *.jpg

Default value: None

[Index] DefaultAlbum
DefaultAlbum is the text to be used when no album name can be determined.

Default value: Singles

[Index] DefaultArtist
DefaultArtist is the text to be used when no artist name can be determined.

Default value: Various Artists

[Index] FilenameCrop
FilenameCrop indicates whether or not to crop track, album and/or artist artist information from filenames. This only applies when ID3 information is unavailable or disabled. If FilenameCrop is set to a value of 2 or higher, that number of characters is always cropped from the beginning of a filename. If FilenameCrop is set to 1 or Numeric, any numbers and the space following them are dropped from the filename. If FilenameCrop is set to Smart, any information in the filename up to the last "- " (hyphen followed by a space) is assumed to be album and artist information and is dropped from the title.

NOTE: Only the Smart and Disabled modes are currently available; Numeric is not yet implemented.

Default value: Smart

> See also: UseID3.

[Index] MaxFolderDepth
Sets how deep to scan into the folder structure for songs, from 1 to 32 levels deep. MaxFolderDepth sets how deep in the folder structure to look for music. This will help prevent runaway indexing if unexpected removable media is found on a song path.

Default value: 3

[Index] RunawayLimiter
RunawayLimiter is used in case a corrupted database gets "stuck" reading a song; unfortunately in rare circumstances a large song database can trigger a runaway limit. This value can be set up to 10000; larger runaway limiters will result in longer delays before exit if a runaway condition is reached. You should not need to change this value unless directed to by technical support.

Default value: 30

[Index] OrphanControl
When a CD has more tracks than can fit on one title card, the remaining tracks are split onto a different album. If the last album of the set has fewer than 25% of the possible tracks for one album, OrphanControl decides how to handle these "orphaned" tracks. If OrphanControl is enabled, some of the tracks from the previous album are moved to the last album, making them both relatively even. If OrphanControl is disabled, the orphaned tracks are left alone.

Default value: Enabled

[Index] SmartCrop
SmartCrop has been replaced by FilenameCrop; it is still supported for backward compatibility.

Default value: Value of FilenameCrop

> See also: FilenameCrop.

[Index] SongPath
SongPath sets the folder(s) in which to look for music. By default, subdirectories under the current folder are searched; to search a different folder, set SongPath to the folder to search. Additional folders may be specified as SongPath1, SongPath2, etc. You may specify the root folder of removable media; songs on that media will only be used when the media is in the drive.

Example:

>     SongPath1 = C:\Documents and Settings\All Users\My Documents\My Music
>     SongPath2 = D:\
>     SongPath3 = C:\Music\Ogg

Default value: The jukebox program directory and below.

> See also: MaxFolderDepth.

[Index] StrictAlbum
StrictAlbum defines which album titles must have their songs in the same folder to count as belonging the same album. This is necessary for common album names like "Greatest Hits". If any StrictAlbum is set to * (asterisk), all albums will be treated as Strict. Multiple StrictAlbum settings can be specified as StrictAlbum1, StrictAlbum2, etc.

Example:

>     StrictAlbum1 = Greatest Hits
>     StrictAlbum2 = Original Motion Picture Soundtrack

Default value: None

[Index] UpdateIndex
UpdateIndex indicates whether to rescan the index every time the jukebox is started or to use the last index created by the jukebox. If UpdateIndex is set to True, the jukebox will go through every song file to make sure it exists and will add new files to the database and/or update existing files. This can take a long time if there are a large number of files; it's best used when a music collection changes often or if some of the song paths are on removable or network paths. If UpdateIndex is set to False, the jukebox will load the last index it created; this is much faster, but could result in errors if a selected song is not found.

If the index file does not exist, the jukebox will ignore this setting and update the index.

Default value: True

[Index] UseID3
UseID3 indicates whether to use ID3 for MP3 song identification, or OGG tags for OGG files. If UseID3 is set to False, it will assume the filename is the name of the song and set the artist and album based on the folder structure. Since DOS does not use long filenames, if ID3 support is disabled the database should be created on a Windows system.

Default value: True

> See also: FilenameCrop.

Back to contents