jovian / venusian-gtk

0.8.x-dev 2026-09-18 17:50 UTC

Requires

• php: ^8.4|^8.5|^8.6
• ext-mbstring: *
• jovian/gtk: ^0.8.0
• microscrap/scrapyard-evdev: ^0.8.0
• venusian-surface/bridge: ^0.8.0
• venusian-surface/contracts: ^0.8.0
• venusian-surface/drawing: ^0.8.0
• venusian-surface/human-input: ^0.8.0
• venusian-surface/native-windows: ^0.8.0
• venusian-voyager/contracts: ^0.8.0

Requires (Dev)

• pestphp/pest: ^4

MIT

• Angel Gonzalez

• framework
• bindings
• macos
• venusian
• gtk4

Published on Packagist.org on 2026-09-18 17:51 UTC

README

GTK4 composition for Venusian Surface on Linux. Installing it publishes the Linux session behind linux.bridge and the input engine behind input.gtk.

ext-gtk  →  jovian/gtk  →  venusian-gtk  →  Surface
1:1 binding  typed projection  composition   cross-platform

Install

composer require jovian/venusian-gtk

Requires Linux, GTK 4.18+, PHP 8.4+ and ext-gtk 0.8.0. Gamepads also need microscrap/scrapyard-evdev and the running user in the input group.

Input

input.gtk reads the keyboard and mouse for native windows through GTK event controllers, and gamepads straight from /dev/input/event* over evdev (id = node name, e.g. event7). Signal handlers only buffer; each poll applies the buffer, so a sketch reads settled state.

• Keys are layout-independent (evdev codes). Modifiers follow the held modifier keys; GTK's own state is from before the key.
• Focus loss releases every held key and mouse button (with release edges).
• mouse()->wheel(): wheel in lines, dy > 0 = away. GTK does not report natural scrolling, so with it on the sign is reversed.
• Pads are rescanned about once a second (sysfs, no device opens). Unplug or Bluetooth off gives input.gamepad.disconnected.<id> mail.
• Failures (a window that will not attach, an unreadable node) are kept for errors() and logged; the engine keeps running.

use Surface\HumanInput\MagicAliases\HumanInput;

$gtk = HumanInput::engine('gtk');          // or INPUT_ENGINE=gtk
$gtk->mouse()->window();                   // window under the pointer, or null
foreach ($gtk->gameControllers() as $id => $pad) {   // 'event7'
    $pad->rightTrigger();
}

See .okf/ for the knowledge bundle.

License

MIT.