ewmhlib

library0.2pypypi✓ verified 81d ago

A pure Python 3 library for interacting with X11 window managers using the Extended Window Manager Hints (EWMH) specification. Current version 0.2 provides support for querying and setting _NET_WM_* properties, managing desktops, windows, and viewports. Released as an early beta; no fixed release cadence.

devops

pip install ewmhlib

github ↗homepage ↗

INSTALL

IMPORT

SIG · EWMHLIB

ewmhlib

devopspythonv0.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

EwmhRoot

✓ from ewmhlib import EwmhRoot

✗ from ewmhlib import EWMH

EwmhWindow

✓ from ewmhlib import EwmhWindow

✗ from ewmhlib import EWMH

Props

✓ from ewmhlib import Props

✗ from ewmhlib import EWMH

Creates an EWMH instance and prints the window titles of all managed client windows.

from ewmhlib import EWMH ewmh = EWMH() # List all client windows clients = ewmh.getClientList() if clients: for client in clients: print(ewmh.getWmName(client)) else: print('No windows found')

Debug

Known issues

gotchaRequires an X11 display; throws exceptions if DISPLAY is not set or if running headless.

fix

Ensure DISPLAY is set (e.g., export DISPLAY=:0) and an X server is running.

affects: all

gotchaPython 2 is not supported; only Python 3.

fix

Use Python 3.4+ (tested up to 3.10).

affects: 0.1+

breakingAPI is unstable; property names and method signatures may change in future releases.

fix

Pin exact version in dependencies (ewmhlib==0.2) and monitor GitHub for changes.

affects: 0.x

Upgrade

Version history

0.2latest on PyPI · released Apr 17, 2024

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/Kalmat/EWMHlib ↗

homepagehttps://github.com/Kalmat/EWMHlib ↗