1TLF(1)                             Ham radio                            TLF(1)
2
3
4

NAME

6       Tlf - amateur radio contest keyer/logging program for Radiosport
7

SYNOPSIS

9       tlf [-dhnrvV] [-f config_file] [-s user:password@host/dir/logfilename]
10

DESCRIPTION

12       Tlf  is  a console (ncurses) mode general purpose CW keyer, logging and
13       contest program for amateur radio operators. It supports the CQWW, WPX,
14       ARRL-DX,  ARRL-FD,  STEWPERRY, PACC and EU SPRINT contests as well as a
15       lot more basic contests, general QSO and DXpedition mode.  From version
16       1.2.0 onward there is also support for the FOC Marathon.  It interfaces
17       with a Morse Code generator, a number of radios via the Hamlib library,
18       and  with  a DX Cluster via telnet or packet radio.  Tlf can project DX
19       cluster data into the excellent Xplanet program, written by Hari Nair.
20
21       Contest operation mimics the popular TR-Log program for DOS, the output
22       file is TR-Log compatible.  The log can be exported in ADIF or Cabrillo
23       format.
24
25       The program was written for console mode on purpose, which allows it to
26       run on smaller machines, or remotely via SSH or a modem link.
27
28       Since Tlf version 0.9.21 the cwdaemon 0.9 is fully supported, featuring
29       direct mode for the keyboard and output to parallel  and  serial  ports
30       and speed and weight control from the keyboard, and band info output on
31       the parallel port.
32
33       For users of the K1EL series  of  “Win  Keyers”,  the  winkeydaemon  is
34       available from GitHub ⟨https://github.com/N0NB/winkeydaemon⟩.  Setup is
35       the same as for the cwdaemon.
36
37       For radio control Tlf works with Hamlib (version  >=  1.2.8),  you  can
38       find it at www.hamlib.org ⟨https://www.hamlib.org/⟩.
39
40       Tlf  provides  full  TCP/IP  networking between Tlf nodes, syncing/dis‐
41       tributing log, packet data, frequency data, local talk, serial numbers,
42       time sync etc.
43

OPTIONS

45       Options given to Tlf on the command line.
46
47       -?     Show summary of options and exit.
48
49       -f config_file
50              Start with non-default configuration file:
51
52              tlf -f PA0R
53
54              Defaults to logcfg.dat in actual working directory.
55
56       -s user:password@host/dir/logfilename
57              Synchronize log with other node
58
59              tlf -s user:password@host/dir/logfilename
60
61       -V     Output version information and exit.
62
63       -v     Verbose startup.
64
65       -d     Debug rigctl.
66
67       -n     Start without packet/cluster.
68
69       -r     Start without radio control when user wants to start Tlf without
70              modifying logcfg.dat.
71
72       -i     Import an existing CABRILLO file. When Tlf starts, looks for the
73              YOURCALL.cab  log,  reads  the configuration and rule files, and
74              based on the current setup, generates the log(s). If the contest
75              is  WAE,  and you have QTC's in cabrillo, then Tlf makes the QTC
76              logfiles too. Tlf doesn't write over the existing  log(s).   The
77              generated  import  will be IMPORT_CONTEST.log, where the CONTEST
78              is the name of contest in the config. If QTC  exists,  then  the
79              files  IMPORT_QTC_sent.log  and IMPORT_QTC_recv.log will be cre‐
80              ated.
81

USAGE

83       Tlf has been written for console mode.  If you want to run Tlf  from  a
84       terminal  in  X,  you  will  probably  get  the best results if you set
85       TERM=linux and use a Linux console terminal.  Both KDE and GNOME termi‐
86       nals  have a facility to start a Linux console in an X terminal as does
87       Xfce-terminal.
88
89       By default, xterm(1) may give unreadable colours.  If so, you will have
90       to  set different colours in logcfg.dat or prepare $HOME/.Xresources to
91       the preferred colour scheme.  One advantage of xterm is that it doesn't
92       consume  the  F11  key  which other terminal emulators reserve for full
93       screen mode nor Ctrl-PgUp/Ctrl-PgDn which may be used for tab switching
94       in other emulators.
95
96       Recent  efforts  have  resulted  in improved keyboard handling.  If you
97       find keys that do not work, the developers would like to  receive  your
98       report  of which keys and which terminal have the problem.  Please send
99       the report to the mailing list shown in the BUGS section below.
100
101       There are excellent results with the latest KDE, GNOME, and Xfce termi‐
102       nal  emulators (vi colours are preferred by some).  As Tlf uses ncurses
103       to format its display you must use a proper font.   (Good  choices  are
104       the  Linux  font, Inconsolata, Hack, or any monospace font that dots or
105       slashes the zero character).  If you have problems, try the linux  text
106       console first and work from there.
107
108       Normally  you start or restart Tlf in fast mode with “tlf”.  During de‐
109       bugging of a logcfg.dat file you can start in verbose mode, to  have  a
110       look at the startup messages.  From Tlf version 0.9.3 you can load dif‐
111       ferent config files with:
112
113              tlf -f config_file
114
115       If you have the packet cluster enabled you will first  see  the  packet
116       screen  (if you are using telnet and you have provided your callsign in
117       logcfg.dat you will be automatically logged in  switched  to  the  main
118       logging  screen).   Log in with your callsign, if needed, and switch to
119       the main logging screen with the ‘:’ command.  You can come back to the
120       packet  screen later with the :PACket command from the call input field
121       of the main logging screen.
122
123       You can exit and close Tlf with the :EXIt or  :QUIt  commands  or  with
124       Ctrl-C, Alt-Q or Alt-X.
125
126       At restart Tlf recalculates the score, which may take some time depend‐
127       ing on the number of QSOs in the logfile and the speed of your  system.
128       Tlf  takes the points as they are in the log, and calculates the multi‐
129       plier from either callsign or exchange field  (depending  on  the  con‐
130       test).
131

COMMANDS

