docs/content/configuration/config-file/flags.md
!!! 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_graph.legend_position or 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 or network.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 ARC memory that can be freed from memory usage. |