Cocktail Frank 4be9ddb561 Add doc for card dispenser and Arduino dispenser script
The Arduino dispenser script sends a single dispense signal every run

Add incomplete Python packaging configuration file
2026-07-05 13:24:42 -04:00
2023-02-04 15:34:12 -05:00
2023-02-04 15:34:12 -05:00
2025-12-06 16:18:49 -08:00
2023-02-04 15:34:12 -05:00
2025-12-06 16:18:49 -08:00
2023-02-20 21:20:47 -05:00
2025-12-06 16:18:49 -08:00
2023-02-04 15:34:12 -05:00

Playzing

Playzing is a portable entertainment device featuring a built-in oven.

Playzing demo photo

Hardware

The Playzing has three main components:

  • Raspberry Pi portable gaming device
  • mini toaster oven
  • custom-built gamepad

The toaster is a commercial mini toaster oven which is modified to have a Raspberry Pi and screen attached to it. The gamepad is built to connect directly to the Raspberry Pi's digital input pins.

See the builder's manual for detailed instructions on how to build the entire system.

Baguette heating

Launcher

The code for launching games is tracked by this repository. The launcher can run on any operating system, but it is intended to run on Raspberry Pi OS when being used with the standard Playzing device.

Requirements

Python and Pygame can be installed using apt on Debian Linux

> sudo apt install python3 python3-pygame

Install the launcher by cloning this repository with PGFW using --recursive

> git clone --recursive https://open.shampoo.ooo/shampoo/playzing

BiTFiT

The game BiTFiT is currently required by the launcher and is the only officially supported game. Clone the game into the empty subfolder games. Alternatively, clone the game into a separate location, and create a symlink to that location.

> cd games/
> git clone https://open.shampoo.ooo/shampoo/ibitfit
> cd ..

Start the launcher. The display can rotate by 90-degrees, but rotation is turned off by default. To turn it on, launch with rotation enabled on the command line or set rotate to yes in config.

> ./Playzing.py --config ",display,rotated,yes"

BiTFiT should launch when any key is pressed at the launcher screen.

Card dispenser

The card dispenser is a Playzing-compatible peripheral device that can be set up to dispense a trading card when sent a signal from the Playzing's Raspberry Pi GPIO pins.

See the card dispenser doc for details.

License

The code is released under the zlib license, and the assets and documentation are released under CC BY 4.0. See LICENSE.md for details.

Playzing logo

Description
Code and documentation for the Playzing portable entertainment device which features a built-in oven
Readme 28 MiB
Languages
Python 99.9%