133       These  commands  are  entered in the callsign field of the main logging
134       screen.  Each command consists of the leading ‘:’ and  at  minimum  the
135       upper  case  characters  of the command name plus any needed parameters
136       separated by ‘Space’.
137
138       :ADIf  Writes the log to an Amateur Data Interchange Format (ADIF) file
139              logfile.adif.
140
141       :CHAr  Input the number of characters for CW auto-start or ‘m’ for man‐
142              ual start. Possible values are:  ‘0’  (off),  ‘2’...‘5’  or  ‘m’
143              (manual).  After typing as many characters in the input field or
144              after pressing the ‘Enter’ key in manual mode Tlf starts sending
145              the  callsign  without  further keystrokes.  You can type in the
146              rest of the call (but quickly).  As soon as the sending  catches
147              your  last  typed character Tlf automatically sends the exchange
148              and the cursor jumps to  the  exchange  field.   ‘Escape’  stops
149              sending.  This works only in CW contests in RUN mode.
150
151       :CHEck
152       :NOCheck
153              Turn the dupe check window On|Off.
154
155       :CQDelay
156              Change  Auto_CQ  delay  (in  1/2  seconds,  with PageUp/PageDown
157              keys).
158
159       :CLOff No cluster information (non-assisted contest operation).
160
161       :CLUster
162       :MAP   Show cluster window or bandmap.
163
164       :CONtest
165              Toggle contest mode On|Off.
166
167       :CTY
168       :ZONe
169       :MULt  Show needed country multipliers, zones, multipliers  per  conti‐
170              nent (depends on the contest).
171
172       :CWMode
173       :SSBmode
174       :DIGimode
175              Switch TRX to CW|SSB|Digimode mode.
176
177       :DEBug_tty
178              Debug routine for rig communication links.
179
180       :EDIt  Edit the log with your favourite editor. Be careful!
181
182       :EXIt
183       :QUIt  Exit Tlf (synonym to Ctl-C, Ctl-D, Alt-Q, and Alt-X).
184
185       :FILter
186              Filter cluster info (announce, dx-spots, all).
187
188       :FREq  Show frequency or band/score information of your other stations.
189
190       :FLDIGI
191              Turn off/on Fldigi communication.
192
193       :HELp  Show  online  help  (displays help.txt from working directory or
194              from /usr/share if no local one exists).
195
196       :INFo  Show network status.
197
198       :MESsage
199              Edit CW (Morse Code) messages.
200
201       :MODe  Toggle TRX mode (CW|SSB|DIG).
202
203       :PACket
204              Switch to the packet terminal.  Switch back to the main  logging
205              screen with ‘:’.
206
207       :REConnect
208              Re-opens the connection to the DX cluster in case it was discon‐
209              nected.
210
211       :REScore
212              Recalculates the values in the score window (e.g. after deleting
213              or editing QSOs).
214
215       :RITclear
216              Toggle the RIT reset after QSO On|Off.
217
218       :SET
219       :CFG   Edit various parameters in logcfg.dat file and reload it.
220
221       :SCAn  Enter the SCAN function (return with ‘Escape’).
222
223       :SCOre Toggle the score window On|Off.
224
225       :SCVolume
226              Adjust  the soundcard volume for the sidetone (Up|Down).  Range:
227              0–99.
228
229       :SIMulator
230              Toggle simulator mode.  In simulator mode you can  work  a  com‐
231              plete CQWW CW contest in TR-Log mode.  Set CONTEST=cqww.
232
233       :SOUnd The  SOUND  recorder is a utility to record the voice keyer mes‐
234              sages and enables you to record the complete contest  in  chunks
235              of  1  hour  to  the hard drive.  It does this in the directory:
236              $HOME/tlf/soundlogs.  The sound recorder uses  a  script  called
237              soundlog which has to be located in $HOME/tlf/soundlogs.  It can
238              be found in the scripts directory.  If your soundcard is differ‐
239              ent  from  /dev/dsp  you  can use the SC_DEVICE parameter in the
240              logcfg.dat file.  The file extension is .au, the Sun  ulaw  for‐
241              mat.   The  recorder  produces < 60 MB per hour.  This means you
242              can record a complete CQWW in less than 3 Giga  Bytes.  If  your
243              disk  cannot  handle  this,  FTP the soundfile to a server every
244              hour.
245
246              F1 ... F12, s, c, ...  will record the voice keyer  message  for
247              that key.
248
249              1: Start contest recording to ddhhmm.au.
250
251              2: Stop contest recording.
252
253              3: List contest recordings.
254
255              4: Play back contest recording ddhh[mm][:xx].
256
257                     xx is the offset from the start of the file e.g.:
258
259                     2110  will  start  from  beginning of the day 21 hr 10:00
260                     file.
261
262                     21100013:00 will start from day 21, hh 10, mm  00,  +  13
263                     minutes: 0 seconds.
264
265              To  create a new file every hour add a crontab(1) job to run the
266              following command every hour:
267
268                     /usr/bin/pkill -f sox > /dev/null 2> /dev/null
269
270                     Running the crontab job at other  intervals  will  create
271                     sound recordings of the interval period in length.
272
273              Once   started  the  recorder  will  run  until  the  lock  file
274              $HOME/.VRlock is removed.
275
276       :SYNc  Synchronize the logfile of this node with the logfile pointed to
277              by  the  parameter SYNCFILE=user:password@host/dir/logfile.  Tlf
278              will wget(1) the logfile from the relevant node,  make  a  dated
279              backup  of your local logfile, and merge the 2 files.  The score
280              will be recalculated.
281
282       :TONe [dd]d
283              Set PC sidetone frequency in Hertz.  Range: 300–900, 0 = Off.
284
285       :TRXcontrol
286              Toggle rig control On|Off.  Default is Off unless  RADIO_CONTROL
287              is  given in logcfg.dat (only makes sense with rig control capa‐
288              bility).
289
290       :VIEw  View the log with less(1).
291
292       :WRIte Write cabrillo file according to specified format (see  CABRILLO
293              statement in the RULES section).
294

KEYS

