TRIKI Control 1.2.0

TRIKI Control 1.2.0 adds the native Android controller and completes the matching desktop update.

What's new

• Native Android app with BLE cap support, configurable touch, joystick and scroll mappings, background operation, and accessibility gestures without root.
• New built-in Mouse profile on Windows, with cap rotation mapped to continuous left/right pointer movement by default.
• A real Disconnect command on desktop that stops output and pauses automatic reconnect.
• Fixed startup calibration that could leave the cap permanently reporting Slide after movement during connection.
• Automatic recovery from stale reconnect calibration without changing the established Game/Doom controls.
• Refreshed README with current desktop and Android screenshots plus a ten-second gameplay clip.

Downloads

• TRIKI-Control.exe - Windows application.
• TRIKI-Control-Android-1.2.0.apk - signed Android application (Android 8.0 or newer).

Tested on Windows and Android hardware. Desktop suite: 438 passed, 10 skipped. Android unit tests, lint, debug build, and signed release build completed successfully.

TRIKI Control 1.1.1

TRIKI Control 1.1.1

• Adds an optional Continuous mouse axis for pointer directions mapped to left/right cap turns.
• Makes pointer speed follow live twist speed, from precise low-speed movement up to the profile's configured Mouse speed.
• Saves the axis mode independently for Game, Music and custom profiles.
• Keeps the previous fixed-step behavior available by disabling Continuous mouse axis.
• Preserves keyboard, media-key, mouse-button and macro behavior, including the established Game/Doom steering path.

Follow-up to #2.

Verification: 431 passed, 10 skipped, 10 subtests passed; Ruff and source-diff checks passed. The UI was checked in Playwright at desktop and small-window sizes with no console errors. The packaged Windows EXE was smoke-tested, including version 1.1.1, the embedded TRIKI icon, tray asset and OpenSSL libraries.

SHA-256 (TRIKI-Control.exe): 9B61CF51A977669131094BFE2A6E716FBA2DF17E71AC9104D3903A08453B5C77

TRIKI Control 1.1.0

TRIKI Control 1.1.0

• Adds an obvious in-app Quit button and a Polish/English notification explaining that X hides the app by the clock instead of closing it.
• Adds separate tray commands for disabling control and quitting the application.
• Adds cross-platform mappings for left, right and middle mouse buttons plus pointer movement in four directions.
• Adds per-profile mouse movement speed for Game and Music.
• Keeps control OFF at startup and pairing, releases held input after connection loss, and leaves OFF available while disconnected.
• Fixes shutdown while Bluetooth is waiting for pairing so Quit terminates the hidden process.
• Hardens the local control API and makes configuration writes atomic.
• Preserves the established Game/Doom controls and Music media bindings.

Addresses #2.

Verification: 426 passed, 10 skipped; Ruff and compileall clean. The packaged Windows EXE was smoke-tested with the real WebView/tray flow, X-to-tray behavior and full process shutdown. The embedded app icon, WebView runtime files and OpenSSL libraries were verified. The release candidate was also tested with a physical TRIKI device.

SHA-256 (TRIKI-Control.exe): C45DD36ADBEAAD07B0534FC64BCAB392A6799AFE8112B2D25F7B6857880F919E

TRIKI Control 1.0.6

TRIKI Control 1.0.6

• Addresses issue #1: launching TRIKI Control again now activates the already-running instance instead of starting another copy.
• Adds a local show control action used by the second launch to reopen the tray-hidden WebView window.
• Browser UI mode now reopens the existing local UI tab instead of spawning a duplicate server.

Verification: 406 passed, 10 skipped; packaged EXE smoke-tested by launching a first instance and then launching a second instance against the same port. The second process exited with code 0 and the first process remained the only listener.

TRIKI Control 1.0.5

TRIKI Control 1.0.5

