Skip to content
Does interval checks on scripts and then touches a file to show it's status on i3status.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

i3status_touchy Build Status


A fork of grub2-se-verifyserv. A service which helps you to have more status information on i3status. If you need a script to be checked regulary by it's return code, this is something for you.


You need gcc or something similar. There is a not finished systemd servicefile included. To compile and install it you may want to do the following within this project directory:

sudo make install

Syntax and i3 status integration

i3status_touchy ( arguments )

It checks if a program has a specific return code within some time. If it has a file will be touched. If not it will be erased.
The purpose is to integrate it with i3status.


-h, --help                         Shows this here.
-p, --program [program or script]  Executes and checks this program for the return code. (Required)
-t, --touch [filename]             File which will be touched. (Required)
-r, --return [return code]         Listen to this return code. (Default: 0)
-s, --sleep [seconds]              Interval of when the next check should start. (Default: 20)
-v, --verbose                      Show some unnecessary stuff.

i3status integration
You may want to copy paste the following into your i3status.conf:

order += "path_exists SomeStatus"
path_exist SomeStatus {
	path = "/path/to/file/which/will/be/touched"

i3status_touchy --help will tell you the same btw.

You can’t perform that action at this time.