picom-trans - Man Page

an opacity setter tool

Examples (TL;DR)

Set the currently focused window opacity to a specific percentage: picom-trans --current --opacity 90
Set the opacity of a window with a specific name: picom-trans --name Firefox --opacity 90
Set the opacity of a specific window selected via mouse cursor: picom-trans --select --opacity 90
Toggle the opacity of a specific window: picom-trans --name Firefox --toggle

Synopsis

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

picom-trans is a bash script that sets _NET_WM_WINDOW_OPACITY attribute of a window using standard X11 command-line utilities, including xprop(1) and xwininfo(1). It is similar to transset(1) or transset-df(1).

Options

-w, --window=WINDOW_ID: Specify the window id of the target window.
-n, --name=WINDOW_NAME: Specify and try to match a window name.
-c, --current: Specify the currently active window as target. Only works if EWMH _NET_ACTIVE_WINDOW property exists on root window.
-s, --select: Select target window with mouse cursor. This is the default if no window has been specified.
-o, --opacity=OPACITY: Specify the new opacity value for the window. This value can be anywhere from 1-100. If it is prefixed with a plus or minus (+/-), this will increment or decrement from the target window’s current opacity instead.
-g, --get: Print the target window’s opacity instead of setting it.
-d, --delete: Delete opacity of the target window instead of setting it.
-t, --toggle: Toggle the target window’s opacity: Set opacity if not already set, and delete if already set.
-r, --reset: Reset opacity for all windows instead of setting it.

Examples

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
```
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

Please submit bug reports to https://github.com/yshui/picom.

Referenced By

picom(1).

02/13/2024 picom v11