# Jukebox Features

- LoopMode
- PlayStimulator
- RadioMode

(Editor's note: All jukebox features are named with BiCapitalization rather than using separate words. This is not for trendy marketing reasons; it simply allows the documentation builder to index the features properly.)

PlayStimulator

In a commercial jukebox, a play stimulator is a feature that automatically plays a song after a certain period of inactivity; the theory is that it essentially reminds patrons that the jukebox is there which encourages people to use it.

DWJukebox has an optional PlayStimulator mode that simulates this function. The PlayStimulator can be enabled in JUKEBOX.INI or toggled on and off via BTN_PLAYSTIMULATOR. When the PlayStimulator is enabled, a random song will play after the selected period of inactivity.

To enable the PlayStimulator via JUKEBOX.INI, set the number of seconds the jukebox is to be idle before the PlayStimulator kicks in by adding or changing the PlayStimulatorDelay setting in JUKEBOX.INI in the [Settings] section:

>     [Settings]
>     PlayStimulatorDelay = 180

This would set the PlayStimulator to 180 seconds, or three minutes. Setting this value to 1 will cause the jukebox to play constantly as if it were in Radio Mode. Setting this value to 0 disables the Play Stimulator.

To avoid repetition, the PlayStimulator (and all other functions that randomly select songs) remembers the last 20 songs played and will avoid playing them again. However, this feature is disabled if the jukebox contains less than 40 songs. Songs higher on the Most Popular list will be selected for random play more often.

RadioMode
RadioMode is similar to the PlayStimulator, except it selects a new random song as soon as the queue is empty. Although RadioMode is essentially a PlayStimulator with a one-second delay, it is a separate function to allow both modes to be toggled independently.

To enable RadioMode via JUKEBOX.INI, set the RadioMode setting in JUKEBOX.INI in the [Settings] section to Enabled.

>     [Settings]
>     RadioMode = Enabled

RadioMode can also be toggled on and off via BTN_RADIO.

> See also: BTN_RADIO, MSG_RADIO.

LoopMode

In LoopMode, when a song finishes playing it is immediately re-added to the end of the queue. Songs removed with MSG_SKIP are not looped. Songs added to the queue through this method do not consume a credit, but they do increase the play count. LoopMode is useful at parties or holiday occasions to keep a particular set of songs on continuous play.

LoopMode is usually enabled or disabled via BTN_LOOP. It can also be enabled via the LoopMode setting in the [Settings] section of JUKEBOX.INI

> See also: BTN_LOOP, MSG_LOOP.

## Song sorting options

There are three options for sorting the songs: Artist (the default), which sorts the labels by artist; Album, which sorts the labels by album; and Random, which randomly scrambles the titlestrips as they would normally appear on a real jukebox.

To set the song sort, add the SongSort parameter to the [Settings] section of JUKEBOX.INI as follows:

[Settings] SongSort = Random

- or -

SongSort = Artist

- or -

SongSort = Album

Note that Album sort only applies to album-based (CD-type) skins. If Album is selected for a classic-style skin, it will be treated as Artist.

Back to contents