docs: Mention that root may be needed on macOS

This commit is contained in:
ClementTsang 2020-12-29 18:32:38 -05:00
parent 148df99a77
commit d8d72d060d
3 changed files with 19 additions and 5 deletions

6
FAQ.md
View File

@ -10,3 +10,9 @@ My graphs look kinda weird with some extra dots, how do I fix this?
You'll have to make sure you have proper braille font support. For example, for Arch, you may have to
install ttf-ubraille and/or properly set it up for your terminal.
- [Why can't I see all my processes/process usage on macOS?]
You may have to run the program with elevated privileges - i.e. `sudo btm`. If you don't like doing
this repeatedly, you can manually force it to run with root each time - for example, following
[this related guide from the htop wiki](https://github.com/hishamhm/htop/wiki/macOS:-run-without-sudo).

View File

@ -724,11 +724,11 @@ Since this is only useful for devices like laptops, it is off by default. You ca
The current compatibility of widgets with operating systems from personal testing:
| OS | CPU | Memory | Disks | Temperature | Processes/Search | Networks | Battery |
| ------- | --- | ------ | ----- | ------------------------------------ | ---------------- | -------- | -------------------------------------------- |
| Linux | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Windows | ✓ | ✓ | ✓ | ? (seems to require elevated access) | ✓ | ✓ | ✓ (seems to have issues with dual batteries) |
| macOS | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| OS | CPU | Memory | Disks | Temperature | Processes/Search | Networks | Battery |
| ------- | --- | ------ | ----- | ------------------------------------ | ------------------------------------------ | -------- | -------------------------------------------- |
| Linux | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Windows | ✓ | ✓ | ✓ | ? (seems to require elevated access) | ✓ | ✓ | ✓ (seems to have issues with dual batteries) |
| macOS | ✓ | ✓ | ✓ | ✓ | ✓ (requires `sudo btm` to show everything) | ✓ | ✓ |
## FAQ

View File

@ -18,5 +18,13 @@ class Bottom < Formula
ohai "For runtime flags, see \"btm --help\""
ohai "If you want to configure bottom, by default bottom looks for a file in $HOME/Library/Application Support/bottom.toml or $HOME/.config/bottom/bottom.toml"
end
def caveats
<<~EOS
Note that bottom may require elevated privileges to correctly display information for all processes.
You can do this with `sudo btm`.
You should be certain that you trust any software you grant root privileges.
EOS
end
end