clerk

Simple event logger to keep track of periodic events, habits, etc. as they occur.
26 Mar 2019201

Track periodic events in your life such as when baby has a nappy change, when you eat chocolate, or how many hours you slept.

Screenshot

  • Web based.
  • Easy to deploy.
  • Self-hosted & FLOSS.
  • Simple text based CSV format.
  • Allows multiple people to log events.
  • Mobile friendly - "Add to Home Screen" web-app.

Install

  • Download a release or git clone the master branch.
  • Copy the files to your PHP web hosting.

To require authentication, first create a password file:

htpasswd -c /path/to/.htpasswd username

Then copy ./example.htaccess to .htaccess and edit it.

Data format

Screenshot 2

For every event logged the event type, timestamp, and comment are stored.

Events are stored in individual CSV files - one file per event type.

You can also download all CSVs stiched together with an extra column for the event name.

Multi-user

If you have multiple users, clone the app folder for each user and create a unique htaccess login for each.

To create shared events either symlink one of the CSV files into each user's data directory or symlink the entire data folder.

Server

The server is written in mal/php which is a Clojure-like implementation on PHP.

License

Copyright Chris McCormick, 2017. GPLv3 licensed.