296       Work  has been ongoing to unify the key map between the Linux text con‐
297       sole and the various X terminals.  It may be slightly different on cer‐
298       tain  X  terminals  depending  on which keys they consume for their own
299       use.  Turn off any key recognition by the terminal for its own purposes
300       (menu  access,  help display, etc.) if possible.  Pay special attention
301       to the F1-F12 and Alt-<char> keys.  Moreover, on some systems you  must
302       set the TERM=linux or TERM=rxvt environment variables.  This also works
303       under VNC.
304
305       Certain key combinations will probably not be useable as the Linux con‐
306       sole  consumes  Alt-F1  through Alt-Fx (often F7, but could be greater)
307       for switching its virtual consoles.  Likewise, the various desktop  en‐
308       vironments consume key combinations for their own use.  Ctrl-F1 through
309       Ctrl-Fx are used to switch desktop workspaces.  Alt-Fx combinations are
310       used for various desktop features and are unavailable for Tlf use.
311
312       Some  desktop terminal emulators are capable of being configured to al‐
313       low the application running in them to get all of the keys the  desktop
314       environment does not consume.  In testing good choices seem to be Gnome
315       Terminal, Rox Terminal, or the classic Xterm (although its color repre‐
316       sentation differs from the Linux console and other terminal emulators).
317       Xfce Terminal is known to consume F11 and  Ctrl-PageUp  and  Ctrl-Page‐
318       Down.   The Tlf developers have implemented Alt-PageUp and Alt-PageDown
319       as a work-around for the Ctrl counterparts.  Reports  of  success  with
320       other terminals are welcome.
321
322   Call Input and Exchange Fields
323       The Call Input and Exchange Fields are the two main entry fields of Tlf
324       where the majority of the keyboard entry takes place.  The  call  input
325       field  is active when Tlf completes its initialization and presents the
326       main screen.
327
328       Most key sequences are the same in both fields.  Differences are  noted
329       as necessary.
330
331       A-Z, 0-9, /
332              Call input: ASCII letters, numerals, and the '/' characters that
333              make up an internationally  recognized  amateur  radio  callsign
334              plus temporary location identifiers.  Spaces are not allowed.
335
336              Exchange:  information  provided  by  the other station possibly
337              separated by spaces, e.g., ARRL Field Day and ARRL Sweepstakes.
338
339       Space  Switches from call input to exchange field.  Separates  exchange
340              field  elements when multiple exchange elements must be entered,
341              e.g., ARRL Field Day and ARRL Sweepstakes.
342
343       Tab    Switch between call input and exchange fields (jump back to call
344              input from exchange field).
345
346       Enter  Smart key depending on contest mode.
347
348              Tlf  follows  the TR operating style which has two modes, CQ and
349              S&P.
350
351              CQ mode is used for “running”, i.e., staying  on  one  frequency
352              and having other stations answer your call.
353              S&P  mode  is  for  tuning up or down the band and answering the
354              calls of other stations.
355
356              In CQ Mode:
357
358              • With the call input field empty, ‘Enter’ sends the F12 message
359                (Auto CQ).
360
361              • With  characters  in the call input field, ‘Enter’ answers the
362                calling station by sending the F3 message (RST) and moves  the
363                cursor to the exchange field.
364
365              • If the exchange field is empty, ‘Enter’ repeats the F3 message
366                (RST).
367
368              • After the exchange information received from the other station
369                is entered, ‘Enter’ sends the CQ_TU_MSG message if defined, or
370                “TU” and your call otherwise.  Afterwards it logs the QSO, and
371                returns  the cursor to the call input field to answer the next
372                call.
373
374              In S&P Mode:
375
376              • When  the  call  input  field  is  empty,  ‘Enter’  sends  the
377                S&P_CALL_MSG if defined, or your call otherwise.
378
379              • When   the   exchange   field  is  empty,  ‘Enter’  sends  the
380                S&P_CALL_MSG if defined, or your call otherwise.
381
382              • When the call input field has been filled, ‘Enter’  sends  the
383                S&P_CALL_MSG  if  defined, or your call otherwise.  Afterwards
384                it moves the cursor to the exchange field.
385
386              • Once  the  exchange  has  been  received,  ‘Enter’  sends  the
387                S&P_TU_MSG  if  defined, otherwise it sends your call followed
388                by the F3 message (RST).  Afterwards it logs the QSO  and  re‐
389                turns  the  cursor  to the call input field to answer the next
390                call.
391
392       Backspace
393              Erases the character to the left of the  cursor  and  moves  the
394              cursor one position to the left.
395
396       Escape Stop  CW  transmission, clears characters, returns to call input
397              field, keyboard off (universal undo).
398
399              As an example, characters have been entered in both the call in‐
400              put  and  exchange  fields, the cursor is in the exchange field,
401              and the transmission of a CW message is in progress.  The  first
402              press  of  ‘Escape’  will stop the CW transmission and clear the
403              exchange field and position the cursor to the leftmost  position
404              of  the  exchange field.  The second press of ‘Escape’ will move
405              the cursor to the right of the last character in the call  input
406              field.   The  third  press of ‘Escape’ will clear the call input
407              field.
408
409       (Left-Arrow)
410              Change to next band lower or wrap to highest band if already  on
411              the lowest band when callsign field empty.
412
413              Enter  edit  mode if one or more characters are present and move
414              the cursor to the left of the rightmost character.
415
416       (Right-Arrow)
417              Change to next band higher or wrap to the lowest band if already
418              on the highest band when call input field is empty.
419
420       F1     In CQ mode, send message F1 (CQ).
421              In S&P mode send message F6 (MY).
422
423       Shift-F1
424              Restore previous CQ frequency from MEM and send message F1 (CQ).
425
426       F2-F11 Send CW, RTTY or VOICE messages 2 through 11.
427
428       F12    Start  Auto_CQ  (only from call input field).  Sends F12 message
429              repeatedly pausing for  Auto_CQ  delay  time  between  messages.
430              Auto_CQ  is  cancelled  with first character entry into the call
431              input field.
432
433       + (Plus)
434              Toggle between the CQ and S&P modes.
435
436       PgUp   Increase CW (Morse Code) speed (from call and exchange fields).
437
438              If the cursor is in the call input field and it is not empty and
439              CHANGE_RST is set: increase his S value (the leftmost of the RST
440              pair).
441
442              If the cursor is in the exchange field and it is not  empty  and
443              CHANGE_RST is set: increase my S value (the rightmost of the RST
444              pair).
445
446       PgDown Decrease CW (Morse Code) speed (from  call  input  and  exchange
447              fields).
448
449              If the cursor is in the call input field and it is not empty and
450              CHANGE_RST is set: decrease his S value (the leftmost of the RST
451              pair).
452
453              If  the  cursor is in the exchange field and it is not empty and
454              CHANGE_RST is set: decrease my S value (the rightmost of the RST
455              pair).
456
457       Ctrl-PgUp
458       Alt-PgUp
459              Increase Auto_CQ delay pause length (+1/2 sec).
460
461              Set Auto_CQ delay to message length + pause length.
462
463       Ctrl-PgDown
464       Alt-PgDown
465              Decrease Auto_CQ delay pause length (-1/2 sec).
466
467              As  some  terminals,  Xfce  Terminal  is one such, consume Ctrl-
468              PageUp/Ctrl-PageDown, the Alt-key combinations allow for setting
469              the Auto_CQ delay pause length.
470
471              NB: If neither key combination works try :CQD instead.
472
473       ? (Query)
474              In  CW  or DIGIMODE sends the partial call followed by “ ?”.  In
475              VOICE mode sends recorded message 5 (F5).
476
477       ; (Semicolon)
478              Insert note in log.
479
480       , (comma)
481              Activate Morse Keyboard.  Also Ctrl-K.
482
483       " (Double quotation)
484              Send talk message to other Tlf nodes.
485
486       - (Minus)
487              Delete last QSO (Use :REScore to correct scoring afterward).
488
489       (Up-Arrow)
490              Edit last QSO: Insert, overwrite, and delete; + log view.
491
492       = (Equals)
493              Confirm last call.
494
495       _ (Underscore)
496              Confirm last exchange.
497
498       { (Open brace)
499              In RTTY (DIGIMODE), keyboard mode switch TX on.
500
501       } (Close brace)
502              In RTTY (DIGIMODE), keyboard mode switch TX off (RX).
503
504       \ (Backslash)
505              Log QSO without CW output.
506
507              In RTTY (DIGIMODE), keyboard mode switch controller  to  command
508              mode (back to operating mode with “K ‘Enter’”.
509
510       # (Hash)
511              Transceiver  VFO  frequency  →  MEM,  MEM → transceiver VFO fre‐
512              quency.
513
514       $ (Dollar)
515              Pop MEM frequency: MEM → transceiver  VFO  frequency  and  clear
516              MEM.
517
518       % (Percent)
519              Swap transceiver VFO frequency and MEM.
520
521       ! (Exclamation)
522              Get a new shell.  Come back with “exit”.
523
524       Alt-,
525       . (Period)
526              Change  bandmap  filter  configuration.   You can filter to show
527              spots from all or own band only, from all/own mode only  and  if
528              you  want  to  see  dupes or not (see the help (Alt-H) display),
529              only new multiplier or all call (only CQWW).
530
531       Ctrl-A Add a spot to bandmap and broadcast it on the local network.
532
533       Ctrl-B Send a spot to the DX Cluster (a connection to a DX cluster must
534              exit).
535
536       Ctrl-C
537       Ctrl-D Exit Tlf (synonyms to :EXIt, :QUIt, Alt-Q, and Alt-X).
538
539       Ctrl-E Ends  modem  capture  for  RTTY mode in QTC window (started with
540              Ctrl-S).
541
542              See /usr/share/doc/README_QTC_RTTY.txt for more information.
543
544       Ctrl-F Set frequency.  Use Up/Down-Arrow for 100hz steps and  Pg-Up/Pg-
545              Down for 500hz steps.  Return to logging with ‘Escape’.
546
547       Ctrl-G Grab next DX spot from bandmap.
548
549       Ctrl-K Keyboard (CW and RTTY).
550
551       Ctrl-L Reset the screen.
552
553       Ctrl-P Maximum Usable Frequency (MUF) display.
554
555       Ctrl-Q Open  the  QTC window for receiving QTCs if QTC=RECV or QTC=BOTH
556              or sending QTCs if QTC=SEND is set in logcfg.dat.  Same as Ctrl-
557              S if QTC=SEND.
558
559              See               /usr/share/doc/README_QTC.txt              and
560              /usr/share/doc/README_QTC_RTTY.txt for more information.
561
562       Ctrl-R Toggle  /dev/lp0  pin  14  (Mic/Soundcard  switch  |   trx1/trx2
563              switch).
564
565       Ctrl-S Open  the QTC window for sending QTCs if QTC=SEND or QTC=BOTH in
566              logcfg.dat.  Saves QTCs while in QTC window.
567
568              In RTTY mode starts capture from the modem after the window  has
569              been opened with Ctrl-Q.  End capture with Ctrl-E.
570
571              See               /usr/share/doc/README_QTC.txt              and
572              /usr/share/doc/README_QTC_RTTY.txt for more information.
573
574       Ctrl-T Show talk messages.  In the QTC window shows RTTY lines.
575
576       Ctrl-Z Stop Tlf.
577
578       Alt-0...Alt-9
579              Send CW (Morse code) messages.
580
581       Alt-A  Cycle cluster window: NOCLUSTER → CLUSTER → BANDMAP → ...
582
583       Alt-B  Band up in TR-Log mode.
584
585       Alt-C  Toggle display of checkwindow.
586
587       Alt-E  Enter QSO edit mode.
588
589       Alt-G  Grab first spot from bandmap which has  the  characters  in  the
590              call  input  field  in  its call.  Allows the operator to selec‐
591              tively grab a specific call from the bandmap.
592
593       Alt-H  Show help.
594
595       Alt-I  Show talk messages.
596
597       Alt-J  Show other local stations frequencies.
598
599       Alt-K  Keyboard (CW and RTTY).
600
601       Alt-M  Show multipliers.
602
603       Alt-N  Add Note to log.
604
605       Alt-P  Toggle PTT (via cwdaemon).
606
607       Alt-Q
608       Alt-X  Exit Tlf (synonym to :EXIt , :QUIt , Ctrl-C, and Ctrl-D).
609
610       Alt-R  Toggle score window.
611
612       Alt-S  Toggle score window.
613
614       Alt-T  Tune your transceiver (via cwdaemon).   Activates  PTT  and  Key
615              output for 6 seconds.  Stop tuning by pressing any key.
616
617       Alt-V  Band down.
618
619       Alt-W  Set CW weight.
620
621       Alt-Z  Show zones worked.
622
623   CT Compatible Mode
624       Tlf  has limited support for the logging sequence keys used in the once
625       popular CT logging program.  Unlike the default Enter   Sends   Message
626       (ESM)  mode,  the  CT Compatible mode uses the Insert and + keys in the
627       logging sequence and Enter logs a complete QSO.  Unlike  ESM  mode,  CT
628       mode does not have separate CQ or S&P modes.
629
630       CT  Compatible  mode  is  enabled  with  the  CTCOMPATIBLE  keyword  in
631       logcfg.dat (see the PREFERENCES section below).
632
633       The following keys differ in behavior in CT Compatible mode.
634
635       Enter  Log the complete QSO without sending any message macro.
636
637              If the callsign field is empty, pressing Enter will activate the
638              Auto-CQ  function.  If the exchange field is empty, pressing En‐
639              ter in either the callsign or exchange field will result  in  no
640              action.
641
642       Insert Send the RST (F3) macro.
643
644              Since the RST macro includes the other station's callsign by de‐
645              fault, the HIS macro is not sent first.  This differs from clas‐
646              sic CT, but is a compromise to use the default Tlf macros.
647
648       + (Plus)
649              Send the TU macro and log the QSO.
650
651              The  +  key  checks  if the exchange field is empty and if it is
652              nothing is sent or logged.  In rare cases where nothing needs to
653              be  entered  in  the exchange field, e.g. working DX from USA in
654              ARRL 160, simply enter a space to allow the + key to send the TU
655              message and log the QSO.
656
657       Alt-V  Change CW speed.
658

PREFERENCES

660       Tlf  can  be fully configured by editing the logcfg.dat file.  Normally
661       you keep one logcfg.dat file, setting up your callsign,  the  log  file
662       name,  the ports and addresses for packet, the radio, the network etc.,
663       and a separate rules file per contest.
664
665       The logcfg.dat file can be edited from within Tlf by  the  :CFG or :SET
666       commands (or with any other plain text editor before starting Tlf).
667
668       You can set your favourite editor in the logcfg.dat file.
669
670       You   connect   the  rules  file  by  using  the  statement  RULES=con‐
671       test_rules_file_name in logcfg.dat.
672
673       Tlf will first look in the working directory for a logcfg.dat file, and
674       if it cannot find one it will look in /usr/share/tlf for a default one.
675       Make sure you edit the logcfg.dat file at least to hold your  call  and
676       your preferred system configuration.
677

LOGCFG.DAT STATEMENTS

679       Configuration  parameters  set in logcfg.dat located in the working di‐
680       rectory (where Tlf is started).
681
682       RULES=contest_rules_filename
683              Name of the rules file to load.  It helps if you name the  rules
684              file according to the contest you want to describe.
685
686       SYNCFILE=user:password@host/dir/syncfile
687              File  on  remote  host you want to synchronize with (use wget(1)
688              syntax).
689
690       CTCOMPATIBLE
691              Do not use the TR-Log QSO sequence, but use  ‘+’,  ‘Insert’  and
692              ‘Enter’ to log the QSO.
693
694              The  default mode of operation is the TR-Log sequence which uses
695              ‘+’ to switch between CQ and S&P modes, in which ‘Enter’ is  the
696              sole  key used to call the other station, send the exchange, and
697              log the QSO.
698
699       TLFCOLORn=FG/BG
700              Defaults:
701                     TLFCOLOR1=23 (Header and footer)
702                     TLFCOLOR2=67 (Pop up windows)
703                     TLFCOLOR3=70 (Log window)
704                     TLFCOLOR4=57 (Markers/dupe colour)
705                     TLFCOLOR5=43 (Input fields)
706                     TLFCOLOR6=63 (Window frames)
707
708              The numbers are given in octal, FG/BG or BG/FG (some  experimen‐
709              tation likely required).
710
711              You should only specify these if you wish to modify the standard
712              colours of Tlf.  In some Terminals you can set a special profile
713              for  Tlf  with  your  own colours.  Another way is to define the
714              colours via the $HOME/.Xresources file.
715
716       EDITOR=nano | vi[m] | <your_favorite_editor>
717              Editor used to modify the QSO log or  logcfg.dat.   The  command
718              specified receives the file name as an argument.
719
720              When  using a GUI editor that runs in the background (e.g. gvim)
721              make sure to exit the editor before logging  new  stations.  You
722              also  have  to  use  :RES  command to reread the log and correct
723              scoring.
724
725              Best is to force the editor to stay  in  foreground  (e.g.  with
726              'gvim -f').
727
728       CALL=PA0R
729              Your  call  used in messages and used to determine your country,
730              zone and continent.
731
732       TIME_OFFSET=0
733              Used to shift the Tlf time with respect to the  computer  clock.
734              Normally 0.  Range: 0–23.
735
736       TIME_MASTER
737              This  node  transmits the time over the network (only one master
738              allowed!).
739
740       ADDNODE=Node_address[:Port_number]
741              Adds an IP address (and optionally a port number)  to  which  we
742              broadcast stuff.  (WARNING: Only add addresses of other nodes).
743
744       THISNODE=A
745              Node  designator (default “A”).  If Tlf hears its own node ID on
746              the network it will exit  and  ask  you  to  pick  another  one!
747              Range: A–H.
748
749       LAN_PORT=Portnumber
750              Specifies  on which portnumber (default “6788”) Tlf is listening
751              for broadcasts from other instances.
752
753       LANDEBUG
754              Switches on the debug function.  Dumps all Tlf net  traffic  re‐
755              ceived  on  this  node into a file named debuglog in the working
756              directory.  This log can be used as a backup log for  the  whole
757              network,  as  it is easy to retrieve QSO data, cluster messages,
758              gab messages etc. after the contest.  Some users have  this  en‐
759              abled all the time.
760
761       NETKEYER
762              Switches  the CW keyer on.  Only the IP networked keyer cwdaemon
763              or any other program that emulates cwdaemon such as winkeydaemon
764              is  supported.   You  may also need the keyer for PTT control or
765              band info output.
766
767       NETKEYERPORT=port_number
768              Default port is 6789.
769
770       NETKEYERHOST=host_address
771              Default host is 127.0.0.1 (localhost).
772
773       MFJ1278_KEYER=serial_port
774              Activates support for the MFJ-1278B multi-mode controller.   The
775              MFJ-1278  supports  CW as well as RTTY contesting.  Fixed serial
776              port rate is 9600 bps.
777
778       CWSPEED=speed_in_WPM
779              Range: 4–69.
780
781       WEIGHT=weight_ratio
782              Set the dot to dash  ratio.   Only  for  the  NETKEYER.   Range:
783              -45–50.
784
785       TXDELAY=PTT_delay_in_mS
786              Delay activation of the Push To Talk pin.  Range: 0–50.
787
788       KEYER_BACKSPACE
789              Support backspace key in keyer window.
790
791       SOUNDCARD
792              Use soundcard for sidetone output.
793
794       SIDETONE_VOLUME=soundcard_volume
795              Set  soundcard  sidetone  volume  (default is 70).  A value of 0
796              turns off  sidetone  output  (even  for  the  console  speaker).
797              Range: 0–99.
798
799       CQDELAY=Auto_cq
800              Set  automatic  CQ pause delay in 1/2 seconds increments between
801              message transmissions.  Range: 3–60.
802
803       CWTONE=sidetone
804              Set the PC  speaker  or  soundcard  frequency.   A  value  of  0
805              switches the sidetone off.  Range: 0–999.
806
807              (Due to a bug in cwdaemon it also turns off the Alt-T tune func‐
808              tion.  Use SIDETONE_VOLUME=0 instead).
809
810       BANDOUTPUT
811              Outputs band information to pins 2, 7,  8,  9  on  the  parallel
812              port.   Output is 1 (160m), 2 (80m) ... 9 (10m).  This format is
813              compatible with the standard  interface  for  antenna  switches,
814              band filters etc.
815
816       BANDOUTPUT=124181818
817              Output pin 2 for 160, 30, 17 and 12, pin 7 for 80, pin 8 for 40,
818              and pin 9 for 20, 15 and 10.  This comes in handy when you  have
819              3 dipoles and a 3-band beam (...).
820
821       NO_BANDSWITCH_ARROWKEYS
822              This will prevent unwanted band switching when you are not using
823              rig control.  Band up = Alt-B, band down = Alt-V (TR-Log compat‐
824              ible).
825
826       TELNETHOST=cluster_address
827              Use  Telnet  to connect to a DX Cluster node using a DNS name or
828              IP address, e.g. claudia.esrac.ele.tue.nl or 131.155.192.179.
829
830       TELNETPORT=telnet_port_of_cluster
831              DX Clusters often use a non-standard port for Telnet, e.g. 8000.
832
833       TNCPORT=serial_port
834              You can use /dev/ttyS0, /dev/ttyUSB1, etc. anything  that  looks
835              like a tty.
836
837       TNCSPEED=serial_rate
838              Tlf supports 1200, 2400, 4800 and 9600 bps.
839
840       FIFO_INTERFACE
841              The FIFO (First In First Out) interface is used when you want to
842              receive cluster info from the network, or from  another  source.
843              The  FIFO  interface uses a special FIFO file in the working di‐
844              rectory called clfile.  Anything you dump into this FIFO will be
845              displayed by the packet interface.
846
847       RADIO_CONTROL
848              Switches the radio interface on.  The rig interface makes use of
849              the Hamlib library which supports a number of different rigs.
850
851       RIGMODEL=rig_number
852              Look at the Hamlib documentation for the rig_number.
853
854              Hint: rigctl -l and its manual page (rigctl(1)).
855
856       RIGSPEED=serial_rate
857              Speed of the serial port for rig control.
858
859       RIGPORT=serial_port
860              You can use /dev/ttyS0, /dev/ttyUSB1, etc. anything  that  looks
861              like a tty.
862
863              RPC rig daemon users should use RIGMODEL=1901 and RIGPORT=local‐
864              host.  In this case RIGSPEED is ignored (NB: rig model  1901  is
865              deprecated  in  Hamlib releases 3.0 and later and is replaced by
866              rigctld(8) which is rig model 2).
867
868       RIGCONF=rig_configuration_parameters
869              Send rig configuration parameters to Hamlib.
870              e.g. RIGCONF=civaddr=0x40,retry=3,rig_pathname=/dev/ttyS0
871
872       RIT_CLEAR
873              Clears the RIT after logging the qso.  This only  works  if  the
874              rig, and the Hamlib routine supports it (tested on the OMNI 6+).
875
876       RIGPTT Declares  that  Hamlib  CAT  PTT capability should be checked at
877              startup and if available use it to activate the radio's PTT  for
878              sending voice messages instead of the NetKeyer PTT.
879
880       CWBANDWIDTH=width
881              Sets the CW bandwidth of your rig when changing bands.  If unset
882              or 0 the default bandwidth (as determined by Hamlib) is used. (a
883              valid bandwidth for the rig must be used).
884
885       SC_DEVICE=device
886              Sound card device for scan function.
887              e.g. SC_DEVICE=/dev/dsp0
888
889       SSBMODE
890              Start Tlf in SSB mode (default is CW).
891
892       RTTYMODE
893              Start Tlf in RTTY mode (defaul is CW)
894
895       GMFSK=$HOME/gMFSK.log
896              Tell miniterm(1) where to get the data.
897
898       DIGIMODEM=$HOME/gmfsk_autofile
899              Tell Tlf where to send the macros.
900
901       CLUSTER
902              Show cluster window at startup.
903
904       CLUSTERLOGIN=yourcall
905              Automatic login for the telnet client.
906
907       CLUSTER_LOG
908              Write clusterlog to disk.
909
910       BANDMAP
911              Shows  cluster  bandmap  on  startup.  Use '.' to change bandmap
912              filtering.
913
914       BANDMAP=xyz,number
915              Show cluster bandmap on startup and set start values for filter‐
916              ing.
917              <xyz> string parsed for:
918                   “B” - only own band
919                   “M” - only own mode
920                   “D” - do not show dupes
921                   “S” - skip dupes during grab_next (Ctrl-G)
922                   “O” - show only multiplier (CQWW only)
923              <number> livetime for new spots in seconds (number >= 30)
924
925       SCOREWINDOW
926              Show the score window (same as Alt-R).
927
928       CHECKWINDOW
929              Show the country/call check window.
930
931       PARTIALS
932              Show a list of possible contest calls.
933
934       USEPARTIALS
935              Use  the  auto-complete  utility  (takes some practice...).  Tlf
936              will complete the call as soon as it is unique in the  database.
937              This  can  of  course  lead  to strange effects, but in practice
938              there are far more hits than misses.  Sometimes  you  must  edit
939              the  call  because  it has locked on a unique call.  Try it, and
940              switch it off when you don't like it.
941
942       LOGFREQUENCY
943              Put frequency (kHz) into QSO number to enable  logging  of  fre‐
944              quency (only QSO and dxped mode).
945
946       IGNOREDUPES
947              Enable to allow multiple QSOs in a contest with the same station
948              (considered a good idea these days as  contest  bots  will  take
949              care of dupes).
950
951       SUNSPOTS=SSN
952              Set  the  sunspots value which is used to do a rough calculation
953              of the MUF.  If the cluster interface is used the  SSN  will  be
954              updated by WWV or WCY messages.
955
956       SFI=Solar_flux_value
957              Set  SFI  used  to calculate SSN.  The SSN value is used to do a
958              rough calculation of the MUF.  If the packet interface  is  used
959              the SSN will be updated by WWV or WCY messages.
960
961       CHANGE_RST
962              If set in logcfg.dat, PgUp and PgDown will change RST instead of
963              CW speed if field is not empty.
964              Default is Off.
965
966       NOB4   Do not send automatic “QSO B4” message.
967              Default is On.
968
969       NOAUTOCQ
970              No automatic CQ when pressing ‘Enter’ or ‘F12’.
971
972       MARKERS=file_name
973              Generate marker file for Xplanet.  Xplanet will show the last  8
974              spots  on an azimuthal map.  See the relevant Xplanet documenta‐
975              tion.  Use azimuthal projection and center the map on your QTH.
976
977       POWERMULT=power_multiplier
978              Use this value to multiply the final  points.   If  the  contest
979              rule  allows  one  to  use the power multiplier (e.g. Stewperry,
980              ARRL-FD), you can pass that here.
981
982              NB: The type of POWERMULT is a float,  e.g.  POWERMULT=1.5,  but
983              the  final score will be rounded by the C library floor(3) func‐
984              tion, which gives the largest integer value that is not  greater
985              than multiplied score.
986
987       SEND_DE
988              Sends a “DE” word before your callsign, e.g. “DE W1AW”. There is
989              a special case: if SEND_DE is present in logcfg.dat, and Tlf  if
990              is  in  DIGIMODE, then the other station's callsign will be sent
991              before “DE”, e.g. “DL1A DE W1AW”.
992
993       DIGI_RIG_MODE=mode
994              If set with RADIO_CONTROL option, specifies the mode  to  change
995              the rig to when :DIG mode is selected. mode may be one of “USB”,
996              “LSB”, “RTTY”, or “RTTYR”.  If not set, “USB” is used if  FLDIGI
997              is set and “LSB” is used otherwise.
998

RULES

1000       The  contest rules can be put into separate files.  Tlf will first look
1001       for a directory called rules/ in the  working  directory,  and  a  file
1002       named  for the contest, e.g.  cqww.  If Tlf cannot find such a file, it
1003       will look into the directory /usr/share/tlf/rules.  A rules  file  con‐
1004       tains  contest  specific parameters like multipliers, scoring rules, CW
1005       and voice keyer messages, etc.
1006
1007       NB: The rules file overrides settings from the logcfg.dat file!
1008
1009       WARNING!  It is your own responsibility to try these rules well  BEFORE
1010       the  contest.   The  authors of Tlf cannot possibly check all rules for
1011       all contests :) and during the contest there is normally no time to fix
1012       it.
1013
1014       CONTEST=xxxxx
1015              Name  of  the contest (same as the file name contest_name refer‐
1016              enced above).  Some contests, like CQWW and  WPX,  are  pre-pro‐
1017              grammed.     Look    for    the    relevant    rules   file   in
1018              /usr/share/tlf/rules.
1019
1020       LOGFILE=log_file_name
1021              Mandatory!
1022
1023       CABRILLO=cabrillo_format
1024              Specify  the  name  of  the  cabrillo   format   to   use   (see
1025              doc/README.cab).
1026
1027       CONTEST_MODE
1028              Sets  Tlf into contest mode.  Do not use this parameter for nor‐
1029              mal QSO logging!
1030
1031       NO_RST Do not use RST in contest, e.g. for CW Open,  ARRL  Sweepstakes,
1032              or ARRL Field Day.  If you want to write a Cabrillo log you must
1033              provide a conforming format definition without RST values.
1034
1035       CQWW_M2
1036              Put the node ID into the logline (just after the QSO number)  to
1037              support Multi/2 operation where the station logging the QSO must
1038              be in the Cabrillo file.  This can also be used for M/1 and M/M,
1039              to enable post-contest analysis of the nodes.
1040
1041       Macro characters in the messages
1042              %  =  mycall,  @  = hiscall, # = serial number, [ = RST, + = in‐
1043              crease cw speed, - = decrease cw speed, * = AR, = = BT, < =  SK,
1044              (  =  KN, !  = SN, & = AS, > = BK, !  = his serial (e.g. confirm
1045              exchange of station in DIGIMODE).
1046
1047       F1="cw message 1"
1048              CQ message, (e.g. CQ de PA0R TEST).
1049
1050       F2="cw message 2"
1051              S&P call message, (e.g. @ de %).
1052
1053       F3="cw message 3"
1054              Exchange message, (e.g. @ ++5NN--#).
1055
1056       F4="cw message 4"
1057              TU message, (e.g. TU 73 %).
1058
1059       F5="cw message 5"
1060              Call of the other station (e.g. @).
1061
1062       F6="cw message 6"
1063              Your call (e.g. %).
1064
1065       F7="cw message 7"
1066              QSO B4 message (e.g. @ sri qso b4 gl).
1067
1068       F8="cw message 8"
1069              Again message (e.g. AGN).
1070
1071       F9="cw message 9"
1072              Query message (e.g. ?).
1073
1074       F10="cw message 10"
1075              QRZ message (e.g. QRZ?).
1076
1077       F11="cw message 11"
1078              Please reply message (e.g. PSE K).
1079
1080       F12="cw message 12"
1081              Auto-CQ message (e.g. +++TEST %---).
1082
1083       CQ_TU_MSG="cw message 13"
1084              Auto Exchange message in CQ mode (TR-Log mode), (e.g. TU %).
1085
1086       S&P_TU_MSG="cw message 14"
1087              Auto Exchange message in S&P mode (TR-Log mode),  (e.g.  TU  5NN
1088              #).
1089
1090       S&P_CALL_MSG="cw message 25"
1091              Custom call message in S&P mode.  Allows replacing the auto-gen‐
1092              erated S&P call message.
1093
1094       Alt_0=<...> ... Alt_9=<...>
1095              Up to 10 additional messages.
1096
1097       SHORT_SERIAL
1098              Uses short form for serial number (599=5NN, 001=TT1).
1099
1100       LONG_SERIAL
1101              Uses long form for serial number (default).
1102
1103       VKM1=voice message file name 1 ... VKM12=voice message file name 12
1104              Use F1 ... F12 keys to send recorded messages for phone.
1105
1106       VKCQM=voice_message_file_name
1107              Auto Exchange voice message in CQ mode (TR-Log mode)
1108
1109       VKSPM=voice_message_file_name
1110              Auto Exchange voice message in S&P mode (TR-Log mode)
1111
1112       ONE_POINT
1113              One point per QSO.
1114
1115       TWO_POINTS
1116              Two points per QSO.
1117
1118       THREE_POINTS
1119              Three points per QSO
1120
1121       CWPOINTS=d
1122              Points per CW QSO.
1123
1124       SSBPOINTS=d
1125              Points per SSB QSO.
1126              NB: SSBPOINTS and CWPOINTS need to be set for both to work!
1127
1128       MY_COUNTRY_POINTS=d
1129              Points for working your own DXCC entity (often zero (0)).
1130
1131       MY_CONTINENT_POINTS=d
1132              Points for working countries in your own continent.
1133
1134       DX_POINTS=d
1135              Points for working a station in other continents.
1136
1137       2EU3DX_POINTS
1138              Deprecated.  Use MY_CONTINENT_POINTS and DX_POINTS instead.
1139
1140       COUNTRY_LIST_POINTS=d
1141              Points for countries in country list.
1142
1143       USE_COUNTRYLIST_ONLY
1144              Score zero points for countries not in the list.
1145
1146       COUNTRYLIST="comma separated list of prefixes starting with colon"
1147              e.g. Scandinavia:SM,LA,OZ,OH.
1148
1149       COUNTRYLIST=file_name
1150              File with a list of prefixes.
1151
1152       PORTABLE_MULT_2
1153              Multiply points x2 for portable stations (e.g. R1 field day).
1154
1155       LOWBAND_DOUBLE
1156              Double all points for lowband (40, 80, and 160m)  QSOs  (can  be
1157              combined  with  any other value). (Will be deprecated in future!
1158              Use BANDWEIGHT_POINTS instead.)
1159
1160       WYSIWYG_MULTIBAND
1161              Exchange is multiplier,  per  band,  whatever  you  enter.   Tlf
1162              builds its own list of multipliers.
1163
1164       WYSIWYG_ONCE
1165              Exchange is multiplier, whatever you enter.  Counts once for the
1166              whole contest (not per band).
1167
1168       WAZMULT
1169              Multiplier is the CQ zone (per band).
1170
1171       ITUMULT
1172              Multiplier is the ITU zone (per band).
1173
1174       PFX_MULT
1175              Multiplier is prefix (PA0, DA2, VE7, etc.).   Counted  once  per
1176              contest, not per band.
1177
1178       PFX_MULT_MULTIBAND
1179              Same as WPX, but the WPX only used CQ-WW-WPX, and there a single
1180              prefix multiplier only once, not all band. With this option, the
1181              PFX counts as multiplier on all band. This usable on AA-DX.
1182
1183       COUNTRY_MULT
1184              Multiplier is the DXCC entity (per band).
1185
1186       MULT_LIST=file_name
1187              Name  of  multipliers  file  (often sections, provinces, states,
1188              counties).  May contain comment lines starting with “#”  in  the
1189              first  column.  Each  multiplier resides on a single line by it‐
1190              self.
1191
1192              Starting from Tlf-1.4 on you can also use aliases for the multi‐
1193              pliers. Define the aliases as
1194
1195                  multiplier:alias1,alias2,alias3
1196
1197              If you log a QSO with one of the aliases  it will be counted for
1198              as the according multiplier. You can have more than one line for
1199              the same multiplier.
1200
1201       SECTION_MULT
1202              Multiplier is section from multipliers file.
1203
1204       SERIAL+SECTION
1205              Exchange  is  serial  number  and section, multiplier is section
1206              from multiplier file.  Mults count per band.
1207
1208       SERIAL_OR_SECTION
1209              Exchange is serial number or section.  This option is similar to
1210              SERIAL+SECTION,  except  the  exchange  could be a serial OR the
1211              section.  The options was introduced for HA-DX,  where  HA  sta‐
1212              tions  give  the  shortest  form of their county, other stations
1213              give serial.
1214
1215       SERIAL+GRID4
1216              Exchange is serial number and grid (e.g. JO21QI),  multipler  is
1217              4-character grid (JO21).  Mults count per band.
1218
1219       DX_&_SECTIONS
1220              Multiplier is DXCC country or section from multiplier file.
1221
1222       RECALL_MULTS
1223              Exchange  can  be  recycled,  will be filled into exchange field
1224              when it is known (see also INITIAL_EXCHANGE).
1225
1226       INITIAL_EXCHANGE=exchanges.txt
1227              The file must contain a comma-separated list  of  exchanges,  if
1228              e.g. the exchange is the name of the operator:
1229              PA0R,rein
1230              PG4I,joop
1231              OK1RR,martin
1232
1233              If  RECALL_MULTS  is set, Tlf will look in this list for the ex‐
1234              change and fill it in for you.  There are various contests which
1235              have  a standard exchange, like e.g. the FOC Marathon.  The mod‐
1236              ule also recognises embedded calls (CT3/PA0R/QRP).
1237
1238       CALLMASTER=callmaster
1239              Allow to name a different file used as callmaster database  (de‐
1240              fault is 'callmaster'). See FILES section.
1241
1242       CONTINENT_EXCHANGE
1243              Exchange is continent (NA, SA, EU, AS, AF, OC).
1244
1245       SERIAL_EXCHANGE
1246              Exchange is serial number (formats exchange field).
1247
1248       MIXED  Station can be worked both in SSB and CW.
1249
1250       SSBMODE
1251              Start Tlf in SSB mode.
1252
1253       MYQRA  For the “Stewperry” contest, this option is used to set the QRA,
1254              e.g.: JN97, or the full form: JN97OM.  In Stewperry, the  points
1255              are calculated based on the distance between the stations.
1256
1257       QTC    If  you  want  to  send  or receive QTC's on contest (usually on
1258              WAEDC), put this option to logcfg.dat. This needs  a  parameter,
1259              which  could be one of these: RECV, SEND, BOTH - note, that cur‐
1260              rently just the RECV works. For more information, please see the
1261              README_QTC.txt file.
1262
1263       QTC_CAP_CALLS=list_of_qtc_capable_callsigns.txt
1264              If you want to help yourself to indicate that the station is QTC
1265              capable, you can see it on your bandmap or  worked  window.  Put
1266              the  callsign  of stations in a file, one callsign per line, and
1267              give it as an argument to this variable.
1268
1269       QTC_AUTO_FILLTIME
1270              If you use QTC feature, and you are  on  EU  station  in  CW/SSB
1271              modes,  then you can only RECEIVE the QTC's. Most sender station
1272              send their QTC's as a most short form, example, after the  first
1273              line  it doesn't send the first two characters of time field. If
1274              you set this option, then when you fill the first QTC line, then
1275              Tlf will fills the other time fields, only the first two charac‐
1276              ters. Of course, if you change the hour  (eg.,  if  there  is  a
1277              time: 2059, and the next one is 2100), then all next time fields
1278              will be changed.
1279
1280       QTC_RECV_LAZY
1281              If you use QTC feature, and you are  on  EU  station  in  CW/SSB
1282              modes, then you can use this feature. In normal case, Tlf checks
1283              all received QTC lines: the time  field  must  be  4  characters
1284              long,  callsign  and serial fields must be non-empty. If you set
1285              up this option, Tlf will ignore this restrictions.
1286
1287       CONTINENTLIST="comma separated list of continents"
1288              Valid values are: SA, NA, EU, AF, AS and OC.
1289
1290       CONTINENT_LIST_POINTS=d
1291              Points for stations from continents in CONTINENTLIST
1292
1293       USE_CONTINENTLIST_ONLY
1294              Score zero points for station from continents not in the list.
1295
1296       BANDWEIGHT_POINTS
1297              Allow a point weighting factor for different bands. E.g.
1298              BANDWEIGHT_POINTS=160:3,80:2,40:1,20:1,15:1,10:2
1299              can be used for AADX contest. It will multiply all QSO points by
1300              3 on 160m, by 2 on 80m and 10m and on all other bands only by 1.
1301
1302              Bands not in list are weighted by 1.
1303
1304       BANDWEIGHT_MULTIS
1305              Allow  a  weigthing  factor  for multipliers on different bands.
1306              E.g.
1307              BANDWEIGHT_MULTIS=80:4,40:3,20:2,15:2,10:2
1308              can be used for WAEDC contest. It will multiply  the  number  of
1309              multipliers on 80 by 4, on 40 by 3 and on 20/15/10 by 2.
1310
1311              The  multiply  operation  is executed after any other multiplier
1312              modification.
1313
1314              Bands not in list will be weighted by 1.
1315
1316       PFX_NUM_MULTIS
1317              On WAEDC (and maybe with other contests too) the multipliers are
1318              the  different countries, but there are some exceptions where of
1319              certain countries a different prefix number is a different  mul‐
1320              tiplier. On WAEDC these countries are: W, VE, VK, ZL, ZS, JA, PY
1321              and RA8/RA9 and RAØ.  With this option, you  can  list  the  af‐
1322              fected  countries:  PFX_NUM_MULTIS=W,VE,VK,ZL,ZS,JA,PY,UA9.  Tlf
1323              will read these items, make a lookup  in  a  countrylist  for  a
1324              country  code,  and  that code will be used.  If you include the
1325              UA9 prefix and then make a QSO with a station from Asiatic  Rus‐
1326              sia,  the  PFX  number will evaulated with a new multiplier, but
1327              European Russia will not.
1328
1329       EXCLUDE_MULTILIST
1330              Some contests have a special multipliers list, which  is  easier
1331              to  write  with  by excluding a predefined set. For example, the
1332              main set could be COUNTRY_MULT, and you  need  to  exclude  from
1333              that  list  just  a few countries, e.g. the SAC contest excludes
1334              the Scandinavian countries as they are not multipliers). In that
1335              case you can use this configuration:
1336                  COUNTRY_MULT
1337                  COUNTRYLIST=sac:JW,JX,LA,OF1,OF0,OJ1,OJ0,OX,OW,OZ,SM,TF
1338                  EXCLUDE_MULTILIST=COUNTRYLIST
1339              Another  useful example at WAEDC RTTY contest: then all stations
1340              can work each other, for EU stations only  the  non-EU  stations
1341              are  the  multi's,  and reverse: for non-EU stations only the EU
1342              stations are the multipliers. In that case the EU  stations  can
1343              use this config:
1344                  CONTINENTLIST=EU
1345                  COUNTRY_MULT
1346                  EXCLUDE_MULTILIST=CONTINENTLIST
1347              Now  all country are multi, except the EU stations. In this con‐
1348              test the non-EU stations can use this config:
1349                  CONTINENTLIST=SA,NA,AF,AS,OC
1350                  COUNTRY_MULT
1351                  EXCLUDE_MULTILIST=CONTINENTLIST
1352              In this example all countries are multis, except  from  SA,  NA,
1353              AF,  OC and AS continent, so only the EU stations left as multi‐
1354              pliers.
1355
1356       BMAUTOGRAB
1357              If set, with RADIO_CONTROL and BANDMAP (mandatory) options,  Tlf
1358              will  grab  the  callsign  from bandmap, if the TRX frequency is
1359              equal with bandmap freq.
1360
1361       BMAUTOADD
1362              If set, with RADIO_CONTROL and BANDMAP (mandatory) options,  Tlf
1363              will add the callsign from callsign field, if at least 3 charac‐
1364              ter have been entered. Use “S”kip dupes in BANDMAP  settings  to
1365              control if it should also grab dupes.
1366
1367       SPRINTMODE
1368              If  set,  Tlf will automatically switch its mode between LOG and
1369              S&P after every QSO.
1370
1371       FLDIGI If you work RTTY (or any other digital modes), you can  communi‐
1372              cate  with  Fldigi through XMLRPC. The FLDIGI keyword will acti‐
1373              vate   the   interface.    By    default    it    connects    to
1374              http://localhost:7362/RPC2 ⟨http://localhost:7362/RPC2⟩.
1375
1376              If  you  run  Fldigi's  xmlrpc  server  on an different port use
1377              FLDIGI=http://localhost:port_#/RPC2
1378
1379       MINITEST [=NNN]
1380              Use this option when the contest is a minitest like contest.  In
1381              that contests the full contest intervall is divided into shorter
1382              sections (e.g. 6 * 10 minute sections in an hour).  Any  station
1383              can be worked once in each of the time sections without counting
1384              as dupe.  The default length of the sections is 600 seconds  (10
1385              minutes),  but you can pass another value (in seconds) after the
1386              '=' sign. There must be an integral number of time sections  per
1387              hour!
1388
1389       UNIQUE_CALL_MULTI
1390              Multiplier  is  callsign.   You  have to pass one of these argu‐
1391              ments: ALL, BAND.
1392
1393              Example:
1394
1395                  UNIQUE_CALL_MULTI=BAND
1396
1397              The argument tells Tlf, how to score the callsigns as  multipli‐
1398              ers:
1399              ALL means the callsign is a multiplier, independet of band.
1400              BAND means the callsign counts as multiplier on different bands.
1401
1402       DKF1=digi keyer message 1 ... DKF12=digi keyer message 12
1403              Use F1 ... F12 keys to send recorded messages for phone.
1404
1405       DKCQM=message
1406              Auto Exchange TU digi message in CQ mode (TR-Log mode)
1407
1408       DKSPM=message
1409              Auto Exchange TU digi message in S&P mode (TR-Log mode)
1410
1411       DKSPC=message
1412              Auto Exchange call digi message in S&P mode (TR-Log mode)
1413

FILES

1415       /usr/share/tlf/logcfg.dat is a recent example of the configuration file
1416       Tlf needs to know what to do.  Tlf won't start without  one.   Copy  it
1417       into  the working directory and edit it before use.  You should do your
1418       experiments well before the contest.  It contains, amongst  other  set‐
1419       tings, your call, name of the log file, info about ports for CW keying,
1420       packet or rig control, contest rules, points, multipliers etc.
1421
1422       /usr/share/tlf/rules/contestname contains the rules of the various con‐
1423       tests.   You can easily write one for your favourite contest making use
1424       of the various multiplier and points capabilities.  Check it before the
1425       contest   and  send  a  message  to  the  Tlf  development  list  ⟨tlf-
1426       devel@nongnu.org⟩ if anything is wrong (or right!).
1427
1428       /usr/share/tlf/cty.dat contains a flat ASCII  database  of  info  about
1429       countries.   This  is  the  same file as used by CT or TR-Log.  Updated
1430       versions  from  Jim,  AD1C,   are   available   from:   Country   Files
1431http://www.country-files.com/⟩.
1432
1433       /usr/share/tlf/callmaster  contains a flat ASCII database of known con‐
1434       test  callsigns.   Updates  are  available  from  Super  Check  Partial
1435http://www.supercheckpartial.com/⟩.  Save the master.scp file as call‐
1436       master in the working directory (or use  CALLMASTER=master.scp  to  use
1437       that file).  It will take precedence over the system installed callmas‐
1438       ter.
1439
1440       Section files contain a flat ASCII database of multpliers like  states,
1441       sections,  provinces, districts, names, ages, etc.  They are invoked by
1442       including MULT_LIST=section_file_name in the rules file.
1443

DOCUMENTATION

1445       An operation manual (a little bit outdated) is available in HTML format
1446       at          the          old          Tlf          project         page
1447http://sharon.esrac.ele.tue.nl/pub/linux/ham/tlf/⟩.
1448
1449       An FAQ and other useful tips are installed in the system doc  directory
1450       under tlf.
1451

BUGS

1453       Please   send   bug   reports   to   the  Tlf  development  list  ⟨tlf-
1454       devel@nongnu.org⟩.
1455

AUTHORS

1457       Tlf was written by Rein Couperus ⟨pa0r at eudxf.org⟩ aka Rein  Couperus
1458       ⟨rein  at  couperus.com⟩  but  maintained  from  2009  onward by Thomas
1459       Beierlein ⟨tb at forth-ev.de⟩.  Lots  of  valuable  contributions  from
1460       PG4I (Joop PA4TU), PA3FWM, LZ3NY, VA3DB, OM4AA, OK1RR, DH5FS, G4KNO and
1461       various other contributors.  (See the AUTHORS file for more). Thanks to
1462       all for improving Tlf!
1463
1464       Beta testers and feedback are always welcome!
1465
1466
1467
1468TLF                              version 1.4.1                          TLF(1)
Impressum