TLF logo a Linux based ham radio contest logger

This is the new home for the TLF project. This project has been taken over from Rein Couperus, PA0R, in 2009 by Thomas Beierlein, DL1JBE, for maintenance and further development.

What is TLF?

TLF is a curses based console mode general logging and contest program for amateur radio.

It supports the CQWW, the WPX, the ARRL-DX, the ARRL-FD, the PACC and the EU SPRINT shortwave contests (single operator) as well as a LOT MORE basic contests, general QSO and DXpedition mode.

It interfaces with cwdaemon or winkeyer daemon for morse code generation and with your sound card for CW/VOICE keying, connects to a number of radios via the Hamlib library and has a built-in client for DX cluster connection.

TLF

Main Features

  • Network based CW Keyer 6-60 wpm with 24 CW messages

  • Integrated voice keyer (14 messages)

  • AUTO-CQ

  • Built-in contests

  • Own contest definitions (with some limitations) supported

  • DX-pedition and QSO mode

  • DXCC database

  • Intelligent dupe checking

  • Radio control via Hamlib library for many tranceivers

  • MUF calculator

  • IP networking for M/S or M/M operation

  • Built-in telnet client and TNC terminal for cluster connection

  • nearly TRLog output compatible

  • configurable Cabrillo output

Some more minor features

  • Built-in CW practising simulator to learn tlf (cqww)

  • On-line log file sync over the network

  • Band info output on parallel port (top ten decoder compatible)

  • RTTY contesting with gMFSK or fldigi (soundcard program)

  • Sound recorder facility to record voice keyer messages and complete contest.

Supported Contests
  • CQWW (SO, M/S and M/M)

  • WPX (SO, M/S and M/M)

  • ARRL Sweepstakes (SO, M/S )

  • EU SPRINT

  • EUHFC

  • ARRL-DX (both sides)

  • ARRL-FD

  • ARRL 10m

  • ARRL 160m

  • Region1 field day

  • SP DX contest

  • PACC (both sides)

  • NRAU - scandinavian

  • Wysiwyg mults mode (per band or per contest)

  • WAEDX (New in tlf-1.2.2 See doc/README_QTC.txt)

Download and Installation

You can download the source code for the last packaged version (TLF-1.3.0) here. It must be compiled after unpacking (see below).

Quick install

Tlf uses automake and autoconf for building. Starting with TLF-1.0.0 you need pkg-config too.

Easiest way to install tlf from source is by typing:

cd <packagedirectory>
./configure
make
make install

If you want to compile the newest code from the git repo (http://www.github.com/Tlf/tlf), please run the following command just after download and unpack:

autoreconf --install

If you want to connect TLF to your radio, you need Hamlib support. Use the following command before the make above to enable it:

./configure --enable-hamlib

By default tlf will be installed into /usr/local/bin, together with the shell-scripts in the scripts directory. Data files will be installed into /usr/local/share/tlf. If you want to change any of these paths, you can do this with configure too, e.g.

./configure --prefix=/usr --datadir=/usr/share

will install tlf and scripts into /usr/bin and datafiles into /usr/share/tlf.

If you are doing a lot of contesting in digimodes using Fldigi there is support for reading the audio frequency via xmlrpc. Make sure to install XMLRPC-c and configure tlf with

./configure --enable-fldigi-xmlrpc

How to get started

Work in progress…
  • Read man page

  • look into the help (the old one for now)

  • See doc/README, doc/README.ssb, …

Other ressources

Want to help making TLF better

  • If you want to contribute to TLF’s development you can

    • clone the repository, make changes and send patches or pull requests.

      git clone git://github.com/Tlf/tlf.git
    • test the contest rules and multiplier files, suggest new contests or

    • review the documentation and provide corrections or additional information.

All help is welcome.

Old documentation