Take a break 1.0

[k. dea]

Name: Take a break
Version: 1.0
Type: Plasma 5 Plasmoid
Depend: Qt 5.x
License: Other
Homepage: 
More Info:
http://kde-apps.org/content/show.php?content=174127

Description:
 Widget (plasmoid) for plasma panel.
Shows an icon when it is time to take a break.

Problem: Sometimes you dont remember that you have
to take a break. Sometimes you remember that you
have to take a break, but you dont remember when
you took a break last time.

Solution: The Take a break widget, that shows an
icon when it is time to take a break.

Characteristics:

* Not intrusive: It doesnt show any dialog nor any
buttons to be clicked. It just shows an icon in
the panel when it is time to take a break.
* Unattended: You dont have to do anything.
Everything is automatic. The widget detects when
you are taking a break and when you come back.
* Easy configuration: You only have to enter two
values in the widget config: The work time and the
break time.

And of course, easy use:
* At start, the widget shows a countdown with the
minutes to take next break.
* When the countdown reaches zero, a tired face
icon is shown in the panel, with a red background.
It means that it is time to take a break.
* The tired face with the red background is kept
if you continue working.
* If you are idle for 50 seconds (not using mouse
nor keyboard), the program considers that you are
taking a break, and shows a yellow background in
the tired face.
* If you are idle for the configured break time,
the program considers that you have completed the
break, and shows a green background in the tired
face.
* If you come back (use the mouse or keyboard)
while showing the green background, the countdown
will be shown and restarted.
* If you come back while still showing the yellow
background, the program considers that you havent
completed the break, so a red background will be
shown again.
* What if you took a short break, but you want to
restart the countdown? No problem, you only have
to click on the widget whenever you want to
restart the countdown.

The widget works in horizontal panels and in
vertical panels.

REQUIRES

* KDE 5 (Plasma 5).


AUTOMATIC INSTALLION

* Right click on any panel widget (for example, in
the kde menu widget) and select Panel options ->
Add widgets... -> Get new widgets -> Download new
Plasma widgets.
* Search for Take a break, and click on Install.

The installation is done. Now we are going to add
the plasmoid to the panel:

* Right click on any panel widget (for example, in
the kde menu widget) and select Panel options ->
Add widgets....
* Search for Take a break, and double-click on the
item found. The plasmoid will be added to the
panel.
* Move the plasmoid to your favourite place.


MANUAL INSTALLION

* Download the file take_a_break.plasmoid to some
folder in your hard disk.
* Right click on any panel widget (for example, in
the kde menu widget) and select Panel options ->
Add widgets... -> Install widget from local
file....
* A file selection window will be shown. Go to the
folder (where you saved the file to), select the
downloaded file, and click on Ok.

The installation is done. Now we are going to add
the plasmoid to the panel:

* Right click on any panel widget (for example, in
the kde menu widget) and select Panel options ->
Add widgets....
* Search for Take a break, and double-click on the
item found. The plasmoid will be added to the
panel.
* Move the plasmoid to your favourite place.


HOW TO UNINSTALL

* Right click on any panel widget (for example, in
the kde menu widget) and select Panel options ->
Panel preferences.
* Rigth-click on the plasmoid (Take a break), and
click on Remove this Take a break.

The plasmoid has been removed from the panel. Now
we are going to uninstall it.  Open a shell and
run this command:

plasmapkg2 --remove org.kde.contrib.takeabreak


SOURCE CODE

The source code is into the file
take_a_break.plasmoid, that is a zip file. So to
see the source code, you only have to rename it to
a .zip extension, and then unzip it:

mv take_a_break.plasmoid take_a_break.zip
unzip take_a_break.zip


LICENSES

The license of this program is the GPLv3. See
COPYING.GPLv3 file in the source code.

The tired icon (face-yawn.svg) is part of the
Breeze icon theme, and its license is the LGPLv3.
See COPYING.LGPLv3 file in the source code, and
https://projects.kde.org/projects/kde/workspace/breeze





JOB RECOMMENDATION:

more jobs: http://KDE-Apps.org/jobs/