Files
nixos-setup/pkgs/niri-touchscreen-gestures/niri_touchscreen_gestures/nirictl.py
T
2026-07-28 16:21:57 -04:00

86 lines
2.4 KiB
Python

import json
import os
import select
import socket
from contextlib import contextmanager
from typing import Any, Literal, TypeAlias
SupportedActions: TypeAlias = Literal[
"FocusWorkspaceUp",
"FocusWorkspaceDown",
"FocusColumnLeft",
"FocusColumnRight",
"ToggleOverview",
]
def get_socket_path():
"""Get the Niri socket path from the environment, raising if not set."""
socket_path = os.environ.get("NIRI_SOCKET")
if not socket_path:
raise RuntimeError("Niri is not running or NIRI_SOCKET is not set.")
return socket_path
@contextmanager
def niri_socket():
"""Context manager for the Niri socket."""
socket_path = get_socket_path()
s = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
s.connect(socket_path)
s.setblocking(False)
try:
yield s
finally:
s.close()
def send_niri_command(command: dict[str, Any] | str) -> dict[str, Any]:
"""Send a raw JSON command to Niri and return the parsed reply."""
with niri_socket() as s:
s.sendall((json.dumps(command) + "\n").encode("utf-8"))
# wait for data (up to 5 s)
ready, _, _ = select.select([s], [], [], 5)
if not ready:
raise TimeoutError("No response from Niri")
# read everything available
data = bytearray()
while True:
try:
chunk = s.recv(4096)
if chunk:
data += chunk
else:
break
except BlockingIOError:
break
return json.loads(data.decode("utf-8"))
def send_niri_action(action: SupportedActions) -> bool:
"""Send an Action command"""
request = {"Action": {action: {}}}
reply = send_niri_command(request)
return reply.get("Ok", "Handled").lower() == "handled"
def get_focused_window() -> dict[str, Any] | None:
"""Query niri for the currently focused window (includes its `app_id`)."""
reply = send_niri_command("FocusedWindow")
return reply.get("Ok", {}).get("FocusedWindow")
def get_outputs() -> dict[str, Any]:
"""Query niri for all connected outputs, keyed by output name (e.g. "eDP-1").
Each output's `logical` field (None if disabled) gives its position/size
in niri's global logical coordinate space: {x, y, width, height, scale,
transform}.
"""
reply = send_niri_command("Outputs")
return reply.get("Ok", {}).get("Outputs", {})