Timecheck is a tool for controlling the usage time on a linux computer.
Go to file
nuron 96f8be1e8a Merge branch 'master' of https://codeberg.org/nuron/timecheck 2021-03-31 15:52:33 +02:00
.gitignore Remove timecheck_path.txt traces 2020-06-08 02:00:00 +02:00
COPYING Correct some stuff 2020-05-15 14:12:48 +02:00
README.md Remove a typo 2021-01-25 17:54:13 +01:00
README_de.md Add 'change-settings.sh' to README 2020-05-20 02:29:38 +02:00
change_settings.sh Fix #13 by checking if whiptail is available or not 2020-06-11 00:36:52 +02:00
install-timecheck.sh Fix issue with the PRG_PATH and the cronjob 2021-01-23 01:20:42 +01:00
timecheck.conf.example Fix issue with the PRG_PATH and the cronjob 2021-01-23 01:20:42 +01:00
timecheck.sh Fix problem with check if installer was started already 2021-03-31 15:42:45 +02:00



Timecheck is a tool for controlling the usage time on a linux computer.

Deutsche README

Timecheck gives you the possibility to control the usage time of a specific user account. It is a small shell script which should work in every shell as it is written based on the POSIX standard.

A speciality of Timecheck is that the days of a week will be grouped.

Per default a week will be splitted into Monday until Friday and Saturday and Sunday. These two groups can have their own, independant times.

Per default Timecheck sends a notification to the user ten, five and one minute before the user get logged out. Of course these notification times can be edited and extended.

See below for more information about possible adjustments.

Important information

Since the project is in the beginning the script is quite rudimentary. Prinicipally the script already works. The script was tested and developed for Linux Mint Cinnamon. Maybe you have to make some adjustments for other distributions and/or desktop environments!

The script has been adapted for German or English systems. For other systems there might are adjustments necessary.

At the moment the notifications are in English. If you want you can edit the notifications.


For a full usage of the script the following applications have to be installed:

  • sudo
  • libnotify-bin (notify-send)


In the meantime it exists an install script for Timecheck which will do some steps for you. For starting you have to clone the repository manually. The easiest way to do this is the following:

git clone https://codeberg.org/nuron/timecheck.git timecheck

For the sake of convenience we switch into the directory timecheck where the script is located.

cd timecheck/

Inside this directory we execute the install script as follows:


This file should already have the required permissions. If not, just run chmod +x install-timecheck.sh to add execute permission.

The script asks for several things and will configure all the necessary things at the end.

At the end there will be a note to copy something into the root crontab. This is esentially to use this script!

If you've done everything there's nothing to do anymore.

If you want to change some settings please run



Maybe you have to adapt the script.

Ath the moment there are no known adjustments

If you have any adjustment please give some feedback.

This script is released under the GPLv3 license.

See COPYING file for more information