Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

To determine how you spend your time, TagTime randomly samples you. At random times it pops up and asks what you're doing right at that moment. You answer with tags.

For more on the idea behind this project, see


  1. Download the latest release and extract it somewhere convenient.
  2. Run the app by double-clicking TagTime.jar, or by typing java TagTime.jar on the command line.
  3. Enter your Beeminder username, or make up a name if you don't plan to get a Beeminder account.
  4. If you want to change your settings, exit the app by right-clicking the icon in the system tray. Find your settings file in the newly-created data folder. Update your settings (see for documentation), and start the app again when you're done.
  5. Answer the pings! (Always answer with what it caught you at right at that moment.)

Beeminder users will need to update these two settings in particular.

Differences between this implementation and the original:

  • This library uses a different random number generator, so even if you copy the seed, it will ping you at different times.
  • When using this library, you can safely change the ping frequency (AVERAGE_GAP) at any time.


TagTime was conceived of, designed, and implemented by Dreeves and Bethany Soule. This Java version was created by Joseph Cloutier (player_03).

This implementation uses libraries licensed under the Apache License 2.0. These are Quartz Scheduler, json-simple, and various libraries from the Apache Commons.

The system tray icon comes from the Silk icon set by Mark James, available under a Creative Commons Attribution 2.5 license.


An offshoot of dreeves' time tracking utility




No packages published