Package: little-brother-taskbar
Taskbar Tray Application forLittleBrotherOverviewLittleBrotherTaskbaris a simple application which can be installed into the tray of the window manager
to display the remaining play time of the current user.ContactThe taskbar does not have a homepage of its own. It is sharingLittleBrother's homepage. Visit the project
atFacebookor write comments to little-brother(at)web.de.ScreenshotsThe following screenshots show the display ofLittleBrotherTaskbarwhen optional play time is not active.These are the corresponding screenhots when optional play is active.Change HistorySeehereGitHub StatusContinuous Integration Status OverviewStatusMasterReleaseCircleCITest CoverageSnyk Vulnerabilitynot availableCodacy Code Qualitynot availableCode Climatenot availableNote: The vulnerability status is derived from the Python PIP packages found inrequirements.txt.FeaturesLittleBrotherTaskbarhas the following features:Shows the status (remaining play time) of a user monitored byLittleBrotherPlays spoken notifications about the status:Session length upon loginReason why login is deniedWarnings about impending logoutReason why user will be logged outAs of version 0.1.18 (seefeature issue):Shows the remaining "optional time" that a user can use to extend her timeProvides buttons to extend the session time (that is to request a time extension)PrerequisitesLittleBrotherTaskbarrequires an active installation ofLittleBrother.
The taskbar client will contact the master process ofLittleBrother. Also, some Linux packages have to be
installed to enable the compilation of the Python PIP packagewxPython. See the installation instructions below.In case you want to use the MP3 speech generation for notification messages you have to install the PIP packagepython-google-speak.Tested DistributionsDistributionVersionCommentsMost Recent TestDebiantesting15.AUG.2021Ubuntu19.308.AUG.2020Quick InstallThis guide will take you through the steps required to install, configure, and run theLittleBrotherTaskbarapplication on your system.YouTube VideoThere are more videos related toLittleBrotherandLittleBrotherTaskbaravailable at
theLittleBrotherhomepage.Install the SoftwareLittleBrotherTaskbaris available as a Python3PIP package. Make
sure you have the Debian packageslibgtk-3-devlibpulse-devinstalled on your system. Also, the required librarywxPythoncannot be compiled successfully with some versions of
thesetuptools. Version40.8.0seems to work fine. Issuepip3 install setuptools==40.8.0to install exactly this version. Then typepip3 install little-brother-taskbarto install the latest version of the taskbar. If you want to install a specific version usepip3 install little-brother-taskbar==[VERSION]instead with[VERSION]replaced by the specific version.Note: Compiling thewxPythonlibrary 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 OutputIn order to use the speech generation for notification messages, issue the commandpip3 install python-google-speakand use the--speech-enginecommand line option (see below). Also, install the Debian packagempg123:apt-get install mpg123Configure the SoftwareIn its simplest setting the tool just needs to be started with the URL of the LittleBrother master API, e.g.run_little_brother_taskbar --server-url=http://[HOSTNAME]:[PORT]with[HOSTNAME]being the host where the LittleBrother master process is running and[PORT]being its port.Extended Command Line ConfigurationThe 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 variableUSER. If no user can be found, the tool will fail.--locale [LOCALE]: Set the locale to[LOCALE], e.g.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.
Seethis filefor an example.--loglevel [LEVEL]: Set the log level toDEBUG,INFO,WARNING, orERROR.--speech-engine [ENGINE]: Activate and select the speech engine to speak messages for the monitored user.
Possible values for[ENGINE]are:google(preferred; which requires PIP packagepython-google-speak) orexternal(which requires the Debian packagefestivaland
possibly some more configuration)Installing LittleBrotherTaskbar as a StartUp ApplicationOnce 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 entryControl Center. In the upcoming window click onStartup Applications.Click onAddand enter your statement into theCommandfield. Chose a name and optionally set a comment.Click onAdd+and and onClose.Logout out of the desktop and login in again to test. If successful you should see the LittleTaskBar icon in the
tray.TroubleshootingSo, you went through all of the above butLittleBrotherTaskbardoes not seem to work? Maybe thistroubleshooting pagecan help you.ConfigurationMost 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~/.config/LittleBrotherTaskbar.conf.CaveatsThe applicationLittleBrotherTaskbaris far from perfect. Issues are listed on GitHub
(seehere). Feel free to open new issues if you have
any trouble with installing and/or running the application.InternationalizationThe application uses the PIP packageFlask-Babelto provide internationalization for the web frontend, Currently,
the following languages are supported/prepared (in the order they were made available):FlagLanguageLocaleStatusTranslation provided byEnglishenUp-to-dateMarcus RickertGermandeUp-to-dateMarcus RickertItalianitUp-to-dateAlbano BattistellaDutchnl0.1.10Simone & LexFinnishfi0.1.10Iisakki KosonenTurkishtr0.1.10Selay DoganRussianru0.1.10J. MoldawskiJapaneseja0.1.10Arik M.Banglabn0.1.10Rownak Jyoti ZamanFrenchfr0.1.11Albano BattistellaThaith0.1.10Busaba KramerSpanishes0.1.10Ruth Wucherpfennig-KrömerLithuanianltIn preparationN.N.CroatianhrIn preparationN.N.Note that the spoken messages are provided by theLittleBrothermaster process. Checkherefor the availability of desired foreign language.Sample ScreenshotsSample Speech Audio FilesSample 1 in DutchSample 2 in DutchSample 1 in ItalianSample 2 in ItalianSample 1 in FinnishSample 2 in FinnishSample 1 in TurkishSample 2 in TurkishSample 1 in RussianSample 2 in RussianSample 1 in JapaneseSample 2 in JapaneseSample 1 in BanglaSample 2 in BanglaSample 1 in FrenchSample 2 in FrenchSample 1 in ThaiSample 2 in ThaiSample 1 in DanishSample 2 in DanishSample 1 in SpanishSample 2 in SpanishYour 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.CreditsThanks to all the people maintaining the wonderful script languagePythonand the libraries onPyPi.The country flags were taken fromwww.countryflags.com.See the section about on internalization for credits regarding the translations.The sitewww.mehr-schulferien.demaintains the vacation metadata for
Germany.The configuration dialog was generated usingwxGlade.People contributing by providing pull requests:Albano Battistellafor providing Italian and French translations