python-xlib

import Xlib.display import Xlib.X try: # Connect to the default display # The DISPLAY environment variable must be set, e.g., export DISPLAY=:0 display = Xlib.display.Display() # Get the root window of the default screen root = display.screen().root print(f"Successfully connected to display: {display.get_display_name()}") print(f"Root window ID: {root.id}") # Example: Create a simple black window # If this causes issues in headless environments, comment out or wrap in try/except try: window = root.create_window( 0, 0, 200, 100, 1, # x, y, width, height, border_width Xlib.X.CopyFromParent, # depth Xlib.X.InputOutput, # class Xlib.X.None, # visual Xlib.X.CWEventMask | Xlib.X.CWBackPixel, # value_mask event_mask=Xlib.X.ExposureMask, # event_mask background_pixel=display.screen().black_pixel # background_pixel ) window.map_request() window.map() display.flush() print("Created a simple window (will be visible briefly or not at all in some environments).") # In a real app, you'd enter an event loop here. # For quickstart, we just create and then let it disappear. except Xlib.error.BadMatch: print("Could not create window (e.g., no graphical environment or visual not supported).") finally: if 'display' in locals() and display: display.close() print("Display connection closed.")