How to Use BallroomDJ

(Updated 2017-10; BallroomDJ version 3.15.5)

These articles explain the controls and features included in BallroomDJ. Some articles are from the point of view of a control found in BallroomDJ, some by subject and some by features in BallroomDJ.

Optional configurations each have their own articles and are not covered in the main articles. Any user interface changes for the optional configurations are outlined in the documentation for the option.

Brief Overviews of BallroomDJ

(With links to relevant wiki articles)
Main Menu
Configuration Menu
Update Database
Music Player
Music Manager
Song Editor
Song List Editor


(Descriptions of all the configuration options with links to pertinent wiki articles. These articles go through each control one by one.)
Audio Files
User Interface
Web Server
Song Server
Special Keys
Edit Dances
Edit Genres
Edit Ratings
Edit Levels

Update Database

Update Database

Song List Editor

Edit Song Lists
Song List Editor Menus
Exporting a Song List
Importing a M3U as a Song List

Sequence Editor

Edit Sequences

Music Player

Adding a Requested Song
Adding a Request from an External Source
The Music Queue
Player Controls
The Player Menus
Dual Queues

Music Manager and Editor

Searching for Songs in the Music Manager
Listing Songs that will be Played for a Playlist
Modifying Songs in the Music Manager
Editing Songs with the Music Manager
Adjusting the Audio Files
Changing the Display Columns
Playback Mode


Playlist Queue
Playlist Management
Manual Playlists
Sequenced Playlists
Automatic Playlists

Playlist Controls

Stopping a playlist after a period of time
Stopping a playlist after it plays a number of songs
Set the Maximum Play Time for a playlist
Set the Gap Between Songs for a playlist
Set the Marquee Message for a playlist
Set the playlist to pause after each song

Advanced Playlist Management and Use

Multiple playlists can be queued in BallroomDJ. When one playlist finishes, the next will be started. Using multiple playlists adds flexibility to the music mix. Be sure that the earlier playlists have a stop condition: stop after playing a certain number of songs, stop after a period of time, or a song list with a limited number of songs.

Example 1: Flexibility with Multiple Playlists
Example 2: Adding a Mixer to a Manual Playlist
Example 3: Adding a Mixer the Easy Way

By Subject

Adjusting Song Playback
Adjusting Song Start and Song End
Speed Adjustments
Volume Adjustments
Changing the Location of the Music Folder
Changing the Name of a Dance
Making a Backup of the BallroomDJ Files
File Manager
Moving BallroomDJ to Another Computer
Restoring a Backup
Song Server
Automatic Playlists
Dance Ratings
Same Song Marks
Profile Specifics
Exporting Audio Files to Burn to a CD
Exporting for BallroomDJ
Raffle Games
Importing from BallroomDJ
Modifying Audio Files
Applying Adjustments to the Song
Audio File Tags
Audio Identification
Normalizing Volume
Special Character Handling
Trimming Silence From a Song
Player Control
Gap Between Songs
Restarting the Player After a Crash or Exit
Startup Files
Web Server
Automatic Playlists
Creating a Song List from a Playlist
Manual Playlists
Maximum Play Time
Sequenced Playlists
Stopping a Playlist
Adding New Songs to BallroomDJ
Quick Save
User Interface
Changing the Display Columns


Initializing the Synchronization Process
Synchronizing Between Two Computers
Synchronizing Missing Audio Files

iTunes Import

iTunes Import - Setup
iTunes Import - Database Functions
iTunes Import - Music Manager
iTunes Import - Song Editor
iTunes Import - Importing a Playlist

Optional Configurations

Quick Play
Keeping Audio Files Organized
Configuring and Using BPM (Beats per Minute)
Tracking Song Status
Displaying Images During Playback
Playing Announcements Before a Dance
Editing as an Album

Use Cases

Need to find a way to set up BallroomDJ for your unique situation? Take a look at some of the different ways to set up BallroomDJ here.

Linedances - Grouping Different Dances Together / Marquee Display
Google Drive - Using BallroomDJ with a Synchronized Folder

Setting up a Ramdisk

If your computer's disk drive is slow or you have other programs running such as an anti-virus program or windows search indexing, a ramdisk may help prevent stuttering and pauses during playback.

Configuring a Ramdisk for Linux
Configuring a Ramdisk for Windows

Remote Controls

Configuring a Remote Control for Linux
Configuring a Remote Control for Windows

Command Line Utilities

Command Line Utilities
Command Line Utilities for Synchronization

Last modified 9 days ago Last modified on 2018-06-10T07:37:27-08:00