Skip to content

Platform Support

Platform Matrix

Platform Display Server Status Screenshot Window List Window Geometry
Linux X11 Supported import xdotool xdotool
Linux Wayland (Sway) Supported grim swaymsg swaymsg
macOS CoreGraphics Supported screencapture osascript osascript
Windows — Planned — — —

Display Server Detection

The CLI automatically detects the display server at startup:

flowchart TD
    A[detectDisplayServer] --> B{process.platform === 'darwin'?}
    B -->|yes| C[darwin]
    B -->|no| D{WAYLAND_DISPLAY set?}
    D -->|yes| E[wayland]
    D -->|no| F{DISPLAY set?}
    F -->|yes| G[x11]
    F -->|no| H{XDG_SESSION_TYPE?}
    H -->|wayland| E
    H -->|x11| G
    H -->|other| I[unknown → error]

Platform Details

Required tools:

Tool Package Purpose
xdotool xdotool Window search, geometry, listing
import imagemagick Window screenshot capture
convert imagemagick Image crop and resize 
sudo apt install xdotool imagemagick

How it works:

  • xdotool search --name <regex> finds windows by title
  • xdotool getwindowgeometry <id> gets position and size
  • import -window <id> png:- captures window pixels to stdout
  • convert crops and resizes via stdin/stdout pipes

Required tools:

Tool Package Purpose
swaymsg sway Window listing and geometry via IPC
grim grim Screenshot capture
convert imagemagick Image crop and resize 
sudo apt install sway grim imagemagick

How it works:

  • swaymsg -t get_tree lists all windows with geometry
  • grim -g <geometry> captures a screen region
  • convert crops and resizes via stdin/stdout pipes

Compositor Support

Currently only Sway is supported. Other Wayland compositors (GNOME, KDE) would need their own adapters.

Required tools:

Tool Package Purpose
screencapture Built-in Window screenshot capture
osascript Built-in Window search and geometry via AppleScript
sips Built-in Image format info
convert imagemagick Image crop and resize 
brew install imagemagick

How it works:

  • AppleScript queries System Events for window properties
  • screencapture -l <windowId> captures a specific window
  • convert crops and resizes via stdin/stdout pipes

Screen Recording Permission

macOS requires Screen Recording permission for screencapture. Grant it in System Settings > Privacy & Security > Screen Recording for your terminal application.

Windows support is planned but not yet implemented. Contributions welcome!

Potential approach: PowerShell for window enumeration, .NET APIs for screenshot capture.

Tool Verification

The CLI checks for required tools on first use and reports missing ones:

$ tauri-agent-tools list-windows
Error: Missing required tools:
  xdotool: sudo apt install xdotool
  import: sudo apt install imagemagick

Tools are only checked once per session. The check runs on the first command that needs platform tools (screenshot, info, list-windows, wait with --title).