2004-09-09 11:27:16 +08:00
|
|
|
.ds q \N'34'
|
2011-11-07 08:20:45 +08:00
|
|
|
.TH compton 1
|
2012-10-22 21:20:43 +08:00
|
|
|
|
2004-09-09 11:27:16 +08:00
|
|
|
.SH NAME
|
2011-11-07 08:20:45 +08:00
|
|
|
compton \- a compositor for X11
|
2012-10-22 21:20:43 +08:00
|
|
|
|
2004-09-09 11:27:16 +08:00
|
|
|
.SH SYNOPSIS
|
2012-10-22 21:20:43 +08:00
|
|
|
.B compton
|
|
|
|
[\-d display] [\-r radius] [\-o opacity] [\-l left\-offset]
|
|
|
|
[\-t top\-offset] [\-i opacity] [\-e opacity] [\-cCfFSdG]
|
|
|
|
[\-\-config path] [\-\-shadow\-red value]
|
|
|
|
[\-\-shadow\-green value] [\-\-shadow\-blue value]
|
|
|
|
[\-\-inactive\-opacity\-override] [\-\-inactive\-dim value]
|
|
|
|
[\-\-mark\-wmwin\-focused] [\-\-shadow\-exclude condition]
|
|
|
|
[\-\-mark\-ovredir\-focused] [\-\-no\-fading\-openclose]
|
|
|
|
[\-\-shadow\-ignore\-shaped] [\-\-detect\-round\-corners]
|
|
|
|
|
2004-09-09 11:27:16 +08:00
|
|
|
.SH DESCRIPTION
|
2011-11-07 08:20:45 +08:00
|
|
|
.B compton
|
|
|
|
is a compositor based on Dana Jansens' version of xcompmgr (which itself was
|
|
|
|
written by Keith Packard). It includes many improvements over the original
|
|
|
|
xcompmgr, including window frame opacity, inactive window transparency,
|
|
|
|
and shadows on argb windows.
|
2012-10-22 21:20:43 +08:00
|
|
|
|
2004-09-09 11:27:16 +08:00
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
2004-09-10 13:55:19 +08:00
|
|
|
.BI \-d\ display
|
2012-10-22 20:41:24 +08:00
|
|
|
Which display should be managed.
|
2004-09-10 13:55:19 +08:00
|
|
|
.TP
|
2004-09-18 08:13:15 +08:00
|
|
|
.BI \-r\ radius
|
2012-10-22 20:41:24 +08:00
|
|
|
The blur radius for shadows. (default 12)
|
2004-09-18 08:13:15 +08:00
|
|
|
.TP
|
|
|
|
.BI \-o\ opacity
|
2012-10-22 20:41:24 +08:00
|
|
|
The translucency for shadows. (default .75)
|
2004-09-18 08:13:15 +08:00
|
|
|
.TP
|
|
|
|
.BI \-l\ left-offset
|
2012-10-22 20:41:24 +08:00
|
|
|
The left offset for shadows. (default -15)
|
2004-09-18 08:13:15 +08:00
|
|
|
.TP
|
|
|
|
.BI \-t\ top-offset
|
2012-10-22 20:41:24 +08:00
|
|
|
The top offset for shadows. (default -15)
|
2004-09-18 08:13:15 +08:00
|
|
|
.TP
|
2004-09-23 15:17:48 +08:00
|
|
|
.BI \-I\ fade-in-step
|
2012-10-22 20:41:24 +08:00
|
|
|
Opacity change between steps while fading in. (default 0.028)
|
2004-09-23 15:17:48 +08:00
|
|
|
.TP
|
|
|
|
.BI \-O\ fade-out-step
|
2012-10-22 20:41:24 +08:00
|
|
|
Opacity change between steps while fading out. (default 0.03)
|
2004-09-23 15:17:48 +08:00
|
|
|
.TP
|
2012-10-22 20:41:24 +08:00
|
|
|
.BI \-D\ fade-delta-time
|
|
|
|
The time between steps in a fade in milliseconds. (default 10)
|
2004-09-23 15:17:48 +08:00
|
|
|
.TP
|
2012-10-22 20:41:24 +08:00
|
|
|
.BI \-m\ opacity
|
|
|
|
The opacity for menus. (default 1.0)
|
2004-09-09 11:27:16 +08:00
|
|
|
.TP
|
2012-10-22 20:41:24 +08:00
|
|
|
.BI \-c
|
|
|
|
Enabled client-side shadows on windows.
|
2004-09-09 11:27:16 +08:00
|
|
|
.TP
|
2004-09-10 13:55:19 +08:00
|
|
|
.BI \-C
|
2012-10-22 20:41:24 +08:00
|
|
|
Avoid drawing shadows on dock/panel windows.
|
2004-09-10 13:55:19 +08:00
|
|
|
.TP
|
2012-10-22 20:41:24 +08:00
|
|
|
.BI \-z
|
|
|
|
Zero the part of the shadow's mask behind the window (experimental).
|
2012-02-27 00:35:17 +08:00
|
|
|
.TP
|
2012-10-22 20:41:24 +08:00
|
|
|
.BI \-f
|
|
|
|
Fade windows in/out when opening/closing and when opacity
|
|
|
|
changes, unless --no-fading-openclose is used.
|
2004-09-10 13:55:19 +08:00
|
|
|
.TP
|
2012-10-22 20:41:24 +08:00
|
|
|
.BI \-F
|
|
|
|
Equals -f. Deprecated.
|
2012-02-27 01:02:42 +08:00
|
|
|
.TP
|
2011-11-07 08:20:45 +08:00
|
|
|
.BI \-i\ opacity
|
2012-10-22 20:41:24 +08:00
|
|
|
Opacity of inactive windows. (0.1 - 1.0)
|
2011-11-07 08:20:45 +08:00
|
|
|
.TP
|
|
|
|
.BI \-e\ opacity
|
2012-10-22 20:41:24 +08:00
|
|
|
Opacity of window titlebars and borders. (0.1 - 1.0)
|
|
|
|
.TP
|
|
|
|
.BI \-G
|
|
|
|
Don't draw shadows on DND windows
|
|
|
|
.TP
|
2012-10-22 21:20:43 +08:00
|
|
|
.BI \-b
|
2012-10-22 20:41:24 +08:00
|
|
|
Daemonize process.
|
2011-11-07 08:20:45 +08:00
|
|
|
.TP
|
2004-09-10 13:55:19 +08:00
|
|
|
.BI \-S
|
2012-10-22 20:41:24 +08:00
|
|
|
Enable synchronous operation (for debugging).
|
|
|
|
.TP
|
|
|
|
.BI \--config\ path
|
|
|
|
Look for configuration file at the path.
|
|
|
|
.TP
|
|
|
|
.BI \--shadow-red\ value
|
|
|
|
Red color value of shadow (0.0 - 1.0, defaults to 0).
|
|
|
|
.TP
|
|
|
|
.BI \--shadow-green\ value
|
|
|
|
Green color value of shadow (0.0 - 1.0, defaults to 0).
|
|
|
|
.TP
|
|
|
|
.BI \--shadow-blue\ value
|
|
|
|
Blue color value of shadow (0.0 - 1.0, defaults to 0).
|
|
|
|
.TP
|
|
|
|
.BI \--inactive-opacity-override
|
|
|
|
Inactive opacity set by -i overrides value of _NET_WM_OPACITY.
|
|
|
|
.TP
|
|
|
|
.BI \--inactive-dim\ value
|
|
|
|
Dim inactive windows. (0.0 - 1.0, defaults to 0)
|
|
|
|
.TP
|
|
|
|
.BI \--mark-wmwin-focused
|
|
|
|
Try to detect WM windows and mark them as active.
|
|
|
|
.TP
|
|
|
|
.BI \--shadow-exclude\ condition
|
|
|
|
Exclude conditions for shadows.
|
|
|
|
.TP
|
|
|
|
.BI \--mark-ovredir-focused
|
|
|
|
Mark over-redirect windows as active.
|
|
|
|
.TP
|
|
|
|
.BI \--no-fading-openclose
|
|
|
|
Do not fade on window open/close.
|
|
|
|
.TP
|
|
|
|
.BI \--shadow-ignore-shaped
|
|
|
|
Do not paint shadows on shaped windows.
|
|
|
|
.TP
|
|
|
|
.BI \--detect-rounded-corners
|
|
|
|
Try to detect windows with rounded corners and don't consider
|
|
|
|
them shaped windows.
|
|
|
|
.TP
|
|
|
|
.BI Format\ of\ a\ condition:
|
|
|
|
|
|
|
|
condition = <target>:<type>[<flags>]:<pattern>
|
|
|
|
|
|
|
|
<target> is one of "n" (window name), "i" (window class
|
|
|
|
instance), and "g" (window general class)
|
|
|
|
|
|
|
|
<type> is one of "e" (exact match), "a" (match anywhere),
|
|
|
|
"s" (match from start), "w" (wildcard), and "p" (PCRE
|
|
|
|
regular expressions, if compiled with the support).
|
|
|
|
|
|
|
|
<flags> could be a series of flags. Currently the only defined
|
|
|
|
flag is "i" (ignore case).
|
|
|
|
|
|
|
|
<pattern> is the actual pattern string.
|
|
|
|
|
2004-09-09 11:27:16 +08:00
|
|
|
.SH BUGS
|
2011-11-07 12:03:18 +08:00
|
|
|
Please report any you find to https://github.com/chjj/compton.
|
2012-10-22 21:20:43 +08:00
|
|
|
|
2004-09-09 11:27:16 +08:00
|
|
|
.SH AUTHORS
|
2011-11-07 12:03:18 +08:00
|
|
|
xcompmgr, originally written by Keith Packard, with contributions from
|
2011-11-07 08:20:45 +08:00
|
|
|
Matthew Allum, Eric Anholt, Dan Doel, Thomas Luebking, Matthew Hawn,
|
|
|
|
Ely Levy, Phil Blundell, and Carl Worth.
|
2012-10-22 20:41:24 +08:00
|
|
|
Compton by Christopher Jeffrey, based on Dana Jansens' original work,
|
|
|
|
with numerous contributions from Richard Grenville.
|
2012-10-22 21:20:43 +08:00
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
.BR compton-trans (1)
|