Installing BallroomDJ on Linux

Linux Volume / pulseaudio

Linux systems seem to be shipping with pulseaudio's flat-volumes configuration set to 'yes'. This means that initializing VLC's volume to 100% is a problem, as every time vlc starts playing a song, the master volume gets reset to the same as VLC's volume (pulse audio weirdness).

I changed /etc/pulse/daemon.conf to have:

flat-volumes = no

(The INSTALLER script will make this change for you)..

Installing via the command line, using the INSTALLER script

This is the recommended method. The INSTALLER script will install the requisite software, change /etc/pulse/daemon.conf as described above, install BallroomDJ and set up the desktop icon.

tar -xfz ballroomdj-3.18.3.tar.gz
cd ballroomdj-3.18.3

The ballroomdj-3.18.3 directory can be removed after you are satisfied that BallroomDJ is working properly.

Installing via the command line

Install the Requisite Software

Debian/Ubuntu/LinuxMint/MX (debian based systems)

sudo apt-get install python-setuptools python-pip 
sudo apt-get install flac faad pulseaudio-utils vlc
sudo apt-get install libvlc5 sox libsox-fmt-mp3 espeak
sudo apt-get install vorbis-tools
# as python-mutagen is often an older version, make sure
# it is removed and install it via pip
sudo apt-get remove python-mutagen

Arch/Manjaro (arch based systems)

# a stable version of vlc is recommended
sudo pacman -R vlc-nightly  
sudo pacman -S --needed faad2 ffmpeg flac pulseaudio-ctl
sudo pacman -S --needed vlc sox python-setuptools python-pip 
sudo pacman -S --needed espeak vorbis-tools libmad lame
sudo pacman -S --needed twolame libid3tag opusfile
sudo pacman -R python-mutagen


For Fedora systems, I recommend using the INSTALLER script, as the SoX package must be built to support MP3s. The instructions to rebuild SoX are not replicated here.

# the rpmfusion repository is needed for faad2, ffmpeg and vlc
sudo dnf install \$(rpm -E %fedora).noarch.rpm \$(rpm -E %fedora).noarch.rpm
sudo dnf install faad2 ffmpeg flac pulseaudio-utils 
sudo dnf install vlc python-setuptools python-pip 
sudo dnf install espeak vorbis-tools libXScrnSaver
sudo dnf remove python-mutagen

All systems

sudo pip install --upgrade mutagen

Add your user account to the audio group

sudo usermod -a -G audio $USER

Install BallroomDJ

tar -xfz ballroomdj-3.18.3.tar.gz
cd ballroomdj-3.18.3
make prefix=/your-install-location install

The ballroomdj-3.18.3 directory can be removed after you are satisfied that BallroomDJ is working properly.

Installing via the graphical user interface

(These instructions apply to version 3.3.14 and later)

(These instructions may vary depending on your file manager and version of Linux. It's easier to just open a terminal and run the INSTALLER script via the command line.)

Open the file manager and double-click on ballroomdj-3.18.3.tar.gz. Select "Extract" and extract all files.

Open the ballroomdj-3.18.3 folder in the file manager.

Double click on the INSTALLER file. Select Run in terminal. (How this works depends on your window manager).

Type in the folder where BallroomDJ should be installed. The default location is $HOME/BallroomDJ. The folder does not need to be created beforehand.

The installation will now run a sudo command to install the requisite packages and a sudo command to add the audio group to your user account. Enter your password.

After installing the requisite packages, BallroomDJ will be installed to the location you entered.

A desktop icon to start BallroomDJ will be created on your desktop. The icon needs to be marked as trusted. Use one of these two methods (depending on your desktop manager): (a) Double click on the icon and select Mark as trusted to activate the icon. (b) Right click on the icon, select Properties, select the Permissions tab, turn on the Allow executing file as program checkbox.

The ballroomdj-3.18.3 folder can be removed after you are satisfied that BallroomDJ is working properly.

Last modified 12 days ago Last modified on 2018-01-09T12:34:46-08:00