1PICOM-TRANS(1)                   User Commands                  PICOM-TRANS(1)
2
3
4

NAME

6       picom-trans - an opacity setter tool
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

18       -w, --window=WINDOW_ID
19           Specify the window id of the target window.
20
21       -n, --name=WINDOW_NAME
22           Specify and try to match a window name.
23
24       -c, --current
25           Specify the currently active window as target. Only works if EWMH
26           _NET_ACTIVE_WINDOW property exists on root window.
27
28       -s, --select
29           Select target window with mouse cursor. This is the default if no
30           window has been specified.
31
32       -o, --opacity=OPACITY
33           Specify the new opacity value for the window. This value can be
34           anywhere from 1-100. If it is prefixed with a plus or minus (+/-),
35           this will increment or decrement from the target window’s current
36           opacity instead.
37
38       -g, --get
39           Print the target window’s opacity instead of setting it.
40
41       -d, --delete
42           Delete opacity of the target window instead of setting it.
43
44       -t, --toggle
45           Toggle the target window’s opacity: Set opacity if not already set,
46           and delete if already set.
47
48       -r, --reset
49           Reset opacity for all windows instead of setting it.
50

EXAMPLES

52       •   Set the opacity of the window with specific window ID to 75%:
53
54               picom-trans -w "$WINDOWID" 75
55
56       •   Set the opacity of the window with the name "urxvt" to 75%:
57
58               picom-trans -n "urxvt" 75
59
60       •   Set current window to opacity of 75%:
61
62               picom-trans -c 75
63
64       •   Select target window and set opacity to 75%:
65
66               picom-trans -s 75
67
68       •   Increment opacity of current active window by 5%:
69
70               picom-trans -c +5
71
72       •   Decrement opacity of current active window by 5%:
73
74               picom-trans -c -- -5
75
76       •   Delete current window’s opacity:
77
78               picom-trans -c --delete
79
80       •   Toggle current window’s opacity between 90 and unset
81
82               picom-trans -c --toggle 90
83
84       •   Reset all windows:
85
86               picom-trans --reset
87

BUGS

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

SEE ALSO

92       picom(1), xprop(1), xwininfo(1)
93
94
95
96picom v10                         01/20/2023                    PICOM-TRANS(1)
Impressum