• Fixes a migration regression found while checking Game/Doom compatibility against 1.0.1 and 1.0.2.
• Preserves Game/Doom key overrides from schema 14/15 configs across the 1.0.4 Motion tuning schema update.
• Preserves Music key overrides from 1.0.2 configs, while still resetting the broken 1.0.1 Music-as-Game defaults.
• Keeps Game motion tuning unchanged: turn threshold 1000, turn sensitivity 50.

Verification: 401 passed, 10 skipped; packaged EXE smoke-tested with v1.0.1 Game and v1.0.2 Music config migrations.

TRIKI Control 1.0.4

TRIKI Control 1.0.4

• Fixes the 1.0.3 tuning mix-up: the profile threshold slider now controls the real turn/twist threshold, not lean/tilt.
• Game keeps the previous feel: turn threshold 1000, turn sensitivity 50.
• Music defaults to faster volume control: turn threshold 580, turn sensitivity 85.
• Music keeps media bindings for volume down/up, previous/next, mute, and play/pause.
• Windows build still bundles _ssl.pyd, libcrypto-3-x64.dll, and libssl-3-x64.dll.

Verification: 399 passed, 10 skipped; packaged EXE smoke-tested via /state.

TRIKI Control 1.0.3

TRIKI Control 1.0.3

• Volume up/down now repeat as media-key taps while a twist is held, so Music profile volume behaves more like a knob instead of one 2% step per gesture.
• Added per-profile Motion tuning for lean threshold and turn sensitivity. Game keeps the steady default, Music defaults to a more sensitive twist pickup.
• Advanced now persists and exports/imports those Motion tuning values per profile.
• Windows build still bundles _ssl.pyd, libcrypto-3-x64.dll, and libssl-3-x64.dll for Windows 10 compatibility.

Verification:

• python -m pytest -q: 398 passed, 10 skipped, 8 subtests passed
• PyInstaller release/debug builds completed
• TRIKI-Control.exe SHA256: 6F71480542532E7CBEEB4A79BB99D84FE40BF81E903B3EFDD98331C8B56BA0BD

TRIKI Control 1.0.2

TRIKI Control 1.0.2

• Restores media-key defaults for the Music profile while keeping the shared Motion action table in Advanced.
• Migrates config version 14 to 15 so Music settings saved by 1.0.1 reset from accidental Game keys back to media controls.
• Keeps the bundled Windows SSL DLLs required by Python's SSL module in the executable.

Verification:

• python -m pytest -q: 389 passed, 10 skipped, 8 subtests passed
• TRIKI-Control.exe SHA256: 97A445F29661D38A0FC9A22B56CF8536C3C7B131418DDEF359537F08A78FE1E2

TRIKI Control 1.0.1

Changes:

• Music and custom profiles now use the same Motion/Game action mapping as Game.
• The Advanced window title is now plain "Advanced settings" / "Ustawienia zaawansowane".
• Includes the refreshed app assets and Windows OpenSSL packaging fix.

Verification:

• actions/build-assets: 47 passed, 8 subtests passed
• focused app profile/UI tests: 11 passed
• TRIKI-Control.exe SHA256: 53A30B39450AAAC6C3B24E723B25F44546D2D87CE22C05CF3F4CD425D6B6BF9E

TRIKI Control 1.0.0

Play PC games, including a full run through Doom, by waving a Żabka bottle cap around.

TRIKI Control pairs with the TRIKI Bluetooth motion cap and turns your wrist into a keyboard. Twist to turn, tilt to walk, tap to fire, flip to run, slide to open doors.

Download

• Windows: grab TRIKI-Control.exe below. No install, just run. (SmartScreen may warn about an unknown publisher; it is an unsigned hobby build, so choose More info then Run anyway.)
• macOS / Linux: build from source. See the README.

Why it steers like a tank

The cap has a gyroscope and accelerometer but no magnetometer, so a round cap cannot know which way it is pointing. Directional movement is physically impossible on this hardware, which is the same reason the cap's official games each use a single axis of motion. Every control here is built from heading-free signals instead (twist=turn, tilt=go, tap=fire, flip=run, slide=use). The full story: docs/how-it-works.md.

See the CHANGELOG for everything in 1.0.0.