Version 27 (modified by bll, 4 months ago) (diff)


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 it starts playing a song , the master volume gets reset to the same as VLC's volume.

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

flat-volumes = no

Installing via the command line

Install the Requisite Software

This is the command for Debian/Ubuntu/LinuxMint/MX

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

Add your user account to the audio group

sudo usermod -a -G audio $USER

Install BallroomDJ

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

Installing via the command line, use INSTALLER script

tar -xfz ballroomdj-3.3.14.tar.gz
cd ballroomdj-3.3.14

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. At this time, the installation script only has support for debian/ubuntu/linux mint insallation of requisite packages)

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

Open the ballroomdj- 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.