1DVTM(1) General Commands Manual DVTM(1)
2
6 dvtm - dynamic virtual terminal manager
7
9 dvtm [-v] [-M] [-m modifier] [-d delay] [-h lines] [-t title] [-s
10 status-fifo] [-c cmd-fifo] [command ...]
11
13 dvtm is a dynamic tiling window manager for the console. As a console
14 window manager it tries to make it easy to work with multiple console
15 based applications.
16
18 -v Print version information to standard output and exit.
19 -M Toggle default mouse grabbing upon startup. Use this to allow
21 normal mouse operation under X.
22 -m modifier
24 Set command modifier at runtime.
25 -d delay
27 Set the delay ncurses waits before deciding if a character that
28 might be part of an escape sequence is actually part of an
29 escape sequence.
30 -h lines
32 Set the scrollback history buffer size at runtime.
33 -t title
35 Set a static terminal title and don't change it to the one of
36 the currently focused window.
37 -s status-fifo
39 Open or create the named pipe status-fifo read its content and
40 display it in the statusbar. See the dvtm-status script for an
41 usage example.
42 -c cmd-fifo
44 Open or create the named pipe cmd-fifo and look for commands to
45 execute which were defined in config.h.
46 command ...
48 Execute command(s), each in a separate window.
49
51 Keyboard commands
52 Mod Each keybinding begins with Mod which defaults to ^g, but can be
53 changed in config.h or with the -m command line option.
54 Mod-c Create a new shell window.
56 Mod-C Create a new shell window using the current working directory of
58 the focused window.
59 Mod-x-x
61 Close focused window.
62 Mod-l Increases the master area width about 5% (all except grid and
64 fullscreen layout).
65 Mod-h Decreases the master area width about 5% (all except grid and
67 fullscreen layout).
68 Mod-i Increase number of windows displayed in the master area.
70 Mod-d Decrease number of windows displayed in the master area.
72 Mod-j Focus next window.
74 Mod-k Focus previous window.
76 Mod-J Focus next non minimized window.
78 Mod-K Focus previous non minimized window.
80 Mod-n Focus the n-th window.
82 Mod-Tab
84 Focus previously selected window.
85 Mod-. Toggle minimization of current window.
87 Mod-m Maximize current window (change to fullscreen layout).
89 Shift-PageUp
91 Mod-PageUp
92 Scroll up.
93 Shift-PageDown
95 Mod-PageDown
96 Scroll down.
97 Mod-Space
99 Toggle between defined layouts (affects all windows).
100 Mod-Enter
102 Zooms/cycles current window to/from master area.
103 Mod-f Change to vertical stack tiling layout.
105 Mod-b Change to bottom stack tiling layout.
107 Mod-g Change to grid layout.
109 Mod-s Show/hide the status bar.
111 Mod-S Toggle position of the status bar between top and bottom.
113 Mod-r
115 Mod-^L Redraw whole screen.
116 Mod-a Toggle keyboard multiplexing mode, if activated keypresses are
118 sent to all visible windows.
119 Mod-M Toggle dvtm mouse grabbing.
121 Mod-e Enter copy mode (see section below for further information).
123 Mod-/ Enter copy mode and start searching forward (assumes a vi-like
125 editor).
126 Mod-p Paste last copied text from copy mode at current cursor
128 position.
129 Mod-? Show this manual page.
131 Mod-Mod
133 Send the Mod key.
134 Mod-F[1..n]
136 Mod-v-[1..n]
137 View all windows with nth tag.
138 Mod-0 View all windows with any tag.
140 Mod-v-Tab
142 Toggles to the previously selected tags.
143 Mod-V-[1..n]
145 Add/remove all windows with nth tag to/from the view.
146 Mod-t-[1..n]
148 Apply nth tag to focused window.
149 Mod-T-[1..n]
151 Add/remove nth tag to/from focused window.
152 Mod-q-q
154 Quit dvtm.
155 Mouse commands
157 Copy and Paste
158 By default dvtm captures mouse events to provide the actions
159 listed below. Unfortunately this interferes with the standard X
160 copy and paste mechanism. To work around this you need to hold
161 down Shift while selecting or pasting text. Alternatively you
162 can disable mouse support at compile time, start dvtm with the
163 -M flag or toggle mouse support during runtime with Mod-M.
164 Button1 click
166 Focus window.
167 Button1 double click
169 Focus window and toggle maximization.
170 Button2 click
172 Zoom/cycle current window to/from master area.
173 Button3 click
175 Toggle minimization of current window.
176 Copy mode
178 Copy mode gives easy access to past output by piping it to an editor.
179 What ever the editor prints to stdout upon exiting will be stored in an
180 internal register and can be pasted into other clients (via Mod-p )
181
183 DVTM Each process spawned by dvtm will have this variable set to the
184 dvtm version it is running under.
185 DVTM_WINDOW_ID
187 Each process also has access to its constant and unique window
188 id.
189 DVTM_CMD_FIFO
191 If the -c command line argument was specified upon dvtm startup,
192 this variable will be set to the file name of the named pipe.
193 Thus allowing the process to send commands back to dvtm.
194 DVTM_TERM
196 By default dvtm uses its own terminfo file and therefore sets
197 TERM=dvtm within the client windows. This can be overridden by
198 setting the DVTM_TERM environment variable to a valid terminal
199 name before launching dvtm.
200 DVTM_EDITOR
202 When entering the copymode dvtm pipes the whole scroll back
203 buffer to DVTM_EDITOR which is launched with - (indicating to
204 read from stdin) as its only argument. If DVTM_EDITOR is not
205 set EDITOR is checked, if this is also not set the default value
206 specified in config.h is used instead.
207
209 See the dvtm-status script as an example of how to display text in the
210 status bar.
211
213 dvtm is customized by creating a custom config.h and (re)compiling the
214 source code. This keeps it fast, secure and simple.
215
217 dvtm is written by Marc André Tanner <mat at brain-dump.org>
218 dvtm-0.15 DVTM(1)