https://github.com/martanne/dvtm Skip to content Sign up Sign up * Why GitHub? Features - + Mobile - + Actions - + Codespaces - + Packages - + Security - + Code review - + Project management - + Integrations - + GitHub Sponsors - + Customer stories- * Team * Enterprise * Explore + Explore GitHub - Learn and contribute + Topics - + Collections - + Trending - + Learning Lab - + Open source guides - Connect with others + The ReadME Project - + Events - + Community forum - + GitHub Education - + GitHub Stars program - * Marketplace * Pricing Plans - + Compare plans - + Contact Sales - + Education - [ ] [search-key] * # In this repository All GitHub | Jump to | * No suggested jump to results * # In this repository All GitHub | Jump to | * # In this user All GitHub | Jump to | * # In this repository All GitHub | Jump to | Sign in Sign up Sign up {{ message }} martanne / dvtm * Notifications * Star 587 * Fork 79 dvtm brings the concept of tiling window management, popularized by X11-window managers like dwm to the console. As a console window manager it tries to make it easy to work with multiple console based programs. MIT License 587 stars 79 forks Star Notifications * Code * Issues 52 * Pull requests 9 * Actions * Projects 0 * Security * Insights More * Code * Issues * Pull requests * Actions * Projects * Security * Insights master Switch branches/tags [ ] Branches Tags Nothing to show {{ refName }} default View all branches Nothing to show {{ refName }} default View all tags 3 branches 19 tags Go to file Code Clone HTTPS GitHub CLI [https://github.com/m] Use Git or checkout with SVN using the web URL. [gh repo clone martan] Work fast with our official CLI. Learn more. * Open with GitHub Desktop * Download ZIP Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Go back Launching GitHub Desktop If nothing happens, download GitHub Desktop and try again. Go back Launching Xcode If nothing happens, download Xcode and try again. Go back Launching Visual Studio If nothing happens, download the GitHub extension for Visual Studio and try again. Go back Latest commit @martanne martanne Remove Travis CI configuration ... 7bcf43f Mar 9, 2021 Remove Travis CI configuration 7bcf43f Git stats * 576 commits Files Permalink Failed to load latest commit information. Type Name Latest commit message Commit time .builds Configure Sourcehut continous integration Mar 9, 2021 .gitignore Cleanup .gitignore Jan 5, 2017 LICENSE Welcome 2016 Jan 9, 2016 Makefile Install man pages and add html generation Makefile target Jan 5, 2017 README.md Tweak README Apr 30, 2020 bstack.c Implement nmaster functionality via MOD+{i,d} Feb 12, 2015 config.def.h Add spatial navigation via MOD+{H,J,K,L} Jan 5, 2017 config.mk Simplify Makefile Jan 3, 2017 dvtm-editor.1 Slightly tweak manual pages Jan 5, 2017 dvtm-editor.c Cleanup and simplify dvtm-editor implementation Jan 3, 2017 dvtm-pager Add dvtm-pager(1) utility Jan 3, 2017 dvtm-pager.1 Slightly tweak manual pages Jan 5, 2017 dvtm-status dvtm-status: cleanup Feb 24, 2015 dvtm.1 Add spatial navigation via MOD+{H,J,K,L} Jan 5, 2017 dvtm.c Display control keys, when typed, next to Layout icon Mar 9, 2021 dvtm.info Support more attributes Oct 25, 2014 fibonacci.c Implement tagging Oct 29, 2014 forkpty-aix.c AIX support Oct 2, 2014 forkpty-sunos.c Solaris support Jul 8, 2014 fullscreen.c Implement tagging Oct 29, 2014 grid.c Implement tagging Oct 29, 2014 testsuite.sh Make ./testsuite.sh work at least on my system Jan 5, 2017 tile.c Implement nmaster functionality via MOD+{i,d} Feb 12, 2015 tstack.c Implement nmaster functionality via MOD+{i,d} Feb 12, 2015 vstack.c Implement nmaster functionality via MOD+{i,d} Feb 12, 2015 vt.c vt_forkpty: check for success of chdir(2) Mar 9, 2021 vt.h Try to preserve coloring in copymode Sep 28, 2015 View code dvtm - dynamic virtual terminal manager News Download Why dvtm? The philosophy behind Quickstart Windows Layouts Tagging Statusbar Copymode Patches FAQ Detach / reattach functionality Copy / Paste does not work under X How to change the key bindings? WARNING: terminal is not fully functional How to set the window title? Something is wrong with the displayed colors Some characters are displayed like garbage The numeric keypad does not work with Putty Unicode characters do not work within Putty Development License README.md dvtm - dynamic virtual terminal manager dvtm brings the concept of tiling window management, popularized by X11-window managers like dwm to the console. As a console window manager it tries to make it easy to work with multiple console based programs. abduco+dvtm demo News * dvtm-0.15 released (09.01.2016) * dvtm-0.14 released (19.02.2015) * dvtm-0.13 released (15.11.2014) * dvtm-0.12 released (05.07.2014) * dvtm-0.11 released (08.03.2014) * dvtm-0.10 released (28.12.2013) * dvtm-0.9 released (3.04.2013) * dvtm-0.8 released (1.08.2012) * dvtm-0.7 released (4.09.2011) * dvtm-0.6 released (8.10.2010) * dvtm-0.5.2 released (7.07.2009) * dvtm-0.5.1 released (8.02.2009) * dvtm-0.5 released (26.01.2009) * dvtm-0.4.1 released (10.05.2008) * dvtm-0.4 released (17.02.2008) * dvtm-0.3 released (12.01.2008) * dvtm-0.2 released (29.12.2007) * dvtm-0.1 released (21.12.2007) * dvtm-0.01 released (08.12.2007) Download Either Download the latest source tarball, compile (you will need curses headers) and install it $EDITOR config.mk && $EDITOR config.def.h && make && sudo make install or use one of the distribution provided binary packages. Why dvtm? The philosophy behind dvtm strives to adhere to the Unix philosophy. It tries to do one thing, dynamic window management on the console, and to do it well. As such dvtm does not implement session management but instead delegates this task to a separate tool called abduco. Similarly dvtm's copy mode is implemented by piping the scroll back buffer content to an external editor and only storing whatever the editor writes to stdout. Hence the selection process is delegated to the editor where powerful features such as regular expression search are available. As a result dvtm's source code is relatively small (~4000 lines of C ), simple and therefore easy to hack on. Quickstart All of dvtm keybindings start with a common modifier which from now on is refered to as MOD. By default MOD is set to CTRL+g however this can be changed at runttime with the -m command line option. For example setting MOD to CTRL-b is accomplished by starting dvtm -m ^b. Windows New windows are created with MOD+c and closed with MOD+x. To switch among the windows use MOD+j and MOD+k or MOD+[1..9] where the digit corresponds to the window number which is displayed in the title bar. Windows can be minimized and restored with MOD+.. Input can be directed to all visible window by pressing MOD+a, issuing the same key combination again restores normal behaviour i.e. only the currently focused window will receive input. Layouts Visible Windows are arranged by a layout. Each layout consists of a master and a tile area. Typically the master area occupies the largest part of the screen and is intended for the currently most important window. The size of the master area can be shrunk with MOD+h and enlarged with MOD-l respectively. Windows can be zoomed into the master area with MOD+Enter. The number of windows in the master area can be increased and decreased with MOD+i and MOD+d. By default dvtm comes with 4 different layouts which can be cycled through via MOD+Space * vertical stack: master area on the left half, other clients stacked on the right * bottom stack: master area on the top half, other clients stacked below * grid: every window gets an equally sized portion of the screen * fullscreen: only the selected window is shown and occupies the whole available display area MOD+m Further layouts are included in the source tarball but disabled by default. Tagging Each window has a non empty set of tags [1..n] associated with it. A view consists of a number of tags. The current view includes all windows which are tagged with the currently active tags. The following key bindings are used to manipulate the tagsets. * MOD-0 view all windows with any tag * Mod-v-Tab toggles to the previously selected tags * MOD-v-[1..n] view all windows with nth tag * 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 Statusbar dvtm can be instructed to read and display status messages from a named pipe. As an example the dvtm-status script is provided which shows the current time. Copymode MOD+e pipes the whole scroll buffer content to an external editor. What ever the editor writes to stdout is remembered by dvtm and can later be pasted with MOD+p. In order for this to work the editor needs to be usable as a filter and should use stderr for its user interface. Examples where this is the case include sandy(1) and vis. $ echo Hello World | vis - | cat Patches There exist a number of out of tree patches which customize dvtm's behaviour: * pertag (see also the corresponding mailing list post) FAQ Detach / reattach functionality dvtm doesn't have session support built in. Use abduco instead. $ abduco -c dvtm-session Detach using CTRL-\ and later reattach with $ abduco -a dvtm-session Copy / Paste does not work under X If you have mouse support enabled, which is the case with the default settings, you need to hold down shift while selecting and inserting text. In case you don't like this behaviour either run dvtm with the -M command line argument, disable it at run time with MOD+M or modify config.def.h to disable it completely at compile time. You will however no longer be able to perform other mouse actions like selecting windows etc. How to change the key bindings? The configuration of dvtm is done by creating a custom config.h and (re)compiling the source code. See the default config.def.h as an example, adapting it to your preference should be straightforward. You basically define a set of layouts and keys which dvtm will use. There are some pre defined macros to ease configuration. WARNING: terminal is not fully functional This means you haven't installed the dvtm.info terminfo description which can be done with tic -s dvtm.info. If for some reason you can't install new terminfo descriptions set the DVTM_TERM environment variable to a known terminal when starting dvtm as in $ DVTM_TERM=rxvt dvtm This will instruct dvtm to use rxvt as $TERM value within its windows. How to set the window title? The window title can be changed by means of a xterm extension terminal escape sequence $ echo -ne "\033]0;Your title here\007" So for example in bash if you want to display the current working directory in the window title this can be accomplished by means of the following section in your startup files. # If this is an xterm set the title to user@host:dir case "$TERM" in dvtm*|xterm*|rxvt*) PROMPT_COMMAND='echo -ne "\033]0;${USER}@${HOSTNAME}: ${PWD/$HOME/~}\007"' ;; *) ;; esac Other shells provide similar functionality, zsh as an example has a precmd function which can be used to achieve the same effect. Something is wrong with the displayed colors Make sure you have set $TERM correctly for example if you want to use 256 color profiles you probably have to append -256color to your regular terminal name. Also due to limitations of ncurses by default you can only use 255 color pairs simultaneously. If you need more than 255 different color pairs at the same time, then you have to rebuild ncurses with $ ./configure ... --enable-ext-colors Note that this changes the ABI and therefore sets SONAME of the library to 6 (i.e. you have to link against libncursesw.so.6). Some characters are displayed like garbage Make sure you compiled dvtm against a unicode aware curses library (in case of ncurses this would be libncursesw). Also make sure that your locale settings contain UTF-8. The numeric keypad does not work with Putty Disable application keypad mode in the Putty configuration under Terminal => Features => Disable application keypad mode. Unicode characters do not work within Putty You have to tell Putty in which character encoding the received data is. Set the dropdown box under Window => Translation to UTF-8. In order to get proper line drawing characters you proabably also want to set the TERM environment variable to putty or putty-256color. If that still doesn't do the trick then try running dvtm with the following ncurses related environment variable set NCURSES_NO_UTF8_ACS=1. Development You can always fetch the current code base from the git repository located at Github or Sourcehut. If you have comments, suggestions, ideas, a bug report, a patch or something else related to dvtm then write to the suckless developer mailing list or contact me directly. License dvtm reuses some code of dwm and is released under the same MIT/X11 license. The terminal emulation part is licensed under the ISC license. About dvtm brings the concept of tiling window management, popularized by X11-window managers like dwm to the console. As a console window manager it tries to make it easy to work with multiple console based programs. Resources Readme License MIT License Releases 19 dvtm 0.15 Latest Feb 11, 2020 + 18 releases Packages 0 No packages published Contributors 20 * @martanne * @rpmohn * @medgar123 * @lenormf * @shua * @jshs * @fjes * @MadCoder * @raimue * @rdailey * @MarSoft + 9 contributors Languages * C 89.9% * Roff 7.1% * Makefile 1.7% * Shell 1.3% * (c) 2021 GitHub, Inc. * Terms * Privacy * Security * Status * Docs * Contact GitHub * Pricing * API * Training * Blog * About You can't perform that action at this time. You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.