# Setup and Configuration

- Control — Contains control map definitions.
- JUKEBOX — Contains program preferences.
- Skin — Defines the look and control scheme of the jukebox.

The jukebox has no configuration options available through the program itself; all configuration is carried out through text-based configuration files.

## First Time Setup:

In order to get up and running quickly, please edit the jukebox.ini file in a text editor like Windows Notepad or DOS Edit and set the SongPath to point to your music collection. You may set multiple song paths, so if you have more than one folder of music, set SongPath1, SongPath2, etc. Please note that if one of your SongPaths is in a subfolder of another SongPath, songs will get indexed twice and updates may not be stored properly. This will be enough to get the jukebox running with the default skin and contols.

The first time the jukebox is run, it will index all of the song files. For large collections, this step can be time-consuming, as each song must be completely loaded into memory to be searched for identification information. This information is saved in a song database, so on subsequent runs, the jukebox only needs to verify the existence of the file. This verification step allows you to use removable media; songs will only be displayed on the jukebox if they exist when the jukebox is started.

## Configuration Files

The configuration files used by DWJukebox are plain text files. They are organized similar to Windows INI files; they contain a number of parameters divided into sections, with the section names starting in square braces. Lines that start with the # character (pound, octothorpe, number sign, whatever you want to call it) are comments and are not read by the jukebox. For example, here is a section with two parameters:

>     [Settings]
>     # This section contains jukebox settings.

>     RadioMode = Disabled
>     MaxQueueSize = 250

Three configuration files are used to determine the operation of the jukebox:

JUKEBOX.INI
This file contains all settings related to operation of the program itself, and general user preferences. Anything related to the physical PC, such as resolution or refresh rate, or jukebox operator settings, such as whether or not to require credits, are set in this file. You can specify a different configuration file on the command line when starting the jukebox; for example, starting the jukebox with WINCAB.EXE MYPREFS.INI will use MYPREFS.INI instead of JUKEBOX.INI.

Control Map File
The control map file assigns jukebox functions to individual keys, joystick or gamepad buttons and axes, or mouse buttons. The default control map file is CONTROLS.INI; however, a different file can be selected via the Controls parameter in JUKEBOX.INI.

Skin File
The skin file defines the look of the jukebox and the scheme by which songs are selected. All interactive elements of the interface can be defined here. The skin file is set via the Skin parameter in JUKEBOX.INI; the default is DEFAULT.SKN. Although the skin files included have a .SKN extension, they are still effectively INI files and can be edited with any text editor.

Back to contents