update readme
This commit is contained in:
parent
f7c8a352dc
commit
a2995a71a7
129
README.rst
129
README.rst
@ -40,7 +40,9 @@ Contributors
|
|||||||
* afics
|
* afics
|
||||||
* al45tair
|
* al45tair
|
||||||
* Arvedui
|
* Arvedui
|
||||||
|
* atalax
|
||||||
* cganas
|
* cganas
|
||||||
|
* crwood
|
||||||
* dubwoc
|
* dubwoc
|
||||||
* enkore (current maintainer)
|
* enkore (current maintainer)
|
||||||
* gwarf
|
* gwarf
|
||||||
@ -49,11 +51,13 @@ Contributors
|
|||||||
* jedrz
|
* jedrz
|
||||||
* jorio
|
* jorio
|
||||||
* mekanix
|
* mekanix
|
||||||
|
* Mic92
|
||||||
* micha-a-schmidt
|
* micha-a-schmidt
|
||||||
* philipdexter
|
* philipdexter
|
||||||
* sbrunner
|
* sbrunner
|
||||||
* siikamiika
|
* siikamiika
|
||||||
* talwrii
|
* talwrii
|
||||||
|
* tomkenmag
|
||||||
* tomxtobin
|
* tomxtobin
|
||||||
* tony
|
* tony
|
||||||
* yemu
|
* yemu
|
||||||
@ -78,6 +82,14 @@ next
|
|||||||
* `network`_: detached_down is now True by default
|
* `network`_: detached_down is now True by default
|
||||||
* `temp`_: removed color_critical and high_factor options
|
* `temp`_: removed color_critical and high_factor options
|
||||||
* `temp`_: fixed issue with Linux kernels 3.15 and newer
|
* `temp`_: fixed issue with Linux kernels 3.15 and newer
|
||||||
|
* maildir: use os.listdir instead of ls
|
||||||
|
* Add `bitcoin`_ module
|
||||||
|
* `temp`_: add file setting
|
||||||
|
* `battery`_: add bar formatter, add not_present_text, full_color,
|
||||||
|
charging_color, not_present_color settings
|
||||||
|
* `wireless`_: Add quality_bar formatter
|
||||||
|
* Add `shell`_ module
|
||||||
|
|
||||||
|
|
||||||
3.29
|
3.29
|
||||||
++++
|
++++
|
||||||
@ -393,24 +405,71 @@ Available formatters:
|
|||||||
* `{consumption (Watts)}` — current power flowing into/out of the battery
|
* `{consumption (Watts)}` — current power flowing into/out of the battery
|
||||||
* `{status}`
|
* `{status}`
|
||||||
* `{battery_ident}` — the same as the setting
|
* `{battery_ident}` — the same as the setting
|
||||||
|
* `{bar}` —bar displaying the percentage graphically
|
||||||
|
|
||||||
|
|
||||||
Settings:
|
Settings:
|
||||||
|
|
||||||
:battery_ident: The name of your battery, usually BAT0 or BAT1 (default: ``BAT0``)
|
:battery_ident: The name of your battery, usually BAT0 or BAT1 (default: ``BAT0``)
|
||||||
:format: (default: ``{status} {remaining}``)
|
:format: (default: ``{status} {remaining}``)
|
||||||
|
:not_present_text: Text displayed if the battery is not present. No formatters are available (default: ``Battery not present``)
|
||||||
:alert: Display a libnotify-notification on low battery (default: ``False``)
|
:alert: Display a libnotify-notification on low battery (default: ``False``)
|
||||||
:alert_percentage: (default: ``10``)
|
:alert_percentage: (default: ``10``)
|
||||||
:alert_format_title: The title of the notification, all formatters can be used (default: ``Low battery``)
|
:alert_format_title: The title of the notification, all formatters can be used (default: ``Low battery``)
|
||||||
:alert_format_body: The body text of the notification, all formatters can be used (default: ``Battery {battery_ident} has only {percentage:.2f}% ({remaining:%E%hh:%Mm}) remaining!``)
|
:alert_format_body: The body text of the notification, all formatters can be used (default: ``Battery {battery_ident} has only {percentage:.2f}% ({remaining:%E%hh:%Mm}) remaining!``)
|
||||||
:path: Override the default-generated path (default: ``None``)
|
:path: Override the default-generated path (default: ``None``)
|
||||||
:status: A dictionary mapping ('DIS', 'CHR', 'FULL') to alternative names (default: ``{'DIS': 'DIS', 'FULL': 'FULL', 'CHR': 'CHR'}``)
|
:status: A dictionary mapping ('DIS', 'CHR', 'FULL') to alternative names (default: ``{'FULL': 'FULL', 'DIS': 'DIS', 'CHR': 'CHR'}``)
|
||||||
:color: The text color (default: ``#ffffff``)
|
:color: The text color (default: ``#ffffff``)
|
||||||
|
:full_color: The full color (default: ``#11aa11``)
|
||||||
|
:charging_color: The charging color (default: ``#00ff00``)
|
||||||
:critical_color: The critical color (default: ``#ff0000``)
|
:critical_color: The critical color (default: ``#ff0000``)
|
||||||
|
:not_present_color: The not present color. (default: ``#ffffff``)
|
||||||
:interval: (default: ``5``)
|
:interval: (default: ``5``)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
bitcoin
|
||||||
|
+++++++
|
||||||
|
|
||||||
|
|
||||||
|
This module fetches and displays current Bitcoin market prices and
|
||||||
|
optionally monitors transactions to and from a list of user-specified
|
||||||
|
wallet addresses. Market data is pulled from the BitcoinAverage Price
|
||||||
|
Index API <https://bitcoinaverage.com> while transaction data is pulled
|
||||||
|
from blockchain.info <https://blockchain.info/api/blockchain_api>.
|
||||||
|
|
||||||
|
Available formatters:
|
||||||
|
|
||||||
|
* {last_price}
|
||||||
|
* {ask_price}
|
||||||
|
* {bid_price}
|
||||||
|
* {daily_average}
|
||||||
|
* {volume}
|
||||||
|
* {status}
|
||||||
|
* {last_tx_type}
|
||||||
|
* {last_tx_addr}
|
||||||
|
* {last_tx_value}
|
||||||
|
* {balance_btc}
|
||||||
|
* {balance_fiat}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Settings:
|
||||||
|
|
||||||
|
:format: Format string used for output. (default: ``฿ {status}{last_price}``)
|
||||||
|
:currency: Base fiat currency used for pricing. (default: ``USD``)
|
||||||
|
:wallet_addresses: List of wallet address(es) to monitor. (default: ````)
|
||||||
|
:color: Standard color (default: ``#FFFFFF``)
|
||||||
|
:colorize: Enable color change on price increase/decrease (default: ``False``)
|
||||||
|
:color_up: Color for price increases (default: ``#00FF00``)
|
||||||
|
:color_down: Color for price decreases (default: ``#FF0000``)
|
||||||
|
:leftclick: URL to visit or command to run on left click (default: ``electrum``)
|
||||||
|
:rightclick: URL to visit or command to run on right click (default: ``https://bitcoinaverage.com/``)
|
||||||
|
:interval: Update interval. (default: ``600``)
|
||||||
|
:status: (default: ``{'price_up': '▲', 'price_down': '▼'}``)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
clock
|
clock
|
||||||
+++++
|
+++++
|
||||||
|
|
||||||
@ -447,6 +506,27 @@ Settings:
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
cpu_usage_bar
|
||||||
|
+++++++++++++
|
||||||
|
|
||||||
|
|
||||||
|
Shows CPU usage as a bar (made with unicode box characters).
|
||||||
|
The first output will be inacurate
|
||||||
|
Linux only
|
||||||
|
|
||||||
|
Available formatters:
|
||||||
|
|
||||||
|
* {usage_bar}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Settings:
|
||||||
|
|
||||||
|
:format: format string (default: ``{usage_bar}``)
|
||||||
|
:interval: (default: ``5``)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
disk
|
disk
|
||||||
++++
|
++++
|
||||||
|
|
||||||
@ -648,6 +728,30 @@ Settings:
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
mem_bar
|
||||||
|
+++++++
|
||||||
|
|
||||||
|
|
||||||
|
Shows memory load as a bar.
|
||||||
|
|
||||||
|
Available formatters:
|
||||||
|
* {used_mem_bar}
|
||||||
|
|
||||||
|
Requires psutil (from PyPI)
|
||||||
|
|
||||||
|
|
||||||
|
Settings:
|
||||||
|
|
||||||
|
:format: format string used for output. (default: ``{used_mem_bar}``)
|
||||||
|
:warn_percentage: minimal percentage for warn state (default: ``50``)
|
||||||
|
:alert_percentage: minimal percentage for alert state (default: ``80``)
|
||||||
|
:color: standard color (default: ``#00FF00``)
|
||||||
|
:warn_color: defines the color used wann warn percentage ist exceeded (default: ``#FFFF00``)
|
||||||
|
:alert_color: defines the color used when alert percentage is exceeded (default: ``#FF0000``)
|
||||||
|
:interval: (default: ``5``)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
modsde
|
modsde
|
||||||
++++++
|
++++++
|
||||||
|
|
||||||
@ -694,7 +798,7 @@ Settings:
|
|||||||
:host: (default: ``localhost``)
|
:host: (default: ``localhost``)
|
||||||
:port: MPD port (default: ``6600``)
|
:port: MPD port (default: ``6600``)
|
||||||
:format: formatp string (default: ``{title} {status}``)
|
:format: formatp string (default: ``{title} {status}``)
|
||||||
:status: Dictionary mapping pause, play and stop to output (default: ``{'play': '▶', 'stop': '◾', 'pause': '▷'}``)
|
:status: Dictionary mapping pause, play and stop to output (default: ``{'stop': '◾', 'pause': '▷', 'play': '▶'}``)
|
||||||
:interval: (default: ``1``)
|
:interval: (default: ``1``)
|
||||||
|
|
||||||
|
|
||||||
@ -856,6 +960,22 @@ Settings:
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
shell
|
||||||
|
+++++
|
||||||
|
|
||||||
|
|
||||||
|
Shows output of shell command
|
||||||
|
|
||||||
|
|
||||||
|
Settings:
|
||||||
|
|
||||||
|
:command: command to be executed
|
||||||
|
:color: standard color (default: ``#FFFFFF``)
|
||||||
|
:error_color: color to use when non zero exit code is returned (default: ``#FF0000``)
|
||||||
|
:interval: (default: ``5``)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
spotify
|
spotify
|
||||||
+++++++
|
+++++++
|
||||||
|
|
||||||
@ -888,8 +1008,9 @@ Settings:
|
|||||||
|
|
||||||
:format: format string used for output. {temp} is the temperature in degrees celsius (default: ``{temp} °C``)
|
:format: format string used for output. {temp} is the temperature in degrees celsius (default: ``{temp} °C``)
|
||||||
:color: (default: ``#FFFFFF``)
|
:color: (default: ``#FFFFFF``)
|
||||||
|
:file: (default: ``/sys/class/thermal/thermal_zone0/temp``)
|
||||||
:interval: (default: ``5``)
|
:interval: (default: ``5``)
|
||||||
:file: file where the temperature is read from
|
|
||||||
|
|
||||||
|
|
||||||
text
|
text
|
||||||
@ -917,6 +1038,7 @@ First, you need to get the code for the location from the www.weather.com
|
|||||||
Available formatters:
|
Available formatters:
|
||||||
|
|
||||||
* {current_temp}
|
* {current_temp}
|
||||||
|
* {current_wind}
|
||||||
* {humidity}
|
* {humidity}
|
||||||
|
|
||||||
Requires pywapi from PyPI.
|
Requires pywapi from PyPI.
|
||||||
@ -946,6 +1068,7 @@ the same, except for these additional formatters and that detached_down doesn't
|
|||||||
* `{essid}` — ESSID of currently connected wifi
|
* `{essid}` — ESSID of currently connected wifi
|
||||||
* `{freq}` — Current frequency
|
* `{freq}` — Current frequency
|
||||||
* `{quality}` — Link quality in percent
|
* `{quality}` — Link quality in percent
|
||||||
|
* `{quality_bar}` —Bar graphically representing link quality
|
||||||
|
|
||||||
|
|
||||||
Settings:
|
Settings:
|
||||||
|
@ -40,7 +40,9 @@ Contributors
|
|||||||
* afics
|
* afics
|
||||||
* al45tair
|
* al45tair
|
||||||
* Arvedui
|
* Arvedui
|
||||||
|
* atalax
|
||||||
* cganas
|
* cganas
|
||||||
|
* crwood
|
||||||
* dubwoc
|
* dubwoc
|
||||||
* enkore (current maintainer)
|
* enkore (current maintainer)
|
||||||
* gwarf
|
* gwarf
|
||||||
@ -49,11 +51,13 @@ Contributors
|
|||||||
* jedrz
|
* jedrz
|
||||||
* jorio
|
* jorio
|
||||||
* mekanix
|
* mekanix
|
||||||
|
* Mic92
|
||||||
* micha-a-schmidt
|
* micha-a-schmidt
|
||||||
* philipdexter
|
* philipdexter
|
||||||
* sbrunner
|
* sbrunner
|
||||||
* siikamiika
|
* siikamiika
|
||||||
* talwrii
|
* talwrii
|
||||||
|
* tomkenmag
|
||||||
* tomxtobin
|
* tomxtobin
|
||||||
* tony
|
* tony
|
||||||
* yemu
|
* yemu
|
||||||
@ -78,6 +82,14 @@ next
|
|||||||
* `network`_: detached_down is now True by default
|
* `network`_: detached_down is now True by default
|
||||||
* `temp`_: removed color_critical and high_factor options
|
* `temp`_: removed color_critical and high_factor options
|
||||||
* `temp`_: fixed issue with Linux kernels 3.15 and newer
|
* `temp`_: fixed issue with Linux kernels 3.15 and newer
|
||||||
|
* maildir: use os.listdir instead of ls
|
||||||
|
* Add `bitcoin`_ module
|
||||||
|
* `temp`_: add file setting
|
||||||
|
* `battery`_: add bar formatter, add not_present_text, full_color,
|
||||||
|
charging_color, not_present_color settings
|
||||||
|
* `wireless`_: Add quality_bar formatter
|
||||||
|
* Add `shell`_ module
|
||||||
|
|
||||||
|
|
||||||
3.29
|
3.29
|
||||||
++++
|
++++
|
||||||
|
Loading…
Reference in New Issue
Block a user