BallroomDJ runs on Windows 7, Windows 8.1 and Windows 10.
If you run the installer on Windows 8.1 or later and you get a message about "Windows Protected Your PC", you can reference the following article: howtogeek : smartscreen filter. Select "More Info", then "Run Anyway".
Open windows explorer on your computer and navigate to the C:\ drive (My PC->Local Disk (C:) or Computer->Local Disk (C:)).
Look for a folder named 'Program Files (x86)'. If this folder exists, you have a 64-bit computer. If this folder does not exist, you have a 32-bit computer.
Another way to check is listed in the Microsoft FAQs: Microsoft FAQ: 32-bit/64-bit
Windows Explorer
If you have 32-bit Windows, make sure the C:\Windows\system32\MSCVR100.DLL file exists. If not, download and install it from the Microsoft website: Microsoft Visual C++ 2010 Redistributable Package (x86).
Python is a computer language used to run the utility that reads and writes the MP3 audio file tags.
Go to the python.org download page.
Select the Latest Python 3 Release - Python 3.x.x link near the top of the page.
Scroll to the bottom of the new page (Files section).
Select the Either the 64-bit Windows x86-64 executable installer or the the 32-bit Windows x86 executable installer that matches your system.
( 64-bit currently at: https://www.python.org/ftp/python/3.8.5/python-3.8.5-amd64.exe
as of 2020-8 )
After downloading, run the python installer.
For the python installation, on the first screen, de-select the
Install launcher for all users, and select Add python 3.x to PATH. Then select Install Now.
After python has installed, reboot your system.
Python Installation / Initial Screen
(Note: BallroomDJ will work with other Python installers such as Anaconda. Not all versions of python installers have been tested).
If you already have VLC installed on 64-bit Windows, you probably have the 32-bit version of VLC, It is recommended that you make sure that you are using a 64-bit version of VLC. BallroomDJ will function better.
Note: BallroomDJ has not been tested with the upcoming VLC version 4.0
Go to: VLC Media Player Download. If you are running 64-bit Windows, select the down-arrow on the orange button and select Installer for 64-bit version. If you are running 32-bit Windows, simply click on the button.
For the VLC installation, the defaults will need to be changed if you normally use some other media player (such as Windows Media Player).
Select Next until you see the Choose Components screen (shown below) and scroll down until you see File Type Associations.
VLC Installation / Choose Components
Select the File type associations checkbox twice in order to turn off all file type associations (if you use VLC as your music/video player, leave these on).
VLC Installation / Choose Components / File Type Associations
Now select Next, Install, then turn off the Run VLC Media Player checkbox and select Finish.
Go to: https://sourceforge.net/projects/ballroomdj. If you are running 64-bit windows, you may just select the 'Download' button.
If you are running 32-bit windows, Select the 'Files' tab. Select the folder at the top of the list. Select the BallroomDJ-3.x.x-win32.exe link.
Run the BallroomDJ windows installer. The installer will create a new folder on your desktop named 'BallroomDJ'.
If you have already installed BallroomDJ, re-install it. Installation of BallroomDJ requires that Python is already installed, otherwise the Mutagen package will not be installed.
Go to: Setting Up BallroomDJ for the First Time and work through the setup instructions.
BallroomDJ has extensive help built in to the program, and there is additional help on the wiki.
If you are having trouble with installation or setup, ask for help on the BallroomDJ forums, or use the Support function within BallroomDJ (see Getting Help).