mirror of
https://github.com/ClementTsang/bottom
synced 2024-11-27 14:40:43 +00:00
85 lines
3.9 KiB
Markdown
85 lines
3.9 KiB
Markdown
# Troubleshooting
|
|
|
|
## The graph points look broken/strange
|
|
|
|
It's possible that your graphs won't look great out of the box due to the reliance on braille fonts.
|
|
|
|
One example of this is seeing a bunch of missing font characters, caused when the terminal isn't configured properly to render braille fonts.
|
|
|
|
<figure>
|
|
<img src="../assets/screenshots/troubleshooting/no_braille.webp" alt="Example of a terminal with no braille font."/>
|
|
<figcaption>Powershell shown missing braille fonts</figcaption>
|
|
</figure>
|
|
|
|
Another example is when braille is rendered as a block of dots, with the non-coloured dots also appearing. This may look strange for some users, and it is also caused by misconfiguration or missing fonts.
|
|
|
|
<figure>
|
|
<img src="../assets/screenshots/troubleshooting/weird_braille.webp" alt="Example of a terminal with the wrong braille font."/>
|
|
<figcaption>Braille fonts rendering as a block of dots</figcaption>
|
|
</figure>
|
|
|
|
In either case, you may need to install a specific font and configure your terminal to use it. For example, installing [UBraille](https://yudit.org/download/fonts/UBraille/)
|
|
and ensuring your terminal uses it should work.
|
|
|
|
Another alternative is to use the `--dot_marker` option to render graph charts using dots instead of the braille characters, which generally seems better supported out of the box,
|
|
at the expense of looking less intricate:
|
|
|
|
<figure>
|
|
<img src="../assets/screenshots/troubleshooting/dots.webp" alt="Example of running bottom with the dot marker flag"/>
|
|
<figcaption>Example using <code>btm --dot_marker</code></figcaption>
|
|
</figure>
|
|
|
|
## Why can't I see all my processes/process usage on macOS?
|
|
|
|
You may have to run the program with elevated privileges - for example:
|
|
|
|
```bash
|
|
sudo btm
|
|
```
|
|
|
|
_Please note that you should be certain that you trust any software you grant root privileges._
|
|
|
|
There are measures taken to try to maximize the amount of information obtained without elevated privileges, but there may still be some limitations.
|
|
|
|
## My configuration file isn't working
|
|
|
|
If your configuration files aren't working, here are a few things to try:
|
|
|
|
### Check the formatting
|
|
|
|
It may be handy to refer to the automatically generated config files or the [sample configuration files](https://github.com/ClementTsang/bottom/tree/master/sample_configs).
|
|
The config files also follow the [TOML](https://toml.io/en/) format.
|
|
|
|
Also make sure your config options are under the right table - for example, to set your temperature type, you must set it under the `[flags]` table:
|
|
|
|
```toml
|
|
[flags]
|
|
temperature_type = "f"
|
|
```
|
|
|
|
Meanwhile, if you want to set a custom color scheme, it would be under the `[colors]` table:
|
|
|
|
```toml
|
|
[colors]
|
|
table_header_color="LightBlue"
|
|
```
|
|
|
|
### Check the configuration file location
|
|
|
|
Make sure bottom is reading the right configuration file. By default, bottom looks for config files at these locations:
|
|
|
|
| OS | Default Config Location |
|
|
| ------- | -------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| macOS | `$HOME/Library/Application Support/bottom/bottom.toml`<br/> `~/.config/bottom/bottom.toml` <br/> `$XDG_CONFIG_HOME/bottom/bottom.toml` |
|
|
| Linux | `~/.config/bottom/bottom.toml` <br/> `$XDG_CONFIG_HOME/bottom/bottom.toml` |
|
|
| Windows | `C:\Users\<USER>\AppData\Roaming\bottom\bottom.toml` |
|
|
|
|
If you want to use a config file in another location, use the `--config` or `-C` flags along with the path to the configuration file, like so:
|
|
|
|
```bash
|
|
btm -C path_to_config
|
|
```
|
|
|
|
## My installation through snap has some widgets that are blank/show no data
|
|
|
|
Make sure bottom is given the correct permissions. [Snapcraft](https://snapcraft.io/docs/interface-management) explains how to do so.
|