1DVTM(1)                     General Commands Manual                    DVTM(1)
2
3
4

NAME

6       dvtm - dynamic virtual terminal manager
7

SYNOPSIS

9       dvtm  [-v]  [-M]  [-m  modifier]  [-d  delay] [-h lines] [-t title] [-s
10       status-fifo] [-c cmd-fifo] [command ...]
11

DESCRIPTION

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

OPTIONS

18       -v     Print version information to standard output and exit.
19
20       -M     Toggle default mouse grabbing upon startup. Use  this  to  allow
21              normal mouse operation under X.
22
23       -m modifier
24              Set command modifier at runtime.
25
26       -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
31       -h lines
32              Set the scrollback history buffer size at runtime.
33
34       -t title
35              Set  a  static  terminal title and don't change it to the one of
36              the currently focused window.
37
38       -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
43       -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
47       command ...
48              Execute command(s), each in a separate window.
49

USAGE

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
55       Mod-c  Create a new shell window.
56
57       Mod-C  Create a new shell window using the current working directory of
58              the focused window.
59
60       Mod-x-x
61              Close focused window.
62
63       Mod-l  Increases  the  master  area width about 5% (all except grid and
64              fullscreen layout).
65
66       Mod-h  Decreases the master area width about 5% (all  except  grid  and
67              fullscreen layout).
68
69       Mod-i  Increase number of windows displayed in the master area.
70
71       Mod-d  Decrease number of windows displayed in the master area.
72
73       Mod-j  Focus next window.
74
75       Mod-k  Focus previous window.
76
77       Mod-J  Focus next non minimized window.
78
79       Mod-K  Focus previous non minimized window.
80
81       Mod-n  Focus the n-th window.
82
83       Mod-Tab
84              Focus previously selected window.
85
86       Mod-.  Toggle minimization of current window.
87
88       Mod-m  Maximize current window (change to fullscreen layout).
89
90       Shift-PageUp
91       Mod-PageUp
92              Scroll up.
93
94       Shift-PageDown
95       Mod-PageDown
96              Scroll down.
97
98       Mod-Space
99              Toggle between defined layouts (affects all windows).
100
101       Mod-Enter
102              Zooms/cycles current window to/from master area.
103
104       Mod-f  Change to vertical stack tiling layout.
105
106       Mod-b  Change to bottom stack tiling layout.
107
108       Mod-g  Change to grid layout.
109
110       Mod-s  Show/hide the status bar.
111
112       Mod-S  Toggle position of the status bar between top and bottom.
113
114       Mod-r
115       Mod-^L Redraw whole screen.
116
117       Mod-a  Toggle  keyboard  multiplexing mode, if activated keypresses are
118              sent to all visible windows.
119
120       Mod-M  Toggle dvtm mouse grabbing.
121
122       Mod-e  Enter copy mode (see section below for further information).
123
124       Mod-/  Enter copy mode and start searching forward (assumes  a  vi-like
125              editor).
126
127       Mod-p  Paste  last  copied  text  from  copy  mode  at  current  cursor
128              position.
129
130       Mod-?  Show this manual page.
131
132       Mod-Mod
133              Send the Mod key.
134
135       Mod-F[1..n]
136       Mod-v-[1..n]
137              View all windows with nth tag.
138
139       Mod-0  View all windows with any tag.
140
141       Mod-v-Tab
142              Toggles to the previously selected tags.
143
144       Mod-V-[1..n]
145              Add/remove all windows with nth tag to/from the view.
146
147       Mod-t-[1..n]
148              Apply nth tag to focused window.
149
150       Mod-T-[1..n]
151              Add/remove nth tag to/from focused window.
152
153       Mod-q-q
154              Quit dvtm.
155
156   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
165       Button1 click
166              Focus window.
167
168       Button1 double click
169              Focus window and toggle maximization.
170
171       Button2 click
172              Zoom/cycle current window to/from master area.
173
174       Button3 click
175              Toggle minimization of current window.
176
177   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

ENVIRONMENT VARIABLES

183       DVTM   Each  process spawned by dvtm will have this variable set to the
184              dvtm version it is running under.
185
186       DVTM_WINDOW_ID
187              Each process also has access to its constant and  unique  window
188              id.
189
190       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
195       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
201       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

EXAMPLE

209       See the dvtm-status script as an example of how to display text in  the
210       status bar.
211

CUSTOMIZATION

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

AUTHOR

217       dvtm is written by Marc André Tanner <mat at brain-dump.org>
218
219
220
221                                   dvtm-0.15                           DVTM(1)
Impressum