NAME
devilspie - perform actions on windows as they are created
SYNOPSIS
devilspie [OPTION]... configuration-files...
DESCRIPTION
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:
- -a --apply-to-existing
-
Apply to all existing windows instead of just new windows.
- -d --debug
-
Output debug information
- -l --list-symbols
-
List available symbols supported in input files.
- -s symname --symbol-doc=symname
-
Get detailed help on symbol symname ('all' for all symbols).
ALLOWED SYMBOLS
In the input files, the following symbols are known by devilspie:
- is
-
String equality, (is a b) means a is the same as b.
- contains
-
Substring, (contains haystack needle) means haystack contains needle.
- matches
-
Regexp matches, (matches str pattern) means the regexp pattern matches str.
- window_name
-
Return the title of the current window (String).
- window_role
-
Return the role (as determined by the WM_WINDOW_ROLE hint) of the current window (String).
- window_class
-
Return the class of the current window (String).
- window_xid
-
Return the X11 window id of the current window (Integer).
- application_name
-
Return the application name (as determined by libwnck) of the current window (String).
- window_property
-
Returns the given property of the window, e.g. pass "_NET_WM_STATE" (String).
- window_workspace
-
Returns the workspace a window is on (Integer).
- debug
-
Debugging function, outputs the current window's title, name, role and geometry (Returns TRUE).
-
Print args (without trailing 0 returns boolean).
- println
-
Print args (with trailing 0 returns boolean).
- str
-
Transform parameters into strings and concat them.
- hex
-
Transform the integer parameter into an unsigned hexadecimal string (with 0x prefix).
- geometry
-
Set position + size (as tring) of current window (returns boolean).
- fullscreen
-
Make the current window fullscreen (returns TRUE).
- focus
-
Focus the current window (returns TRUE).
- center
-
Center position of current window (returns boolean).
- maximize
-
Maximise the current window (returns TRUE).
- maximize_vertically
-
Maximise vertically the current window (returns TRUE).
- maximize_horizontally
-
Maximise horizontally the current window (returns TRUE).
- unmaximize
-
Un-maximise the current window (returns TRUE).
- minimize
-
Minimise the current window (returns TRUE).
- unminimize
-
Un-minimise the current window (returns TRUE).
- shade
-
Shade ("roll up") the current window (returns TRUE).
- unshade
-
Un-shade ("roll down") the current window (returns TRUE).
- close
-
Close the current window (returns TRUE).
- pin
-
Pin the current window to all workspaces (returns TRUE).
- unpin
-
Unpin the current window from all workspaces (returns TRUE).
- stick
-
Make the current window stick to all viewports (returns TRUE).
- unstick
-
Unstick the window from viewports (returns TRUE).
- set_workspace
-
Move the window to a specific workspace number, counting from 1 (returns boolean).
- set_viewport
-
Move the window to a specific viewport number, counting from 1 (returns boolean).
- skip_pager
-
Remove the current window from the window list (returns TRUE).
- skip_tasklist
-
Remove the current window from the pager (returns TRUE).
- above
-
Set the current window to be above all normal windows (returns TRUE).
- below
-
Set the current window to be below all normal windows (returns TRUE).
- decorate
-
Add the window manager decorations to the current window (returns boolean).
- undecorate
-
Remove the window manager decorations from the current window (returns boolean).
- wintype
-
Set the window type of the current window (returns boolean). Accepted values are: normal, dialog, menu, toolbar, splashscreen, utility, dock, desktop.
- opacity
-
Change the opacity level (as integer in 0..100) of the current window (returns boolean).
- spawn_async
-
Execute a command in the background (returns boolean). Command is given as a single string, or as a series of strings (similar to execl).
- spawn_sync
-
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).
BUGS
This manpage is almost useless, as it was thrown together on a train.
AUTHOR
This manual page was written by Ross Burton <[email protected]>.