What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

btop exposes all three controls you need—box layout, color output, and refresh timing—in its options interface and in the persistent btop.conf file. Use presets and shown_boxes for the dashboard structure, color_theme plus the color-mode settings for appearance, and update_ms for the refresh interval.

The configuration and log directory is $XDG_CONFIG_HOME/btop when XDG_CONFIG_HOME is set. If it is not set, btop uses $HOME/.config/btop. The project documents these settings in its README and startup switches in its man page.

Choose between the options screen and btop.conf

btop’s built-in options interface can change every configuration option, so it is the safest starting point when you are learning the names and ranges. Once you know the setting you want, editing btop.conf is useful for repeatable setups, dotfile management, or applying several changes at once.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Find the directory that btop uses with this shell expression:

#1 Best Overall
Sale
Compressed Air Duster,130000RPM Super Power Cordless Air Duster,Rechargeable Brushless Blower,3 Gear Adjustable Blower with LED Light,Dust Remover for Computer/House/Outdoor/Car
  • Powerful Turbo Fan:CAGIWIRU Electric Air Duster have reached speed up to 130000RPM,Can efficient remove dust and debris.With LED light and Three Adjustable Speed to meet with different cleaning tasks.
  • With Attached USB C Fasting Charging cable.Charing 3 hours,Enjoy up to 240 minutes of use on the lowest setting, For third speed can use for 25mins.with four charging options to meet with your needs.
  • Wide Application:Upgraded attached 5 different nozzles,making it suitable for a variety of scenes, such as car,pet, pc, keyboards, and other electronic devices. It also serves for office and home clean duster.
  • Handy Design & Portable:Cordless air duster electric nozzle is Light weight and small size, design and comfortable to hold and space saving, convenient to carry around. You can put it in your room or inside the car without taking up space.
  • Warranty & Support: Our Electric air duster comes with 5 years warranty and 24/7 customer service. During this period, if you have any questions,pls kindly feel free to contact us.
printf '%sn' "${XDG_CONFIG_HOME:-$HOME/.config}/btop"

That path is also where btop keeps its log files. A typical configuration file is named btop.conf inside the directory. Before making manual edits, close btop and make a backup:

cp "${XDG_CONFIG_HOME:-$HOME/.config}/btop/btop.conf" "${XDG_CONFIG_HOME:-$HOME/.config}/btop/btop.conf.backup"

If the file does not exist yet, open btop, change an option in its interface, and let btop create its configuration. The exact keyboard shortcut for opening the options view can vary with the release and is shown in btop’s on-screen help.

Arrange the dashboard with presets

A preset describes the arrangement of btop’s boxes. The presets setting contains one or more definitions, and btop selects one definition when it starts. The upstream configuration comments define each box entry as box_name:P:G: the box name identifies the panel, P selects one of two alternate positions, and G selects the graph symbol. Preset definitions are separated by whitespace, while the entries inside a definition are comma-separated.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What preset 0 means

Preset 0 is special: it always displays all boxes with the default settings. It is a reliable fallback when an experimental arrangement makes a panel hard to find. The configuration supports up to nine additional presets, and the command-line selector accepts IDs from 0 through 9.

Switch presets at startup

Use -p or its long form, --preset, followed by an ID:

btop --preset 0
btop --preset 3

The first command requests the built-in all-boxes arrangement. The second requests preset 3 from your configuration. A startup selection changes that run; it does not by itself rewrite the preset definitions in btop.conf.

Build or edit a preset definition

  1. Open btop.conf in a text editor after making a backup.
  2. Locate the presets setting. Keep each box entry in the documented box_name:P:G form.
  3. Use the documented box name for every panel you want in an arrangement. Change the position field P only between its two supported alternatives, and choose a graph symbol value supported by your btop version for G.
  4. Separate entries in the same preset with commas and separate preset definitions with whitespace.
  5. Save the file, start btop with --preset and the desired ID, and check that every panel appears where expected.

