README.md

A program for timing mechanical watches

The program tg is distributed under the GNU GPL license version 2. The full source code of tg is available at https://github.com/vacaboja/tg and its copyright belongs to the respective contributors.

Tg is in development, and there is still no manual. Some info can be found in this thread at WUS, in particular the calibration procedure is described at this post.

Install instructions

Tg is known to work under Microsoft Windows, OS X, and Linux. Moreover it should be possible to compile the source code under most modern UNIX-like systems. See the sub-sections below for the details.

Windows

Binaries can be found at https://tg.ciovil.li

Macintosh

A formula for the Homebrew package manager has been prepared by GitHub user dmnc. To use it, you need to install Homebrew first (instructions on http://brew.sh).

Then run the following command to check everything is set up correctly and follow any instructions it gives you.

brew doctor

To install tg, run

brew install dmnc/horology/tg

You can now launch tg by typing

tg-timer &

Debian or Debian-based (e.g. Mint, Ubuntu)

Binary .deb packages can be downloaded from https://tg.ciovil.li

Compiling from sources

The source code of tg can probably be built by any C99 compiler, however only gcc and clang have been tested. You need the following libraries: gtk+3, portaudio2, fftw3 (all available as open-source).

Release build:

git clone https://github.com/vacaboja/tg.git
cd tg
./autogen.sh
./configure
make

Debug build:

make tg-timer-dbg

Compiling on Windows

It is suggested to use the msys2 platform. First install msys2 according to the instructions at http://www.msys2.org. Then issue the following commands.

pacman -S mingw-w64-x86_64-gcc make pkg-config mingw-w64-x86_64-gtk3 mingw-w64-x86_64-portaudio mingw-w64-x86_64-fftw git autoconf automake libtool
git clone https://github.com/vacaboja/tg.git
cd tg
./autogen.sh
./configure
make

Compiling on Debian

To compile tg on Debian

sudo apt-get install libgtk-3-dev libjack-jackd2-dev portaudio19-dev libfftw3-dev git autoconf automake libtool
git clone https://github.com/vacaboja/tg.git
cd tg
./autogen.sh
./configure
make

The package libjack-jackd2-dev is not necessary, it only works around a known bug (https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=718221).

Compiling on Fedora

To compile tg on Fedora

sudo dnf install fftw-devel portaudio-devel gtk3-devel autoconf automake libtool
git clone https://github.com/vacaboja/tg.git
cd tg
./autogen.sh
./configure
make