xyzzy42 / tg

A program for timing mechanical watches
GNU General Public License v2.0
34 stars 10 forks source link

A program for timing mechanical watches Build Status

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

Fedora, CentOS or other Redhat-based

Binary RPM packages are available from https://copr.fedorainfracloud.org/coprs/tpiepho/tg-timer/

This COPR repository can be added to dnf's list with:

dnf copr enable tpiepho/tg-timer

Then tg-timer can be installed with dnf install tg-timer, or with any dnf based GUI package installer.

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

To build an RPM on Fedora or another RPM based distro, install the build prerequisites and checkout the source as for compiling (above), then run rpmbuild to create the RPM:

rpmbuild --build-in-place -bb packaging/tg-timer.spec