Initial setup

• Windows
• macOS
• Linux

Windows

The Windows app for TumblBee is provided as a portable app and does not need to be installed before use. Just unzip the archive to your desired location, then run TumblBee.exe.

macOS

TumblBee can be installed by simply unzipping the archive and dragging the app icon to your Applications folder.

To circumvent code-signing requirements added to newer versions of macOS, you’ll need to remove the quarantine bit from TumblBee before use. Otherwise, you’ll see this message when attempting to launch the app.

To remove the quarantine bit from TumblBee:

1. Navigate to your Applications folder and open the Terminal app.

2. At the command prompt, enter the following command.

   sudo xattr -r -d com.apple.quarantine /Applications/TumblBee.app

   IMPORTANT

   If you installed TumblBee to somewhere other than your Applications folder, you’ll need to replace /Applications/TumblBee.app with the correct path. An easier way to do this is to enter the first portion of the command, ending with com.apple.quarantine, then drag and drop the TumblBee icon from Finder into the terminal window. The path to the app will be filled in for you.

3. Press Return. You may be prompted to enter your login password.

Once the command finishes processing, you can exit Terminal and try launching the app again. Note that you’ll need to repeat these steps each time the app is updated.

Linux

The Linux version of TumblBee is distributed with Flatpak packaging and should work on most distros that support Flatpak. You can check if Flatpak is installed on your system by running the following command in your terminal.

flatpak --version

For systems that have Flatpak installed, this command should return version info for your install. If instead you see an error message, you’ll need to install Flatpak. You’ll find setup instructions for most distros on the Flatpak Quick Setup page.

Once Flatpak is installed on your system, unzip the downloaded archive to obtain the .flatpak package. If your environment supports it, you can double-click the package file to install it. For all other setups, you can install the package from your terminal. For example, if you unzipped the package to the Downloads folder in your home directory:

flatpak install ~/Downloads/TumblBee-x.x.x-x86_64.flatpak

Be sure to replace ~/Downloads/TumblBee-x.x.x-x86_64.flatpak with the correct path and filename for your system.

If you aren’t able to install and run TumblBee on your system, please submit a bug report with more details.