If you are unsure which graph symbol or position combination your release accepts, copy the existing commented example in your generated configuration and change one entry at a time. This avoids guessing at values that can differ between versions.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
EVEO® Screen Cleaner Spray Kit (Streak-Free) TV Screen Cleaner for Smart TV, Lcd, LEd, Oled | Computer Screen Cleaner Spray and Wipe Microfiber Cloth - TV, Monitor, Laptop, iPad, Car - 6.7oz 1 Pack
  • Screen Cleaner is Your Screen’s New Bestfriend! - EVEO is proud to present a screen cleaner that’s perfectly suited for your TV. Meet your new screen cleaner, computer screen cleaner, laptop cleaner, iPad cleaner, Macbook,tv cleaner or any other electronic device. Our screen cleaner spray and wipe along with the included plush microfiber cloth, easily removes dust, fingerprints & other smudges on the screen’s surface. Clean effectively for a streak-free screen
  • Gentle on your Screens - Our screen cleaner spray and wipes is compatible to be used even for the most sensitive LCD, LED, CRT, and OLED screens in proper use. Be at ease knowing that this product is compatible with all the major brands: LG, SONY, Samsung, Sharp, iPad, iPhone, Android screens, Kindle, PC monitors - we’ve got you covered! Can be used as LCD screen cleaner, tv cleaner, smart tv screen cleaner, and more
  • Premium Super Soft Plush Microfiber Cloth - Included in this efficient screen cleaning kit. This screen cleaner spray and wipe has our signature plush microfiber cloth specially designed to comply with screens and monitors and leave them streak-free. Has been shown to effectively absorbs stubborn stains, zero streaks, and no fiber shedding. Always use this together with our screen cleaner for the best results
  • Easy-to-Use Screen Cleaner Kit + microfiber cleaning cloth - The EVEO Screen Cleaning Kit will easily be your new favorite tool when it comes to taking care of the things you love most, quick and easy solution for a streak-free screen. Simply screw on the sprayer gun on the screen cleaner bottle. Spray the cleaning liquid onto the microfiber cloth, then wipe the screen until desired cleanliness & shine is achieved.
  • Quality Screen Care Kit Worth Purchasing - Enjoy a convenient Screen Cleaner anytime, anywhere you need it. Your satisfaction is our top priority. We stand behind the quality of our products and that’s why, you shouldn’t be worrying at all. We manufacture the Best Screen Cleaner. and can be used for laptop cleaning kit, laptop screen cleaner, tv screen cleaner for smart tv. MacBook screen cleaner, monitor cleaner or screen cleaner spray for electronic devices with microfiber cleaning cloth

Control which boxes appear with shown_boxes

presets controls arrangement; it is not the visibility switch. The separate shown_boxes option names the boxes that btop should display. Documented names include:

  • cpu for processor statistics
  • mem for memory and swap information
  • net for network activity
  • proc for the process list
  • gpu0 through gpu5 for supported graphics devices

A minimal visibility line can therefore look like this:

shown_boxes = cpu mem net proc

To show a GPU panel, add the corresponding name, such as gpu0, if btop detects that device. If a box is omitted from shown_boxes, rearranging presets cannot make it visible; add it to the visibility list first.

Presets and shown_boxes together

Think of the two settings as a two-stage filter. shown_boxes determines the available panels, and presets determines their positions and graph presentation. For example, you can keep a compact daily view by listing only CPU, memory, network, and processes, while retaining another preset that includes every detected GPU panel. When troubleshooting an empty area, check the visibility list before changing coordinates.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose a theme and terminal color mode

The color_theme setting selects a named theme. btop includes the built-in Default and TTY themes. The project also supports system and user theme directories, so installed theme files can be selected by name rather than copied into the main configuration file.

Select a built-in theme

Set the theme name in btop.conf:

color_theme = Default

For a terminal-oriented palette, use:

color_theme = TTY

Theme names are case-sensitive in practice when they correspond to file names, so copy the spelling used by the available theme file. The btop README lists the search locations and the theme-file format.

Use a custom theme directory

For a one-run test, point btop at a directory containing your theme files:

Rank #3
BladeHawks RGB Gaming Mouse Pad Extra Large Extended 31.5x12 Inch-Black
  • 【Large size】:Measuring 800 x 300 mm/ 31. 5×12 inches, which is wider and taller than others. Large mouse pad can perfectly fit your keyboard and mouse of any size, and there is also ample space for peripherals such as phones, tablets, etc.
  • 【LED backlight mouse pad】:Blade Hawks RGB mouse pad provides 7 static modes and 7 dynamic modes will give you the options you are looking for. Power-off memory function remembers the last lighting mode you selected. The super glow fiber Chroma will give you a colorful gaming setup that you want.
  • 【Anti-slip rubber base】:Made from Natural rubber, this gaming mousepad will firmly grip your desktop, allowing you to enjoy the ultimate precision in the games you are most passionate about. It also comes with a texture that enhances this ability even further.
  • 【Smooth and waterproof surface】: Micro-textured cloth surface, for extremely precise mouse control and a smooth movement. When liquid splashes on the gaming mouse pad, it forms water droplets and slides down. Will not delay your work or gameplay.
  • 【Plug and play】: This mouse and keyboard pad is powered by USB, plug and play, no driver required. One button control light modes. Press one time to change the lighting mode, press twice to change the brightness, press and hold about 3 seconds turn ON/OFF.
btop --themes-dir "$HOME/.config/btop/themes"

