'\" t .\" Title: picom-trans .\" Author: Yuxuan Shui .\" Generator: Asciidoctor 2.0.23 .\" Date: 2024-11-13 .\" Manual: User Commands .\" Source: picom .\" Language: English .\" .TH "PICOM\-TRANS" "1" "2024-11-13" "picom" "User Commands" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 .nh .ad l .de URL \fI\\$2\fP <\\$1>\\$3 .. .als MTO URL .if \n[.g] \{\ . mso www.tmac . am URL . ad l . . . am MTO . ad l . . . LINKSTYLE blue R < > .\} .SH "NAME" picom-trans \- an opacity setter tool .SH "SYNOPSIS" .sp \fBpicom\-trans\fP [\-w \fIWINDOW_ID\fP] [\-n \fIWINDOW_NAME\fP] [\-c] [\-s] \fIOPACITY\fP .SH "DESCRIPTION" .sp \fBpicom\-trans\fP is a bash script that sets \fI_NET_WM_WINDOW_OPACITY\fP attribute of a window using standard X11 command\-line utilities, including \fBxprop\fP(1) and \fBxwininfo\fP(1). It is similar to \fBtransset\fP(1) or \fBtransset\-df\fP(1). .SH "OPTIONS" .sp \fB\-w\fP, \fB\-\-window\fP=\fIWINDOW_ID\fP .RS 4 Specify the window id of the target window. .RE .sp \fB\-n\fP, \fB\-\-name\fP=\fIWINDOW_NAME\fP .RS 4 Specify and try to match a window name. .RE .sp \fB\-c\fP, \fB\-\-current\fP .RS 4 Specify the currently active window as target. Only works if EWMH \*(Aq_NET_ACTIVE_WINDOW\*(Aq property exists on root window. .RE .sp \fB\-s\fP, \fB\-\-select\fP .RS 4 Select target window with mouse cursor. This is the default if no window has been specified. .RE .sp \fB\-o\fP, \fB\-\-opacity\fP=\fIOPACITY\fP .RS 4 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\(cqs current opacity instead. .RE .sp \fB\-g\fP, \fB\-\-get\fP .RS 4 Print the target window\(cqs opacity instead of setting it. .RE .sp \fB\-d\fP, \fB\-\-delete\fP .RS 4 Delete opacity of the target window instead of setting it. .RE .sp \fB\-t\fP, \fB\-\-toggle\fP .RS 4 Toggle the target window\(cqs opacity: Set opacity if not already set, and delete if already set. .RE .sp \fB\-r\fP, \fB\-\-reset\fP .RS 4 Reset opacity for all windows instead of setting it. .RE .SH "EXAMPLES" .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Set the opacity of the window with specific window ID to 75%: .sp .if n .RS 4 .nf .fam C picom\-trans \-w "$WINDOWID" 75 .fam .fi .if n .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Set the opacity of the window with the name "urxvt" to 75%: .sp .if n .RS 4 .nf .fam C picom\-trans \-n "urxvt" 75 .fam .fi .if n .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Set current window to opacity of 75%: .sp .if n .RS 4 .nf .fam C picom\-trans \-c 75 .fam .fi .if n .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Select target window and set opacity to 75%: .sp .if n .RS 4 .nf .fam C picom\-trans \-s 75 .fam .fi .if n .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Increment opacity of current active window by 5%: .sp .if n .RS 4 .nf .fam C picom\-trans \-c +5 .fam .fi .if n .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Decrement opacity of current active window by 5%: .sp .if n .RS 4 .nf .fam C picom\-trans \-c \-\- \-5 .fam .fi .if n .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Delete current window\(cqs opacity: .sp .if n .RS 4 .nf .fam C picom\-trans \-c \-\-delete .fam .fi .if n .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Toggle current window\(cqs opacity between 90 and unset .sp .if n .RS 4 .nf .fam C picom\-trans \-c \-\-toggle 90 .fam .fi .if n .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Reset all windows: .sp .if n .RS 4 .nf .fam C picom\-trans \-\-reset .fam .fi .if n .RE .RE .SH "BUGS" .sp Please submit bug reports to \c .URL "https://github.com/yshui/picom" "" "." .SH "SEE ALSO" .sp \fBpicom\fP(1), \fBxprop\fP(1), \fBxwininfo\fP(1) .SH "AUTHOR" .sp Yuxuan Shui