xdrive

X11 window manager automation and testing framework.

xdrive gives you programmatic control over X11 windows, input devices, and display state — ideal for integration-testing tiling or stacking window managers inside headless (Xvfb) environments.

Guides

• Quick Start
  • Installation
  • Your First Test
  • Using the Pytest Fixtures
  • Key Concepts
• Headless Display Setup
  • Installing Xvfb
  • Using VirtualDisplay
  • Manual Xvfb usage
  • CI Integration (GitHub Actions)
  • Troubleshooting
• X11 Pitfalls & Gotchas
  • DISPLAY environment variable
  • Timing and race conditions
  • Focus stealing and input
  • Root window events
  • Window geometry and reparenting
  • XTest extension
  • Screenshot colour format
  • Multi-monitor (Xinerama / RandR)

API Reference

• API Reference
  • xdrive.xdrive
  • xdrive.window
  • xdrive.screen
  • xdrive.keyboard
  • xdrive.mouse
  • xdrive.display
  • xdrive.geometry
  • xdrive.events
  • xdrive.assertions
  • xdrive.ui_tree

Indices and tables

• Index

• Module Index

• Search Page