Scroll to navigation

PICOM-TRANS(1) User Commands PICOM-TRANS(1)

NAME

picom-trans - an opacity setter tool

SYNOPSIS

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

DESCRIPTION

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.

SEE ALSO

picom(1), xprop(1), xwininfo(1)

03/15/2024 picom v10