graph TB
subgraph Settings loading order
direction LR
A1["1"] --- B1("Init hardcoded <file=.../> list")
B1 --> C1("Take <file=.../> list from the $VTM_CONFIG value or file it referencing")
C1 --> G1("Take <file=.../> list from the received DirectVT packet")
G1 --> H1("Take <file=.../> list from the --config' CLI option value or file it referencing")
direction LR
A2["2"] --- B2("Overlay <config/> subsections from the resultant <file=.../> list")
B2 --> C2("Overlay <config/> subsection from the $VTM_CONFIG value or file it referencing")
C2 --> G2("Overlay <config/> subsection from the received DirectVT packet")
G2 --> H2("Overlay <config/> subsection from the --config' CLI option value or file it referencing")
end
The settings are stored in a slightly modified XML-like format which allows to store hierarchical list of key=value pairs.
See /src/vtm.xml for reference.
There are two default settings locations that can be overridden:
<file="/etc/vtm/settings.xml"/> <!-- Default system-wide settings source. The "/etc/..." path will be auto converted to the "%PROGRAMDATA%\..." on Windows. -->
<file="~/.config/vtm/settings.xml"/> <!-- Default user-wise settings source. -->The process of loading settings consists of the following steps:
- Build an ordered list of source files by looking for the root
<file=.../>subsections. - Overlay the
<config/>subsection from the source files in the loading order. - Overlay the
<config/>subsection from the value of the$VTM_CONFIGenvironment variable or from a settings file it references. - Overlay the
<config/>subsection from the DirectVT config received from the parent process. - Overlay the
<config/>subsection from the specified--config <...>CLI option value or from a settings file it referencing.
The file list is built in the following order from the following sources:
- The settings file list from the hardcoded configuration containing a list of two files:
<file*/> <!-- Clear previously defined sources. Start a new list. --> <file="/etc/vtm/settings.xml"/> <!-- Default system-wide settings source. The "/etc/..." path will be auto converted to the "%PROGRAMDATA%\..." on Windows. --> <file="~/.config/vtm/settings.xml"/> <!-- Default user-wise settings source. --> ...
- The settings file list from the
$VTM_CONFIGenvironment variable value or from a settings file it referencing.- A case with a plain XML-data:
$VTM_CONFIG=<file*/><file='/path/to/override_defaults.xml'/>...- Clear the current file list and begin a new file list containing a single file '/path/to/override_defaults.xml'.$VTM_CONFIG=<file='/path/to/first.xml'/><file='/path/to/second.xml'/>...- Append the current file list with the files '/path/to/first.xml' and '/path/to/second.xml'.
- A case with a file reference:
$VTM_CONFIG='/path/to/override_defaults.xml'- Take the file list from the '/path/to/override_defaults.xml'.
- A case with a plain XML-data:
- The settings file list from the DirectVT config received from the parent process.
- The settings file list from the specified
--config <...>CLI option value or from a settings file it referencing.- A case with a plain XML-data:
./vtm --config "<file*/><file='/path/to/override_defaults.xml'/>..."- Clear the current file list and begin a new file list containing a single file '/path/to/override_defaults.xml/'.
- A case with a file reference:
./vtm --config "/path/to/override_defaults.xml"- Take the file list from the '/path/to/override_defaults.xml'.
- A case with a plain XML-data:
- All stored values are UTF-8 strings:
name=2000andname="2000"have the same meaning.
- There is no distinction between XML-attribute and XML-subobject, i.e. any attributes are sub-objects:
<name param=value />and<name> <param=value /> </name>have the same meaning.
- In addition to a set of sub-objects each object can contain its own text value:
- E.g.
<name=names_value param=params_value />.
- E.g.
- Each object can be defined in any way, either using an XML-attribute or an XML-subobject syntax:
<... name=value />,<...> <name> "value" </name> </...>, and<...> <name=value /> </...>have the same meaning.
- The object name that ending in an asterisk indicates that this object is not an object, but it is a template for all subsequent objects with the same name in the same scope. See
Template Examplebelow. - Compact syntax is allowed.
<node0><node1><thing name=value/></node1></node0>and<node0/node1/thing name=value/>have the same meaning.
- Objects can reference values of other objects using absolute references (three levels of indirection allowed).
thing2refers to the valuething1in<node1 thing1=value1/><node2 thing2=/node1/thing1 />.
- Escaped characters with special meaning:
\aASCII 0x07 BEL\tASCII 0x09 TAB\nASCII 0x0A LF\rASCII 0x0D CF\eASCII 0x1B ESC\\ASCII 0x5C Backslash\uA Unicode escape sequence in the form\u{XXX}or\uXXX, whereXXXis the hexadecimal codepoint value.$0Current module full path (it only expands in cases where it makes sense)
Let's take the following object hierarchy as an example:
- <document> - Top-level element
- <thing> - Second level element
- <name> - Third level element
- <thing> - Second level element
The following forms of element declaration are equivalent:
<document>
<thing name="a">text1</thing>
<thing name="b">text2</thing>
</document><document>
<thing="text1" name="a"/>
<thing="text2" name="b"/>
</document><document>
<thing name="a">
"text1"
</thing>
<thing name="b">
"text2"
</thing>
</document><document>
<thing>
"text1"
<name="a"/>
</thing>
<thing>
<name="b"/>
"text2"
</thing>
</document><document>
<thing="t">
"ext"
<name>
"a"
</name>
"1"
</thing>
<thing>
<name>
"b"
</name>
"text"
"2"
</thing>
</document>- Using asterisk
*at the end of the element name sets defaults for subsequent elements with the same name.
Note. Placing an asterisk without any other nested elements (such as <listitem*/>) indicates the start of a new list of elements. This list will replace the existing one when merging the configuration.
The following declarations have the same meaning:
<list>
<listitem id=first name="text_string1">text_string2</listitem>
<listitem id=second name="text_string1">text_string2</listitem>
</list><list>
<listitem* name="text_string1"/> <!-- skip this element and set name="text_string1" as default for the following listitems -->
<listitem id=first >text_string2</listitem>
<listitem id=second>text_string2</listitem>
</list><list>
<listitem* name="text_string1"/>
<listitem="text_string2" id=first />
<listitem="text_string2" id=second/>
</list><list>
<listitem*="text_string2" name="text_string1"/> <!-- skip this element and set listitem="text_string2" and name="text_string1" as default for the following listitems -->
<listitem id=first />
<listitem id=second/>
</list>The following declarations have the same meaning:
<config>
<document>
<thing="thing_value">
<name="name_value"/>
</thing>
</document>
</config><config/document/thing="thing_value" name="name_value"/><file= ... /> <!-- Ordered list of references to settings files used to form the resultant configuration. -->
...
<config> <!-- Global configuration. -->
<set> <!-- Global namespace - Unresolved literals will try to be resolved from here. -->
<variable = value/> <!-- Globally referenced variable. -->
... <!-- Set of global variables. -->
</set>
...
<object1=variable/> <!-- object1 references the value of /config/set/variable (/config/set is a default namespace). -->
<object2=/config/object1/> <!-- object2 references the value of /config/object1 using an absolute reference (three levels of indirection allowed). -->
<object3="/config/object1"/> <!-- object3 contains the string value "/config/object1". -->
...
<desktop> <!-- Desktop client settings. -->
<taskbar ... > <!-- Taskbar menu settings. -->
... <!-- Set of additional taskbar settings. -->
<item ... > <!-- Taskbar menu item definition. -->
... <!-- Additional application settings. -->
</item>
... <!-- Set of taskbar menu items. -->
</taskbar>
... <!-- Set of additional desktop settings. -->
</desktop>
<term ... > <!-- Built-in terminal configuration section. -->
...
</term>
</config>All value literals containing spaces must be enclosed in double or single quotes.
| Value type | Format |
|---|---|
RGBA |
Hex: #rrggbbaa | Hex: 0xaarrggbb | Decimal: r,g,b,a | 256-color index: i |
boolean |
true | false | yes | no | 1 | 0 | on | off | undef |
string |
UTF-8 text string |
x;y |
integer <any_delimeter> integer |
| Attribute | Description | Value type | Default value |
|---|---|---|---|
id |
Item id | string |
|
alias |
Item template id reference |
string |
|
hidden |
Item visibility on taskbar | boolean |
no |
label |
Item label text | string |
=id |
notes |
Item tooltip text | string |
empty |
title |
App window title | string |
empty |
footer |
App window footer | string |
empty |
winsize |
App window size | x;y |
|
winform |
App window state | undefined | normal | maximized | minimized |
|
type |
Desktop window type | string |
vtty |
env |
Environment variable in "var=val" format | string |
|
cwd |
Current working directory | string |
|
cmd |
Desktop window constructor arguments | string |
empty |
cfg |
Configuration patch for dtvt-apps in XML-format | string |
empty |
config |
Configuration patch for dtvt-apps | xml-node |
empty |
The menu item of DirectVT Gateway type (type=dtvt) can be additionally configured using a <config> subsection or a cfg="xml-text-data" attribute. The <config> subsection will be ignored if the cfg attribute contains a non-empty value.
The content of the cfg attribute (or <config> subsection) is passed to the dtvt-application on launch.
| Window type (case insensitive) |
Parameter cmd= |
Description |
|---|---|---|
vtty (default) |
A CUI application command line with arguments | Run a CUI application inside the Teletype Console dtvt-bridge. Usage example type=vtty cmd="cui_app ...". It is the same as type=dtvt cmd="vtm -r vtty cui_app ...". |
term |
A CUI application command line with arguments | Run a CUI application inside the Terminal Console dtvt-bridge. Usage example type=term cmd="cui_app ...". It is the same as type=dtvt cmd="vtm -r term cui_app ...". |
dtvt |
A DirectVT-aware application command line with arguments | Run a DirectVT-aware application inside the DirectVT Gateway. Usage example type=dtvt cmd="dtvt_app ...". |
dtty |
A DirectVT-aware application command line with arguments | Run a DirectVT-aware application inside the DirectVT Gateway with TTY which has additional controlling terminal. Usage example type=dtty cmd="dtvt_app ...". |
tile |
[[ v[n:m:w] | h[n:m:w] ] ( id1 | nested_block , id2 | nested_block )] |
Run tiling window manager with layout specified in cmd. Usage example type=tile cmd="v(h1:1(Term, Term),Term)".n:m - Ratio between panes (default n:m=1:1).w - Resizing grip width (default w=1). |
site |
cmd=@ or empty |
The attribute title=<view_title> is used to set region name/title. Setting the value of the cmd attribute to @ adds numbering to the title. |
The following configuration items produce the same final result:
<item ... cmd=mc/>
<item ... type=vtty cmd=mc/>
<item ... type=dtvt cmd='vtm -r vtty mc'/>
In vtm there are several layers of key combination processing. Each layer has its own set of key bindings. Keys processed at the previous layer usually do not get to the next one.
| Layer | Config section | Description |
|---|---|---|
| Native GUI window | <config/hotkeys/gui/> |
Native GUI window layer key bindings. |
| TUI matrix | <config/hotkeys/tui/> |
TUI matrix layer key bindings. |
| Desktop environment | <config/hotkeys/desktop/> |
Desktop layer key bindings (taskbar and window management). |
Application app_name |
<config/hotkeys/app_name/> |
Application layer key bindings. |
The syntax for defining key combination bindings is:
<key="Key+Chord" action="NameOfAction" scheme=N/> <!-- scheme=0 can be omitted. -->| Tag | Value |
|---|---|
key |
The text string containing the key combination. |
action |
The action name. |
scheme |
Hotkey scheme for which mapping is being done (0 by default). Either 0 or 1 are allowed. |
The following joiners are allowed for combining keys:
| Joiner | Meaning |
|---|---|
+ |
The subsequent key is in pressed state. |
- |
The subsequent key is in released state. This joiner is allowed for the last key only. |
Key combinations can be of the following types:
| Type | Example | Description |
|---|---|---|
Generic |
Ctrl+A |
A generic key combination without distinction left/right and numpad. |
Literal |
Alt+'a' |
A generic key combination without distinction left/right and numpad, except for the last key represented as a single-quoted character/string generated by the key. |
Specific |
LeftShift+RightShift |
A key combination with explicitly specified physical keys. |
Scancodes |
0x3B+0x3C |
A key combination represented solely by scan codes of physical keys in hexadecimal format. |
Generic, literal and specific key sequences can be mixed in any order.
The required key combination sequence can be generated on the Info page, accessible by clicking on the label in the lower right corner of the vtm desktop.
| Configuration record | Interpretation |
|---|---|
<key="Key+Chord" action=NameOfAction/> |
Append existing bindings using an indirect reference (the NameOfAction variable without quotes). |
<key="Key+Chord" action="NameOfAction"/> |
Append existing bindings with the directly specified command "NameOfAction". |
<key="Key+Chord" action="NameOfAction" scheme=1/> |
Append existing bindings for scheme=1. |
<key="Key+Chord" action=""/> |
Remove all existing bindings for the specified key combination "Key+Chord". |
<key="" action="NameOfAction"/> |
Do nothing. |
| Action | Default key combination | Available at layer | Description |
|---|---|---|---|
Drop |
All layers | Drop all events for the specified key combination. No further processing. | |
DropAutoRepeat |
All layers | Drop Key Repeat events for the specified key combination. This binding should be specified before the main action for the key combination. |
|
ToggleDebugOverlay |
TUI matrix | Toggle debug overlay. | |
ToggleHotkeyScheme |
Ctrl-Alt, Alt-Ctrl |
TUI matrix | Toggle hotkey scheme between scheme=0 (default) and scheme=1. |
IncreaseCellHeight |
CapsLock+UpArrow |
Native GUI window | Increase the text cell height by one pixel. |
DecreaseCellHeight |
CapsLock+DownArrow |
Native GUI window | Decrease the text cell height by one pixel. |
ResetCellHeight |
Ctrl+Key0 |
Native GUI window | Reset text cell height. |
ToggleFullscreenMode |
Alt+Enter |
Native GUI window | Toggle fullscreen mode. |
ToggleAntialiasingMode |
Ctrl+CapsLock |
Native GUI window | Toggle text antialiasing mode. |
RollFontsBackward |
Ctrl+Shift+F11 |
Native GUI window | Roll font list backward. |
RollFontsForward |
Ctrl+Shift+F12 |
Native GUI window | Roll font list forward. |
FocusPrevWindow |
Ctrl+PageUp |
Desktop | Switch focus to the next desktop window. |
FocusNextWindow |
Ctrl+PageDown |
Desktop | Switch focus to the previous desktop window. |
Disconnect |
Shift+F7 |
Desktop | Disconnect from the desktop. |
TryToQuit |
F10 |
Desktop | Shut down the desktop server if no applications are running. |
TerminalFindNext |
Alt+RightArrow |
Application | Highlight next match of selected text fragment. Clipboard content is used if no active selection. |
TerminalFindPrev |
Alt+LeftArrow |
Application | Highlight previous match of selected text fragment. Clipboard content is used if no active selection. |
TerminalViewportOnePageUp |
Shift+Ctrl+PageUp |
Application | Scroll one page up. |
TerminalViewportOnePageDown |
Shift+Ctrl+PageDown |
Application | Scroll one page down. |
TerminalViewportOnePageLeft |
Shift+Alt+LeftArrow |
Application | Scroll one page to the left. |
TerminalViewportOnePageRight |
Shift+Alt+RightArrow |
Application | Scroll one page to the right. |
TerminalViewportOneCharUp |
Shift+Ctrl+UpArrow |
Application | Scroll one line up. |
TerminalViewportOneCharDown |
Shift+Ctrl+DownArrow |
Application | Scroll one line down. |
TerminalViewportOneCharLeft |
Shift+Ctrl+LeftArrow |
Application | Scroll one cell to the left. |
TerminalViewportOneCharRight |
Shift+Ctrl+RightArrow |
Application | Scroll one cell to the right. |
TerminalViewportTop |
Shift+Ctrl+Home |
Application | Scroll to the scrollback top. |
TerminalViewportEnd |
Shift+Ctrl+End |
Application | Scroll to the scrollback bottom (reset viewport position). |
TerminalViewportCopy |
Application | Сopy viewport to clipboard. | |
TerminalClipboardPaste |
Application | Paste from clipboard. | |
TerminalClipboardWipe |
Application | Reset clipboard. | |
TerminalUndo |
Application | (Win32 Cooked/ENABLE_LINE_INPUT mode only) Discard the last input. | |
TerminalRedo |
Application | (Win32 Cooked/ENABLE_LINE_INPUT mode only) Discard the last Undo command. | |
TerminalToggleCwdSync |
Application | Toggle the current working directory sync mode. | |
TerminalToggleWrapMode |
Application | Toggle terminal scrollback lines wrapping mode. Applied to the active selection if it is. | |
TerminalToggleSelectionMode |
Application | Toggle between linear and rectangular selection form. | |
TerminalToggleFullscreen |
Application | Toggle fullscreen mode. | |
TerminalToggleMaximize |
Application | Toggle between maximized and normal window size. | |
TerminalToggleStdioLog |
Application | Stdin/stdout log toggle. | |
TerminalQuit |
Application | Terminate runnning console apps and close terminal. | |
TerminalRestart |
Application | Terminate runnning console apps and restart current session. | |
TerminalSwitchCopyMode |
Application | Switch terminal text selection copy mode. | |
TerminalSelectionCopy |
Application | Сopy selection to clipboard. | |
TerminalSelectionCancel |
Esc |
Application | Deselect a selection. |
TerminalSelectionOneShot |
Application | One-shot toggle to copy text while mouse tracking is active. Keep selection if 'Ctrl' key is pressed. |
The value of the cfg menu item attribute (or a whole <config> subsection) will be passed to the child dtvt-aware application on launch.
settings.xml:... <desktop> <taskbar> ... <item ... title="DirectVT-aware Application" type=dtvt ... cfg="plain xml data as alternative to <config> subsection" cmd="dtvt_app..."> <config> <!-- item's `<config>` subsection in case of 'cfg=' is not specified --> ... </config> </item> ... </taskbar> </desktop> ...
~/.config/vtm/settings.xml:
<config>
<desktop>
<taskbar selected=Term item*> <!-- Use asterisk to remove previous/existing items from the list. -->
<item id=Term/> <!-- id=Term title="Term" type=SHELL cmd=os_default_shell -->
</taskbar>
</desktop>
</config>Notes
- Hardcoded settings can be found in the source file /src/vtm.xml.
- The
$0tag will be expanded to the fully qualified current module filename at runtime.
$VTM-CONFIG=/path/to/settings.xml.
settings.xml:
<file*/> <!-- Clear previously defined sources. Start a new list. -->
<file="/path/to/override_defaults.xml"/> <!-- Reference to the base configuration. -->
<config>
<gui> <!-- GUI mode related settings. (win32 platform only for now) -->
<antialiasing=on/> <!-- Antialiasing of rendered glyphs. Note: Multi-layered color glyphs such as emoji are always antialiased. -->
<cellheight=20/> <!-- Text cell height in physical pixels. Note: The width of the text cell depends on the primary font (the first one in the font list). -->
<gridsize=""/> <!-- Window initial grid size "width,height" in text cells. If gridsize="" or gridsize=0,0, then the size of the GUI window is left to the OS window manager. -->
<wincoor=""/> <!-- Window initial coordinates "x,y" (top-left corner on the desktop in physical pixels). If wincoor="", then the position of the GUI window is left to the OS window manager. -->
<winstate="normal"/> <!-- Window initial state: normal | maximized | minimized . -->
<blinkrate=400ms/> <!-- SGR5/6 attribute blink rate. Blinking will be disabled when set to zero. -->
<fonts> <!-- Font fallback ordered list. The rest of the fonts available in the system will be loaded dynamically. -->
<font*/> <!-- Clear previously defined fonts. Start a new list. -->
<font="Courier New"/> <!-- The first font in the list: Primary font. Its metrics define the cell geometry. -->
<font="Cascadia Mono"/>
<font="NSimSun"/>
<font="Noto Sans Devanagari"/>
</fonts>
</gui>
<cursor>
<style="bar"/> <!-- Cursor style: "bar" | "block" | "underline" ( | █ _ ). -->
<blink=400ms/> <!-- Cursor blink period. Set to zero for a steady cursor. -->
<show=true/>
<color fgc=color/default bgc=color/default/> <!-- Cursor cell color. By default, the cursor color (bgc) is set to either black or white depending on the lightness of the underlying text background. -->
</cursor>
<tooltips> <!-- Not implemented for GUI mode. -->
<timeout=2000ms/>
<enabled=true/>
<color fgc=pureblack bgc=purewhite/>
</tooltips>
<debug>
<logs=off/> <!-- Enable logging. Use the Logs or vtm monitor mode (vtm -m) to see the log output. -->
<overlay=off/> <!-- Show debug overlay. -->
<regions=0/> <!-- Highlight UI objects boundaries. -->
</debug>
<clipboard>
<preview enabled=no size=80x25> <!-- Not implemented for GUI mode. -->
<color fgc=whitelt bgc=bluedk/>
<alpha=0xFF/> <!-- Preview alpha is applied only to the ansi/rich/html text type. -->
<timeout=3s/> <!-- Preview hiding timeout. Set it to zero to disable hiding. -->
<shadow=3 /> <!-- Preview shadow strength (0-5). -->
</preview>
<format="html"/> <!-- Default clipboard format for screenshots: "text" | "ansi" | "rich" | "html" | "protected" . -->
</clipboard>
<colors> <!-- Along with fgc, bgc and txt, other SGR attributes (boolean) are allowed here: itc: italic, bld: bold, und: underline, inv: reverse, ovr: overline, blk: blink. -->
<window fgc=whitelt bgc=0x80404040 /> <!-- Base desktop window color. -->
<focus fgc=purewhite bgc=bluelt /> <!-- Focused item tinting. -->
<brighter fgc=purewhite bgc=purewhite alpha=60/> <!-- Brighter. -->
<shadower bgc=0xB4202020 /> <!-- Dimmer. -->
<warning fgc=whitelt bgc=yellowdk /> <!-- "Warning" color. -->
<danger fgc=whitelt bgc=purered /> <!-- "Danger" color. -->
<action fgc=whitelt bgc=greenlt /> <!-- "Action" color. -->
</colors>
<timings>
<fps=60/> <!-- Frames per second. Maximum frequency of rendering UI updates. -->
<kinetic> <!-- Kinetic scrolling. -->
<spd = 10 /> <!-- Initial speed component ΔR. -->
<pls = 167 /> <!-- Initial speed component ΔT. -->
<ccl = 120 /> <!-- Duration in ms. -->
<spd_accel = 1 /> <!-- Speed accelation. -->
<ccl_accel = 30 /> <!-- Additional duration in ms. -->
<spd_max = 100 /> <!-- Max speed. -->
<ccl_max = 1000/> <!-- Max duration in ms. -->
</kinetic>
<switching = 200ms/> <!-- Duration of an object state switching. -->
<deceleration = 2s /> <!-- Duration of stopping a moving object. -->
<leave_timeout = 1s /> <!-- Timeout off the active object (e.g. after mouse leaving scrollbar). -->
<repeat_delay = 500ms/> <!-- Repeat delay. -->
<repeat_rate = 30ms /> <!-- Repeat rate. -->
<dblclick = 500ms/> <!-- Mouse double click threshold. -->
</timings>
<set> <!-- Global namespace - Unresolved literals will try to be resolved from here. -->
<blackdk = 0xFF101010 /> <!-- Color reference literals. -->
<reddk = 0xFFc40f1f />
<greendk = 0xFF12a10e />
<yellowdk = 0xFFc09c00 />
<bluedk = 0xFF0037db />
<magentadk = 0xFF871798 />
<cyandk = 0xFF3b96dd />
<whitedk = 0xFFbbbbbb />
<blacklt = 0xFF757575 />
<redlt = 0xFFe64856 />
<greenlt = 0xFF15c60c />
<yellowlt = 0xFFf8f1a5 />
<bluelt = 0xFF3a78ff />
<magentalt = 0xFFb3009e />
<cyanlt = 0xFF60d6d6 />
<whitelt = 0xFFf3f3f3 />
<pureblack = 0xFF000000 />
<purewhite = 0xFFffffff />
<purered = 0xFFff0000 />
<puregreen = 0xFF00ff00 />
<pureblue = 0xFF0000ff />
<puremagenta = 0xFFff00ff />
<purecyan = 0xFF00ffff />
<pureyellow = 0xFFff00ff />
<nocolor = 0x00000000 />
<color>
<default = 0x00ffffff />
<transparent = nocolor />
</color>
<menu>
<autohide=no/> <!-- Auto hide window menu items on mouse leave. -->
<slim=true/> <!-- Make the window menu one cell high (slim=true) or three cells high (slim=false). -->
</menu>
<selection>
<mode="text"/> <!-- Clipboard copy format: "text" | "ansi" | "rich" | "html" | "protected" | "none" . -->
<rect=false/> <!-- Preferred selection form: Rectangular: true, Linear: false. -->
</selection>
</set>
<desktop> <!-- Desktop client settings. -->
<viewport coor=0,0/> <!-- Viewport position for the first connected user. At runtime, this value is temporarily replaced with the next disconnecting user's viewport coordinates to restore the viewport position on reconnection. -->
<windowmax=3000x2000/> <!-- Maximum window cell grid size. -->
<macstyle=no/> <!-- Preferred window control buttons location. no: right corner (like on MS Windows), yes: left side (like on macOS). -->
<taskbar wide=off selected="Term"> <!-- Taskbar menu. wide: Set wide/compact menu layout; selected: Set selected taskbar menu item id. -->
<item*/> <!-- Clear all previously defined items. Start a new list of items. -->
<item splitter label="apps">
<notes>
" Default applications group \n"
" It can be configured in ~/.config/vtm/settings.xml "
</notes>
</item>
<item* hidden=no winsize=0,0 wincoor=0,0 winform="normal"/> <!-- Asterisk in the xml node name to set default node values (it is a template). -->
<item id="Term" label="Term" type="dtvt" title="Terminal Console" cmd="$0 -r term">
<notes>
" Terminal Console \n"
" LeftClick to launch instance \n"
" RightClick to set as default "
</notes>
<config> <!-- The following config partially overrides the base configuration. It is valid for DirectVT apps only. -->
<term>
<scrollback>
<size=40000/> <!-- Scrollback buffer length. -->
<wrap=on/> <!-- Lines wrapping mode. -->
</scrollback>
<selection>
<mode=/config/set/selection/mode/> <!-- Clipboard copy format: "text" | "ansi" | "rich" | "html" | "protected" | "none" . -->
</selection>
</term>
</config>
</item>
<item id="Tile" label="Tile" type="tile" title="Tiling Window Manager" cmd="h1:1(Term, Term)" notes=" Tiling Window Manager \n LeftClick to launch instance \n RightClick to set as default "/>
<item id="Site" label="Site" type="site" title="\e[11:3pSite " cmd="@" winform="maximized" notes=" Desktop Region Marker \n LeftClick to launch instance \n RightClick to set as default "/> <!-- "\e[11:3p" for center alignment, cmd="@" for instance numbering -->
<item id="Logs" label="Logs" type="dtvt" title="Logs" cmd="$0 -q -r term $0 -m" notes=" Log Monitor \n LeftClick to launch instance \n RightClick to set as default ">
<config>
<term>
<scrollback>
<size=5000/>
<wrap="off"/>
</scrollback>
<menu item*>
<autohide=menu/autohide/>
<slim=menu/slim/>
<item label="<" action=TerminalFindPrev> <!-- type=Command is a default item's attribute. -->
<label="\e[38:2:0:255:0m<\e[m"/>
<notes>
" Previous match \n"
" LeftClick to jump to previous match or scroll \n"
" one page up if nothing to search \n"
" Match clipboard data if no selection \n"
" Left+RightClick to clear clipboard "
</notes>
</item>
<item label=">" action=TerminalFindNext>
<label="\e[38:2:0:255:0m>\e[m"/>
<notes>
" Next match \n"
" LeftClick to jump to next match or scroll \n"
" one page down if nothing to search \n"
" Match clipboard data if no selection \n"
" Left+RightClick to clear clipboard "
</notes>
</item>
<item label="Wrap" type="Option" action=TerminalWrapMode data="off">
<label="\e[38:2:0:255:0mWrap\e[m" data="on"/>
<notes>
" Wrapping text lines on/off \n"
" Applied to selection if it is "
</notes>
</item>
<item label="Selection" notes=" Text selection mode " type="Option" action=TerminalSelectionMode data="none"> <!-- type=Option means that the тext label will be selected when clicked. -->
<label="\e[38:2:0:255:0mPlaintext\e[m" data="text"/>
<label="\e[38:2:255:255:0mANSI-text\e[m" data="ansi"/>
<label data="rich">
"\e[38:2:109:231:237m""R"
"\e[38:2:109:237:186m""T"
"\e[38:2:60:255:60m" "F"
"\e[38:2:189:255:53m" "-"
"\e[38:2:255:255:49m" "s"
"\e[38:2:255:189:79m" "t"
"\e[38:2:255:114:94m" "y"
"\e[38:2:255:60:157m" "l"
"\e[38:2:255:49:214m" "e" "\e[m"
</label>
<label="\e[38:2:0:255:255mHTML-code\e[m" data="html"/>
<label="\e[38:2:0:255:255mProtected\e[m" data="protected"/>
</item>
<item label="Reset" notes=" Clear scrollback and SGR-attributes " action=TerminalOutput data="\e[!p"/>
</menu>
</term>
</config>
</item>
<autorun item*> <!-- Autorun specified menu items: -->
<!-- <item* id=Term winsize=80,25 /> -->
<!-- <item wincoor=92,31 winform=minimized /> --> <!-- Autorun supports minimized winform only. -->
<!-- <item wincoor=8,31 /> -->
<!-- <item wincoor=8,4 winsize=164,25 focused /> -->
</autorun>
<width> <!-- Taskbar menu width. -->
<folded=16/>
<expanded=32/>
</width>
<timeout=250ms/> <!-- Taskbar collaplse timeout after mouse leave. -->
<colors>
<bground fgc=whitedk bgc=0xC0202020 /> <!-- Set the bgc color non-transparent (alpha to FF) to disable acrylics in taskbar. -->
<focused fgc=puregreen /> <!-- Focused taskbar item color. -->
<selected fgc=whitelt /> <!-- Default taskbar item color. -->
<active fgc=whitelt /> <!-- Running taskbar item color. -->
<inactive fgc=blacklt bgc=color.transparent/> <!-- Blocked taskbar item color (e.g. when the app is maximized by a remote user). -->
</colors>
</taskbar>
<panel> <!-- Desktop info panel. -->
<env=""/> <!-- Environment block. -->
<cmd=""/> <!-- Command-line to activate. -->
<cwd=""/> <!-- Working directory. -->
<height=1/> <!-- Desktop space reserved on top. -->
</panel>
<background> <!-- Desktop background. -->
<color fgc=whitedk bgc=0x80000000/> <!-- Desktop background color. -->
<tile=""/> <!-- Truecolor ANSI-art with gradients can be used here. -->
</background>
<shadow enabled=0> <!-- Desktop window shadows (TUI mode). -->
<blur=3/> <!-- Blur radius (in cells). Default is "3". -->
<bias=0.37/> <!-- Shadow contour bias [0.0 - 1.0]. Default is "0.37". -->
<opacity=105.5/> <!-- Opacity level (alpha) [0.0 - 255.0]. Default is "105.5". -->
<offset=2,1/> <!-- 2D offset relative to the window (in cells). Default is "2,1". -->
</shadow>
</desktop>
<term> <!-- Base settings for the Term app. It can be partially overridden by the menu item's config subarg. -->
<sendinput=""/> <!-- Send input on startup. E.g. sendinput="echo \"test\"\n" -->
<cwdsync=" cd $P\n"/> <!-- Command to sync the current working directory. When 'Sync' is active, $P (case sensitive) will be replaced with the current path received via OSC9;9 notification. Prefixed with a space to avoid touching command history. -->
<scrollback>
<size=40000 /> <!-- Initial scrollback buffer size. -->
<growstep=0 /> <!-- Scrollback buffer grow step. The buffer behaves like a ring in case of zero. -->
<growlimit=0 /> <!-- Scrollback buffer grow limit. The buffer will behave like a ring when the limit is reached. If set to zero, then the limit is equal to the initial buffer size. -->
<maxline=65535 /> <!-- Max line length. Line splits if it exceeds the limit. -->
<wrap=on /> <!-- Lines wrapping mode. -->
<reset onkey=on onoutput=off/> <!-- Scrollback viewport position reset triggers. -->
<altscroll=on /> <!-- Alternate scroll mode settings. -->
<oversize=0 opacity=0xC0/> <!-- Scrollback horizontal (left and right) oversize. It is convenient for horizontal scrolling. -->
</scrollback>
<colors> <!-- Terminal colors. -->
<color0 = pureblack /> <!-- Link to global <config/set/*/> namespace. -->
<color1 = reddk />
<color2 = greendk />
<color3 = yellowdk />
<color4 = bluedk />
<color5 = magentadk />
<color6 = cyandk />
<color7 = whitedk />
<color8 = blacklt />
<color9 = redlt />
<color10 = greenlt />
<color11 = yellowlt />
<color12 = bluelt />
<color13 = magentalt />
<color14 = cyanlt />
<color15 = whitelt />
<default fgc=whitedk bgc=pureblack/> <!-- Default/current colors (SGR49/39). -->
<bground = color/default/> <!-- Independent background color of the scrollback canvas. Set to 0x00ffffff(or =/config/set/color/default) to sync with SGR49 (default background). -->
<match fx="color" fgc=whitelt bgc=0xFF007F00/> <!-- Color of the selected text occurrences. Set an fx to use cell::shaders: "xlight" | "color" | "invert" | "reverse". -->
<selection>
<text fx="color" fgc=whitelt bgc=bluelt/> <!-- Highlighting of the selected text in plaintext mode. -->
<protected fx="color" fgc=whitelt bgc=bluelt/> <!-- Note: The bgc and fgc attributes only apply to the fx=color shader. -->
<ansi fx="xlight" fgc=whitelt bgc=bluelt/>
<rich fx="xlight" fgc=whitelt bgc=bluelt/>
<html fx="xlight" fgc=whitelt bgc=bluelt/>
<none fx="color" fgc=whitedk bgc=blacklt/> <!-- Inactive selection color. -->
</selection>
</colors>
<border=0/> <!-- Width of the left and right border of the terminal window. -->
<tablen=8/> <!-- Tab length. -->
<menu item*>
<autohide=menu/autohide/> <!-- Link to global <config/set/menu/autohide>. -->
<slim=menu/slim/> <!-- Link to global <config/set/menu/slim>. -->
<item label="<" action=TerminalFindPrev> <!-- type=Command is a default item's attribute. -->
<label="\e[38:2:0:255:0m<\e[m"/>
<notes>
" Previous match \n"
" LeftClick to jump to previous match or scroll \n"
" one page up if nothing to search \n"
" Match clipboard data if no selection \n"
" Left+RightClick to clear clipboard "
</notes>
</item>
<item label=">" action=TerminalFindNext>
<label="\e[38:2:0:255:0m>\e[m"/>
<notes>
" Next match \n"
" LeftClick to jump to next match or scroll \n"
" one page down if nothing to search \n"
" Match clipboard data if no selection \n"
" Left+RightClick to clear clipboard "
</notes>
</item>
<item type="Command" action=ToggleHotkeyScheme>
<label=" Undef " data="undef"/>
<label=" Keys0 " data="off"/>
<label="\e[48:2:0:128:128;38:2:0:255:0m Keys1 \e[m" data="on"/>
<notes>
" Toggle hotkey scheme \n"
" Alternative hotkey scheme allows keystrokes \n"
" to be passed through without processing "
</notes>
</item>
<item label="Wrap" type="Option" action=TerminalWrapMode data="off">
<label="\e[38:2:0:255:0mWrap\e[m" data="on"/>
<notes>
" Wrapping text lines on/off \n"
" Applied to selection if it is "
</notes>
</item>
<item label="Selection" notes=" Text selection mode " type="Option" action=TerminalSelectionMode data="none"> <!-- type=Option means that the тext label will be selected when clicked. -->
<label="\e[38:2:0:255:0mPlaintext\e[m" data="text"/>
<label="\e[38:2:255:255:0mANSI-text\e[m" data="ansi"/>
<label data="rich">
"\e[38:2:109:231:237m""R"
"\e[38:2:109:237:186m""T"
"\e[38:2:60:255:60m" "F"
"\e[38:2:189:255:53m" "-"
"\e[38:2:255:255:49m" "s"
"\e[38:2:255:189:79m" "t"
"\e[38:2:255:114:94m" "y"
"\e[38:2:255:60:157m" "l"
"\e[38:2:255:49:214m" "e" "\e[m"
</label>
<label="\e[38:2:0:255:255mHTML-code\e[m" data="html"/>
<label="\e[38:2:0:255:255mProtected\e[m" data="protected"/>
</item>
<item label="Sync" notes=" CWD sync is off " type="Option" action=TerminalCwdSync data="off">
<label="\e[38:2:0:255:0mSync\e[m" notes=" CWD sync is on \n Make sure your shell has OSC9;9 enabled " data="on"/>
</item>
<item label="Log" notes=" Console logging is off " type="Option" action=TerminalStdioLog data="off">
<label="\e[38:2:0:255:0mLog\e[m" notes=" Console logging is on \n Run Logs to see output " data="on"/>
</item>
<item label="Clear" notes=" Clear TTY viewport " action=TerminalOutput data="\e[2J"/>
<item label="Reset" notes=" Clear scrollback and SGR-attributes " action=TerminalOutput data="\e[!p"/>
<!-- <item label="Hello, World!" notes=" Simulate keypress " action=TerminalSendKey data="Hello World!"/> -->
</menu>
<selection>
<mode=selection/mode/> <!-- Selection clipboard copy format: "text" | "ansi" | "rich" | "html" | "protected" | "none". -->
<rect=selection/rect/> <!-- Preferred selection form: Rectangular: true, Linear: false. -->
</selection>
<atexit="auto"/> <!-- Behavior after the last console process has terminated: "auto" | "ask" | "close" | "restart" | "retry"
auto: Stay open and ask if exit code != 0. (default)
ask: Stay open and ask.
close: Always close.
restart: Restart session.
retry: Restart session if exit code != 0. -->
</term>
<defapp>
<menu>
<autohide=menu/autohide/> <!-- Link to global <config/set/menu/autohide>. -->
<slim=menu/slim/> <!-- Link to global <config/set/menu/slim>. -->
</menu>
</defapp>
<hotkeys> <!-- The required key combination sequence can be generated on the Info page, accessible by clicking on the label in the lower right corner of the vtm desktop. -->
<gui key*> <!-- Native GUI window layer key bindings. key* here is to clear all previous bindings and start a new list. -->
<key="CapsLock+UpArrow" action=IncreaseCellHeight/> <!-- Increase the text cell height by one pixel. -->
<key="CapsLock+DownArrow" action=DecreaseCellHeight/> <!-- Decrease the text cell height by one pixel. -->
<key="Ctrl+0" action=DropAutoRepeat/> <!-- Don't repeat the Reset text cell height. -->
<key="Ctrl+0" action=ResetCellHeight/> <!-- Reset text cell height. -->
<key="Alt+Enter" action=DropAutoRepeat/> <!-- Don't repeat the Toggle fullscreen mode. -->
<key="Alt+Enter" action=ToggleFullscreenMode/> <!-- Toggle fullscreen mode. -->
<key="Ctrl+CapsLock" action=DropAutoRepeat/> <!-- Don't repeat the Toggle text antialiasing mode. -->
<key="Ctrl+CapsLock" action=ToggleAntialiasingMode/> <!-- Toggle text antialiasing mode. -->
<key="Ctrl+Shift+F11" action=DropAutoRepeat/> <!-- Don't repeat the Roll font list backward. -->
<key="Ctrl+Shift+F11" action=RollFontsBackward/> <!-- Roll font list backward. -->
<key="Ctrl+Shift+F12" action=DropAutoRepeat/> <!-- Don't repeat the Roll font list forward. -->
<key="Ctrl+Shift+F12" action=RollFontsForward/> <!-- Roll font list forward. -->
</gui>
<tui key*> <!-- TUI matrix layer key bindings. The scheme=0 is implicitly used by default. -->
<key="Space-Backspace" action=ToggleDebugOverlay/> <!-- Toggle debug overlay. -->
<key="Backspace-Space" action=ToggleDebugOverlay/> <!-- Toggle debug overlay (reversed release order). -->
<key="Ctrl-Alt" action=ToggleHotkeyScheme/> <!-- Toggle hotkey scheme to 1 by pressing and releasing Ctrl-Alt. -->
<key="Alt-Ctrl" action=ToggleHotkeyScheme/> <!-- Toggle hotkey scheme to 1 by pressing and releasing Alt-Ctrl (reversed releasing). -->
<key="Ctrl-Alt" scheme=1 action=ToggleHotkeyScheme/> <!-- Toggle hotkey scheme to 0 (default) by pressing and releasing Ctrl-Alt. -->
<key="Alt-Ctrl" scheme=1 action=ToggleHotkeyScheme/> <!-- Toggle hotkey scheme to 0 (default) by pressing and releasing Alt-Ctrl (reversed releasing). -->
</tui>
<desktop key*> <!-- Desktop layer key bindings. -->
<key="Ctrl+PageUp" action=FocusPrevWindow/> <!-- Switch focus to the next desktop window. -->
<key="Ctrl+PageDown" action=FocusNextWindow/> <!-- Switch focus to the previous desktop window. -->
<key="Shift+F7" action=Disconnect/> <!-- Disconnect from the desktop. -->
<key="F10" action=TryToQuit/> <!-- Shut down the desktop server if no applications are running. -->
<!-- <key="Ctrl+N" action="Start(\"Term\")"/> -->
</desktop>
<term key*> <!-- Application specific layer key bindings. -->
<key="Alt+RightArrow" action=TerminalFindNext/> <!-- Highlight next match of selected text fragment. Clipboard content is used if no active selection. -->
<key="Alt+LeftArrow" action=TerminalFindPrev/> <!-- Highlight previous match of selected text fragment. Clipboard content is used if no active selection. -->
<key="Shift+Ctrl+PageUp" action=TerminalViewportOnePageUp/> <!-- Scroll one page up. -->
<key="Shift+Ctrl+PageDown" action=TerminalViewportOnePageDown/> <!-- Scroll one page down. -->
<key="Ctrl+PageUp" scheme=1 action=TerminalViewportOnePageUp/> <!-- Scroll one page up. -->
<key="Ctrl+PageDown" scheme=1 action=TerminalViewportOnePageDown/> <!-- Scroll one page down. -->
<key="Shift+Alt+LeftArrow" action=TerminalViewportOnePageLeft/> <!-- Scroll one page to the left. -->
<key="Shift+Alt+RightArrow" action=TerminalViewportOnePageRight/> <!-- Scroll one page to the right. -->
<key="Shift+Ctrl+UpArrow" action=TerminalViewportOneCharUp/> <!-- Scroll one line up. -->
<key="Shift+Ctrl+DownArrow" action=TerminalViewportOneCharDown/> <!-- Scroll one line down. -->
<key="Shift+Ctrl+LeftArrow" action=TerminalViewportOneCharLeft/> <!-- Scroll one cell to the left. -->
<key="Shift+Ctrl+RightArrow" action=TerminalViewportOneCharRight/> <!-- Scroll one cell to the right. -->
<key="Shift+Ctrl+Home" action=DropAutoRepeat/> <!-- Don't repeat the Scroll to the scrollback top. -->
<key="Shift+Ctrl+Home" action=TerminalViewportTop/> <!-- Scroll to the scrollback top. -->
<key="Shift+Ctrl+End" action=DropAutoRepeat/> <!-- Don't repeat the Scroll to the scrollback bottom (reset viewport position). -->
<key="Shift+Ctrl+End" action=TerminalViewportEnd/> <!-- Scroll to the scrollback bottom (reset viewport position). -->
<key="" action=TerminalViewportCopy/> <!-- Сopy viewport to clipboard. -->
<key="" action=TerminalClipboardPaste/> <!-- Paste from clipboard. -->
<key="" action=TerminalClipboardWipe/> <!-- Reset clipboard. -->
<key="" action=TerminalUndo/> <!-- (Win32 Cooked/ENABLE_LINE_INPUT mode only) Discard the last input. -->
<key="" action=TerminalRedo/> <!-- (Win32 Cooked/ENABLE_LINE_INPUT mode only) Discard the last Undo command. -->
<key="" action=TerminalToggleCwdSync/> <!-- Toggle the current working directory sync mode. -->
<key="" action=TerminalToggleWrapMode/> <!-- Toggle terminal scrollback lines wrapping mode. Applied to the active selection if it is. -->
<key="" action=TerminalToggleSelectionMode/> <!-- Toggle between linear and rectangular selection form. -->
<key="" action=TerminalToggleFullscreen/> <!-- Toggle fullscreen mode. -->
<key="" action=TerminalToggleMaximize/> <!-- Toggle between maximized and normal window size. -->
<key="" action=TerminalToggleStdioLog/> <!-- Stdin/stdout log toggle. -->
<key="" action=TerminalQuit/> <!-- Terminate runnning console apps and close terminal. -->
<key="" action=TerminalRestart/> <!-- Terminate runnning console apps and restart current session. -->
<key="" action=TerminalSwitchCopyMode/> <!-- Switch terminal text selection copy mode. -->
<key="" action=TerminalSelectionCopy/> <!-- Сopy selection to clipboard. -->
<key="Esc" action=TerminalSelectionCancel/> <!-- Deselect a selection. -->
<key="" action=TerminalSelectionOneShot/> <!-- One-shot toggle to copy text while mouse tracking is active. Keep selection if 'Ctrl' key is pressed. -->
</term>
</hotkeys>
</config>