PICOM-TRANS(1)

💅 picom-trans — the opacity setter tool, bestie edition

okay so. you know how some windows are just too much? too loud, too solid, too there? yeah. picom-trans is the girl who walks in and goes "let's turn that down a lil" ✨ She lives in your picom-trans(1) manual page and she is SO ready.

---

🌸 NAME 🌸

picom-trans — an opacity setter tool 💖 (yes that's literally the whole name, she's mysterious like that)

---

🎀 SYNOPSIS 🎀

picom-trans [-w WINDOW_ID] [-n WINDOW_NAME] [-c] [-s] OPACITY

look at her. gorgeous. effortless. barely even trying 💅

---

🦋 DESCRIPTION 🦋

so picom-trans is a bash script (yes bestie, a script, and she still slays) that sets the _NET_WM_WINDOW_OPACITY attribute of a window using standard X11 command-line utilities, including xprop(1) and xwininfo(1). no cap, she's out here doing real work with the tools already on your system.

if you've ever met transset(1) or transset-df(1) — it's giving the same energy. same vibe, iconic lineage. 👑

---

✨ OPTIONS ✨

the way she has so many flags and every single one eats 😭

• -w, --window=WINDOW_ID — tells her the window id of the target window. like, "her. that one. that's the one." 🎯
• -n, --name=WINDOW_NAME — give her a window name and she'll try to match it. (try! she's doing her best and honestly her best is great 🫶)
• -c, --current — targets the currently active window. periodt. BUT — only works if the EWMH '_NET_ACTIVE_WINDOW' property exists on the root window. if it's not there, she can't find the main character, sorry 💀
• -s, --select — pick the target window with your mouse cursor 🖱️✨ you literally point at it like a wand. this is the default if no window has been specified.
• -o, --opacity=OPACITY — sets the new opacity value for the window. it can be anywhere from 1-100. AND here's the cute part: if it's prefixed with a plus or minus (+/-), she'll increment or decrement from the target window's current opacity instead of setting it fresh. math but make it fashion 🍓
• -g, --get — prints the target window's opacity instead of setting it. she's not changing anything, just reading you to filth (lovingly) 📖
• -d, --delete — deletes the opacity of the target window instead of setting it. gone. bye. the window is opaque again and unbothered 🧚
• -t, --toggle — toggles the target window's opacity: sets opacity if it's not already set, and deletes it if it is. flip-flop queen 🌈
• -r, --reset — resets opacity for all windows instead of setting it. every window. all of them. group therapy 💖

---

🌈 EXAMPLES 🌈

here's where she really shows out, no notes:

• Set the opacity of the window with specific window ID to 75%:

picom-trans -w "$WINDOWID" 75

• Set the opacity of the window with the name "urxvt" to 75%:

picom-trans -n "urxvt" 75

• Set current window to opacity of 75%:

picom-trans -c 75

• Select target window and set opacity to 75%:

picom-trans -s 75

• Increment opacity of current active window by 5%:

picom-trans -c +5

• Decrement opacity of current active window by 5%:

picom-trans -c -- -5

👀 notice the -- before the -5? yeah. that's her being smart. the dash is a negative number, not another flag. iykyk.

• Delete current window's opacity:

picom-trans -c --delete

• Toggle current window's opacity between 90 and unset:

picom-trans -c --toggle 90

• Reset all windows:

picom-trans --reset

---

💀 BUGS 💀

found a bug? bestie, do NOT suffer in silence. please submit bug reports to https://github.com/yshui/picom. she wants to know. she wants to grow. 🌱

---

👑 SEE ALSO 👑

• picom(1)
• xprop(1)
• xwininfo(1)

the whole friend group honestly 💜

---

🫶 AUTHOR 🫶

Yuxuan Shui — the legend, the blueprint, the moment. 🌟

---

okay that's the whole page, bestie, you're officially fluent in picom-trans. this was the picom manual, dated 2026-02-07 — go make your windows translucent and your life cute. mwah 💋✨