Flags

Warning

This section is in progress, and is just copied from the old documentation.

You can configure flags by putting them in [flags] table. Example:

[flags]
hide_avg_cpu = true

Most of the command line flags have config file equivalents to avoid having to type them out each time:

Field	Type	Functionality
hide_avg_cpu	Boolean	Deprecated - use cpu.hide_avg_cpu. Hides the average CPU usage.
dot_marker	Boolean	Uses a dot marker for graphs.
cpu_left_legend	Boolean	Deprecated - use cpu.left_legend. Puts the CPU chart legend to the left side.
current_usage	Boolean	Deprecated - use processes.current_usage. Sets process CPU% to be based on current CPU%.
group_processes	Boolean	Deprecated - use processes.default_grouped. Groups processes with the same name by default.
case_sensitive	Boolean	Deprecated - use processes.case_sensitive. Enables case sensitivity by default.
whole_word	Boolean	Deprecated - use processes.whole_word. Enables whole-word matching by default.
regex	Boolean	Deprecated - use processes.regex. Enables regex by default.
basic	Boolean	Hides graphs and uses a more basic look.
use_old_network_legend	Boolean	DEPRECATED - uses the older network legend.
battery	Boolean	Shows the battery widget.
rate	Unsigned Int (represents milliseconds) or String (represents human time)	Sets a refresh rate in ms.
default_time_value	Unsigned Int (represents milliseconds) or String (represents human time)	Default time value for graphs in ms.
time_delta	Unsigned Int (represents milliseconds) or String (represents human time)	The amount in ms changed upon zooming.
hide_time	Boolean	Hides the time scale.
temperature_type	String (one of ["k", "f", "c", "kelvin", "fahrenheit", "celsius"])	Sets the temperature unit type.
default_widget_type	String (one of ["cpu", "proc", "net", "temp", "mem", "disk"], same as layout options)	Sets the default widget type, use --help for more info.
default_widget_count	Unsigned Int (represents which default_widget_type)	Sets the n'th selected widget type as the default.
disable_click	Boolean	Disables mouse clicks.
enable_cache_memory	Boolean	Deprecated - use memory.cache_memory. Enable cache and buffer memory stats (not available on Windows).
process_memory_as_value	Boolean	Deprecated - use processes.default_memory_value. Defaults to showing process memory usage by value.
tree	Boolean	Deprecated - use processes.default_tree. Defaults to showing the process widget in tree mode.
show_table_scroll_position	Boolean	Shows the scroll position tracker in table widgets.
show_table_scroll_bar	Boolean	Shows a scroll bar on the right edge of table widgets.
process_command	Boolean	Deprecated - use processes.process_command. Show processes as their commands by default.
disable_advanced_kill	Boolean	Deprecated - use processes.disable_advanced_kill. Disable being able to send signals to processes on supported Unix-like systems. Only available on Linux, macOS, and FreeBSD.
read_only	Boolean	Prevents performing any actions that affect the system (e.g. stopping processes).
network_use_binary_prefix	Boolean	Deprecated - use network_graph.use_binary_prefix. Displays the network widget with binary prefixes.
network_use_bytes	Boolean	Deprecated - use network_graph.use_bytes. Displays the network widget using bytes.
network_use_log	Boolean	Deprecated - use network_graph.use_log. Displays the network widget with a log scale.
disable_gpu	Boolean	Disable NVIDIA and AMD GPU data collection.
retention	String (human readable time, such as "10m", "1h", etc.)	How much data is stored at once in terms of time.
unnormalized_cpu	Boolean	Deprecated - use processes.unnormalized_cpu. Show process CPU% without normalizing over the number of cores.
expanded	Boolean	Expand the default widget upon starting the app.
memory_legend	String (one of ["none", "top-left", "top", "top-right", "left", "right", "bottom-left", "bottom", "bottom-right"])	Deprecated - use memory.legend_position. Where to place the legend for the memory widget.
network_legend	String (one of ["none", "top-left", "top", "top-right", "left", "right", "bottom-left", "bottom", "bottom-right"])	Deprecated - use network_graph.legend_position. Where to place the legend for the network widget.
average_cpu_row	Boolean	Deprecated - use cpu.basic_average_cpu_row. Moves the average CPU usage entry to its own row when using basic mode.
tree_collapse	Boolean	Deprecated - use processes.tree_collapse. Collapse process tree by default.
autohide_time	Boolean	Temporarily shows the time scale in graphs.
table_gap	String (one of ["none", "space", "line"])	Controls the gap between table headers and data rows. Defaults to "space".
disable_keys	Boolean	Disables keyboard shortcuts, including the ones that stop bottom.
no_write	Boolean	Disables writing to the config file.
hide_k_threads	Boolean	Deprecated - use processes.hide_k_threads. Hide kernel threads from being shown.
free_arc	Boolean	Deprecated - use memory.free_arc. Subtract freeable ARC from memory usage.