WARNING! Backup your data often! BACKUP your log directory at the end of EVERY session! All that you need to backup and store in a safe place is the log database directory located in the ~/.config/cqrlog/database folder, or you can enable the autobackup function in Preferences. This autobackup function creates an ADIF file with a backup of your log.
 < Prev [Menu] Next >



The first step you need is to set up your log preferences. From the logging window, choose the 'File' menu item and 'Preferences' (or Ctrl-P).

A multitab window appears, allowing setup of the following parameters:


The first tab of the 'Preferences' dialog is labelled 'Program'. Here you can setup the main program behaviour.


The Internet connection is important to those who are behind a proxy. The data required does not need further explanation, hopefully. CQRLOG attempts to connect if you try to connect to the DX Cluster (either via web or telnet) and/or if you hit F6 to access the HamQTH.com/QRZ.COM callbook data.

Other settings are:

get UTC time from computer time - CQRLOG will read UTC from the system time. If you uncheck the option, you can set the difference between UTC and your local time manually both for sunrise/sunset and qso time.

Grayline offset - sometimes the gray line position is not accurate. You can set your own correction.

Check for newer version of DXCC tables after program startup - if checked, CQRLOG will check if any update of the country files is available. If a new version is found, an update will be performed, however you are asked first if you want this update.

Check for newer version of qsl managers database after program startup - if checked, CQRLOG will check if any update of the QSL Managers database is available. If a new version is found, an update will be performed, however you are asked first if you want this update.

Show deleted countries in statistics - adds formerly valid countries to statistics and overall DXCC counts.

Show sunrise/sunset in UTC - if checked, sunrise and sunset times are shown in UTC, otherwise in local time. Set up the proper time difference for both grayline and sun rise/set.

Show statistics in metres (m) or Megahertz (MHz). Selecting one of the radio buttons affects the statistics appearing at the bottom of logging screen:

and also the headers of the main statistics (DXCC, WAZ and ITU).

Configuration storage settings - if you have one common database and several computers with CQRLOG installed, you can choose which configuration items will be stored only on the local computer and which will be stored in the database. Configuration stored in the database will be common for all computers but local configuration will affect CQRLOG on the local computer only. E.g. if you have two computers in hamshack, both are connected to the common database. Now you can choose that TRX control, CW keying interface and position of opened windows will be stored only to local computer. You'll be able to have different TRX control configuration, windows postions, number of opened windows etc. on each computer.


