l.behm/bumblebee-status
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

[modules] Add contributions to (hopefully!) all modules

Browse source
This commit is contained in:
tobi-wan-kenobi 2020-05-08 20:58:35 +02:00
parent 5dcf9f9c9d
commit 21049b9b03
62 changed files with 278 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

155
docs/modules.rst
View file

@ -19,6 +19,8 @@ Parameters:
* battery.showpowerconsumption: If set to 'true', show current power consumption (defaults to False)
* battery.compact-devices : If set to 'true', compacts multiple batteries into a single entry (default to False)
(partially) contributed by `martindoublem <https://github.com/martindoublem>`_ - many thanks!
.. image:: ../screenshots/battery.png
battery-upower
@ -31,6 +33,8 @@ Parameters:
* battery-upower.critical : Critical threshold in % of remaining charge (defaults to 10)
* battery-upower.showremaining : If set to true (default) shows the remaining time until the batteries are completely discharged
contributed by `martindoublem <https://github.com/martindoublem>`_ - many thanks!
brightness
~~~~~~~~~~
@ -39,6 +43,8 @@ Displays the brightness of a display
Parameters:
* brightness.step: The amount of increase/decrease on scroll in % (defaults to 2)
contributed by `TheEdgeOfRage <https://github.com/TheEdgeOfRage>`_ - many thanks!
.. image:: ../screenshots/brightness.png
cmus
@ -62,6 +68,8 @@ Parameters:
* cmus.server: The address of the cmus server, either a UNIX socket or host[:port]. Connects to the local instance by default.
* cmus.passwd: The password to use for the TCP/IP connection.
contributed by `TheEdgeOfRage <https://github.com/TheEdgeOfRage>`_ - many thanks!
.. image:: ../screenshots/cmus.png
cpu
@ -139,6 +147,8 @@ kernel
Shows Linux kernel version information
contributed by `pierre87 <https://github.com/pierre87>`_ - many thanks!
.. image:: ../screenshots/kernel.png
layout-xkb
@ -248,6 +258,7 @@ Parameters:
'auto' uses whatever redshift is configured to do
* redshift.lat : latitude if location is set to 'manual'
* redshift.lon : longitude if location is set to 'manual'
* redshift.show_transition: information about the transitions (x% day) defaults to True
.. image:: ../screenshots/redshift.png
@ -312,6 +323,8 @@ Parameters:
* vault.offx: x-axis offset of popup menu (defaults to 0)
* vault.offy: y-axis offset of popup menu (defaults to 0)
Many thanks to `bbernhard <https://github.com/bbernhard>`_ for the idea!
.. image:: ../screenshots/vault.png
xrandr
@ -346,6 +359,8 @@ get volume level
Parameters:
* amixer.device: Device to use, defaults to "Master,0"
contributed by `zetxx <https://github.com/zetxx>`_ - many thanks!
.. image:: ../screenshots/amixer.png
apt
@ -356,6 +371,8 @@ Requires the following packages:
* aptitude
contributed by `qba10 <https://github.com/qba10>`_ - many thanks!
arch-update
~~~~~~~~~~~
@ -364,6 +381,8 @@ Check updates to Arch Linux.
Requires the following executable:
* checkupdates (from pacman-contrib)
contributed by `lucassouto <https://github.com/lucassouto>`_ - many thanks!
bluetooth
~~~~~~~~~
@ -377,6 +396,8 @@ Parameters:
* bluetooth.dbus_destination_path : dbus destination path (defaults to /)
* bluetooth.right_click_popup : use popup menu when right-clicked (defaults to True)
contributed by `brunosmmm <https://github.com/brunosmmm>`_ - many thanks!
.. image:: ../screenshots/bluetooth.png
bluetooth2
@ -389,6 +410,8 @@ python-dbus to count the number of connections
Parameters:
* bluetooth.manager : application to launch on click (blueman-manager)
contributed by `martindoublem <https://github.com/martindoublem>`_ - many thanks!
caffeine
~~~~~~~~
@ -400,6 +423,8 @@ Requires the following executables:
* xprop (as dependency for xdotool)
* notify-send
contributed by `TheEdgeOfRage <https://github.com/TheEdgeOfRage>`_ - many thanks!
.. image:: ../screenshots/caffeine.png
cpu2
@ -438,6 +463,8 @@ Parameters:
Note: if you are getting 'n/a' for CPU temperature / fan speed, then you're
lacking the aforementioned pattern settings or they have wrong values.
contributed by `somospocos <https://github.com/somospocos>`_ - many thanks!
currency
~~~~~~~~
@ -456,6 +483,8 @@ Parameters:
Note: source and destination names right now must correspond to the names used by the API of https://markets.ft.com
contributed by `AntouanK <https://github.com/AntouanK>`_ - many thanks!
.. image:: ../screenshots/currency.png
datetimetz
@ -474,6 +503,8 @@ Parameters:
* timetz.locale : alias for datetimetz.locale
* timetz.timezone : alias for datetimetz.timezone
contributed by `frankzhao <https://github.com/frankzhao>`_ - many thanks!
datetz
~~~~~~
@ -518,6 +549,8 @@ Parameters:
Available options for deadbeef.previous, deadbeef.next and deadbeef.pause are:
LEFT_CLICK, RIGHT_CLICK, MIDDLE_CLICK, SCROLL_UP, SCROLL_DOWN
contributed by `joshbarrass <https://github.com/joshbarrass>`_ - many thanks!
deezer
~~~~~~
@ -536,6 +569,8 @@ Parameters:
Available options for deezer.previous, deezer.next and deezer.pause are:
LEFT_CLICK, RIGHT_CLICK, MIDDLE_CLICK, SCROLL_UP, SCROLL_DOWN
contributed by `wwmoraes <https://github.com/wwmoraes>`_ - many thanks!
dnf
~~~
@ -557,11 +592,15 @@ Displays the number of docker containers running
Requires the following python packages:
* docker
contributed by `jlopezzarza <https://github.com/jlopezzarza>`_ - many thanks!
dunst
~~~~~
Toggle dunst notifications.
contributed by `eknoes <https://github.com/eknoes>`_ - many thanks!
.. image:: ../screenshots/dunst.png
getcrypto
@ -579,6 +618,8 @@ Parameters:
* getcrypto.getltc: 0 for not getting price of LTC, 1 for getting it (default).
* getcrypto.getcur: Set the currency to display the price in, usd is the default.
contributed by `Ryunaq <https://github.com/Ryunaq>`_ - many thanks!
.. image:: ../screenshots/getcrypto.png
github
@ -593,6 +634,8 @@ Parameters:
* github.token: GitHub user access token, the token needs to have the 'notifications' scope.
* github.interval: Interval in minutes between updates, default is 5.
contributed by `yvesh <https://github.com/yvesh>`_ - many thanks!
.. image:: ../screenshots/github.png
gpmdp
@ -603,17 +646,23 @@ Displays information about the current song in Google Play music player.
Requires the following executable:
* gpmdp-remote
contributed by `TheEdgeOfRage <https://github.com/TheEdgeOfRage>`_ - many thanks!
hddtemp
~~~~~~~
Fetch hard drive temeperature data from a hddtemp daemon
that runs on localhost and default port (7634)
contributed by `somospocos <https://github.com/somospocos>`_ - many thanks!
hostname
~~~~~~~~
Displays the system hostname.
contributed by `varkokonyi <https://github.com/varkokonyi>`_ - many thanks!
http_status
~~~~~~~~~~~
@ -624,6 +673,8 @@ Parameters:
* http__status.target: Target to retrieve the HTTP status from
* http__status.expect: Expected HTTP status
contributed by `valkheim <https://github.com/valkheim>`_ - many thanks!
.. image:: ../screenshots/http_status.png
indicator
@ -635,6 +686,8 @@ Parameters:
* indicator.include: Comma-separated list of interface prefixes to include (defaults to 'numlock,capslock')
* indicator.signalstype: If you want the signali type color to be 'critical' or 'warning' (defaults to 'warning')
contributed by `freed00m <https://github.com/freed00m>`_ - many thanks!
.. image:: ../screenshots/indicator.png
layout
@ -645,6 +698,8 @@ Displays and changes the current keyboard layout
Requires the following executable:
* setxkbmap
contributed by `Pseudonick47 <https://github.com/Pseudonick47>`_ - many thanks!
.. image:: ../screenshots/layout.png
layout-xkbswitch
@ -655,6 +710,8 @@ Displays and changes the current keyboard layout
Requires the following executable:
* xkb-switch
contributed by `somospocos <https://github.com/somospocos>`_ - many thanks!
libvirtvms
~~~~~~~~~~
@ -663,6 +720,8 @@ Displays count of running libvirt VMs.
Required the following python packages:
* libvirt
contributed by `maxpivo <https://github.com/maxpivo>`_ - many thanks!
mocp
~~~~
@ -688,6 +747,8 @@ Parameters:
* %b Bitrate
* %r Sample rate
contributed by `chrugi <https://github.com/chrugi>`_ - many thanks!
mpd
~~~
@ -734,13 +795,17 @@ Parameters:
* mpd.host: MPD host to connect to. (mpc behaviour by default)
* mpd.layout: Space-separated list of widgets to add. Possible widgets are the buttons/toggles mpd.prev, mpd.next, mpd.shuffle and mpd.repeat, and the main display with play/pause function mpd.main.
contributed by `alrayyes <https://github.com/alrayyes>`_ - many thanks!
.. image:: ../screenshots/mpd.png
network_traffic
~~~~~~~~~~~~~~~
Displays network traffic
* No extra configuration needed
* No extra configuration needed
contributed by `izn <https://github.com/izn>`_ - many thanks!
notmuch_count
~~~~~~~~~~~~~
@ -757,6 +822,8 @@ Errors:
Dependencies:
notmuch (https://notmuchmail.org/)
contributed by `abdoulayeYATERA <https://github.com/abdoulayeYATERA>`_ - many thanks!
nvidiagpu
~~~~~~~~~
@ -768,6 +835,8 @@ Parameters:
Requires nvidia-smi
contributed by `RileyRedpath <https://github.com/RileyRedpath>`_ - many thanks!
octoprint
~~~~~~~~~
@ -792,6 +861,8 @@ Requires the following executables:
* fakeroot
* pacman
contributed by `Pseudonick47 <https://github.com/Pseudonick47>`_ - many thanks!
.. image:: ../screenshots/pacman.png
pihole
@ -803,6 +874,8 @@ Parameters:
* pihole.address : pi-hole address (e.q: http://192.168.1.3)
* pihole.pwhash : pi-hole webinterface password hash (can be obtained from the /etc/pihole/SetupVars.conf file)
contributed by `bbernhard <https://github.com/bbernhard>`_ - many thanks!
pomodoro
~~~~~~~~
@ -821,6 +894,8 @@ Parameters:
not support command chaining (see https://github.com/tobi-wan-kenobi/bumblebee-status/issues/532
for a detailled explanation)
contributed by `martindoublem <https://github.com/martindoublem>`_, inspired by `karthink <https://github.com/karthink>`_ - many thanks!
prime
~~~~~
@ -847,6 +922,8 @@ Parameters:
Requires the following executable:
* prime-select
contributed by `jeffeb3 <https://github.com/jeffeb3>`_ - many thanks!
progress
~~~~~~~~
@ -863,6 +940,8 @@ Parameters:
Requires the following executable:
* progress
contributed by `remi-dupre <https://github.com/remi-dupre>`_ - many thanks!
publicip
~~~~~~~~
@ -889,6 +968,8 @@ Parameters:
* rss.feeds : Space-separated list of RSS URLs
* rss.length : Maximum length of the module, default is 60
contributed by `lonesomebyte537 <https://github.com/lonesomebyte537>`_ - many thanks!
sensors
~~~~~~~
@ -904,6 +985,9 @@ Parameters:
* sensors.match_number: (fallback) which of the matches you want (default -1: last match).
* sensors.show_freq: whether to show CPU frequency. (default: true)
contributed by `mijoharas <https://github.com/mijoharas>`_ - many thanks!
.. image:: ../screenshots/sensors.png
shell
@ -931,6 +1015,8 @@ Parameters:
running scripts to avoid bumblebee-status freezes
(defaults to False)
contributed by `rrhuffy <https://github.com/rrhuffy>`_ - many thanks!
shortcut
~~~~~~~~
@ -950,6 +1036,9 @@ Parameters:
* shortcut.labels: List of widgets' labels (text)
* shortcut.delim : Commands and labels delimiter (; semicolon by default)
contributed by `cacyss0807 <https://github.com/cacyss0807>`_ - many thanks!
.. image:: ../screenshots/shortcut.png
smartstatus
@ -959,7 +1048,8 @@ Displays HDD smart status of different drives or all drives
Parameters:
* smartstatus.display: how to display (defaults to 'combined', other choices: 'seperate' or 'singles')
* smartstauts.drives: in the case of singles which drives to display, separated comma list value, multiple accepted (defaults to 'sda', example:'sda,sdc')
* smartstatus.drives: in the case of singles which drives to display, separated comma list value, multiple accepted (defaults to 'sda', example:'sda,sdc')
* smartstatus.show_names: boolean in the form of "True" or "False" to show the name of the drives in the form of sda, sbd, combined or none at all.
spaceapi
~~~~~~~~
@ -986,6 +1076,8 @@ Format Strings:
to say 'Open/Closed' depending on the boolean you
would write '%%state.open%Open%Closed%%'
contributed by `rad4day <https://github.com/rad4day>`_ - many thanks!
spotify
~~~~~~~
@ -1004,6 +1096,9 @@ Parameters:
Available options for spotify.previous, spotify.next and spotify.pause are:
LEFT_CLICK, RIGHT_CLICK, MIDDLE_CLICK, SCROLL_UP, SCROLL_DOWN
contributed by `yvesh <https://github.com/yvesh>`_ - many thanks!
.. image:: ../screenshots/spotify.png
stock
@ -1018,6 +1113,9 @@ Parameters:
* stock.symbols : Comma-separated list of symbols to fetch
* stock.change : Should we fetch change in stock value (defaults to True)
contributed by `msoulier <https://github.com/msoulier>`_ - many thanks!
.. image:: ../screenshots/stock.png
sun
@ -1033,6 +1131,10 @@ Parameters:
* cpu.lat : Latitude of your location
* cpu.lon : Longitude of your location
(if none of those are set, location is determined automatically via location APIs)
contributed by `lonesomebyte537 <https://github.com/lonesomebyte537>`_ - many thanks!
system
~~~~~~
@ -1056,6 +1158,8 @@ Parameters:
* system.suspend: specify a command for suspending (defaults to 'i3exit suspend')
* system.hibernate: specify a command for hibernating (defaults to 'i3exit hibernate')
contributed by `bbernhard <https://github.com/bbernhard>`_ - many thanks!
taskwarrior
~~~~~~~~~~~
@ -1067,6 +1171,9 @@ Requires the following library:
Parameters:
* taskwarrior.taskrc : path to the taskrc file (defaults to ~/.taskrc)
contributed by `chdorb <https://github.com/chdorb>`_ - many thanks!
.. image:: ../screenshots/taskwarrior.png
timetz
@ -1091,6 +1198,9 @@ Parameters:
* title.placeholder : Placeholder text to be placed if title was truncated. Defaults to '...'.
* title.scroll : Boolean flag for scrolling title. Defaults to False
contributed by `UltimatePancake <https://github.com/UltimatePancake>`_ - many thanks!
.. image:: ../screenshots/title.png
todo
@ -1101,6 +1211,9 @@ Displays the number of todo items from a text file
Parameters:
* todo.file: File to read TODOs from (defaults to ~/Documents/todo.txt)
contributed by `codingo <https://github.com/codingo>`_ - many thanks!
.. image:: ../screenshots/todo.png
traffic
@ -1118,6 +1231,8 @@ Parameters:
char shows 2 seconds. If set, enables up/down traffic
graphs
contributed by `meain <https://github.com/meain>`_ - many thanks!
.. image:: ../screenshots/traffic.png
twmn
@ -1125,11 +1240,15 @@ twmn
Toggle twmn notifications.
contributed by `Pseudonick47 <https://github.com/Pseudonick47>`_ - many thanks!
uptime
~~~~~~
Displays the system uptime.
contributed by `ccoors <https://github.com/ccoors>`_ - many thanks!
.. image:: ../screenshots/uptime.png
vpn
@ -1137,17 +1256,19 @@ vpn
Displays the VPN profile that is currently in use.
Left click opens a popup menu that lists all available VPN profiles and allows to establish
a VPN connection using that profile.
Left click opens a popup menu that lists all available VPN profiles and allows to establish
a VPN connection using that profile.
Prerequisites:
* tk python library (usually python-tk or python3-tk, depending on your distribution)
* nmcli needs to be installed and configured properly.
To quickly test, whether nmcli is working correctly, type 'nmcli -g NAME,TYPE,DEVICE con' which
lists all the connection profiles that are configured. Make sure that your VPN profile is in that list!
Prerequisites:
* tk python library (usually python-tk or python3-tk, depending on your distribution)
* nmcli needs to be installed and configured properly.
To quickly test, whether nmcli is working correctly, type 'nmcli -g NAME,TYPE,DEVICE con' which
lists all the connection profiles that are configured. Make sure that your VPN profile is in that list!
e.g: to import a openvpn profile via nmcli:
`sudo nmcli connection import type openvpn file </path/to/your/openvpn/profile.ovpn>`
e.g: to import a openvpn profile via nmcli:
`sudo nmcli connection import type openvpn file </path/to/your/openvpn/profile.ovpn>`
contributed by `bbernhard <https://github.com/bbernhard>`_ - many thanks!
watson
~~~~~~
@ -1157,6 +1278,8 @@ Displays the status of watson (time-tracking tool)
Requires the following executable:
* watson
contributed by `bendardenne <https://github.com/bendardenne>`_ - many thanks!
weather
~~~~~~~
@ -1174,6 +1297,9 @@ Parameters:
* weather.showminmax: If set to true, show the minimum and maximum temperature, otherwise hide it (defaults to false)
* weather.apikey: API key from http://api.openweathermap.org
contributed by `TheEdgeOfRage <https://github.com/TheEdgeOfRage>`_ - many thanks!
.. image:: ../screenshots/weather.png
xkcd
@ -1181,6 +1307,8 @@ xkcd
Opens a random xkcd comic in the browser.
contributed by `whzup <https://github.com/whzup>`_ - many thanks!
yubikey
~~~~~~~
@ -1191,6 +1319,9 @@ Requires: https://github.com/Yubico/python-yubico
The output indicates that a YubiKey is not connected or it displays
the corresponding serial number.
contributed by `EmmaTinten <https://github.com/EmmaTinten>`_ - many thanks!
zpool
~~~~~
@ -1219,4 +1350,6 @@ is used, the following (or ekvivalent) must be added to the `sudoers(5)`:
Be aware of security implications of doing this!
contributed by `adam-dej <https://github.com/adam-dej>`_ - many thanks!
.. image:: ../screenshots/zpool.png

1
docs/other/NOTES.md
View file

@ -22,3 +22,4 @@
# documentation
Add info about error widget and events for error logging
- add module contributor doc
- which location APIs are used?

2
modules/contrib/amixer.py
View file

@ -2,6 +2,8 @@
Parameters:
* amixer.device: Device to use, defaults to "Master,0"
contributed by `zetxx <https://github.com/zetxx>`_ - many thanks!
"""
import re

1
modules/contrib/apt.py
View file

@ -5,6 +5,7 @@ Requires the following packages:
* aptitude
contributed by `qba10 <https://github.com/qba10>`_ - many thanks!
"""
import re

1
modules/contrib/arch-update.py
View file

@ -3,6 +3,7 @@
Requires the following executable:
* checkupdates (from pacman-contrib)
contributed by `lucassouto <https://github.com/lucassouto>`_ - many thanks!
"""
import logging

1
modules/contrib/bluetooth.py
View file

@ -8,6 +8,7 @@ Parameters:
* bluetooth.dbus_destination_path : dbus destination path (defaults to /)
* bluetooth.right_click_popup : use popup menu when right-clicked (defaults to True)
contributed by `brunosmmm <https://github.com/brunosmmm>`_ - many thanks!
"""

2
modules/contrib/bluetooth2.py
View file

@ -4,6 +4,8 @@ python-dbus to count the number of connections
Parameters:
* bluetooth.manager : application to launch on click (blueman-manager)
contributed by `martindoublem <https://github.com/martindoublem>`_ - many thanks!
"""

2
modules/contrib/caffeine.py
View file

@ -7,6 +7,8 @@ Requires the following executables:
* xdotool
* xprop (as dependency for xdotool)
* notify-send
contributed by `TheEdgeOfRage <https://github.com/TheEdgeOfRage>`_ - many thanks!
"""
import logging

1
modules/contrib/cpu2.py
View file

@ -31,6 +31,7 @@ Parameters:
Note: if you are getting 'n/a' for CPU temperature / fan speed, then you're
lacking the aforementioned pattern settings or they have wrong values.
contributed by `somospocos <https://github.com/somospocos>`_ - many thanks!
"""
import psutil

2
modules/contrib/currency.py
View file

@ -15,6 +15,8 @@ Parameters:
* currency.destinationdelimiter: Delimiter used for separating individual rates (defaults to '|')
Note: source and destination names right now must correspond to the names used by the API of https://markets.ft.com
contributed by `AntouanK <https://github.com/AntouanK>`_ - many thanks!
"""
import requests

2
modules/contrib/datetimetz.py
View file

@ -12,6 +12,8 @@ Parameters:
* datetz.locale : alias for datetimetz.locale
* timetz.locale : alias for datetimetz.locale
* timetz.timezone : alias for datetimetz.timezone
contributed by `frankzhao <https://github.com/frankzhao>`_ - many thanks!
"""
from __future__ import absolute_import

1
modules/contrib/deadbeef.py
View file

@ -32,6 +32,7 @@ Parameters:
Available options for deadbeef.previous, deadbeef.next and deadbeef.pause are:
LEFT_CLICK, RIGHT_CLICK, MIDDLE_CLICK, SCROLL_UP, SCROLL_DOWN
contributed by `joshbarrass <https://github.com/joshbarrass>`_ - many thanks!
"""
import sys

2
modules/contrib/deezer.py
View file

@ -14,6 +14,8 @@ Parameters:
Available options for deezer.previous, deezer.next and deezer.pause are:
LEFT_CLICK, RIGHT_CLICK, MIDDLE_CLICK, SCROLL_UP, SCROLL_DOWN
contributed by `wwmoraes <https://github.com/wwmoraes>`_ - many thanks!
"""
import dbus

1
modules/contrib/docker_ps.py
View file

@ -5,6 +5,7 @@
Requires the following python packages:
* docker
contributed by `jlopezzarza <https://github.com/jlopezzarza>`_ - many thanks!
"""
import docker

5
modules/contrib/dunst.py
View file

@ -1,6 +1,9 @@
# pylint: disable=C0111,R0903
"""Toggle dunst notifications."""
"""Toggle dunst notifications.
contributed by `eknoes <https://github.com/eknoes>`_ - many thanks!
"""
import core.module
import core.widget

2
modules/contrib/getcrypto.py
View file

@ -11,6 +11,8 @@ Parameters:
* getcrypto.geteth: 0 for not getting price of ETH, 1 for getting it (default).
* getcrypto.getltc: 0 for not getting price of LTC, 1 for getting it (default).
* getcrypto.getcur: Set the currency to display the price in, usd is the default.
contributed by `Ryunaq <https://github.com/Ryunaq>`_ - many thanks!
"""
import requests

2
modules/contrib/github.py
View file

@ -8,6 +8,8 @@ Requires the following library:
Parameters:
* github.token: GitHub user access token, the token needs to have the 'notifications' scope.
* github.interval: Interval in minutes between updates, default is 5.
contributed by `yvesh <https://github.com/yvesh>`_ - many thanks!
"""
import shutil

2
modules/contrib/gpmdp.py
View file

@ -4,6 +4,8 @@
Requires the following executable:
* gpmdp-remote
contributed by `TheEdgeOfRage <https://github.com/TheEdgeOfRage>`_ - many thanks!
"""
import core.module

2
modules/contrib/hddtemp.py
View file

@ -2,6 +2,8 @@
"""Fetch hard drive temeperature data from a hddtemp daemon
that runs on localhost and default port (7634)
contributed by `somospocos <https://github.com/somospocos>`_ - many thanks!
"""
import socket

5
modules/contrib/hostname.py
View file

@ -1,6 +1,9 @@
# pylint: disable=C0111,R0903
"""Displays the system hostname."""
"""Displays the system hostname.
contributed by `varkokonyi <https://github.com/varkokonyi>`_ - many thanks!
"""
import platform

2
modules/contrib/http_status.py
View file

@ -6,6 +6,8 @@ Parameters:
* http__status.label: Prefix label (optional)
* http__status.target: Target to retrieve the HTTP status from
* http__status.expect: Expected HTTP status
contributed by `valkheim <https://github.com/valkheim>`_ - many thanks!
"""
from requests import head

2
modules/contrib/indicator.py
View file

@ -5,6 +5,8 @@
Parameters:
* indicator.include: Comma-separated list of interface prefixes to include (defaults to 'numlock,capslock')
* indicator.signalstype: If you want the signali type color to be 'critical' or 'warning' (defaults to 'warning')
contributed by `freed00m <https://github.com/freed00m>`_ - many thanks!
"""
import core.module

2
modules/contrib/layout-xkbswitch.py
View file

@ -2,6 +2,8 @@
Requires the following executable:
* xkb-switch
contributed by `somospocos <https://github.com/somospocos>`_ - many thanks!
"""
import core.module

2
modules/contrib/layout.py
View file

@ -4,6 +4,8 @@
Requires the following executable:
* setxkbmap
contributed by `Pseudonick47 <https://github.com/Pseudonick47>`_ - many thanks!
"""
import core.module

2
modules/contrib/libvirtvms.py
View file

@ -2,6 +2,8 @@
Required the following python packages:
* libvirt
contributed by `maxpivo <https://github.com/maxpivo>`_ - many thanks!
"""
import sys

2
modules/contrib/mocp.py
View file

@ -22,6 +22,8 @@ Parameters:
* %cs CurrentSec
* %b Bitrate
* %r Sample rate
contributed by `chrugi <https://github.com/chrugi>`_ - many thanks!
"""
import core.module

2
modules/contrib/mpd.py
View file

@ -43,6 +43,8 @@ Parameters:
* mpd.host: MPD host to connect to. (mpc behaviour by default)
* mpd.layout: Space-separated list of widgets to add. Possible widgets are the buttons/toggles mpd.prev, mpd.next, mpd.shuffle and mpd.repeat, and the main display with play/pause function mpd.main.
contributed by `alrayyes <https://github.com/alrayyes>`_ - many thanks!
"""
from collections import defaultdict

2
modules/contrib/network_traffic.py
View file

@ -3,6 +3,8 @@
"""Displays network traffic
* No extra configuration needed
contributed by `izn <https://github.com/izn>`_ - many thanks!
"""
import psutil

2
modules/contrib/notmuch_count.py
View file

@ -11,6 +11,8 @@ Errors:
Dependencies:
notmuch (https://notmuchmail.org/)
contributed by `abdoulayeYATERA <https://github.com/abdoulayeYATERA>`_ - many thanks!
"""
import os

2
modules/contrib/nvidiagpu.py
View file

@ -7,6 +7,8 @@ Parameters:
Available values are: {name} {temp} {mem_used} {mem_total} {fanspeed} {clock_gpu} {clock_mem}
Requires nvidia-smi
contributed by `RileyRedpath <https://github.com/RileyRedpath>`_ - many thanks!
"""
import core.module

2
modules/contrib/pacman.py
View file

@ -8,6 +8,8 @@ Parameters:
Requires the following executables:
* fakeroot
* pacman
contributed by `Pseudonick47 <https://github.com/Pseudonick47>`_ - many thanks!
"""
import os

2
modules/contrib/pihole.py
View file

@ -5,6 +5,8 @@
Parameters:
* pihole.address : pi-hole address (e.q: http://192.168.1.3)
* pihole.pwhash : pi-hole webinterface password hash (can be obtained from the /etc/pihole/SetupVars.conf file)
contributed by `bbernhard <https://github.com/bbernhard>`_ - many thanks!
"""
import requests

2
modules/contrib/pomodoro.py
View file

@ -14,6 +14,8 @@ Parameters:
please use an external wrapper script and invoke that. The module itself does
not support command chaining (see https://github.com/tobi-wan-kenobi/bumblebee-status/issues/532
for a detailled explanation)
contributed by `martindoublem <https://github.com/martindoublem>`_, inspired by `karthink <https://github.com/karthink>`_ - many thanks!
"""
from __future__ import absolute_import

1
modules/contrib/prime.py
View file

@ -23,6 +23,7 @@ Parameters:
Requires the following executable:
* prime-select
contributed by `jeffeb3 <https://github.com/jeffeb3>`_ - many thanks!
"""
import core.module

2
modules/contrib/progress.py
View file

@ -11,6 +11,8 @@ Parameters:
Requires the following executable:
* progress
contributed by `remi-dupre <https://github.com/remi-dupre>`_ - many thanks!
"""
import core.module

2
modules/contrib/rss.py
View file

@ -9,6 +9,8 @@ New stories are highlighted.
Parameters:
* rss.feeds : Space-separated list of RSS URLs
* rss.length : Maximum length of the module, default is 60
contributed by `lonesomebyte537 <https://github.com/lonesomebyte537>`_ - many thanks!
"""
import feedparser

3
modules/contrib/sensors.py
View file

@ -12,6 +12,9 @@ Parameters:
* sensors.match_pattern: (fallback) Line to match against before temperature is read (no default)
* sensors.match_number: (fallback) which of the matches you want (default -1: last match).
* sensors.show_freq: whether to show CPU frequency. (default: true)
contributed by `mijoharas <https://github.com/mijoharas>`_ - many thanks!
"""
import re

2
modules/contrib/shell.py
View file

@ -21,6 +21,8 @@ Parameters:
previous one didn't finished yet. Useful for long
running scripts to avoid bumblebee-status freezes
(defaults to False)
contributed by `rrhuffy <https://github.com/rrhuffy>`_ - many thanks!
"""
import os

3
modules/contrib/shortcut.py
View file

@ -15,6 +15,9 @@ Parameters:
* shortcut.cmds : List of commands to execute
* shortcut.labels: List of widgets' labels (text)
* shortcut.delim : Commands and labels delimiter (; semicolon by default)
contributed by `cacyss0807 <https://github.com/cacyss0807>`_ - many thanks!
"""
import logging

2
modules/contrib/spaceapi.py
View file

@ -24,6 +24,8 @@ Format Strings:
you would write '%%state.open%%', if you also want
to say 'Open/Closed' depending on the boolean you
would write '%%state.open%Open%Closed%%'
contributed by `rad4day <https://github.com/rad4day>`_ - many thanks!
"""
import requests

3
modules/contrib/spotify.py
View file

@ -14,6 +14,9 @@ Parameters:
Available options for spotify.previous, spotify.next and spotify.pause are:
LEFT_CLICK, RIGHT_CLICK, MIDDLE_CLICK, SCROLL_UP, SCROLL_DOWN
contributed by `yvesh <https://github.com/yvesh>`_ - many thanks!
"""
import sys

3
modules/contrib/stock.py
View file

@ -9,6 +9,9 @@ Requires the following python packages:
Parameters:
* stock.symbols : Comma-separated list of symbols to fetch
* stock.change : Should we fetch change in stock value (defaults to True)
contributed by `msoulier <https://github.com/msoulier>`_ - many thanks!
"""
import json

4
modules/contrib/sun.py
View file

@ -9,6 +9,10 @@ Requires the following python packages:
Parameters:
* cpu.lat : Latitude of your location
* cpu.lon : Longitude of your location
(if none of those are set, location is determined automatically via location APIs)
contributed by `lonesomebyte537 <https://github.com/lonesomebyte537>`_ - many thanks!
"""
from suntime import Sun, SunTimeException

2
modules/contrib/system.py
View file

@ -20,6 +20,8 @@ Parameters:
* system.lock: specify a command for locking the screen (defaults to 'i3exit lock')
* system.suspend: specify a command for suspending (defaults to 'i3exit suspend')
* system.hibernate: specify a command for hibernating (defaults to 'i3exit hibernate')
contributed by `bbernhard <https://github.com/bbernhard>`_ - many thanks!
"""
import logging

3
modules/contrib/taskwarrior.py
View file

@ -5,6 +5,9 @@ Requires the following library:
Parameters:
* taskwarrior.taskrc : path to the taskrc file (defaults to ~/.taskrc)
contributed by `chdorb <https://github.com/chdorb>`_ - many thanks!
"""
from taskw import TaskWarrior

3
modules/contrib/title.py
View file

@ -9,6 +9,9 @@ Parameters:
* title.max : Maximum character length for title before truncating. Defaults to 64.
* title.placeholder : Placeholder text to be placed if title was truncated. Defaults to '...'.
* title.scroll : Boolean flag for scrolling title. Defaults to False
contributed by `UltimatePancake <https://github.com/UltimatePancake>`_ - many thanks!
"""
import threading

3
modules/contrib/todo.py
View file

@ -4,6 +4,9 @@
Parameters:
* todo.file: File to read TODOs from (defaults to ~/Documents/todo.txt)
contributed by `codingo <https://github.com/codingo>`_ - many thanks!
"""
import os.path

2
modules/contrib/traffic.py
View file

@ -11,6 +11,8 @@ Parameters:
* traffic.graphlen: Graph lenth in seconds. Positive even integer. Each
char shows 2 seconds. If set, enables up/down traffic
graphs
contributed by `meain <https://github.com/meain>`_ - many thanks!
"""
import re

5
modules/contrib/twmn.py
View file

@ -1,6 +1,9 @@
# pylint: disable=C0111,R0903
"""Toggle twmn notifications."""
"""Toggle twmn notifications.
contributed by `Pseudonick47 <https://github.com/Pseudonick47>`_ - many thanks!
"""
import core.module
import core.widget

5
modules/contrib/uptime.py
View file

@ -1,6 +1,9 @@
# pylint: disable=C0111,R0903
"""Displays the system uptime."""
"""Displays the system uptime.
contributed by `ccoors <https://github.com/ccoors>`_ - many thanks!
"""
from datetime import timedelta

2
modules/contrib/vpn.py
View file

@ -13,6 +13,8 @@
e.g: to import a openvpn profile via nmcli:
`sudo nmcli connection import type openvpn file </path/to/your/openvpn/profile.ovpn>`
contributed by `bbernhard <https://github.com/bbernhard>`_ - many thanks!
"""
import logging

2
modules/contrib/watson.py
View file

@ -4,6 +4,8 @@
Requires the following executable:
* watson
contributed by `bendardenne <https://github.com/bendardenne>`_ - many thanks!
"""
import logging

3
modules/contrib/weather.py
View file

@ -14,6 +14,9 @@ Parameters:
* weather.showcity: If set to true, show location information, otherwise hide it (defaults to true)
* weather.showminmax: If set to true, show the minimum and maximum temperature, otherwise hide it (defaults to false)
* weather.apikey: API key from http://api.openweathermap.org
contributed by `TheEdgeOfRage <https://github.com/TheEdgeOfRage>`_ - many thanks!
"""
import core.module

5
modules/contrib/xkcd.py
View file

@ -1,6 +1,9 @@
# pylint: disable=C0111,R0903
"""Opens a random xkcd comic in the browser."""
"""Opens a random xkcd comic in the browser.
contributed by `whzup <https://github.com/whzup>`_ - many thanks!
"""
import core.module
import core.widget

2
modules/contrib/yubikey.py
View file

@ -7,6 +7,8 @@ Requires: https://github.com/Yubico/python-yubico
The output indicates that a YubiKey is not connected or it displays
the corresponding serial number.
contributed by `EmmaTinten <https://github.com/EmmaTinten>`_ - many thanks!
"""
import yubico

2
modules/contrib/zpool.py
View file

@ -22,6 +22,8 @@ is used, the following (or ekvivalent) must be added to the `sudoers(5)`:
```
Be aware of security implications of doing this!
contributed by `adam-dej <https://github.com/adam-dej>`_ - many thanks!
"""
import time

2
modules/core/battery-upower.py
View file

@ -6,6 +6,8 @@ Parameters:
* battery-upower.warning : Warning threshold in % of remaining charge (defaults to 20)
* battery-upower.critical : Critical threshold in % of remaining charge (defaults to 10)
* battery-upower.showremaining : If set to true (default) shows the remaining time until the batteries are completely discharged
contributed by `martindoublem <https://github.com/martindoublem>`_ - many thanks!
"""
import dbus

2
modules/core/battery.py
View file

@ -10,6 +10,8 @@ Parameters:
* battery.decorate : If set to 'false', hides additional icons (charging, etc.) (defaults to True)
* battery.showpowerconsumption: If set to 'true', show current power consumption (defaults to False)
* battery.compact-devices : If set to 'true', compacts multiple batteries into a single entry (default to False)
(partially) contributed by `martindoublem <https://github.com/martindoublem>`_ - many thanks!
"""
import os

1
modules/core/brightness.py
View file

@ -5,6 +5,7 @@
Parameters:
* brightness.step: The amount of increase/decrease on scroll in % (defaults to 2)
contributed by `TheEdgeOfRage <https://github.com/TheEdgeOfRage>`_ - many thanks!
"""
import glob

1
modules/core/cmus.py
View file

@ -18,6 +18,7 @@ Parameters:
* cmus.server: The address of the cmus server, either a UNIX socket or host[:port]. Connects to the local instance by default.
* cmus.passwd: The password to use for the TCP/IP connection.
contributed by `TheEdgeOfRage <https://github.com/TheEdgeOfRage>`_ - many thanks!
"""
from collections import defaultdict

5
modules/core/kernel.py
View file

@ -1,6 +1,9 @@
# pylint: disable=C0111,R0903
"""Shows Linux kernel version information"""
"""Shows Linux kernel version information
contributed by `pierre87 <https://github.com/pierre87>`_ - many thanks!
"""
import platform

2
modules/core/vault.py
View file

@ -9,6 +9,8 @@ Parameters:
* vault.location: Location of the password store (defaults to ~/.password-store)
* vault.offx: x-axis offset of popup menu (defaults to 0)
* vault.offy: y-axis offset of popup menu (defaults to 0)
Many thanks to `bbernhard <https://github.com/bbernhard>`_ for the idea!
"""