Files
Remark: Character ~ (tilde) is short cut of user home directory (bash# echo $HOME). Under Windows it poins to user's AppData folder.
Files which are described below are saved in plain text format. Is possible to edit these files but it is necessary to keep format of files. In other case Tucnak shouldn't work properly.
Note files in /usr/share/tucnak2/ are only examples and are not read by tucnak. These files are default values hard-wired in tucnak binary. You can copy into ~/tucnak and modify them. Tucnak will use files in ~/tucnak instead of compiled-in data.
Binaries
tucnak
Is one binary file. If Tucnak is install from source code it's installed to /usr/local/bin. If Tucnak is install from package it's installed to /usr/bin mostly. On Debian it's /usr/bin/tucnak2 and command tucnak2 is found via /etc/alternatives.
soundwrapper
Suided binary allows to access to /dev/console for PC speaker control (Linux only)
Configuration
~/tucnak/tucnakrc
Configuration file of Tucnak program. When it don't found configuration file it reads from internal hardcoded default.
/tucnak/tucnakrc.local
This file has the same structure as tucnakrc file. Is determine to set specific local options, when you synchronize tucnakrc between more computers. Tucnak only reads this file after loading tucnakrc. It is necessary to create and maintain it manually.
Use is obsolete. I think tucnakrc synchronize brings many problems. It is better to have separate tucnakrc and maintain they by program.
Call database
~/tucnak/tucnakcw
File with pairs of callsign-locator. Each callsign has saved maximally two locators. Format is similar to Taclog's taclog.c_w but not same when one call has two wwls. Format is:
CALL WWL YYYYMMDD QRV
f.e.
DR5A JO30EM 20071006 CEGHK
Second locator is saved as next line.
Also look at Update C_W from contest and Update C_W from band.
If you are connected to ON4KST chat, tucnak sometimes sends sh/us command and gathers the loacators.
~/tucnak/tucnaknames
Here you can save first names of operators and say them 'Hello John' :-). Tucnak updates this database on demand from DL8EBW database. Of course you can maintain it manually.
CALL Name
e.g
OK1ZIA NAME
~/tucnak/qrv
Template for qrv. It is copied to contest directory when you create new contest. Note: not when you created contest from network. In this case qrv database is transferred over network.
~/tucnak/tucnakmasters
User definable master.scp database for shortwaves. If not present, tucnak uses internal hardcoded (probalby not actual) database.
~/tucnak/tucnakexcXXX
Like tucnakcw contains database of callsigns, their optional exchanges (EXC, OE) and datestamp. XXX is name of EXC for example OKRES (Czech districts) but in lovercase (~/tucnak/tucnakexcokres). Format is:
CALL EXC YYYYMMDD
f.e.
OK2BKP GKR 20081006
Second locator is saved as next line.
~/tucnak/tucnakvexcXXX
List of all available optional exchanges if verified EXC's are used. XXX is name of EXC for example OKRES (Czech districts) but in lovercase (~/tucnak/tucnakvexcokres). Format is free, Tucnak reads all lines from file and uses all words sepparated by spaces or tabs. f.e.
APA APB APC APD APE APF APG APH API APJ BBN BBE BKD BKO BKH BME BMB BNY BPZ BPV BPB BRA CBU CCK CJH CPE CPI CPR CST CTA
DXC files & others
All these files are optional. Tucnak is reading these when are existing, in other case uses own hardcoded defaults.
~/tucnak/tucnakdw
File with information about DXCC countries. Each country has saved information about possible large squares and centre of activity in the country. Tucnak doesn't write to this file. Format of file is:
# 1th row - The official prefix of the DXCC
# 2nd row - The list of WWL in the DXCC (separated by a gap).
# The first WWL is the most effective one or midlands
# or Capital City of DXCC.
# 3rd row - The most effective WWL from JN69UO
# There is a free row between DXCC's
#
OK
JN79 JO70 JO60 JO80 JO90 JN69 JN89 JN99 JN68 JN78 JN88 JN98 JO71
JN89JM JO80IA
~/tucnak/cty.dat
Follows up information to tucnakdw. Tucnak doesn't write to this file. You can download new version from http://www.country-files.com/cty/index.htm and place it into ~/tucnak.
~/tucnak/tucnakwiz
This file contains information about contest as kind of pointing, etc. Tucnak doesn't write to this file. Items are described in Contest options.
Example of file:
[Region I Standard Contest] pexch= tttype=1 qsoused=1 qsomult=1 qsoglob=0 wwlused=1 wwlbonu=0 wwlmult=0 wwlcfm=1 excused=0 excbonu=0 excmult=0 exccfm=1 exctype=0 excname= rstused=1 defrstr=0 dxcbonu=0 dxcmult=0 qsop_method=1 total_method=1 bands=ABCEGHIJKLMNOPQ [Region I Std test 59 expert] pexch= tttype=3 ...
~/tucnak/vhf.dbf
This file is maintained by Guy, DL8EBW and contains informations about many stations qrv on VHF bands. Copy file like VHF250.DBF to ~/tucnak/vhf.dbf, open contest and choose Menu->Import DL8EBW Database. Tucnak reads:
- Locators of unknown stations to tucnakcw (only unknown because database may contain older locators than tucnakcw, timestamp cannot be processed by computer)
- Names of calls if they are longer than 2 characters.
If the file is not found, tucnak try to read /usr/share/tucnak2/vhf.dbf (depends on DESTDIR argument of configure)
~/tucnak/tucnakbeacons
The beacon database is maintained by UK Microwave Group. Tucnak has own compiled-in database. User can update it online using menu Edit / Import beaconspot.uk. The website updates the dataset typically weekly. Downloaded data is saved to ~/tucnak/tucnakbeacons for offline use.
Contest files
Each contest is saved to differed directory. Name of directories is created from date of contest e.g. ~/tucnak/2003083.1. It is possible to have many contest in one day or one contest on one computer under one user (thought telnet, ssh) with many running Tucnaks. Each contest with the same date has different number behind point.
Files in ~/tucnak/<date>:
Data files
Named <letter>.txt e.g. c.txt, e.txt. This files are main files for individual bands. Files use information about station, QTH, points of both finished and unfinished contacts. Format is compatible with EDI format and should be accepted by contest comitee. Files has DOS end of line (`\r\n') for compatibility.
Swap files
Are <letter>.swp eg. c.swp, e.swp. Here is saved all typed text from input line ended by Enter key. You are able to reconstruct all contest exchange manually from this file.
desc
Contains information displayed in start of contest as date of contest, callsign and name of contest.
log
Content of log window.
sked
Information about received skeds
spy
Specify hosts and bands on which tucnak does spy
talk
Content of talk window. That's good idea to read after contest :-)
hicalls
Contains highlighted calls from DX-Cluster and OK4KST chat
qrv
QRV file format was changed since 2.38. Newer version should import old format but writes only new format.
File is imported from external script, you can prepare your own criteria. Some items are updated when you select line in shell window running the KST chat.
;DR5A;JO30EM;GHK;G5H3K1;@QRV;1299419310
Leading semicolon tells file is in new format. Follow call and locator. GHK are bands on which this call is QRV. Next item tells number of contact we mate in last period. Negative number means we make this call never but other stations do. @QRV is remark for additional informations. @QRV means info comes from qrv script. Last one is timestamp when call was last caught on KST.
old qrv until 2.38
Contains list of stations that are QRV in contest. Functionality is described here. Format is:
CALL WWL CALL WWL BANDS DESCRPTION
f.e.
OK2M JN69UN OK2M JN69UN CEGHK Skeds via KST
chart
Holds informations about files displayed in chart window.
0;/home/ok1zia/tucnak/20110305/h.txt
Zero means record is for first chart window. Follows file name (TXT or EDI).
Output files
Commonly files are saved to contest directory.
ADIF
Filenames have format YYYYMMDD_CALL.adif. Exported are all qsos into one file.
CABRILO
Filenames have format YYYYMMDD_CALL.cbr. Exported are all qsos into one file.
EDI
Files are named CategoryCall.edi, f.e. 06OK2M.edi. Format is very similar as txt files, the only one difference is missing section [TUCNAK extension].
PNG
By pressing F1 you can make screenshot of Tucnak window. ALT+F1 takes snapshot only of top dialog/window. Filenames are in format snapN.png where N is number 0, 1, 2, ... Screenshot are saved to contest directory or in ~/tucnak/ when no contest is opened.
You can use optipng to reduce image size. Similar tool is advpng but it seems it doesn't work with Tucnak's snapshots.
HTML
Contacts from all bands are saved in YYYYMMDD_CALL.html. Also creates map and chart for all bands with at least one QSO.
Report
Report is format used in small OK contest like OK VHF activity contest. It summarizes callsign, locators, QSO count, QSO points, multipliers and total score. It is in Czech language only.
Titlepage
Creates HTML of similar format as title page of old paper log.
Wiki
Creates post-contest report in MediaWiki format. Usable as skeleton for contest story web page. Also creates map and chart for all bands with at least one QSO.
System files
- /etc/mtab
- /proc/mounts
- /proc/self/status
- /var/lock/lck..tty*