Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
devilspie(1)							  devilspie(1)

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  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,  splash-
	      screen, 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 <ross@burtonini.com>.

								  devilspie(1)

NAME | SYNOPSIS | DESCRIPTION | ALLOWED SYMBOLS | BUGS | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=devilspie&sektion=1&manpath=FreeBSD+11.1-RELEASE+and+Ports>

home | help