The --themes-dir option takes priority over the default theme search paths. This is useful when you keep themes in a dotfiles repository or want to test a theme without installing it system-wide. The directory must contain theme files in btop’s expected format; selecting a name that is not present there will leave btop unable to load that custom palette.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The project says btop uses the same theme files as bpytop and bashtop, but also notes that some color values are missing in bashtop themes. A theme may therefore load while still leaving some btop-specific colors at defaults. Do not assume that every bashtop theme exposes every btop feature.

Match color output to your terminal

Theme choice and color depth are separate decisions. A vivid theme can still look wrong when the terminal cannot display the colors it requests. btop’s documented modes are:

Mode How to select it Terminal requirement Graph behavior
24-bit truecolor truecolor = true (the default) A terminal with truecolor support Uses the theme’s full 24-bit colors and provides the best visual fidelity
256-color conversion truecolor = false or the --low-color startup option A terminal that supports 256 colors Converts 24-bit theme colors to the 256-color palette
16-color TTY mode The --tty startup option A basic TTY or similarly limited terminal Uses 16 colors and TTY-friendly graph symbols

Keep truecolor enabled when your terminal supports it:

truecolor = true

For a persistent 256-color configuration, set:

truecolor = false

For a temporary test, use:

btop --low-color

TTY mode is a stronger compatibility fallback:

btop --tty

Use --low-color when you want the normal interface with converted colors. Use --tty when both color count and graph glyph compatibility are concerns. The README describes 24-bit output as the best experience and 256-color terminals as supported through conversion; neither mode changes the underlying monitoring data.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Diagnose washed-out or unreadable colors

  1. Start btop without a custom theme and confirm that Default is readable.
  2. Run btop --low-color. If readability improves, your terminal or connection is not handling truecolor correctly.
  3. Run btop --tty when working on a raw console, serial session, or terminal with unreliable line-drawing characters.
  4. Only after the mode is correct, switch back to your custom color_theme. This separates a theme-file problem from a terminal-capability problem.

Set the update interval with update_ms

update_ms is the refresh interval in milliseconds. The official configuration example uses 2000, and the project recommends 2000 milliseconds or more for better graph sample times.

update_ms = 2000

That value requests a two-second interval because 1,000 milliseconds equals one second. A slower example is:

Rank #4
Sale
Vaydeer Wrist Rest for Keyboard and Mouse, Computer Ergonomic Wrist Support Pad, Soft Memory Foam Arm Cushion for Desk, Palm Hand Office Laptop Typing
  • 【Softer and More Comfortable】Vaydeer wrist rest has unique diamond pattern, which is the combination of softness and aesthetics. The materials of wrist rest are improved into higher quality memory foam and covered with silky smooth lycra. The computer wrist rest makes you as comfortable and cushiony as like rest your wrists on clouds.
  • 【Ergonomic Wrist Saver】The wrist rests for keyboard and mouse comes with a 17.32×3.15×0.83 inch keyboard wrist pad and a 5.94×3.15×0.83 inch mouse wrist support. Based on ergonomic design, the unique concave shape is the perfect fit for your wrist joints. The wrist rest pad fits most computer keyboards and laptops, improve hand and wrist posture, release your wrist and arm stress.
  • 【Non-Slip Rubber Bottom】Featuring an anti-skid silicone base on the bottom, this wrist keyboard support stays firmly in place on your desk, preventing the padding from sliding around, ensuring stable and consistent wrist support during extended computer sessions.
  • 【Better Experience & Pain Relief】Our keyboard arm rest is beneficial to alleviate the soreness caused by direct contact and friction between your arm and a hard desk surface, reducing the risk of wrist fatigue or carpal tunnel. The soft texture of memory foam can evenly distribute the pressure around your wrists and provide good support with just enough give.
  • 【Helpful in Multiple Scenarios】Whether you're working, studying, writing, typing, gaming, this keyboard and mouse rest combo is an essential accessory to add comfort and support to your hands and wrists. It’s also a great gift for men, women, family, friend, coworker, gamer, teacher, etc.
update_ms = 5000

which requests five seconds between updates. Choose a shorter interval when you need a more immediate view of changing processes or network activity; choose a longer interval when a steadier graph sample cadence is more useful. The documentation gives the 2000-millisecond recommendation but does not publish a benchmark showing a particular CPU or battery saving at any other value.

Try a refresh rate without editing the file

Use -u or --update followed by an interval in milliseconds for a one-run override:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
btop --update 1000
btop --update 5000

These commands let you compare a one-second and five-second cadence without changing the persistent configuration. To keep the chosen value for later launches, set update_ms in btop.conf or save the equivalent change through btop’s options interface.

Balance responsiveness and graph sampling

The interval applies to the dashboard refresh, so it affects how often values are redrawn and how frequently graph samples are collected. Very short intervals can make a graph look busy without adding useful historical detail. Starting at 2000 ms or above follows the project’s documented guidance; adjust from there based on whether you prioritize quick visual feedback or a less frequently sampled display.

