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
       o   Set the opacity of the window with specific window ID to 75%:

               picom-trans -w "$WINDOWID" 75

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

               picom-trans -n "urxvt" 75

       o   Set current window to opacity of 75%:

               picom-trans -c 75

       o   Select target window and set opacity to 75%:

               picom-trans -s 75

       o   Increment opacity of current active window by 5%:

               picom-trans -c +5

       o   Decrement opacity of current active window by 5%:

               picom-trans -c -- -5

       o   Delete current window's opacity:

               picom-trans -c --delete

       o   Toggle current window's opacity between 90 and unset

               picom-trans -c --toggle 90

       o   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)

picom vgit-89c2c                  02/13/2024                    PICOM-TRANS(1)