Enter your call, name, QTH and QRA Locator here. Remember, that the entered call is also used as the login for the DX Cluster and is displayed on all stats exported to html. The QRA locator is of high importance because it determines your accurate position (ie. you don't need to enter your exact coordinates). The QRA Locator is used in beam heading and distance computation as well as the start point of the simplified path to the other station which appears on the grayline map.


Here are the default values for a new QSO. Remember, that if the radio interface control is active, the default frequency does not appear on the logging screen. The preset RST values will apppear in their corresponding boxes.

The Change default values button allows you to change the frequencies available in the drop down menu in the NewQSO window. Very useful if you have favourite frequencies and don't have the radio connected to the computer.
The 'Use spacebar to move between fields' is very interesting and probably the most natural way but it works only if you are moving forwards. To move between fields, there are two other generic possibilities (TAB key and up/down arrow keys) which remain unaffected even if you check the spacebar option. The 'Refresh data after save QSO' affects the data displayed in the QSO List (Ctrl-O). If checked, each QSO appears in this list immediately after logging, however the refresh procedure is quite slow. To save time, keep this box unchecked. The 'Skip over mode and frequency when radio is connected' is very important if the radio control is active. The 'Show detail window' option enables an extra window to appear at program start. The 'Enable auto search on HamQTH.com/QRZ.COM' switches on the automated search for HamQTH/QRZ callbook data for any worked station. This option does the same as F6 on the logging screen, however it can be rather slow depending on the HamQTH.com/QRZ.COM server availability. The 'Show recent QSO records for last ** days' limits the QSO records listed in the logging screen. Do not set the number of days too high, a high number can cause program speed issues! The default value of 5 days is appropriate for most cases. The In previous QSO list show also QSO with call/p etc. means you can see previous QSO with a station even if he was active from another country with his call/prefix. E.g. if you enter OK2CQR, you'll also see previous QSOs with him when he was OM/OK2CQR, SP/OK2CQR etc.

This window dispays details about new/confirmed zones, IOTA details etc.

Visible columns

Checked columns are visible in the previous QSO list appearing at the top of the logging screen.


Checked bands are visible in both statistics appearing at the bottom of logging screen (bands/modes of the actual logged station) and main DXCC, WAZ and ITU zones statistics. It also affects the Challenge points at the bottom of the DXCC statistics.

TRX Control

The TRX Control displays actual frequency. You can change band and mode. The radio will change the freq/mode after you double click on a spot from dx cluster or on an item in bandmap.
CQRLOG uses the rigctld utilty from HamLib. It controls the radio and programs communicate with it through UDP. CQRLOG supports operating with two TRX but only one can be active at a time.

Radio one, desc: is a description you'll see in TRX control window. It is only descriptive text, you can write whatever you want.

Host: computer where rigctld is running, localhost is fine for most cases.

RIG model: choose your radio model from the list

Device: device which the radio is connected to. /dev/ttyS0 is COM1, /dev/ttyS1 is COM2 etc. If you use USB to serial interface, the device will usually be /dev/ttyUSB0 for COM1 etc. If you are using Ubuntu or Debian, you have to be member of the dialout users group to have rights to the serial ports.

Poll rate: specifies how often CQRLOG should read data from rigctld. 500 milliseconds is fine.

Port number is the number of the port used to communicate with rigctld. Default value is 4532. The second radio, has to have a different port e.g. 4533.

Extra command line arguments usefull when you have to specify more parameters to rigctld. E.g. CIV address (--civaddr=ID, where ID is the CIV address).

Serial port parameters from the manual of your rig, please choose the correct options. Very often it is much better to specify only serial speed and leave other options as default. Default value means that the settings from HamLib will be used.

Switch only between mode related memories if this option is cheched, only memories related to current operating mode will be used. E.g. you are on CW right now, CQRLOG will switch only between memories with CW mode. When you switch to USB or LSB, CQRLOG will use memories both with USB and LSB mode.

Show communication with TRX in console sometimes TRX control doesn't work. Check this option, run CQRLOG from console and you'll see the communication between TRX and Hamlib. This could help to find out what is wrong.

Change default frequencies
The default frequencies which the radio tunes if you click a band button in the 'TRX control' panel can be changed to your preferences. The mode is switched in accordance to the band plan, there is actually a separate set of default frequencies for each CW, SSB, RTTY, AM and FM modes. Click the 'Change default frequencies' button and set up frequencies of your choice.

Add/Modify memory

You can define your own favourite frequencis and swich between them directly in New QSO window using ALT+V (Mem down) and ALT+B (Mem up). These keys are used in N6TR clones to switch between bands.


Here you can set up the default bandwidth for any of the supported modes (CW - SSB - RTTY - AM - FM). If your radio is tuned to the corresponding band segment or if you switch the mode on the radio control panel, CQRLOG will change the bandwidth to the desired value. The bandwidth can be changed at any time, however a program restart will probably be needed to make the changes take effect.

User definable digital modes can be set up in a separate box. Use comma as a separator, ie. BPSK31,QPSK64,OLIVIA,CONTESTIA etc.
Some TRX like ICOM don't have support for this in HamLib. To get mode settings work, set all values to 0 (zero).

QTH Profiles

CQRLOG uses QTH Profiles. Your QTH and equipment details can be entered here. If you are logging a new QSO, choose the appropriate profile. Later, you can see which rig and antenna were used but the main purpose is usage in filters. You can create a filter with QTH Profile as one of the criteria, a later filtering of QSOs made on your portable operation or QRP activity is possible. This method seems more effective than the usual portable log, even if you are using MM0XXX/P as your call it will probably contain a mixture of all portable activities together. With QTH Profile, it is always possible to make a separate 'log' for each operation.


Our tip: Check all fields if you backup your whole log. Nothing will be lost and the amount of data is not large, compared to a very reduced export.

This option allows an easy setup of the log fields to be exported into ADIF or HTML format. Only checked fields are exported. The 'Width' option denotes the column size in the HTML export.

DX cluster

This dialog allows an easy setup of the DX cluster spot filtering. Check the bands you want to display. If you want to supress (ie. filter out) spots for some DX countries, put its prefixes in the box below. Use a semicolon as a separator.

Callsign alert - allows you to enter callsigns that you are interested in. Eg. some special station for an award etc.
Run this command when callsign is spotted: will run select command when any of callsigns you've enter appears in the cluster.
E.g. use this if you want to see small window with information:

zenity --info --text='Callsign $CALLSIGN detected at $FREQ $MODE' --title=Info

You have to install zenity, first. (Thans to SV2RCK for the tip!)

Show country name in the DX cluster spot - next to every spot, you will se the coutry name of the DX station
Connect to DX cluster after program startup - after log is opened, cqrlog will connect to your default cluster. Please remember that username and password(if needed) have to be filled in the cluster list.


This dialog is self explanatory. Choose the appropriate font size to prevent any screen garbage and a nice look to the buttons.

WAZ, ITU zones

This is the color coding setup for the 'Details' window. New ones can be displayed in different color and QSL status is indicated verbosely in the 'Details' window. The 'Show info' boxes must be checked to display the relevant info.


New IOTA color coding and QSL status can be set up here. The 'Show info' boxes must be checked to display the relevant info.


The primary aim of the 'Membership' info is tracking of members of a club or stations valid for an award. The info is derived from the call sign entered into the 'Call' box on the logging screen. CQRLOG can track member's calls from up to 5 databases simultaneously. To set up the tracking, do the following steps:

1. Choose a Club to be tracked. Click the first long button in the 'First club' box. A long list of Clubs appears.

2. Click the 'Load' button. The membership data is loaded from the text database in the 'members' subfolder of your CQRLOG directory. A box with the number of converted records appears.

Note: All files in the 'membership' subfolder are displayed. If you create your own database, put it into this subfolder!

3. Click the 'Settings' button. A new dialog appears:

The color coding scheme for new members, new band, new mode, need of a QSL card and an already confirmed contact can be set up in the left half of the window. You can see here also my preferred color settings.

This dialog also allows you to set up the messages appearing in the 'Details' window if you work a member of a club which is tracked. This can be anything, my preferred messages are:
New %s member! (%c #%n)
New band %s member! (%c #%n)
New mode %s member! (%c #%n)
QSL needed for %s member! (%c #%n)
Already confirmed %s member! (%c #%n)

Note also the regular expressions used in the messages. The complete list is here:
%l - long club name
%s - short club name
%n - club number
%c - callsign

The right half of this screen contains the join rules.
Here you can set up which fields from the QSO entry should be bound with the appropriate column in the membership database. Because the most relevant is the call sign in the QSO and the membership database contains also mostly the call sign, use the defaults - the 'clubcall' in the 'join ... field in club database' and the 'call' in the 'with ... field in main database'.

The lower part contains a dialog allowing the set up of where the resulting info will be stored.

While logging, you will see the info in the corresponding field. The most preferred field is 'Award'. Since this field is used for check purposes only, all info (more memberships) are displayed in a single line which can be longer than the corresponding field on the logging screen. You can navigate here with the cursor but the well formated and color coded results in verbose form are displayed in the 'Details' window.


The Band map is a well known feature of many contesting programs, however it is also great in a general logging program. It contains a mix of filtered DX Cluster spots and your own entries where you can store call and frequency of a station which you can't work just now but you want to return to later.

A very useful option of the Band Map is the 'entries aging'. Depending on the time left since entry 'birth', the color changes to lighter tone until the entry disappears. There are two levels between appearance and disappearance of the entry. The times of these two levels and the time of disappearance can be set. If you change the aging times, restart CQRLOG. Remember that a program restart will be needed to make the changes take effect!

The spots can be color coded to highlight new countries, new band countries etc., in the same way as in the DX Cluster window - check the 'Use the same color as the spot' option. If this option remains unchecked, all entries are shown in black (with aging to dark grey and light grey) and your own entries, made with Ctrl-A or the Big Plus key on the numerical keyboard, are shown in blue. Also, another set of Watched and Ignored entries can be defined.

The content of the Band map can be stored if leaving the log. Check the 'Save band map after close' option.

The 'Show only active mode' and 'Show only active band' options providing an additional level of cluster spot filtering. When checked, the Band Map will show only spots for the mode or band which the radio is on. The spots are sorted by frequency, so you will see what is on the band - at a glance. No doubt you will prefer this over the DX Cluster window which contains a mess of rolling spots, often hard to 'catch'. Finally, if the 'Delete station from band map after QSO' option is checked, the entry with a worked station disappers from the Band Map. If such a station is spotted again, it will appear again in the Band Map.

xplanet support

To ensure correct rendering of the azimuthal map with DX Cluster spots, the external program xplanet must be installed and several parameters must be set up. First, install xplanet. Many distributions have this program either on the installation media (CD, DVD) or xplanet exists in the form of a corresponding package (rpm, deb, tgz, ebuild etc.). If not, download source codes from:

Follow the usual installation instructions:
make install
There are no known dependencies issues.

The first thing to be set up is the path to the xplanet binary. The default
is OK in most cases for installation from sources, the usual path for installation from precompiled packages is
Adjust the window size (remember to set up a square, ie. 400x400, 300x300 etc. to avoid strange effects). Also, the window position must be set up to create a nice looking screen. Use the Test it! button to see how your settings affect the resulting screen.

Xplanet can refresh its display at a preset interval. This is very useful because it can read the spot (entry) list and update the displayed data. To avoid a 'flooded', unreadable window, the number of displayed spots/entries must be limited. It seems that 20 is the maximum to keep the display garbage away. Actually, the number of spots (entries) is not limited by the program but by the readability. If you change the number of spots to be displayed or if the spots should (should not) be sent to xplanet, restart the program. Remember that a program restart will be needed to make the changes take effect!

Set up the source (DX Cluster, Band map) by checking the appropriate radio button in the 'Show stations from' section. The 'Projection' has 3 options:
The xplanet window currently has no other function than to display spots or band map entries in the azimuthal projection or 3D-like picture.

Zip code tracking

Zip code tracking allows you to determine states, counties, provinces and other geographical details if the postal zip code structure allows such operations. The zip code itself is retrieved from the callbook address. The database is located in the /zipcodes folder. If set up properly, the F6 key is used to determine US state, US county and Italian province.

Setup: The database must be loaded before use and the target (field) must be specified. Also, the position of the zip code (line begin or end) must be set up.

LoTW/eQSL support

Provide your user name for eQSL/LoTW and the password (this is not the password sent to US amateurs via postcard!). Choose if you want to include LoTW confirmation in the statistics and New country and New band country info messages.

CW interface

Choose your preferred CW interface. There are 4 options: None, WinKeyer USB, cwdaemon and K3NG keyer. We strongly recommend Winkey USB by Steve Elliot, K1EL, which provides 'all in one' keying, including one of most advanced paddle keyers available. cwdaemon should be seen as a backup option with many limitations, which may need a custom linux kernel to avoid sloppy CW at speeds above 25 WPM. If cwdaemon is used, only keyboard keying is possible.

Detailed setup of the CW devices is here: For further steps (CW messages edit, keyboard keyer operation) - click here.

fldigi interface

First, fldigi must be installed and functional. Preferences must be set up to operate with fldigi. Set up the path to fldigi, and if you wish to start it when CQRLOG switches to remote mode. Other parameters including the way that the CQRLOG - fldigi combo should handle the frequency, mode and RST. CQRLOG also loads the fldigi contents to keep the data, so the 'polling' period should be set up. The 2 seconds interval is a very acceptable default.

The way the CQRLOG - fldigi combo handles the frequency, mode and RST is rather important. Keep in mind that CQRLOG operates in remote mode which means that the logger is offline and therefore does not display the actual frequency and mode on the logging screen. If you properly set up the fldigi mode and frequency control, both are correctly displayed in the fldigi window. Choose the fldigi option in Frequency from, Mode from and RST from boxes and you don't need to watch the logger, except the QSO list in the upper portion of the logging screen. When logging/saving a contact, frequency, mode and RST should appear correctly in this QSO list. If you choose the CQRLOG option, you must set the mode in CQRLOG which seems less sensible.

Auto backup

To increase the safety of your log data, CQRLOG is equipped with an Auto backup option which allows you to export (ADIF) and store the log data in a safe location. The ADIF format was choosen because of its text format. The output file can be compressed in tar.gz format.

Of course, the export and compression takes some time, depending on the log size (QSO count). If you are not in a hurry, allow the program 2-3 minutes to perform this safety measure. We reccomend you backup your log to your hard drive from there it should be copied to other media (your server, USB flash, a memory card etc.).

External viewers

Set up the viewers used for browsing the notes related to a particular callsign.

The notes in the call_data subfolder can contain text, html, pdf and image files. To enable reading of all file types, corresponding viewers must be set up properly, ie. must be in the system path.

Callbook support

CQRLOG supports HamQTH and QRZ.com callbooks but only access through the XML interace is supported. HamQTH has a free interface, for QRZ.com you have to pay an annual fee.

RBN support

CQRLOG can receive spots from RBN and show them on the Gray line map. It's very nice to see where your signal has been decoded especially when you are calling CQ on an empty band.

Login: - your user name to log in to RBN. It's usually your own callsign.
Watch for: the callsign you are watching for, also usually your own callsign. If you leave this field empty, every spot will be shown on the grayline map.
Auto connect after open the log - check this option if you want to autoconnect to RBN when the program starts, you won't have to worry about it and CQRLOG will do it for you automatically. Signal strength How strong you are will be clear very quickly when you look at the map with the dots in different colours. Which colour will be used can be set here.
Delete old information after XX seconds The dots won't stay on the map forever. 180 seconds (3 minutes) is a good default value. Please note, it also depends on the band, if you change band, dots will always be deleted. All data is band related.

Online log upload support

CQRLOG supports online log upload to HamQTH, ClubLog.org and HRDLOG.net

Both ClubLog and HamQTH need a username and password, Clublog also needs the email address used when you registered. HRDLog.net needs only user name and the code you got by e-mail. You can set different color for each service. This color will be used for status messages which will inform you about upload progress. Upload QSO data immediately after save, update or delete means that every insert/update or delete will be uploaded automatically. But if you change something in QSO list window with hot keys e.g. CTRL+S, CTRL+W etc. and/or download data from eQSL/LoTW, changes won't be uploaded. All will be uploaded after you save/delete QSO or if you choose Online log and Upload to all online logs menu.

How to get it to work?

That's all, Now if you insert/edit or delete a QSO, it will also be uploaded to the online log.

Close the "Status of log upload" window after successful upload if you don't want to have Log upload status window visible, check this option and windows will be closed after upload to online log is finished.

Ignore changes caused by LoTW/eQSL upload or download - every change of a qso will cause a new upload to the online log database. Sometimes it can be useful to have the opportunity to disable it when upload/download data to LoTW/eQSL. These changes won't be logged and QSO won't be uploaded to any online log.

 < Prev [Menu] Next >