.TH NOTION 1 .SH NAME Notion - an X11 window manager .SH SYNOPSIS .B notion .I "[options]" .SH "DESCRIPTION" Notion is a tiling tabbed window manager designed with keyboard users in mind. .SH "OPTIONS" .TP .B \-display host:display.screen X display to manage .TP .B \-conffile configfile Configuration file to use instead of default .TP .B \-searchdir dir Directory to search for configuration files and other scripts .TP .B \-oneroot On X servers with multiple (traditional non-Xinerama) screens, manage only default screen (root window), not all, as given by the \-display option or in the DISPLAY environment variable. .TP .B \-session session_name Set session name. This option affects where workspace and other save files are put (~/.notion/session_name if option set). .TP .B \-help Show help on command line options .TP .B \-version Show version .TP .B \-about Show about text (version, author, license) .SH BASIC CONCEPTS This section is an overview of the types objects that appear on an X display managed by Notion and their relationships in a standard setup. This information is necessary to understand the operations and availability of the different key bindings explained below. For a more detailed explanation, needed for writing custom bindings configuration files, see the additional documentation available from the Notion Web page. The top-level objects that matter in the case at hand are \fBscreens\fP. They correspond to physical screens. Screens contain \fBworkspaces\fP (which are a kind of \fBgroup\fP), and \fBclient windows\fP put into full screen mode. These objects are \fBmultiplexed\fP in the sense that only one can be displayed at a time. Workspaces themselves may contain \fBtilings\fP and detached/floating \fBframes\fP. A workspace containing no tilings and only detached/floating windows is also called a \fBfloating workspace\fP. Tilings themselves contain \fBframes\fP tiled to fill the screen, and possibly a statusbar or dock. Akin to screens, frames multiplex other objects, but in this case mostly client window \fBgroups\fP. Most of the time, frames are the only trace of Notion you see on the screen. Frames may have border decorations, and they have a \fBtab\fP for each multiplexed object. \fBQueries\fP are boxes that appear at the bottoms of frames or screens to ask you for textual input to execute an action that depends on it. Most queries support tab-completion. .SH BINDINGS These are the default key and pointer bindings. Below, \fBMod4\fP refers to the modifier used by Notion. \fBMod4\fP is the default, but this can be configured by setting \fBMETA\fP in the configuration. The particular key that is interpreted as \fBMod4\fP depends on your system. On Xorg-based systems it is usually bound to the \fBwindows\fP key. The \fIxmodmap(1x)\fP tool can be used to get/set which key codes correspond to which modifiers, and the \fIxev(1x)\fP tool can be used to see what codes are generated by particular keys. The string in square brackets after a binding group heading below indicates the module that whose configuration file defines these bindings. .SS Globally available bindings .TP .B Mod4+1 Switch to object 0 (workspace, full screen client window) within current screen. .TP .B Mod4+2 Switch to object 1 (workspace, full screen client window) within current screen. .TP .B Mod4+3 Switch to object 2 (workspace, full screen client window) within current screen. .TP .B Mod4+4 Switch to object 3 (workspace, full screen client window) within current screen. .TP .B Mod4+5 Switch to object 4 (workspace, full screen client window) within current screen. .TP .B Mod4+6 Switch to object 5 (workspace, full screen client window) within current screen. .TP .B Mod4+7 Switch to object 6 (workspace, full screen client window) within current screen. .TP .B Mod4+8 Switch to object 7 (workspace, full screen client window) within current screen. .TP .B Mod4+9 Switch to object 8 (workspace, full screen client window) within current screen. .TP .B Mod4+0 Switch to object 9 (workspace, full screen client window) within current screen. .TP .B Mod4+grave Switch to next object (workspace, full screen client window) within current screen. .TP .B Mod4+Shift+asciitilde Switch to previous object (workspace, full screen client window) within current screen. .TP .B Mod4+O O Open first region demanding attention or previously active one. .TP .B Mod4+Shift+1, Mod4+F1 Go to screen 0 on multihead setup. .TP .B Mod4+Shift+2, Mod4+F2 Go to screen 1 on multihead setup. .TP .B Mod4+Shift+3, Mod4+F3 Go to screen 2 on multihead setup. .TP .B Mod4+Shift+4 Go to screen 3 on multihead setup. .TP .B Mod4+Shift+Escape Go to previous screen on multihead setup. .TP .B Mod4+Escape Go to next screen on multihead setup. .TP .B Mod4+F9 Create a new workspace of chosen default type. .TP .B F12, Mod4+F12, Button3 press Display the main menu. .TP .B Button2 press Display the window list menu. .TP .B Mod4+Tab Forward-circulate focus. .TP .B Mod4+Shift+Tab Backward-circulate focus. .TP .B Mod4+Shift+R Raise focused object, if possible. .SS Bindings operating on all frames and screens .TP .B Mod4+C Close current object. .TP .B Mod4+Shift+D Detach (float) or reattach an object to its previous location. .SS Bindings operating on all frames .TP .B Mod4+H Maximize the frame horizontally. .TP .B Mod4+V Maximize the frame vertically. .TP .B Button3 press Display context menu. .TP .B Mod4+R Begin move/resize mode. .TP .B Button1 click at tab, Button2 click at tab Switch the frame to display the object indicated by the tab. .TP .B Button1 drag at border, Mod4+Button3 drag Resize the frame. .TP .B Mod4+Button1 drag Move the frame. .TP .B Button1 drag at tab, Button2 drag at tab Move objects between frames by dragging and dropping the tab. .TP .B Mod4+Caps_Lock, Mod4+Button4 click Switch to next object within the frame. .TP .B Mod4+Shift+Caps_Lock, Mod4+Button5 click Switch to previous object within the frame. .SS Bindings operating on top-level (non-transient) frames and screens .TP .B Mod4+T Toggle tag of current object. .TP .B Mod4+Shift+T Clear all tags. .TP .B Mod4+L Lock screen .TP .B Mod4+Return, F2 Run a terminal emulator. .TP .B Mod4+J Query for command line to execute. .TP .B Mod4+Shift+J Query for Lua code to execute. .TP .B Mod4+F4 Query for host to connect to with SSH. .TP .B Mod4+F5 Query for file to edit. .TP .B Mod4+F6 Query for file to view. .TP .B Mod4+F7 Query for keybinding. .TP .B Mod4+Shift+F9 Query for workspace to go to or create a new one. .TP .B Mod4+G Query for a client window to go to. .TP .B Mod4+M Display context menu. .TP .B Mod4+Shift+M Query for context menu. .TP .B Mod4+slash Show Notion 'live docs'. .TP .B Mod4+Shift+slash Query for manual page to be displayed. .SS Bindings operating on top-level (non-transient) frames .TP .B Mod4+N Attach tagged objects to this frame. .TP .B Mod4+Shift+N Query for a client window to attach ('nick'). .TP .B Mod4+A Switch to tab 0 in this frame. .TP .B Mod4+S Switch to tab 1 in this frame. .TP .B Mod4+D Switch to tab 2 in this frame. .TP .B Mod4+F Switch to tab 3 in this frame. .TP .B Mod4+comma Move current tab to the right within the frame. .TP .B Mod4+period Move current tab to the left within the frame. .TP .B Mod4+H, Mod4+V Maximize the frame horizontally/vertically. .SS Bindings for floating/detached frames .TP .B Button1 double click at tab Toggle shade mode .TP .B Button1 press at tab, Button1 press at border, Mod4+Button1 click Raise the frame. .TP .B Mod4+Button3 click Lower the frame. .TP .B Button1 drag at tab Move the frame. .TP .B Mod4+Shift+B Tile frame, if no tiling exists on the workspace .SS Bindings for tilings and tiled frames [mod_tiling] .TP .B Mod4+I Split current into columns. .TP .B Mod4+Shift+I Split current into rows. .TP .B Mod4+X Destroy current frame. .TP .B Mod4+W Go to frame below current frame. .TP .B Mod4+Shift+W, Mod4+Shift+Button4 click, Mod4+Shift+Button5 click Go to frame above current frame. .\"? .SS Bindings for client windows .TP .B Mod4+Shift+L Nudge the client window. This might help with some programs' resizing problems. .TP .B Mod4+Shift+C Kill client owning the client window. .TP .B Mod4+Shift+Q Send next key press to the client window. Some programs may not allow this by default. .TP .B Mod4+Q Toggle client window group full-screen mode .SS Move/resize mode bindings .TP .B Escape Cancel the resize mode. .TP .B Return End the resize mode. .TP .B Left, Right, Up, Down, F, B, P, N Grow in specified direction. .TP .B Shift+Left, Shift+Right, Shift+Up, Shift+Down, Shift+F, Shift+B, Shift+P, Shift+N Shrink in specified direction. .TP .B Mod4+Left, Mod4+Right, Mod4+Up, Mod4+Down, Mod4+F, Mod4+B, Mod4+P, Mod4+N Move in specified direction. .SS Bindings for message boxes and queries [mod_query] .TP .B Escape, Control+G, Control+C Close the query/message box, not executing bound actions. .TP .B Control+U, Control+V, Page_Up, Page_Down Scroll the message or completions up/down. .SS Bindings for editing in queries [mod_query] These bindings are similar to those of the \fIjoe(1)\fP text editor. Cut, copy and paste works in a more conventional manner, though, but the keys are equivalent. .TP .B Control+F, Control+B, Right, Left Move one character forward/backward. .TP .B Control+E, Control+A, End, Home Go to end/beginning. .TP .B Control+X, Control+Z Skip one word forward/backward. .TP .B Control+D, Delete Delete next character. .TP .B BackSpace, Control+H Delete previous character. .TP .B Control+W, Control+O Delete one word forward/backward. .TP .B Control+J Delete to end of line. .TP .B Control+Y Delete the whole line. .TP .B Control+T Transpose characters. .TP .B Control+P, Control+N, Up, Down, Control+Up, Control+Down Select next/previous (matching) history entry. .TP .B Button2 click, Control+K C Paste from the clipboard. .TP .B Control+K B Set mark/begin selection. .TP .B Control+K Y Cut selection. .TP .B Control+K K Copy selection. .TP .B Control+K G Clear mark/cancel selection. .TP .B Tab, Shift+Tab, Control+Tab Try to complete the entered text or cycle through completions. .TP .B Control+R, Control+S Complete from history .TP .B Control+M, Return, KP_Enter Close the query and execute bound action. .SS Bindings for menus [mod_menu] .TP .B Escape, Control+G, Control+C, Left Close the menu. .TP .B Return, KP_Enter, Control+M, Right Activate current menu entry. .TP .B Control+N, Control+P, Up, Down Select next/previous menu entry. .TP .B BackSpace Clear the menu's typeahead find buffer. .SH FILES AND DIRECTORIES .TP .B /etc/X11/notion/cfg_notion.lua System default main configuration files .TP .B /etc/X11/notion/cfg_*.lua Other configuration files. .TP .B /etc/X11/notion/look_*.lua Colour scheme configuration files .TP .B ~/.notion/ User configuration files .TP .B ~/.notion/cfg_notion.lua User default main configuration file (overrides system default) .SH SEE ALSO The Notion home page, \fIhttps://notionwm.net/\fP .PP The document "Configuring and extending Notion with Lua" found on the Notion home page. .PP .I /usr/share/doc/notion/ .PP \fIX(7x)\fP, \fInotionflux(1)\fP, \fIjoe(1)\fP .SH AUTHOR Notion was written by the Notion team, based on Ion which was written by Tuomo Valkonen .