EUCLID(1) General Commands Manual EUCLID(1) NAME euclid-wm - A highly flexible, minimal, dynamic, tiling window manager SYNOPSIS start-euclid euclid-wm (started directly euclid will not check for config files.) DESCRIPTION euclid (euclid-wm) aims to be a highly flexible tiling window manger, which allows easy management of large collections of windows entirely from the keyboard. USAGE Basic Concepts Euclid's state can be described as: * views. These are arranged in a series. Up to 9 of them are num- bered. They are composed of a set of visible windows (arranged in tracks ) and minimized windows (stored in a stack ). * tracks are either rows or columns (the orientation can be toggled at runtime), that contain visible windows. * stack is a set of minimized windows, associated with a view, which can be viewed at the bottom of the screen in the form of a box con- taining their titles. All bindings are prefaced by a mod ("M", defaults to mod1, i.e., alt). Starting Programs M + <enter> - start run dialogue (by default, dmenu). NB: this takes keyboard focus as long as it is open; Once it is opened you must ei- ther select a command (with enter) or exit the dialog (with esc). M + <shift> + <enter> - start terminal (default: xterm). Basic Window Manipulation M + h/j/k/l - move focus left/down/up/right M + H/J/K/L - move focused window left/down/up/right M + u/i/o/p - resize window: move lower right corner left/down/up/right M + <esc> - close currently focused window M + <shift> + <esc> - kill window (for unresponsive programs) The Stack The stack maintains its own focus; The currently focused item can be iden- tified by its blue color. M + <space> - Toggle the stack's visibility M + . - Move the currently focused window to the stack (i.e., mini- mize it) M + , - Move the currently focused stack item to the main area (i.e., restore it) M + / - Swap currently focused stack item and currently focused main item. M + ;/' - Move stack focus up/down M + <shift> + ;/' - Shift the stack item up/down in the stack Manipulating Views M + n/m - Move to the previous/next view M + N/M - Move currently focused window to the previous/next view M + 1-9 - Move to the 1-9th view M + <shift> + 1-9 - Move the currently focused window to the 1-9th view M + 0 - Move to the last populated view (regardless of its number). M + <shift> + 0 - Move the currently focused window to the last pop- ulated view. A note on the order and numbering of views: The enumeration is not strictly accurate; View 9 may not be the 9th view. Specifically, once a view is assigned a number it retains that number regardless of where it actually falls in the list of views. This is so that ac- cessing views based on their number remains consistent. The first view, created when euclid starts, is view 1; Going to the previous view makes a new view, but view 1 remains the original one, even though by counting it is now actually the second. Likewise, if one starts on view 1, and goes to view 9, view 9 remains view 9, even though it may actually be the second view. However, numbered views are always in order. So if one starts with view 1 and creates view 9, then creates view 8, view 8 will be placed between views 1 and 9. Other M + <shift> + <space> - Change to fullscreen mode. Notes on fullscreen mode: In fullscreen mode the stack is disabled: widows cannot be added or taken out. j/k will cycle through all win- dows on the view in a linear way. If the view is in fullscreen mode because a window triggered fullscreen, and that window closes, eu- clid will switch back to its normal tiled layout; if the user manu- ally triggered fullscreen mode, euclid will remain in fullscreen. M + <tab> - toggle the orientation of the tracks (vertical or hori- zontal layout) M + Q - quit euclid. M + r - reload config file in place. M + <shift> + ? - search a list of all windows presented in dmenu. M + PgUp/PgDown - when multiple screen is in use, switch focus to previous/next screen. FILES On startup euclid will look for $XDG_CONFIG_HOME/euclid-wm/euclid- wm.conf If $XDG_CONFIG_HOME is not defined it will look for $HOME/.config/euclid-wm/euclid-wm.conf If euclid-wm.conf is found, euclid will override its default settings with those found in the file. A sample config file euclid-wm.conf.sample should have come with euclid. If euclid is started with start-euclid the start-euclid will check to see whether these files are installed for the current user, and if not, it will create them from the system defaults. The default is kept in /usr/share/euclid-wm/ At startup euclid will also (try to) run the script euclidrc in the same directory (e.g., ~/.config/euclid-wm/euclidrc). This is meant as a place for the user to add any commands he would like run at startup. A default is stored in /usr/share/euclid-wm/ BUGS Please go to http://code.google.com/p/euclid-wm/issues/list to see the most recent set of known issues, to report new bugs, or request features. You may also submit reports to the mailing list: <euclid- wm@googlegroups.com>. 15-8-2010 EUCLID(1)
NAME | SYNOPSIS | DESCRIPTION | USAGE | FILES | BUGS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=euclid-wm&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>