Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Zabka Triki Desktop Controller & Minigames

Python Platform License

A lightweight background Windows system tray utility for the motion-sensing Zabka Triki Bluetooth LE puck. Turn your Triki into a tactile desktop media dial, shadowboxing punch speedometer, or an 8-bit coin-flip decision maker.


Disclaimer

This is an independent, open-source hobby project. It is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Żabka Polska sp. z o.o. or the official Żabka Triki campaign/brand. All product names, trademarks, and registered trademarks belong to their respective owners.


Features

Media Controller

  • Spin Dial: Smooth volume up/down control using Z-axis gyroscope integration.
  • Tilt Navigation: Tilt forward to skip to the next track, tilt back for previous track.
  • Spin-Lock Mutex: Debounce locks prevent accidental track skips while rotating.

Punch & Throw Speedometer

  • Real-time Velocity: Integrates linear hand acceleration in real time.
  • HUD Overlay: Live speed readouts in km/h (refreshed every 650ms) with peak session records.

Coin Flip & Minigames

  • Coin Toss: Physical toss detection with low-latency HUD readouts for Heads/Tails.
  • Target Flip Challenge: Land specific sides consecutively to build score streaks.

System Tray Integration

  • Battery Monitor: Live battery percentage readout.
  • LED Control: Configurable onboard LED strobe modes (Fast, Default, Slow, Off).
  • Audio Feedback: Toggleable 8-bit sound effects.
  • Auto-Start: Optional Windows startup integration via Registry.

Getting Started

Prerequisites

  • Windows 10 / 11
  • Bluetooth LE-capable adapter (built-in or USB dongle)
  • Python 3.10+ (only required if running from source)

Option 1: Quick Start (Standalone Executable)

  1. Download the latest triki-util.exe from the Releases page.
  2. Run the .exe file.
  3. Access controls, minigames, and settings directly from the Windows system tray icon.

Option 2: Running from Source

  1. Clone the repository:
    git clone [https://github.com/heszgt/-triki-util.git](https://github.com/heszgt/-triki-util.git)
    cd -triki-util

About

A lightweight system tray controller, media dial & minigames suite for the Żabka Triki BLE puck.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages