RomanNum3ral
/
Solaar
mirror of https://github.com/pwr-Solaar/Solaar.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: add a short discussion of how battery icons work

This commit is contained in:
Peter F. Patel-Schneider 2020-04-20 15:34:44 -04:00
parent 5290980ac8
commit f28da6e7c4
1 changed files with 17 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/capabilities.md
View File

@ -96,6 +96,23 @@ no way to force an update of the cached information besides terminating
Solaar and starting it again. Solaar and starting it again.
## Battery Icons
For many devices, Solaar shows the approximate battery level via icons that
show up in both main Solaar window and the system tray. Solaar used to use
several heuristics to determine which icon names to use for this purpose,
but as more and more battery icon schemes have been developed this has
become impossible to do well. Solaar now only uses the eleven standard
battery icon names `battery-{full,good,low,critical,empty}[-charging]` and
`battery-missing`. To use different icons from you have to change (part of)
your GTK icon theme.
Solaar is not using the symbolic versions of these icons because of a bug
external to Solaar that results in these icons not changing to the
foreground colour in the system tray. This can leave these icons nearly
invisible in dark themes.
[solaar]: https://github.com/pwr-Solaar/Solaar [solaar]: https://github.com/pwr-Solaar/Solaar
[logitech]: https://www.logitech.com [logitech]: https://www.logitech.com
[unifying]: https://en.wikipedia.org/wiki/Logitech_Unifying_receiver [unifying]: https://en.wikipedia.org/wiki/Logitech_Unifying_receiver