Attributes

The following top-level attributes are configurable in config.yml. See this example config file for more details.

wtf:
  colors:
    background: "red"
    border:
      focusable: "darkslateblue"
      focused: "orange"
      normal: "gray"
  grid:
    # How _wide_ the columns are, in terminal characters. In this case we have
    # six columns, each of which are 35 characters wide
    columns: [35, 35, 35, 35, 35, 35]

    # How _high_ the rows are, in terminal lines. In this case we have five rows
    # that support ten line of text, one of three lines, and one of four
    rows: [10, 10, 10, 10, 10, 3, 4]
  openFileUtil: open      # the name of the utility to call to open files
  refreshInterval: 1      # the app refreshes once per second
  term: "xterm-256color"

Attributes

colors.background
The color to draw the background of the app in. Use this to match your terminal colors. May be over-written by individual module configurations.
Values: Any X11 color name.

colors.border.focusable
The color in which to draw the border of widgets that can accept keyboard focus.
Values: Any X11 color name.

colors.border.focused
The color in which to draw the border of the widget that currently has keyboard focus.
Values: Any X11 color name.

colors.border.normal
The color in which to draw the borders of the widgets that cannot accept focus.
Values: Any X11 color name.

grid.columns
An array that defines the widths of all the columns.
Values: See tview’s Grid for details.

grid.rows
An array that defines the heights of all the rows.
Values: See tview’s Grid for details.

openFileUtil
Command to use to open a file or URL

refreshInterval
How often, in seconds, the UI refreshes itself.
Note: This implementation is probably wrong and buggy and likely to change.
Values: A positive integer, 0..n.

term
Optional.
Sets a custom value for the terminal type this app runs in. Leave this entry out of the config if you simply want to use your terminal’s default setting.
Note: If an invalid value is provided for this setting, the app will crash with a "terminal entry not found" error.
Values: Any valid terminal type (ie: vt100, xterm, xterm-256color, ansi, etc.).