pewidot/funkeyhub_linux

This project helps people run U.B. Funkeys, an old toy game called FunkeyOne, on Linux using Wine, including the physical USB hub that reads the toy figures. It does not include the game itself, which you still have to download separately from the official site. Instead, this repository provides the Linux side fixes needed to make an old Windows game work properly under Wine. The original game is a .NET application that embeds Adobe Flash and talks to its USB hub through a Windows specific driver, none of which works cleanly under Wine by default. To fix this, the project ships three small replacement files, called shims, plus a launcher script. One shim forwards USB communication to the Linux libusb library so the hub works without a Windows only driver. A second shim sits in front of the real Flash component and prevents a licensing check that would otherwise crash the game. A third shim replaces a Wine input function that would otherwise abort the game when Flash calls it. The launcher script starts the hub reading program alongside the game itself, since the game does not do this on its own. On Ubuntu or Debian, you can install a prebuilt package, and the first time you open the game from your applications menu, a setup window walks you through installing Wine, downloading the actual game, and applying all the fixes automatically. During the game's own installer, you are told to skip certain options, such as installing shortcuts or the original hub driver. On other Linux distributions, a setup script detects your package manager, installs what is missing, builds the shims from source, and creates a menu entry for you, and it is safe to run more than once. The README also includes a long troubleshooting section covering what to do if the hub is not detected, including specific error messages to look for in a log file, how to reload permission rules for the USB device, and fixes for a few other known crashes. The project only contains original support code such as the shims, launcher, and setup scripts. It does not include Adobe Flash or any of the original game's files, and it is described as an unofficial, unaffiliated compatibility layer.