Android

Installing BassBoom to Android!

The tricky part is getting BassBoom to run on Android phones and tablets, especially those that run the latest version of Android. The trickier part is getting PulseAudio to work.

---

Installation

To install BassBoom on your phone or tablet, install the following dependencies:

• Termux

• Ubuntu PRoot

• PulseAudio on your Termux environment

Ensure that your Android version is compatible with Termux. You need at least 8 GB of free storage and Android 7.0 or higher.

Once you're done, follow the steps:

1

Set up environment

You'll need to set up the environment.

1. Install Termux

2. Install proot-distro using the following command:

   • pkg install proot-distro

3. Install the Ubuntu proot

   • proot-distro install ubuntu

2

Set up PulseAudio

You'll need to set up PulseAudio.

1. In the Termux environment (not proot), install PulseAudio

   • pkg install pulseaudio

2. Append the following text at the end of the $PREFIX/etc/pulse/default.pa like this:

   1. echo "load-module module-simple-protocol-tcp source=OpenSL_ES_sink.monitor port=12345 record=true" >> $PREFIX/etc/pulse/default.pa

3. Start PulseAudio. Note that you'll have to repeat this each time you exit and re-open Termux.

   1. pulseaudio --start --load="module-native-protocol-tcp auth-ip-acl=127.0.0.1 auth-anonymous=1" --exit-idle-time=-1

3

Configure the Ubuntu package manager

In the proot environment, you'll need to configure the Ubuntu package manager to be able to install packages.

1. Log in to the Ubuntu proot

   • proot-distro login ubuntu

2. Ensure that you've updated the package cache

   • apt update

   • apt dist-upgrade

4

Install .NET 10.0, wget, and unzip

You won't be able to run BassBoom if you haven't installed .NET 10.0.

1. Install the .NET 10.0 runtime

   • apt install dotnet-runtime-10.0

2. Install wget and unzip

   • apt install wget unzip

5

Download the ZIP archive

Follow this step to download the ZIP archive.

1. Download the latest release from this page.

   • wget https://github.com/Aptivi/BassBoom/releases/download/vx.x.x/x.x.x-bin.zip

6

Extract the ZIP archive

Follow this step to extract the ZIP archive.

1. Use unzip to extract the files

   • unzip x.x.x-bin.zip

7

Execute the BassBoom CLI

Follow this step to execute the BassBoom CLI.

1. Execute dotnet BassBoom.Cli.dll

If you get no audio input and you're using a Samsung device with One UI 6.1 or higher, kill PulseAudio with pkill pulseaudio, then append LD_PRELOAD=/system/lib64/libskcodec.so before the above command like this:

1. LD_PRELOAD=/system/lib64/libskcodec.so pulseaudio --start --load="module-native-protocol-tcp auth-ip-acl=127.0.0.1 auth-anonymous=1" --exit-idle-time=-1

---

Upgrade

The only way to upgrade BassBoom in Android is to unpack the updated files manually. This assumes that you've already set up PulseAudio, that it's working on your Android device, and that wget and unzip is installed.

To upgrade, follow these steps:

1

Log in to the Ubuntu proot environment

In the proot environment, you'll need to login to it.

1. Log in to the Ubuntu proot

   • proot-distro login ubuntu

2

Download the ZIP archive

Follow this step to download the ZIP archive.

1. Download the latest release from this page.

   • wget https://github.com/Aptivi/BassBoom/releases/download/vx.x.x/x.x.x-bin.zip

3

Extract the ZIP archive

Follow this step to extract the ZIP archive.

1. Use unzip to extract the files

   • unzip x.x.x-bin.zip

4

Execute the BassBoom CLI

Follow this step to execute the BassBoom CLI.

1. Execute dotnet BassBoom.Cli.dll