File: devilspie.1

package info (click to toggle)
devilspie 0.23-2
  • links: PTS
  • area: main
  • in suites: bullseye, buster, jessie, jessie-kfreebsd, sid, stretch
  • size: 1,092 kB
  • sloc: ansic: 2,392; sh: 1,166; makefile: 60
file content (167 lines) | stat: -rw-r--r-- 4,801 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
.TH devilspie 1
.SH NAME
devilspie \- perform actions on windows as they are created

.SH SYNOPSIS
.B devilspie
.I [\fIOPTION\fR]...
.I "configuration-files..."

.SH "DESCRIPTION"
.BR devilspie
is a program which can detect windows as they are created, and perform
actions on them if they match as set of criteria.

The configuration files are a set of s-expressions.  For documentation and
examples, see /usr/share/doc/devilspie/.

Command-lines options:
.TP
\fB\-a\fR \fB\-\-apply\-to\-existing\fR
Apply to all existing windows instead of just new windows.
.TP
\fB\-d\fR \fB\-\-debug\fR
Output debug information

.SH "ALLOWED SYMBOLS"
In the input files, the following symbols are known by \fIdevilspie\fR:
.\"SYMBOL HELP BEGINS HERE
.TP
\fBis\fR
String equality, (is a b) means a is the same as b.
.TP
\fBcontains\fR
Substring, (contains haystack needle) means haystack contains needle.
.TP
\fBmatches\fR
Regexp matches, (matches str pattern) means the regexp pattern matches str.
.TP
\fBwindow_name\fR
Return the title of the current window (String).
.TP
\fBwindow_role\fR
Return the role (as determined by the WM_WINDOW_ROLE hint) of the current window (String).
.TP
\fBwindow_class\fR
Return the class of the current window (String).
.TP
\fBwindow_xid\fR
Return the X11 window id of the current window (Integer).
.TP
\fBapplication_name\fR
Return the application name (as determined by libwnck) of the current window (String).
.TP
\fBwindow_property\fR
Returns the given property of the window, e.g. pass "_NET_WM_STATE" (String).
.TP
\fBwindow_workspace\fR
Returns the workspace a window is on (Integer).
.TP
\fBdebug\fR
Debugging function, outputs the current window's title, name, role and geometry (Returns TRUE).
.TP
\fBprint\fR
Print args (without trailing \n, returns boolean).
.TP
\fBprintln\fR
Print args (with trailing \n, returns boolean).
.TP
\fBstr\fR
Transform parameters into strings and concat them.
.TP
\fBhex\fR
Transform the integer parameter into an unsigned hexadecimal string (with 0x prefix).
.TP
\fBgeometry\fR
Set position + size (as tring) of current window (returns boolean).
.TP
\fBfullscreen\fR
Make the current window fullscreen (returns TRUE).
.TP
\fBfocus\fR
Focus the current window (returns TRUE).
.TP
\fBcenter\fR
Center position of current window (returns boolean).
.TP
\fBmaximize\fR
Maximise the current window (returns TRUE).
.TP
\fBmaximize_vertically\fR
Maximise vertically the current window (returns TRUE).
.TP
\fBmaximize_horizontally\fR
Maximise horizontally the current window (returns TRUE).
.TP
\fBunmaximize\fR
Un-maximise the current window (returns TRUE).
.TP
\fBminimize\fR
Minimise the current window (returns TRUE).
.TP
\fBunminimize\fR
Un-minimise the current window (returns TRUE).
.TP
\fBshade\fR
Shade ("roll up") the current window (returns TRUE).
.TP
\fBunshade\fR
Un-shade ("roll down") the current window (returns TRUE).
.TP
\fBclose\fR
Close the current window (returns TRUE).
.TP
\fBpin\fR
Pin the current window to all workspaces (returns TRUE).
.TP
\fBunpin\fR
Unpin the current window from all workspaces (returns TRUE).
.TP
\fBstick\fR
Make the current window stick to all viewports (returns TRUE).
.TP
\fBunstick\fR
Unstick the window from viewports (returns TRUE).
.TP
\fBset_workspace\fR
Move the window to a specific workspace number, counting from 1 (returns boolean).
.TP
\fBset_viewport\fR
Move the window to a specific viewport number, counting from 1 (returns boolean).
.TP
\fBskip_pager\fR
Remove the current window from the window list (returns TRUE).
.TP
\fBskip_tasklist\fR
Remove the current window from the pager (returns TRUE).
.TP
\fBabove\fR
Set the current window to be above all normal windows (returns TRUE).
.TP
\fBbelow\fR
Set the current window to be below all normal windows (returns TRUE).
.TP
\fBdecorate\fR
Add the window manager decorations to the current window (returns boolean).
.TP
\fBundecorate\fR
Remove the window manager decorations from the current window (returns boolean).
.TP
\fBwintype\fR
Set the window type of the current window (returns boolean). Accepted values are: normal, dialog, menu, toolbar, splashscreen, utility, dock, desktop.
.TP
\fBopacity\fR
Change the opacity level (as integer in 0..100) of the current window (returns boolean).
.TP
\fBspawn_async\fR
Execute a command in the background (returns boolean). Command is given as a single string, or as a series of strings (similar to execl).
.TP
\fBspawn_sync\fR
Execute a command in the foreground (returns command output as string, or FALSE on error). Command is given as a single string, or as a series of strings (similar to execl).
.\"SYMBOL HELP ENDS HERE

.SH BUGS
This manpage is almost useless, as it was thrown together on a train.

.SH AUTHOR
This manual page was written by Ross Burton <ross@burtonini.com>.