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

FreeBSD Manual Pages

  
 
  

home | help
DVTM(1)			    General Commands Manual		       DVTM(1)

NAME
       dvtm - dynamic virtual terminal manager

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

DESCRIPTION
       dvtm is a dynamic tiling	window manager for the console.	 As a  console
       window  manager	it tries to make it easy to work with multiple console
       based applications.

OPTIONS
       -v     Print version information	to standard output and exit.

       -M     Toggle default mouse grabbing upon startup. Use  this  to	 allow
	      normal mouse operation under X.

       -m modifier
	      Set command modifier at runtime.

       -d delay
	      Set  the delay ncurses waits before deciding if a	character that
	      might be part of an escape  sequence  is	actually  part	of  an
	      escape sequence.

       -h lines
	      Set the scrollback history buffer	size at	runtime.

       -t title
	      Set  a  static  terminal title and don't change it to the	one of
	      the currently focused window.

       -s status-fifo
	      Open or create the named pipe status-fifo	read its  content  and
	      display  it  in the statusbar. See the dvtm-status script	for an
	      usage example.

       -c cmd-fifo
	      Open or create the named pipe cmd-fifo and look for commands  to
	      execute which were defined in config.h.

       command ...
	      Execute command(s), each in a separate window.

USAGE
   Keyboard commands
       Mod    Each keybinding begins with Mod which defaults to	^g, but	can be
	      changed in config.h or with the -m command line option.

       Mod-c  Create a new shell window.

       Mod-C  Create a new shell window	using the current working directory of
	      the focused window.

       Mod-x-x
	      Close focused window.

       Mod-l  Increases	 the  master  area width about 5% (all except grid and
	      fullscreen layout).

       Mod-h  Decreases	the master area	width about 5% (all  except  grid  and
	      fullscreen layout).

       Mod-i  Increase number of windows displayed in the master area.

       Mod-d  Decrease number of windows displayed in the master area.

       Mod-j  Focus next window.

       Mod-k  Focus previous window.

       Mod-J  Focus next non minimized window.

       Mod-K  Focus previous non minimized window.

       Mod-n  Focus the	n-th window.

       Mod-Tab
	      Focus previously selected	window.

       Mod-.  Toggle minimization of current window.

       Mod-m  Maximize current window (change to fullscreen layout).

       Shift-PageUp
       Mod-PageUp
	      Scroll up.

       Shift-PageDown
       Mod-PageDown
	      Scroll down.

       Mod-Space
	      Toggle between defined layouts (affects all windows).

       Mod-Enter
	      Zooms/cycles current window to/from master area.

       Mod-f  Change to	vertical stack tiling layout.

       Mod-b  Change to	bottom stack tiling layout.

       Mod-g  Change to	grid layout.

       Mod-s  Show/hide	the status bar.

       Mod-S  Toggle position of the status bar	between	top and	bottom.

       Mod-r
       Mod-^L Redraw whole screen.

       Mod-a  Toggle  keyboard	multiplexing mode, if activated	keypresses are
	      sent to all visible windows.

       Mod-M  Toggle dvtm mouse	grabbing.

       Mod-e  Enter copy mode (see section below for further information).

       Mod-/  Enter copy mode and start	searching forward (assumes  a  vi-like
	      editor).

       Mod-p  Paste  last  copied  text	 from  copy  mode  at  current	cursor
	      position.

       Mod-?  Show this	manual page.

       Mod-Mod
	      Send the Mod key.

       Mod-F[1..n]
       Mod-v-[1..n]
	      View all windows with nth	tag.

       Mod-0  View all windows with any	tag.

       Mod-v-Tab
	      Toggles to the previously	selected tags.

       Mod-V-[1..n]
	      Add/remove all windows with nth tag to/from the view.

       Mod-t-[1..n]
	      Apply nth	tag to focused window.

       Mod-T-[1..n]
	      Add/remove nth tag to/from focused window.

       Mod-q-q
	      Quit dvtm.

   Mouse commands
       Copy and	Paste
	      By default dvtm captures mouse events  to	 provide  the  actions
	      listed below.  Unfortunately this	interferes with	the standard X
	      copy and paste mechanism.	 To work around	this you need to  hold
	      down  Shift  while selecting or pasting text.  Alternatively you
	      can disable mouse	support	at compile time, start dvtm  with  the
	      -M flag or toggle	mouse support during runtime with Mod-M.

       Button1 click
	      Focus window.

       Button1 double click
	      Focus window and toggle maximization.

       Button2 click
	      Zoom/cycle current window	to/from	master area.

       Button3 click
	      Toggle minimization of current window.

   Copy	mode
       Copy  mode  gives easy access to	past output by piping it to an editor.
       What ever the editor prints to stdout upon exiting will be stored in an
       internal	register and can be pasted into	other clients (via Mod-p )

ENVIRONMENT VARIABLES
       DVTM   Each  process spawned by dvtm will have this variable set	to the
	      dvtm version it is running under.

       DVTM_WINDOW_ID
	      Each process also	has access to its constant and	unique	window
	      id.

       DVTM_CMD_FIFO
	      If the -c	command	line argument was specified upon dvtm startup,
	      this variable will be set	to the file name of  the  named	 pipe.
	      Thus allowing the	process	to send	commands back to dvtm.

       DVTM_TERM
	      By  default  dvtm	 uses its own terminfo file and	therefore sets
	      TERM=dvtm	within the client windows. This	can be	overridden  by
	      setting  the  DVTM_TERM environment variable to a	valid terminal
	      name before launching dvtm.

       DVTM_EDITOR
	      When entering the	copymode dvtm  pipes  the  whole  scroll  back
	      buffer  to  DVTM_EDITOR  which is	launched with -	(indicating to
	      read from	stdin) as its only argument.  If  DVTM_EDITOR  is  not
	      set EDITOR is checked, if	this is	also not set the default value
	      specified	in config.h is used instead.

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

CUSTOMIZATION
       dvtm  is	customized by creating a custom	config.h and (re)compiling the
       source code.  This keeps	it fast, secure	and simple.

AUTHOR
       dvtm is written by Marc AndrA(C)	Tanner <mat at brain-dump.org>

				   dvtm-0.15			       DVTM(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE | ENVIRONMENT VARIABLES | EXAMPLE | CUSTOMIZATION | AUTHOR

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

home | help