.ds q \N'34'
.TH compton\-trans 1

.SH NAME
compton\-trans \- an opacity setter tool

.SH SYNOPSIS
.nf
.B compton-trans [-w WINDOW_ID] [-n WINDOW_NAME] [-c] [-s] OPACITY
.fi

.SH DESCRIPTION
.B compton-trans
is a bash script that sets _NET_WM_WINDOW_OPACITY only using standard
command-line utilities for X11, including xprop(1) and xwininfo(1).
It is similar to other utilities like transset(1) or transset-df(1).

.SH OPTIONS
.TP
.BI \-w\ window\-id
Specify the window id to target.
.TP
.BI \-n\ window\-name
Specify and try to match a window name.
.TP
.BI \-c
Specify the current window as a target.
.TP
.BI \-s
Select target window with mouse cursor.
This is the default if no window has been specified.
.TP
.BI \-o\ 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.

.SH EXAMPLES
.TP
Set window id to opacity of 75%.
compton-trans -w "$WINDOWID" 75
.TP
Set window name, "urxvt", to opacity of 75%.
compton-trans -n "urxvt" 75
.TP
Set current window to opacity of 75%.
compton-trans -c 75
.TP
Select target window and set opacity to 75%.
compton-trans -s 75
.TP
Increment current window opacity by 5%.
compton-trans -c +5
.TP
Decrement current window opacity by 5%.
compton-trans -c -- -5

.SH BUGS
Please report any you find to https://github.com/chjj/compton.

.SH AUTHORS
Christopher Jeffrey (https://github.com/chjj)

.SH SEE ALSO
.BR compton(1),
.BR xprop(1),
.BR xwininfo(1)