This web site uses cookies. By staying on this web site, you accept the use of cookies.

TheGrue.org

Welcome!

You have come across the ZephyrSoft home page. Here you can download some tools I developed over the years and also actively take part in further development. I wrote these programs because there was no free solution, at least no satisfactory one. Some were created especially for Koinonia Fellowship in Hannover, Germany.

Mathis Dirksen-Thedens

And just in case you wondered what "Zephyr" stands for: it's Latin and means "westerly winds". I chose it as my code name (or brand name) long ago.

Track Work Time - FAQ

Some things seem to be a problem regularly, so here are the answers to these questions.

I activated the tracking by location or Wi-Fi but it does not work.

  1. Please make sure you use the latest version of the app. If you don't have the possibility (or don't want) to use the Play Store or F-Droid, read "How do I install the lastest APK from Github" below. Sometimes the app stores also don't contain the latest version yet, the process always takes a few days after the new app is released.
  2. Grant the app all permissions it asks for. On Android 10+ it's especially important to grant the location permission "at all times" (which means also when the app is not shown).

I want to mark some days as holidays or change the target working time for specific days, but I don't know where.

Tap on the date in the table on the main screen. In the following dialog you can do that, and also delete your changes using the recycle bin icon if you want to.

What do the options "Ignore before events" and "Ignore after events" mean?

If you use one or both automated tracking methods (location and/or Wi-Fi) you can activate these checkboxes to suppress automatically-generated events from these tracking methods before a manually entered event and/or after a (manually or automatically enetered) event.

For example, if you leave your facility and TWT clocks you out when you leave the Wi-Fi area, but then (on your way to the parking lot) you come across another part where the same Wi-Fi is visible again, TWT will clock you in again (and out when you leave that area). Or you may have manually entered your clock-out event and afterwards TWT wants to clock you in/out again (because of the Wi-Fi on the way to the parking lot). In these cases, the options can prevent TWT from creating the superfluous events.

How do I install the latest APK from Github?

Firstly, the APK files published on Github are identical to the packages you receive from Google Play store. So if you installed TWT through Google Play, you may use an APK from Github without losing compatibility - Google Play will update your app later when a newer version is published. You don't have to install all the following version manually.

So, how to install? It's relatively easy:

  1. Safety first! Create a backup of TWT's data (see "How can I create a backup" below).
  2. On your mobile device, go to the page of the latest release (or an older release if you want) and download the file with its name ending in _release-signed.apk. This is the complete app in one file.
  3. Open the downloaded file, either from your browser's download manager or from a file manager app. This will trigger the installation of the APK.
    • Your Android may require you to allow installation from "unsafe sources" (which only means "another source than the Play store" on Android). Allow that for now, you can safely disable it again after the installation.
  4. Done!

How can I create a backup, maybe for a restore on another device?

Good news first: TWT automatically creates a backup for you once a day. But you can always manually trigger a backup via the menu item "Data Backup".

When you backed up the app's data, there will be a directory named trackworktime on your device's storage with at least two files into it: backup.events.csv and backup.targets.csv. Both files together comprise a backup of the app's data.

There may also be another two files like the previous two with the prefix automatic- which are the automatically created backup files mentioned above. Also one or a few log files are saved in the same directory which are only important if there's an error in the app.

You can copy the directory trackworktime onto another device for additional safety - or even have a synchronisation app do it for you in specified intervals. If you use an app which is triggered on every file change, be sure to exclude log.txt from the mechanism - if you don't, it will copy the log file many times a day which is not necessary.

My question is not answered here!

If you don't find what you're looking for in the general description of the app or in this FAQ, you're welcome to drop me a line. My email address is provided here.

Incident Response

This is about the upgrade of Track Work Time in January 2021.

- see below for status updates -

Some users contacted me about their problems with the new version of the app and said their data was gone after the upgrade. Here's at least some good news: the data is still there, although maybe it's not displayed in the app. One report also stated that the details dialog (which opens when you tap on the main table) still shows the data, and only the table doesn't show anything.

Some background: the migration process to the new version does only create new data structures but leaves the existing untouched. After the migration ran, the old structures are still there but not read from. So when something goes wrong while migrating to the new version of the app, the old data is recoverable.

So what to do if you also have those problems?

  1. If the app seems to run normally but doesn't display your data: Please send me your log file so the cause of the problem can be investigated. You can do that in these steps:
    • open Track Work Time
    • tap on the burger icon to the top left
    • scroll down and tap on Send Logs...
    • select your email app in the "share" dialog which opens and send the prepared email to me (you're also welcome to send it to yourself before and check that there's nothing in it you don't want to share with me)
  2. If the app crashes: Please tap OK in the "Oops" dialog to send the error message to me.

Every report helps to identify the problem.

One word about uninstalling the app: if you want to keep your data, don't do it (yet). I can understand that you're frustrated, even infuriated - but if you uninstall the app, your data is deleted by Android automatically.

Status as of February 2nd, 2021, 11 a.m. CET

An updated version 1.1.1 was released via Github and Google Play Store.

If you don't want to wait until it arrives (as the Play Store is known to need 1-2 days until an update is actually rolled out) you can do one of two things:

  1. Open Trach Work Time's options and activate flexi time (you will have to provide a flexi time target). The main table now should contain the times again. This possible workaround was only discovered an hour ago.
  2. Open this link on your mobile device and download the file ending in "release-signed.apk". If you open the downloaded file, you will be asked if you want to install it, maybe after enabling installation from "insecure sources" (which means "anything but the Play Store" for Google). This is exactly the same file which will come though the Play Store later.

A big thank you to dliw for analyzing and solving the problems!