Apply all three customizations in a controlled workflow

  1. Back up the configuration. Copy btop.conf before changing it so you can restore a known-good file.
  2. Set visibility. Edit shown_boxes and list only the panels you need, adding gpu0 through gpu5 only for devices btop actually detects.
  3. Define arrangements. Edit presets using the documented box_name:P:G entries. Keep preset 0 available as the all-boxes fallback.
  4. Choose a palette. Set color_theme to Default, TTY, or an installed custom theme name.
  5. Set color depth. Leave truecolor enabled for a truecolor terminal; set it to false or use --low-color for 256-color output; use --tty for a 16-color TTY presentation.
  6. Set timing. Put the desired millisecond value in update_ms, or test a temporary value with --update.
  7. Verify from a clean launch. Start btop with the intended preset and any temporary flags, then check panel visibility, graph symbols, color contrast, and refresh cadence.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot settings that appear to be ignored

The edited file is not the file btop reads

Recheck whether XDG_CONFIG_HOME is set. If it is, btop uses $XDG_CONFIG_HOME/btop; otherwise it uses $HOME/.config/btop. Editing a similarly named file under the other directory will not change the active configuration.

A command-line option overrides the file

Startup switches are intentional per-run overrides. A launch using --preset, --update, --low-color, --tty, or --themes-dir can therefore produce output different from the values in btop.conf. Remove the temporary switch when checking the persistent setup.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A panel is missing

Check shown_boxes first. A panel omitted there cannot appear through a preset. For GPU panels, verify that the corresponding numbered name is included and that btop detects the device.

Best Value
Sale
Under Desk Cable Management Tray No Drill, Metal Mesh Cable Management Under Desk with Clamp Mount, 2 Hole Cable Tray with Wire Management and Cord Organizer for Home Office Standing Desk
  • 【No Drill Mounted】Cable management tray can be assembled in as little as 3 minutes or less-simply. Side clips easily clampe the edge of desk, pass through the holes on the sides, and secure excess cables with baskets. Desk cable management supports inward or outward installation to meet your needs in different scenarios, and provides you with great convenience when collecting and organizing wires.
  • 【Rubber Pad Protects Desk】Wire organizer under desk built-in soft rubber pads on the clamp protect your desk from scratches, so you will not damage your furniture or office.
  • 【Sturdy and Beautiful】Cord management under desk is made of high-quality carbon steel and holds about 15 lbs. The wire basket has 2 holes on each side of the tray to enable your cables to pass freely. Cable baskets are suitable for desk thickness use from 0.4" to 2.4".
  • 【Space Saving & Keep Organized】Desk cable management tray holds all your power cords, outlet strips, USB hubs and computer transformers hidden from your feet, and the data cables will not enter the vacuum cleaner to keep your desk clean and tidy. Desk wire organizer is also suitable for use in the kitchen and outdoors.
  • 【Reduce Safety Risks】Cable tray under desk keeps all plugs away from your kids, no more worry about tripping. Using 2 holes wire tray saves extra space, helps you easily cabling and wire protection. The mesh design is not easy to accumulate dust, but avoids safety accidents caused by messy wires.

The layout loads but looks wrong

Confirm that each preset entry follows box_name:P:G, that entries inside a preset are comma-separated, and that separate preset definitions are separated by whitespace. Restore the backup if a hand edit introduced an invalid value, then change one entry at a time.

A theme name has no effect

Confirm that the theme file is in one of btop’s searched directories or in the directory supplied with --themes-dir. Remember that a custom directory takes priority over the normal search paths, so an incomplete file with the same name there can be selected first.

Colors or graph characters are corrupted

Test the same theme with --low-color, then with --tty. Improvement in one of those modes indicates a terminal capability mismatch rather than a layout error. Keep the mode that matches the terminal where btop will normally run.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Graphs do not sample as expected

Check that update_ms is expressed in milliseconds, not seconds. A value of 2 means two milliseconds, not two seconds. Use 2000 or a larger value when following the project’s graph-sampling recommendation, and use --update to test alternatives without rewriting the file.

Useful command-line combinations

These examples combine the documented startup controls for common situations:

Goal Command What it changes
Use the all-boxes fallback btop --preset 0 Selects preset 0 for this launch
Try another saved arrangement btop --preset 3 Selects preset 3 for this launch
Slow the display for longer samples btop --update 5000 Uses a five-second interval for this launch
Use 256-color conversion btop --low-color Converts truecolor values to a 256-color palette
Use a basic TTY presentation btop --tty Forces 16 colors and TTY-friendly graph symbols
Test themes in a personal directory btop --themes-dir "$HOME/.config/btop/themes" Gives that directory priority for theme lookup

For a permanent setup, move the values you have validated into btop.conf. Keep startup flags in scripts or aliases only when you deliberately want a different profile for a particular terminal or task.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.