mirror of
https://github.com/yshui/picom.git
synced 2024-11-25 14:06:08 -05:00
c29e1a4c3d
Signed-off-by: Yuxuan Shui <yshuiv7@gmail.com>
114 lines
2.5 KiB
Text
114 lines
2.5 KiB
Text
= picom-trans(1)
|
|
Yuxuan Shui
|
|
:doctype: manpage
|
|
:mansource: picom
|
|
:manversion: {picom-version}
|
|
:manmanual: User Commands
|
|
|
|
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
|
|
--------
|
|
xref:picom.1.adoc[*picom*(1)], *xprop*(1), *xwininfo*(1)
|