summaryrefslogtreecommitdiffstats
path: root/docs/content/configuration/command-line-flags.md
blob: e2ab53ae541d2542254c707c15f3b5af8d294f96 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# Command-line Flags

The following flags can be provided to bottom in the command line to change the behaviour of the program. You can also
see information on these flags by running `btm -h`, or run `btm --help` to display more detailed information on each flag:

| Flag                                | Behaviour                                                             |
| ----------------------------------- | --------------------------------------------------------------------- |
| --autohide_time                     | Temporarily shows the time scale in graphs.                           |
| -b, --basic                         | Hides graphs and uses a more basic look.                              |
| --battery                           | Shows the battery widget.                                             |
| -S, --case_sensitive                | Enables case sensitivity by default.                                  |
| -c, --celsius                       | Sets the temperature type to Celsius.                                 |
| --color <COLOR SCHEME>              | Use a color scheme, use --help for info.                              |
| -C, --config <CONFIG PATH>          | Sets the location of the config file.                                 |
| -u, --current_usage                 | Sets process CPU% to be based on current CPU%.                        |
| -t, --default_time_value <TIME>     | Default time value for graphs.                                        |
| --default_widget_count <INT>        | Sets the n'th selected widget type as the default.                    |
| --default_widget_type <WIDGET TYPE> | Sets the default widget type, use --help for info.                    |
| --disable_advanced_kill             | Hides advanced process killing.                                       |
| --disable_click                     | Disables mouse clicks.                                                |
| -m, --dot_marker                    | Uses a dot marker for graphs.                                         |
| --enable_cache_memory               | Enable collecting and displaying cache and buffer memory.             |
| --enable_gpu                        | Enable collecting and displaying GPU usage.                           |
| -e, --expanded                      | Expand the default widget upon starting the app.                      |
| -f, --fahrenheit                    | Sets the temperature type to Fahrenheit.                              |
| -g, --group_processes               | Groups processes with the same name by default.                       |
| -a, --hide_avg_cpu                  | Hides the average CPU usage.                                          |
| --hide_table_gap                    | Hides spacing between table headers and entries.                      |
| --hide_time                         | Hides the time scale.                                                 |
| -k, --kelvin                        | Sets the temperature type to Kelvin.                                  |
| -l, --left_legend                   | Puts the CPU chart legend to the left side.                           |
| --mem_as_value                      | Defaults to showing process memory usage by value.                    |
| --network_use_binary_prefix         | Displays the network widget with binary prefixes.                     |
| --network_use_bytes                 | Displays the network widget using bytes.                              |
| --network_use_log                   | Displays the network widget with a log scale.                         |
| --process_command                   | Show processes as their commands by default.                          |
| -r, --rate <TIME>                   | Sets the data refresh rate.                                           |
| -R, --regex                         | Enables regex by default.                                             |
| --retention <TIME>                  | The timespan of data stored.                                          |
| --show_table_scroll_position        | Shows the scroll position tracker in table widgets.                   |
| -d, --time_delta <TIME>             | The amount of time changed upon zooming.                              |
| -T, --tree                          | Defaults the process widget be in tree mode.                          |
| -n, --unnormalized_cpu              | Show process CPU% usage without normalizing over the number of cores. |
| --use_old_network_legend            | DEPRECATED - uses a separate network legend.                          |
| -V, --version                       | Prints version information.                                           |
| -W, --whole_word                    | Enables whole-word matching by default.                               |
| -h, --help                          | Print help (see more with '--help')                                   |