Mirrors/bottom
2
0
Fork 0
mirror of https://github.com/ClementTsang/bottom synced 2024-11-14 00:17:07 +00:00
Code Issues Projects Releases Packages Wiki Activity

docs: add even more troubleshooting documentation

Browse source
This commit is contained in:
ClementTsang 2022-05-07 19:48:32 -04:00
parent 4d507d1793
commit c09322fdc2
1 changed files with 28 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

43
docs/content/troubleshooting.md
View file

@ -46,50 +46,55 @@ Let's say you're installing [Iosevka](https://github.com/be5invis/Iosevka). The
4. Here, add a new `String value`, and set the `Name` to a bunch of 0's (e.g. `000` - make sure the name isn't already used), then set the `Data` to the font name (e.g. `Iosevka`).
<figure>
<figure>
<img src="../assets/screenshots/troubleshooting/regedit_fonts.webp" alt="Regedit menu showing how to add a new font for Command Prompt/PowerShell"/>
<figcaption>The last entry is the new entry for Iosevka</code></figcaption>
</figure>
</figure>
5. Then, open the Command Prompt/PowerShell, and right click on the top bar, and open `Properties`:
<figure>
<figure>
<img src="../assets/screenshots/troubleshooting/cmd_prompt_props.webp" alt="Opening the properties menu in Command Prompt/PowerShell"/>
</figure>
</figure>
6. From here, go to `Font`, and set the font to your new font (e.g. `Iosevka`):
<figure>
<figure>
<img src="../assets/screenshots/troubleshooting/cmd_prompt_font.webp" alt="Setting a new font in Command Prompt/PowerShell"/>
</figure>
</figure>
## Why can't I see all my temperature sensors on Windows?
This is a known issue, and some sensors may require admin privileges to get sensor data.
This is a [known limitation](./support/official.md#windows), some sensors may require admin privileges to get sensor data.
## Why don't I see dual batteries on Windows reported separately? (e.g. Thinkpads)
This seems to be some issue with how batteries are being detected on Windows.
This is a [known limitation](./support/official.md#windows) which seems to be with how batteries are being detected on Windows.
## Why can't I see all my temperature sensors on WSL?
Due to how WSL works, hosts may not expose their temperature sensors and therefore, temperature sensors might be missing.
This is a [known limitation](./support/official.md#windows) with WSL. Due to how it works, hosts may not expose their
temperature sensors and therefore, temperature sensors might be missing.
## Why does WSL2 not match Task Manager?
Due to how WSL2 works, the two might not match up in terms of reported data.
This is a [known limitation](./support/official.md#windows) with WSL2. Due to how WSL2 works, the two might not match
up in terms of reported data.
## Why can't I see all my processes/process usage on macOS?
## Why can't I see all my processes/process data on macOS?
You may have to run the program with elevated privileges - for example:
This is a [known limitation](./support/official.md#macos), and you may have to run the program with elevated
privileges to work around it - for example:
```bash
sudo btm
```
_Please note that you should be certain that you trust any software you grant root privileges._
**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.
There are measures taken to try to maximize the amount of information obtained without elevated privileges. For example,
one can modify the instructions found on the [htop wiki](https://github.com/hishamhm/htop/wiki/macOS:-run-without-sudo)
on how to run htop without sudo for bottom. However **please** understand the potential security risks before doing so!
## My configuration file isn't working
@ -132,4 +137,12 @@ 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.
Make sure bottom is given the correct permissions in order to collect data. [Snapcraft](https://snapcraft.io/docs/interface-management)
explains how to do so, but the TL;DR is:
```bash
sudo snap connect bottom:mount-observe
sudo snap connect bottom:hardware-observe
sudo snap connect bottom:system-observe
sudo snap connect bottom:process-control
```