Taskbar app displaying the remaining play time of users monitored by LittleBrother
Taskbar Tray Application for
LittleBrotherTaskbar is a simple application which can be installed into the tray of the window manager
to display the remaining play time of the current user.
The taskbar does not have a homepage of its own. It is sharing
LittleBrother's homepage. Visit the project
at Facebook or write comments to little-brother(at)web.de.
The following screenshots show the display of
LittleBrotherTaskbar when optional play time is not active.
These are the corresponding screenhots when optional play is active.
Continuous Integration Status Overview
|Snyk Vulnerability||not available|
|Codacy Code Quality||not available|
|Code Climate||not available|
Note: The vulnerability status is derived from the Python PIP packages found in
LittleBrotherTaskbar has the following features:
Shows the status (remaining play time) of a user monitored by LittleBrother
Plays spoken notifications about the status:
- Session length upon login
- Reason why login is denied
- Warnings about impending logout
- Reason why user will be logged out
As of version 0.1.18 (see feature issue):
- Shows the remaining "optional time" that a user can use to extend her time
- Provides buttons to extend the session time (that is to request a time extension)
LittleBrotherTaskbar requires an active installation of LittleBrother.
The taskbar client will contact the master process of
LittleBrother. Also, some Linux packages have to be
installed to enable the compilation of the Python PIP package
wxPython. See the installation instructions below.
In case you want to use the MP3 speech generation for notification messages you have to install the PIP package python-google-speak.
|Distribution||Version||Comments||Most Recent Test|
This guide will take you through the steps required to install, configure, and run the
application on your system.
There are more videos related to
LittleBrotherTaskbar available at
the LittleBrother homepage.
Install the Software
LittleBrotherTaskbar is available as a Python3 PIP package. Make
sure you have the Debian packages
installed on your system. Also, the required library
wxPython cannot be compiled successfully with some versions of
40.8.0 seems to work fine. Issue
pip3 install setuptools==40.8.0
to install exactly this version. Then type
pip3 install little-brother-taskbar
to install the latest version of the taskbar. If you want to install a specific version use
pip3 install little-brother-taskbar==[VERSION]
[VERSION] replaced by the specific version.
Note: Compiling the
wxPython library takes a LONG time. Depending on the speed of your system, compilation
times of up to 15 minutes are not unusual. So, please, be patient!
Speech Generation and Output
In order to use the speech generation for notification messages, issue the command
pip3 install python-google-speak
and use the
--speech-engine command line option (see below). Also, install the Debian package
apt-get install mpg123
Configure the Software
In its simplest setting the tool just needs to be started with the URL of the LittleBrother master API, e.g.
[HOSTNAME] being the host where the LittleBrother master process is running and
[PORT] being its port.
Extended Command Line Configuration
The tool recognizes the following extra options:
--username [NAME]: Set the username to
[NAME]. If the option is not given the tool will try to derive the login name from the environment variable
USER. If no user can be found, the tool will fail.
--locale [LOCALE]: Set the locale to
en_US. Note that this locale is only used until the taskbar receives the first status from the LittleBrother master since status contains the locale configured for the user.
--config [FILENAME]: Read the configuration file
[FILENAME]. If this option is not given the tool will try to read the file
~/.config/LittleBrotherTaskbar.conf. See this file for an example.
--loglevel [LEVEL]: Set the log level to
--speech-engine [ENGINE]: Activate and select the speech engine to speak messages for the monitored user. Possible values for
external(which requires the Debian package festival and possibly some more configuration)
Installing LittleBrotherTaskbar as a StartUp Application
Once you have succeeded starting the tool on the command line (see above) it makes sense to install the tool as a startup application in your desktop environment. Most environments allow you to configure the applications which are automatically started upon logging into the desktop. Below you will find screenshots to guide you through the installation on a 19.3 Ubuntu system using the Mate Desktop.
From the main menu choose the entry
Control Center. In the upcoming window click on
Addand enter your statement into the
Commandfield. Chose a name and optionally set a comment.
Add+and and on
Logout out of the desktop and login in again to test. If successful you should see the LittleTaskBar icon in the tray.
So, you went through all of the above but
LittleBrotherTaskbar does not seem to work? Maybe this
troubleshooting page can help you.
Most settings of the application can be configured using the configuration dialog which reached using the right mouse click on the tray icon:
The configuration will be saved to (and subsequently loaded from) the file
LittleBrotherTaskbar is far from perfect. Issues are listed on GitHub
(see here). Feel free to open new issues if you have
any trouble with installing and/or running the application.
The application uses the PIP package
Flask-Babel to provide internationalization for the web frontend, Currently,
the following languages are supported/prepared (in the order they were made available):
|Flag||Language||Locale||Status||Translation provided by|
|Dutch||nl||0.1.10||Simone & Lex|
|Bangla||bn||0.1.10||Rownak Jyoti Zaman|
Note that the spoken messages are provided by the
LittleBrother master process. Check
here for the availability of desired foreign language.
Sample Speech Audio Files
- Sample 1 in Dutch
- Sample 2 in Dutch
- Sample 1 in Italian
- Sample 2 in Italian
- Sample 1 in Finnish
- Sample 2 in Finnish
- Sample 1 in Turkish
- Sample 2 in Turkish
- Sample 1 in Russian
- Sample 2 in Russian
- Sample 1 in Japanese
- Sample 2 in Japanese
- Sample 1 in Bangla
- Sample 2 in Bangla
- Sample 1 in French
- Sample 2 in French
- Sample 1 in Thai
- Sample 2 in Thai
- Sample 1 in Danish
- Sample 2 in Danish
- Sample 1 in Spanish
- Sample 2 in Spanish
Your help with translations is greatly appreciated. Please, contact the author if you are interested in providing a translation. You do not necessarily have to clone this repository or be familiar with Python to do so.
Thanks to all the people maintaining the wonderful script language Python and the libraries on PyPi.
The country flags were taken from www.countryflags.com.
See the section about on internalization for credits regarding the translations.
The site www.mehr-schulferien.de maintains the vacation metadata for Germany.
The configuration dialog was generated using wxGlade.
People contributing by providing pull requests:
- Albano Battistella for providing Italian and French translations
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for little-brother-taskbar-0.1.18.tar.gz