# Xdotool

> Linux UI automation using xdotool for window management, keyboard/mouse simulation, and desktop control. Use when this capability is needed.

- Skill: `tomevault-io/xdotool` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/xdotool`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/xdotool/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/xdotool

---


# Linux UI 自动化

使用 xdotool 控制 Linux 桌面窗口和输入。

## 安装

```bash
# Debian/Ubuntu
sudo apt install xdotool

# Fedora
sudo dnf install xdotool

# Arch
sudo pacman -S xdotool
```

## 命令参考

### 窗口管理

```bash
# 获取当前活动窗口
xdotool getactivewindow getwindowname

# 按名称查找窗口
xdotool search --name "Firefox"

# 激活窗口
xdotool windowactivate $(xdotool search --name "Firefox" | head -1)

# 最小化/最大化
xdotool windowminimize $(xdotool getactivewindow)

# 移动和调整大小
xdotool windowmove --sync $(xdotool getactivewindow) 100 100
xdotool windowsize --sync $(xdotool getactivewindow) 1200 800
```

### 键盘输入

```bash
# 输入文本
xdotool type "Hello World"

# 按键
xdotool key Return
xdotool key ctrl+c
xdotool key ctrl+shift+t
xdotool key super
```

### 鼠标操作

```bash
# 移动鼠标
xdotool mousemove 500 300

# 点击
xdotool click 1  # 左键
xdotool click 3  # 右键

# 移动并点击
xdotool mousemove 500 300 click 1
```

### 等待

```bash
# 等待窗口出现
xdotool search --sync --name "Save"
```

## 注意

- 仅支持 X11，Wayland 下需要用 `ydotool` 替代
- 某些应用可能不响应 xdotool 的键盘输入

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/malue-ai) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->