### Install Bottom using Windows installer Source: https://github.com/clementtsang/bottom/blob/main/README.md Manually install Bottom on Windows by downloading and running the .msi installer file from the latest release page. ```bash You can manually install bottom as a Windows program by downloading and using the .msi file from the [latest release](https://github.com/ClementTsang/bottom/releases/latest). ``` -------------------------------- ### Install Bottom as a Snap package Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom using the snap package manager. After installation, connect necessary interfaces for full functionality. ```bash sudo snap install bottom # To allow the program to run as intended sudo snap connect bottom:mount-observe sudo snap connect bottom:hardware-observe sudo snap connect bottom:system-observe sudo snap connect bottom:process-control ``` -------------------------------- ### Install Bottom on Nix Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom using the 'nix profile install' command with the nixpkgs channel. This is a declarative way to manage packages. ```bash nix profile install nixpkgs#bottom ``` -------------------------------- ### Install Bottom using Scoop Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom on Windows using the Scoop package manager. This command installs the package from the Main bucket. ```bash scoop install bottom ``` -------------------------------- ### Install Bottom on Solus Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom on Solus using the eopkg package manager. This command will install the package from the Solus repositories. ```bash sudo eopkg it bottom ``` -------------------------------- ### Install Bottom using winget Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom on Windows using the winget package manager. You can use the general app ID or a more specific one if needed. ```bash winget install bottom # If you need a more specific app id: winget install Clement.bottom ``` -------------------------------- ### Install Bottom on Debian/Ubuntu using .deb Source: https://github.com/clementtsang/bottom/blob/main/README.md Download and install the .deb package for x86-64, ARM64, or ARMHF architectures. Ensure you use the correct architecture for your system. ```bash # x86-64 curl -LO https://github.com/ClementTsang/bottom/releases/download/0.14.2/bottom_0.14.2-1_amd64.deb sudo dpkg -i bottom_0.14.2-1_amd64.deb # ARM64 curl -LO https://github.com/ClementTsang/bottom/releases/download/0.14.2/bottom_0.14.2-1_arm64.deb sudo dpkg -i bottom_0.14.2-1_arm64.deb # ARM curl -LO https://github.com/ClementTsang/bottom/releases/download/0.14.2/bottom_0.14.2-1_armhf.deb sudo dpkg -i bottom_0.14.2-1_armhf.deb # musl-based curl -LO https://github.com/ClementTsang/bottom/releases/download/0.14.2/bottom-musl_0.14.2-1_amd64.deb sudo dpkg -i bottom-musl_0.14.2-1_amd64.deb ``` -------------------------------- ### Install Bottom using gah Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom on Linux or macOS using the 'gah' package manager. This is a convenient way to install cross-platform tools. ```bash gah install bottom ``` -------------------------------- ### Install and use Bottom with mise Source: https://github.com/clementtsang/bottom/blob/main/README.md Install and manage Bottom using 'mise'. The 'mise use -g bottom@latest' command installs the latest version globally. ```bash mise use -g bottom@latest ``` -------------------------------- ### Run Documentation Locally Source: https://github.com/clementtsang/bottom/blob/main/docs/README.md Steps to set up a Python virtual environment, install dependencies, and serve the documentation locally using MkDocs. ```bash # Change directories to the documentation. cd docs/ # Create and activate venv. python -m venv venv source venv/bin/activate # Install requirements pip install -r requirements.txt # Run mkdocs venv/bin/mkdocs serve ``` -------------------------------- ### Install Bottom on Void Linux Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom on Void Linux using the xbps-install command. This command fetches the package from the void-packages repository. ```bash sudo xbps-install bottom ``` -------------------------------- ### Install Bottom on Gentoo Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom using the emerge command with the official Gentoo repository. Ensure your package list is up-to-date. ```bash sudo emerge --ask sys-process/bottom ``` -------------------------------- ### Serve Local Documentation Source: https://github.com/clementtsang/bottom/blob/main/docs/content/contribution/documentation.md Use this script to serve a local version of the documentation. It installs dependencies and updates as you make changes, allowing for local validation. ```bash # Change directories to the documentation. cd docs/ # Create venv, install the dependencies, and serve the page. ./serve.sh ``` -------------------------------- ### Install Bottom using Chocolatey Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom on Windows using the Chocolatey package manager. This command will download and install the package from the Chocolatey repository. ```bash choco install bottom ``` -------------------------------- ### Install Bottom on openSUSE Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom on openSUSE Tumbleweed using the zypper package manager. This command will fetch and install the latest available version. ```bash zypper in bottom ``` -------------------------------- ### Get Bottom CLI Help Source: https://github.com/clementtsang/bottom/blob/main/README.md Display quick help overview or detailed help for Bottom CLI flags. ```bash btm -h ``` ```bash btm --help ``` -------------------------------- ### Install Bottom on Fedora/CentOS/AlmaLinux/Rocky Linux via Terra Source: https://github.com/clementtsang/bottom/blob/main/README.md Install the 'terra-release' package to enable the Terra repository, then install Bottom using DNF. Ensure the GPG key is correctly configured. ```bash sudo dnf install --repofrompath 'terra,https://repos.fyralabs.com/terra$releasever' --setopt='terra.gpgkey=https://repos.fyralabs.com/terra$releasever/key.asc' terra-release sudo dnf install bottom ``` -------------------------------- ### Install Bottom using Homebrew Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom on macOS using the Homebrew package manager. Ensure Homebrew is installed and updated before running this command. ```bash brew install bottom ``` -------------------------------- ### Install Bottom on Fedora/CentOS/AlmaLinux/Rocky Linux via COPR Source: https://github.com/clementtsang/bottom/blob/main/README.md Enable the 'atim/bottom' COPR repository and install Bottom using DNF. Note that this COPR may be unmaintained. ```bash sudo dnf copr enable atim/bottom -y sudo dnf install bottom ``` -------------------------------- ### Install Bottom on Exherbo Linux Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom using the 'cave' command with the 'rust' repository. This ensures you are using the Exherbo package manager. ```bash cave resolve -x repository/rust cave resolve -x bottom ``` -------------------------------- ### Install Bottom using Conda Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom using Conda by adding the 'conda-forge' channel and then installing the 'bottom' package. Ensure channel priority is set to strict. ```bash # Add the channel conda config --add channels conda-forge conda config --set channel_priority strict # Install conda install bottom ``` -------------------------------- ### Install Bottom using MacPorts Source: https://github.com/clementtsang/bottom/blob/main/README.md Install Bottom on macOS using the MacPorts package manager. This involves updating MacPorts and then installing the 'bottom' port. ```bash sudo port selfupdate sudo port install bottom ``` -------------------------------- ### Install bottom on Arch Linux Source: https://github.com/clementtsang/bottom/blob/main/README.md Installs the official 'bottom' package on Arch Linux using pacman. For the latest changes, 'bottom-git' can be installed from the AUR using helpers like paru or yay. ```bash sudo pacman -S bottom ``` ```bash # Using paru paru -S bottom-git # Using yay yay -S bottom-git ``` -------------------------------- ### Get Help with Bottom Commands Source: https://github.com/clementtsang/bottom/blob/main/docs/content/usage/general-usage.md View command-line options for Bottom. Use -h for a simple overview or --help for more details. ```bash btm -h ``` ```bash btm --help ``` -------------------------------- ### Install Bottom on Fedora/CentOS/AlmaLinux/Rocky Linux using .rpm Source: https://github.com/clementtsang/bottom/blob/main/README.md Download and install the .rpm package for x86 architecture. This method is suitable for systems using DNF package manager. ```bash curl -LO https://github.com/ClementTsang/bottom/releases/download/0.14.2/bottom-0.14.2-1.x86_64.rpm sudo dnf install ./bottom-0.14.2-1.x86_64.rpm ``` -------------------------------- ### Install bottom on Alpine Linux Source: https://github.com/clementtsang/bottom/blob/main/README.md Installs the 'bottom' package on Alpine Linux using the apk package manager. Related packages for documentation and shell completions are also available. ```bash apk add bottom ``` -------------------------------- ### Install bottom using Cargo Source: https://github.com/clementtsang/bottom/blob/main/README.md Installs the 'bottom' binary from crates.io. It's recommended to update Rust to the stable version first. The --locked flag ensures locked crate versions. ```bash rustup update stable cargo install bottom --locked ``` ```bash cargo +stable install bottom --locked ``` ```bash cargo install bottom ``` -------------------------------- ### Install bottom from source using Cargo Source: https://github.com/clementtsang/bottom/blob/main/README.md Installs 'bottom' by building from a downloaded archive or by cloning the repository. The --locked flag ensures locked crate versions. RUSTFLAGS can be used for CPU-specific optimizations. ```bash rustup update stable curl -LO https://github.com/ClementTsang/bottom/archive/0.14.2.tar.gz tar -xzvf 0.14.2.tar.gz cargo install --path . --locked ``` ```bash git clone https://github.com/ClementTsang/bottom cd bottom cargo install --path . --locked ``` ```bash cargo install --git https://github.com/ClementTsang/bottom --locked ``` ```bash RUSTFLAGS="-C target-cpu=native" cargo install --path . --locked ``` -------------------------------- ### Combine Disk Name and Mount Filters Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/disk-table.md Combine `[disk.name_filter]` and `[disk.mount_filter]` to refine which disk entries are displayed. This example includes entries not matching '/dev/sda' but excludes those matching '/mnt/.*' or '/' based on regex and whole word matching. ```toml [disk.name_filter] is_list_ignored = false list = ["/dev/sda"] regex = true case_sensitive = false whole_word = false [disk.mount_filter] is_list_ignored = true list = ["/mnt/.*", "/"] regex = true case_sensitive = false whole_word = true ``` -------------------------------- ### Connect Snap Permissions Source: https://github.com/clementtsang/bottom/blob/main/docs/content/troubleshooting.md Grant Bottom necessary permissions for snap installations to ensure widgets display data correctly. These commands connect specific interfaces required for observing system resources and processes. ```bash sudo snap connect bottom:mount-observe ``` ```bash sudo snap connect bottom:hardware-observe ``` ```bash sudo snap connect bottom:system-observe ``` ```bash sudo snap connect bottom:process-control ``` -------------------------------- ### Configure Flags in TOML Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/flags.md Set application flags by defining them within the `[flags]` table in your TOML configuration file. This example shows how to hide average CPU usage. ```toml [flags] hide_avg_cpu = true ``` -------------------------------- ### Update Rust Toolchain Source: https://github.com/clementtsang/bottom/blob/main/docs/content/contribution/packaging-and-distribution.md Ensures you have the latest stable version of Rust installed, which is required for building the project. ```bash rustup update stable ``` -------------------------------- ### Filter Disk Entries by Name Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/disk-io-graph.md Configure filtering for disk I/O graph entries based on their name. This example ignores entries matching '/dev/sda' using regex. ```toml [disk_io_graph.name_filter] # Whether to ignore any matches. Defaults to true. is_list_ignored = true # A list of filters to try and match. list = ["/dev/sda"] # Whether to use regex. Defaults to false. regex = true # Whether to be case-sensitive. Defaults to false. case_sensitive = false # Whether to require matching the whole word. Defaults to false. whole_word = false ``` -------------------------------- ### Configure Custom Styles Source: https://github.com/clementtsang/bottom/blob/main/docs/content/troubleshooting.md Define custom color and styling schemes for tables and headers under the `[styles]` table in your TOML configuration file. This example sets the header color to LightBlue and makes it bold. ```toml [styles.tables.headers] colour = "LightBlue" bold = true ``` -------------------------------- ### Enable Basic Mode via Command Line Source: https://github.com/clementtsang/bottom/blob/main/docs/content/usage/basic-mode.md Use the -b or --basic flags to launch bottom in basic mode directly from the command line. ```bash btm -b # or btm --basic ``` -------------------------------- ### Run Bottom Application Source: https://github.com/clementtsang/bottom/blob/main/docs/content/usage/general-usage.md Execute the Bottom application from the command line. ```bash btm ``` -------------------------------- ### Run Bottom CLI Binary Source: https://github.com/clementtsang/bottom/blob/main/README.md Execute the downloaded Bottom CLI binary from the current directory. ```bash ./btm ``` -------------------------------- ### Set Default CPU Graph Selection Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/cpu-graph.md Configure which CPU graph is shown by default on startup. Defaults to 'all'. ```toml [cpu] default = "average" ``` -------------------------------- ### Enable Basic Mode via Configuration Source: https://github.com/clementtsang/bottom/blob/main/docs/content/usage/basic-mode.md Set the 'basic' flag to true within the [flags] section of your bottom configuration file to enable basic mode. ```toml [flags] basic = true ``` -------------------------------- ### Enable Bottom via home-manager on Nix Source: https://github.com/clementtsang/bottom/blob/main/README.md Configure Bottom to be enabled through the home-manager module. This is a declarative approach for managing user-specific configurations. ```nix { programs.bottom.enable = true; } ``` -------------------------------- ### Deploy Stable Documentation Source: https://github.com/clementtsang/bottom/blob/main/docs/README.md Commands to deploy stable documentation, including renaming the previous stable version and updating aliases for the new release. ```bash cd docs # Rename the previous stable version mike retitle --push stable $OLD_STABLE_VERSION # Set the newest version as the most recent stable version mike deploy --push --update-aliases $RELEASE_VERSION stable # Append a "(stable)" string to the end. mike retitle --push $RELEASE_VERSION "$RELEASE_VERSION (stable)" ``` -------------------------------- ### Generate Manpages and Completions Source: https://github.com/clementtsang/bottom/blob/main/docs/content/contribution/packaging-and-distribution.md Builds the project while enabling the generation of manpages and shell completion files. Set the BTM_GENERATE environment variable to a non-empty value to trigger this. The generated files will be placed in target/tmp/bottom/ by default. ```bash BTM_GENERATE=true cargo build --release --locked ``` -------------------------------- ### Set Built-in Theme via Config File Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/styling.md Configure the application's theme by adding this setting to your configuration file. ```toml [styles] theme = "gruvbox" ``` -------------------------------- ### Deploy Nightly Documentation Source: https://github.com/clementtsang/bottom/blob/main/docs/README.md Command to deploy the nightly documentation using mike, pushing changes to the remote repository. ```bash cd docs mike deploy nightly --push ``` -------------------------------- ### Specify Configuration File Location Source: https://github.com/clementtsang/bottom/blob/main/docs/content/troubleshooting.md Use the `--config` or `-C` flags to specify a custom path to your configuration file if it's not in the default location. ```bash btm -C path_to_config ``` -------------------------------- ### Publishing to crates.io Source: https://github.com/clementtsang/bottom/blob/main/docs/content/contribution/development/deploy_process.md After validating builds, use this command to publish the Bottom package to crates.io. ```bash cargo publish ``` -------------------------------- ### Configure Text Styling with Color, Background, and Bold Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/styling.md Set the foreground color, background color, and bold property for text elements. All fields are optional. ```toml [field] colour = "black" bg_colour = "blue" bold = false # Inline table version field = { colour = "black", bg_colour = "blue", bold = false } ``` -------------------------------- ### Set Refresh Rate in Configuration Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/flags.md Configure the application's refresh rate using the `rate` flag in the `[flags]` table. The rate can be specified in milliseconds as an unsigned integer or as a human-readable string. ```toml [flags] rate = "1s" ``` -------------------------------- ### Tagging a Stable Release Source: https://github.com/clementtsang/bottom/blob/main/docs/content/contribution/development/deploy_process.md Use this command to create a Git tag for a stable release, which automatically triggers the deployment workflow. ```bash git tag 0.6.9 && git push origin 0.6.9 ``` -------------------------------- ### Show CPU Usage Decimals Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/cpu-graph.md Configure whether CPU usage values are displayed with a decimal place. Defaults to false. ```toml [cpu] show_decimal = true ``` -------------------------------- ### Show Unmounted Devices in Disk Table (Linux) Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/disk-table.md Enable `include_unmounted` to display unmounted devices on Linux systems. Unmounted devices will show I/O activity but have 'N/A' for space-related columns. ```toml [disk] include_unmounted = true ``` -------------------------------- ### Include Unmounted Devices (Linux) Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/disk-io-graph.md Enable the display of unmounted disk devices in the I/O graph on Linux systems. Defaults to showing only mounted devices. ```toml [disk_io_graph] include_unmounted = true ``` -------------------------------- ### Configure CPU Component Colors Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/styling.md Set specific colors for the 'All' CPU label, average CPU label/graph, and individual CPU core labels/graphs. Colors are applied in the order they appear. ```toml [styles.cpu] all_entry_colour = "Red" avg_entry_colour = "255, 0, 255" cpu_core_colours = ["Red", "Blue", "Green"] ``` -------------------------------- ### Set Built-in Theme via Command Line Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/styling.md Use this command to apply a built-in theme directly from your terminal. ```bash btm --theme gruvbox ``` -------------------------------- ### Configure Disk Table Columns Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/disk-table.md Set the `columns` option to specify which columns to display in the disk table widget. The order of column names in the list determines their display order. ```toml [disk] # Pick which columns you want to use in any order. columns = ["Disk", "Mount", "Used", "Free", "Total", "Used%", "R/s", "W/s"] ``` -------------------------------- ### Configure Process Columns Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/processes.md Specify which columns to display in the process widget and their order. This setting is part of the `[processes]` section in the configuration file. ```toml [processes] # Pick which columns you want to use in any order. columns = ["cpu%", "mem%", "pid", "name", "read", "write", "tread", "twrite", "state", "user", "time", "gmem%", "gpu%"] ``` -------------------------------- ### Sample TOML Layout Configuration Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/layout.md This TOML structure defines a two-row layout with nested columns and specific widget types. Ratios control the relative sizing of rows and columns. ```toml [[row]] [[row.child]] type="cpu" [[row]] ratio=2 [[row.child]] ratio=4 type="mem" [[row.child]] ratio=3 [[row.child.child]] type="temp" [[row.child.child]] type="disk" ``` -------------------------------- ### Average CPU Row in Basic Mode Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/cpu-graph.md In basic mode, give the average CPU entry a dedicated row. Defaults to false. ```toml [cpu] basic_average_cpu_row = true ``` -------------------------------- ### Custom Component Styling with Color and Background Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/styling.md Customize the foreground and background colors for specific components like widget titles. Supports named, hex, and RGB colors. ```toml # This is okay [styles.widgets.widget_title] colour = "black" bg_colour = "white" [styles.cpu] all_entry_colour = "green" # This is also okay [styles.widgets.widget_title] color = "black" bg_color = "white" [styles.cpu] all_entry_color = "green" ``` -------------------------------- ### Configure Widget Selected Text Color Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/styling.md A shorthand for setting only the foreground color for selected text within widgets. ```toml [styles.widgets] selected_text = "#fff" ``` -------------------------------- ### Build Project with Cargo Source: https://github.com/clementtsang/bottom/blob/main/docs/content/contribution/packaging-and-distribution.md Compiles the project in release mode, creating an optimized binary. The --locked flag ensures that the exact versions of dependencies specified in Cargo.lock are used. ```bash cargo build --release --locked ``` -------------------------------- ### Generate JSON Schema using Scripts Source: https://github.com/clementtsang/bottom/blob/main/schema/README.md Execute shell scripts for generating schemas, with specific scripts for stable releases and nightly builds. ```bash scripts/schema/generate.sh ``` ```bash scripts/schema/nightly.sh ``` -------------------------------- ### Show/Hide Read/Write Lines Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/disk-io-graph.md Control the visibility of read and write rate lines in the disk I/O graph. Defaults to showing both. ```toml [disk_io_graph] # Whether to show the read rate line. Defaults to true. show_read = true # Whether to show the write rate line. Defaults to true. show_write = true ``` -------------------------------- ### Enable Logarithmic Scale for Y-axis Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/disk-io-graph.md Switch the y-axis of the disk I/O graph to a logarithmic scale for better visualization of wide data ranges. ```toml [disk_io_graph] use_log = true ``` -------------------------------- ### Run with Elevated Privileges on macOS Source: https://github.com/clementtsang/bottom/blob/main/docs/content/troubleshooting.md Use sudo to run Bottom with elevated privileges on macOS if you cannot see all processes. Ensure you trust the software before granting root access. ```bash sudo btm ``` -------------------------------- ### Configure Disk Name Filter Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/disk-table.md Filter disk entries by name using `[disk.name_filter]`. Configure `list`, `regex`, `case_sensitive`, and `whole_word` to control the filtering behavior. `is_list_ignored` determines whether to ignore or include matching entries. ```toml [disk.name_filter] # Whether to ignore any matches. Defaults to true. is_list_ignored = true # A list of filters to try and match. list = ["/dev/sda"] # Whether to use regex. Defaults to false. regex = true # Whether to be case-sensitive. Defaults to false. case_sensitive = false # Whether to require matching the whole word. Defaults to false. whole_word = false ``` -------------------------------- ### Set Default Sort Order for Processes Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/processes.md Define the default column by which the process widget is sorted on startup. This can be overridden by a command-line flag. ```toml [processes] default_sort = "mem" ``` -------------------------------- ### Configure Temperature Graph Colors Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/styling.md Define the colors for each temperature sensor's graph line. Colors are applied in the order they are listed. ```toml [styles.temp_graph] temp_graph_colour_styles = ["Red", "Blue", "Green"] ``` -------------------------------- ### Generate JSON Schema from Tools Source: https://github.com/clementtsang/bottom/blob/main/schema/README.md Use the cargo run command with the schema generator tool to output JSON schemas to stdout. This requires the 'generate_schema' feature flag. ```bash cargo run --manifest-path tools/schema_gen/Cargo.toml ``` ```bash cargo run --manifest-path tools/schema_gen/Cargo.toml > schema/nightly/bottom.json ``` ```bash cargo run --manifest-path tools/schema_gen/Cargo.toml -- 0.12.0 > schema/v0.12.0/bottom.json ``` -------------------------------- ### Configure Memory Component Colors Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/styling.md Customize the colors for RAM, cache, swap, and ARC labels and graph lines. Also configure colors for multiple GPU memory graphs. Colors are applied in order. ```toml [styles.memory] ram_colour = "Red" cache_colour = "#ffffff" swap_colour = "255, 0, 255" arc_colour = "Blue" gpu_colours = ["Red", "Blue", "Green"] ``` -------------------------------- ### Linux Memory Calculation Formula Source: https://github.com/clementtsang/bottom/blob/main/docs/content/usage/widgets/memory-graph.md This formula, based on values from /proc/meminfo, calculates memory usage on Linux systems. It's derived from htop's implementation. ```text MemTotal - MemFree - Buffers - (Cached + SReclaimable - Shmem) ``` -------------------------------- ### Place CPU Legend on Left Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/cpu-graph.md Place the CPU chart legend on the left side. Defaults to false. ```toml [cpu] left_legend = true ``` -------------------------------- ### Set Legend Labels by Mount Point Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/disk-io-graph.md Configure the disk I/O graph legend to use mount points instead of disk names. Valid values are "disk" (default) and "mount". ```toml [disk_io_graph] legend = "mount" ``` -------------------------------- ### Hide Average CPU Entry Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/cpu-graph.md Hide the average CPU entry entirely. Defaults to false. ```toml [cpu] hide_avg_cpu = true ``` -------------------------------- ### Set Default Sort Order for Disk Table Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/disk-table.md Customize the default sort order of the disk table by setting the `default_sort` option to a valid column name. If an invalid column name is used, it defaults to the first column shown. ```toml [disk] default_sort = "R/s" ``` -------------------------------- ### Configure Sensor Filter for Temperature Graph Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/temperature-graph.md Filter which sensors are plotted on the temperature graph. This configuration ignores sensors with 'cpu' or 'wifi' in their name. ```toml [temperature_graph.sensor_filter] is_list_ignored = true list = ["cpu", "wifi"] regex = false case_sensitive = false whole_word = false ``` -------------------------------- ### Set Default Sort Order via CLI Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/processes.md Use the command-line flag to set the default sort order for the process widget. This takes precedence over the configuration file setting. ```bash btm --process_default_sort mem ``` -------------------------------- ### Configure Sensor Filtering for Temperature Table Source: https://github.com/clementtsang/bottom/blob/main/docs/content/configuration/config-file/temperature-table.md Filter which sensor entries are displayed in the temperature table. Configure `sensor_filter` to ignore or include specific sensors based on a list and matching criteria. ```toml [temperature.sensor_filter] # Whether to ignore any matches. Defaults to true. is_list_ignored = true # A list of filters to try and match. list = ["cpu", "wifi"] # Whether to use regex. Defaults to false. regex = false # Whether to be case-sensitive. Defaults to false. case_sensitive = false # Whether to require matching the whole word. Defaults to false. whole_word = false ``` -------------------------------- ### Configure Temperature Type Source: https://github.com/clementtsang/bottom/blob/main/docs/content/troubleshooting.md Set the temperature type within the `[flags]` table in your TOML configuration file. Supported values include 'f' for Fahrenheit. ```toml [flags] temperature_type = "f" ```