datag/jtimesched

A simple and lightweight time tracking tool

jTimeSched

jTimeSched is a simple and lightweight time tracking tool. You can track elapsed time for tasks and projects and use the data for the recording of time worked.

One aim of jTimeSched is a lean but extremely intuitive GUI and providing only really necessary functionality.

For a complete list of features please see the project website.

Download binary release

If you don't want to build the application yourself, you can download and run one of the binary releases containing platform launchers for Linux and Windows.

• Download latest version
• Browse all releases

Documentation

The user manual can be found at the project website:

• Running jTimeSched
• Using jTimeSched

Building from source

jTimeSched can be built using ant:

$ ant

Build variables (build.xml)

• version - Application version string written to Manifest and used in the application
• build - Build directory
• dist - Directory used for generating a release package

You can override the defaults providing the -D option to ant, e.g. $ ant -Dversion=my-1.5

Example: Build release package with version string "my-1.5"

$ ant -Dversion=1.0

Build targets (build.xml)

• compile
  Just compile the sources. jTimeSched requires to access certain assets and searches for them in JAR-file, if present, or uses them from a directory with name data
• data
  Copy assets to the build directory. You can run jTimeSched using java -cp $[build} de.dominik_geyer.jtimesched.JTimeSchedApp
• jar
  Pack all class files and assets into one single JAR-file, which will be stored at ${dist}/jTimeSched.jar. Run it with java -jar ${dist}/jTimeSched.jar
• zip
  Create a release packages with all platform launchers. The archive will be stored in ${dist}/jTimeSched-${version}.zip
• clean
  Clean-up everything

Example: Just compile the sources

$ ant compile

Eclipse project

The repository provides a basic Eclipse project. You may use the Import-wizard of Eclipse.

jtimesched's Issues

In some cases the wrong project is started

It seems that when resorting the table with an already running project in combination with a start of a other project with key-shortcut SPACE the wrong project is started. May not be reproducible every time.

shell script cannot find jarfile

I added the shell-script as a launcher, like /bin/sh "/some/path/jTimeSched.sh", but it didn't run. Calling the shell-script from shell I got this error: "Unable to access jarfile ./jTimeSched.jar". To locate the jarfile it uses current working directory, instead of the directory where the script is. This worked for me:

#!/bin/sh

if [ -n "$JAVA_HOME" ]; then
    JAVA=$JAVA_HOME/bin/java    # use $JAVA_HOME if set
else
    JAVA=java       # java binary within the current PATH
fi

DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
cd $DIR  # without this it saved projects to home dir.

if ! $JAVA -jar "$DIR/jTimeSched.jar" "$@"; then
    echo "Error executing Java binary." >&2
    exit 1
fi

(SUSE 11.4 with Gnome)