Skip to content

v3.0.0 - Renamed driver to TuxBox

Choose a tag to compare

@AndyCappDev AndyCappDev released this 04 May 13:12

TuxBox v3.0.0

The project has been renamed from tourbox-linux to TuxBox. "TourBox" continues to refer to the hardware device; "TuxBox" is the name of this Linux driver and configuration tool.

Upgrading from v2.x

For existing installations, pull the latest code and re-run the install script:

cd /path/to/your/clone
git pull
./install.sh

The install script will automatically:

  • Migrate your config from ~/.config/tourbox/ to ~/.config/tuxbox/, preserving all your profiles and button mappings
  • Rename the old config directory to ~/.config/tourbox.pre-v3-backup/
  • Stop and remove the old tourbox.service
  • Remove old launcher, desktop entry, and icon
  • Install everything under the new tuxbox names
  • Update the git remote URL if it still references tourbox-linux

Note: If you pinned the TuxBox GUI to your taskbar, the pin will be removed during the upgrade. After installing, find "TuxBox Configuration" in your application menu and pin it again.

What Changed

  • Python package: tourboxelite/tuxbox/
  • Config directory: ~/.config/tourbox/~/.config/tuxbox/
  • Service: tourbox.servicetuxbox.service
  • GUI launcher: tourbox-guituxbox-gui
  • Desktop entry: tourbox-gui.desktoptuxbox-gui.desktop
  • Version: 2.10.0 → 3.0.0

Fresh Install

git clone https://github.com/AndyCappDev/tuxbox.git
cd tuxbox
./install.sh

Breaking Changes

  • The Python package is now tuxbox (was tourboxelite). Any custom scripts using from tourboxelite import ... will need to be updated.
  • The environment variable TOURBOX_USB_PORT has been renamed to TUXBOX_USB_PORT.

After Upgrading

Once you're satisfied everything works, you can delete the backup of your old config:

rm -rf ~/.config/tourbox.pre-v3-backup