XDO(1)

okay bestie, welcome to the xdo manual page — XDO(1), section 1 of the Xdo Manual 💖

💖 NAME 💖

xdo — perform actions on windows. periodt.

✨ SYNOPSIS ✨

xdo ACTION [OPTIONS] [WID ...]

that's the whole shape of it, no cap.

🌸 DESCRIPTION 🌸

Apply the given action to the given windows.

If no window IDs and no options are given, the action applies to the focused window. 💅

👑 ACTIONS 👑

okay so these are the moves you can pull, bestie:

• close — close the window.
• kill — kill the client.
• hide — unmap the window.
• show — map the window.
• raise — raise the window.
• lower — lower the window.
• below — put the window below the target (see -t).
• above — put the window above the target (see -t).
• move — move the window.
• resize — resize the window.
• activate — activate the window.
• id — print the window’s ID.
• pid — print the window’s pid.
• key_press, key_release — simulate a key press/release event.
• button_press, button_release — simulate a button press/release event.
• pointer_motion — simulate a pointer motion event.
• -h — print the synopsis and exit.
• -v — print the version and exit.

🎀 OPTIONS 🎀

When options are provided, the action applies to all the children of the root window that match the comparisons implied by the options in relation to the focused window. got it? got it. 💅

• -r — distinct ID.
• -c — same class.
• -C — distinct class.
• -d — same desktop.
• -D — distinct desktop.
• -n INSTANCE_NAME — the window has the given instance name.
• -N CLASS_NAME — the window has the given class name.
• -a WM_NAME — the window has the given wm name.
• -t WID — the target window for the below and above actions.
• -p PID — the window has the given pid.
• -k CODE — use the given code for the key_press, key_release, button_press and button_release actions.
• -x [±]PIXELS — window x coordinate (or delta) for the move and pointer_motion action.
• -y [±]PIXELS — window y coordinate (or delta) for the move and pointer_motion action.
• -w [±]PIXELS — window width (or delta) for the resize action.
• -h [±]PIXELS — window height (or delta) for the resize action. yes bestie, -h is also the help action up in ACTIONS — context is everything 💀
• -m — wait for the existence of a matching window.
• -s — handle symbolic desktop numbers.

🌈 EXAMPLES 🌈

vibe check: here are the exact moves, copy-paste ready.

Close the focused window:

xdo close

Close all the windows having the same class as the focused window:

xdo close -c

Hide all the windows of the current desktop except the focused window:

xdo hide -dr

Activate the window which ID is 0x00800109:

xdo activate 0x00800109

Send fake key press/release events with keycode 46 to the focused window:

xdo key_press -k 46; sleep 0.2; xdo key_release -k 46

Xdo 0.5.7, dated 09/18/2017 — XDO(1), signing off. mwah 💖