Media Scanning

Jukebox Jockey is designed to import a list of media into it's database, so that it can display your media in its Views.

Adding Folders

1. Go to Settings>Media>Media Folder Configuration
   1. If prompted for a password, enter the administrator password (default is "a").
2. Choose a Collection from the drop down list on top.
3. Choose "Add Folder" and select a folder containing media.
4. Add the root folder of the music folder you wish to scan. (JJ will automatically recourse sub-directories)
5. Choose "Scan All".

Tag Readers

Some media files contain tags. Jukebox Jockey's plugin system has tag readers for the following file formats.

• ID3v1 & ID3v2 (mp3,mp2,mp1)
• WMA (wma, wmv)
• DSHow (mpg,mpeg,avi,asf,wmv,m2v,mkv)
• OGG (OGG Vorbis Audio Files)
• WAV (wav)
• iTunes Format (m4a,m4p,mp4,m4v)
• CDG Zip

File Masks

Some media files do not contain tags. Jukebox Jockey can identify the files based on their file location and file name.

To view or edit the file masks for a collection

1. Go to Settings>Media>Media Folder Configuration>
2. Choose a collection from the drop down box at the top of the page.
3. Select the tab labeled "File Masks".

In the following filepath example, Jukebox Jockey can determine the Artist, Album, Track Number, Title, and extension of the file.

    M:/Music/Beatles/The White Album/ 4 - Ob-La-Di, Ob-La-Da.mp3 

The file mask would look something like this.

    {ARTIST}/{ALBUM}/{TRACKNUMBER} - {TITLE}.{EXTENSION}

Database Mapping

Additional metadata stored in a .csv file can be imported (Jukebox Jockey Media Player Platinum Only). A field obtained by the tag readers or the file masks can be compared to a column in a csv file. The matching data will be written into Jukebox Jockey's database.

To setup database matching

1. Create a database containing the metadata you wish to import.
   1. Organize it with each column referring to an attribute about the file. One column must be dedicated to a unique identifier.
2. Create a text document with the name idef_Location_Matching.txt and put it into Jukebox Jockey/Jukebox Jockey Media Player [Edition]/Plugins/ImportDefinitions
3. Copy and Paste the following import definition to the file.
4. Be sure to specify the SourceMatchField with your unique identifier and define your MediaMappings.
5. Scan your folder of media as you normally would. Ensure that either the Tag Readers or the File Masks pickup your unique identifier and put it in the right field.
6. As a process during the scan, your media mappings will be written with the contents of your csv file.

;This import definition will import a database of information based on a match rule of "Location". 

[Settings]
Name=Location Based Matching Import
DisplayName=Location Import
Type=Metadata
aMatchRule=LOCATION=Data('LOCATION')
SourceMatchField=LOCATION
DestMatchField=LOCATION

[AddRules]
Rule0=LOCATION<>''

[SkipRules]

[Tables]

[Views]

[MediaMappings]
ARTIST=ARTIST
TITLE=TITLE
GENRE=GENRE

;Enter additional variables above to import additional metadata fields.