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 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. 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: The current compatibility of widgets with operating systems from personal testing:
| OS | CPU | Memory | Disks | Temperature | Processes/Search | Networks | Battery | | OS | CPU | Memory | Disks | Temperature | Processes/Search | Networks | Battery |
| ------- | --- | ------ | ----- | ------------------------------------ | ---------------- | -------- | -------------------------------------------- | | ------- | --- | ------ | ----- | ------------------------------------ | ------------------------------------------ | -------- | -------------------------------------------- |
| Linux | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | Linux | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Windows | ✓ | ✓ | ✓ | ? (seems to require elevated access) | ✓ | ✓ | ✓ (seems to have issues with dual batteries) | | Windows | ✓ | ✓ | ✓ | ? (seems to require elevated access) | ✓ | ✓ | ✓ (seems to have issues with dual batteries) |
| macOS | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | macOS | ✓ | ✓ | ✓ | ✓ | ✓ (requires `sudo btm` to show everything) | ✓ | ✓ |
## FAQ ## FAQ

View File

@ -18,5 +18,13 @@ class Bottom < Formula
ohai "For runtime flags, see \"btm --help\"" 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" 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 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 end