Files
bitfit/README.md
cocktailfrank 7ce34d9684 Revert changes that treated gpiozero as optional
gpiozero is a requirement that can be installed on any system,
regardless of whether the Pi GPIO is available. gpiozero provides mock
pins, so the dispenser can be mocked even when not running on the Pi
2026-06-20 00:33:15 -04:00

1.6 KiB

BiTFiT

Land the triangles without touching the rods

Controls

  • Left/Right - Move rods
  • Down - Increase fall speed
  • F11 - Full screen

Requirements

On Debian Linux, these can be installed with apt

> sudo apt install python3 python3-pygame python3-gpiozero

Running

Once Python and Pygame have been installed, clone the repository, and run OPEN-GAME. The --recursive flag includes the PGFW project as submodule.

git clone --recursive https://open.shampoo.ooo/shampoo/ibitfit
cd ibitfit/
./OPEN-GAME

Raspberry Pi

If running on a Raspberry Pi, it is possible to control left and right using buttons connected to the Raspberry Pi pins GPIO 24 and GPIO 23. It should work automatically as long as RPi.GPIO is installed, which should be installed by default.

BiTFiT is the first Playzing compatible game. See the Playzing builder's manual for detailed instructions on how to get it running.

Headless

If running on Linux without X-Windows (for example, Raspberry Pi Lite OS), there are two options for launching:

  • add --kms to the command line if the newer KMS driver and Pygame 2 are being used
  • add --fb to use the framebuffer if using Pygame 1