Windows

Installing BassBoom on Windows!

Before performing the installation, your Windows system must meet the following requirements:

System	Framework	Terminal
Windows 7+	.NET 8.0	ConEmu or Windows 10 cmd.exe

We advice you to use the terminal emulation software capable of displaying the VT sequences on systems older than Windows 10. BassBoom uses Terminaux to render its elements in the CLI music player.

Installation

There are several ways to install BassBoom on Windows systems. We recommend installing BassBoom using the Chocolatey package manager or the Windows installer for simplicity.

Method 1: Windows Installer

The Windows Installer method allows you to easily install BassBoom.

1. Download the latest Windows Installer EXE file from this page

2. Double-click on a single EXE file, and follow the instructions

3. Double-click on BassBoom in your desktop.

Method 2: Chocolatey

This step-by-step guide shows you how to install BassBoom using the package manager, Chocolatey, assuming that you already have it on your system.

1. Ensure that Chocolatey is installed to your system PATH

2. Open your favorite terminal emulator, like ConEmu, and execute the following command: choco install bassboom

3. Start BassBoom using bassboom

Method 3: Manual unpack

If you like to manually unpack the BassBoom packages, follow these steps:

1. Ensure that you have all the required software installed

2. Download the latest release ZIP file from this page.

3. Unpack the ZIP archive to any folder of your choice using 7-Zip

4. Open your favorite terminal emulator, like ConEmu, and change the working directory to a folder containing the BassBoom executable

5. Execute bassboom or BassBoom.Cli.exe to start the kernel

Bleeding-edge

Bleeding-edge builds usually come from building the development branch of the application, and they usually contain bugs and other untested features.

If you're a tester to such software, please follow the steps on your Windows machine. Please be sure that you're signed in to your GitHub account.

1. Open the canary release preparation workflow

2. Select the most recent build

3. Scroll down to Artifacts and click on one of the bb-build buttons to download the ZIP file or one of the installer-ARCH-msi files for the installer version, where ARCH is either x64 or arm64.

4. Extract the file. Be sure that you have the latest version of 7-Zip or your favorite archive manager installed. After that, follow the steps:

   1. If you've used the bb-build output, follow the last two steps in the Manual unpack section.

   2. If you've used the installer output, follow the last two steps in the Windows Installer section.

Notice for SmartScreen

SmartScreen may detect that BassBoom and its associated executables may not pass the SmartScreen attestation. If this happens, you'll see the below page:

BassBoom will not put your PC at risk (except if you downloaded a copy from an unofficial software distributor, or from an unofficial source other than our official GitHub releases found here, our Chocolatey page found here, and our NuGet page found here). Click on More Info, then click on Run anyways.