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. /td>

Wsjt remote mode

• Wsjt-x CQ-monitor
• Colors & fonts
• Alerts
• Starting qso from wsjtx-monitor
• Logging qso to cqrlog
• Starting fldigi and wsjt-x via cqrlog

From New QSO / File select 'Remote mode for wsjt'

Remote mode for WSJT-X-communication is made via UDP dtatgrams that and is supported from WSJT-X 1.5.0 program upwards.
Cqrlog supports WSJT-X UDP remote mode since version 1.9.1

When remote mode is selected it shows last received WSJT-X packet type number after text “Wsjt-x remote” text. Also color of text changes while receiving packets.
These will show you that UDP link is alive between these programs.

New QSO / Window list

“ Wsjtx monitor “ is visible only if WSJT-X remote mode is selected. Others can be found from there all the time.

Wsjt-x CQ-monitor

Wsjt-x CQ-monitor form opens when you select ”Remote mode for wsjtx” from ”File” of NewQSO window.

You can close this window and reopen it later via NewQSO/Window/Wsjt-x monitor that is visible only when remote mode is selected. While it is closed it will not update it’s contents.
Only remote logging and call qrz/hamqth seek are used then.
If UPD port opening for remote fails "NewQSO/Comment to qso" will have text “Could not bind socket for wsjtx!"

Line of CQ-monitor contains:

• time
  
• mode symbol. Same that wsjt-x uses.
  
• callsign with color and low/Upcase coding.
  
• locator grid with color and low/Upcase coding
  
• caller’s country name (cut to 15chrs) Overlayed with “CQ:xx” and different color if station is calling directed CQ like: CQ DX, AS, AF, OC, NA, SA .. or CQ CALLSIGN DX.
  This is set as warning for you to check that you are in directed area before answering to his/her CQ.
  I.E. In case of CQ DX you should be in DIFFERENT CONTINENT as the CQ caller to be a valid DX for him. Program does not warn you if it thinks you are real DX for caller. Otherwise it does.
  https://en.wikipedia.org/wiki/CQ_(call) says: In amateur radio usage, a CQ call can be qualified by appending more letters, as in CQ DX (meaning " calling all stations located in a different continent to the caller"). See also: http://www.mapability.com/ei8ic/maps/continent.php for continents.
• information of DXCC status compared to your logged qsos.
  

If you want to see a bit more in country name you may try to create this script and run it from console. Remember to set execute bit (chmod +x) to script file to get it running. This script will fix some long country names and change comma-space combinations to dot (as CQ-monitor cuts contry name if it sees comma). That way you will see a bit more info in 15chr long country name of CQ-monitor.

--------------cut here---------------------------------------------------------
#/bin/sh
cd ~/.config/cqrlog/ctyfiles

# fix long names to these 3 files--------------------------------
# /-----Existing name now------/new-name/ file to read > file to write
# Do plain Germany
 sed s/"Federal Republic of Germany"/Germany/g Country.tab > /tmp/fixme.txt
 mv /tmp/fixme.txt Country.tab 
 sed s/"Federal Republic of Germany"/Germany/g CallResolution.tbl > /tmp/fixme.txt
 mv /tmp/fixme.txt CallResolution.tbl
 sed s/"Federal Republic of Germany"/Germany/g  AreaOK1RR.tbl > /tmp/fixme.txt
 mv /tmp/fixme.txt AreaOK1RR.tbl

#Next replacement round-----------------------------------------
#Do plain name to all "Rebublic of"
 sed s/"Republic of "//g Country.tab > /tmp/fixme.txt
 mv /tmp/fixme.txt Country.tab 
 sed s/"Republic of "//g CallResolution.tbl > /tmp/fixme.txt
 mv /tmp/fixme.txt CallResolution.tbl
 sed s/"Republic of "//g  AreaOK1RR.tbl > /tmp/fixme.txt
 mv /tmp/fixme.txt AreaOK1RR.tbl

#Next replacement round-----------------------------------------
#Do replacement ", " to "." Comma cuts name in CQ-monitor, replace with dot for more data
 sed s/", "/./g Country.tab > /tmp/fixme.txt
 mv /tmp/fixme.txt Country.tab 
 sed s/", "/./g CallResolution.tbl > /tmp/fixme.txt
 mv /tmp/fixme.txt CallResolution.tbl
 sed s/", "/./g  AreaOK1RR.tbl > /tmp/fixme.txt
 mv /tmp/fixme.txt AreaOK1RR.tbl

#Next replacement round-----------------------------------------
#Do replace USA
 sed s/"USA - "/"US:"/g AreaOK1RR.tbl > /tmp/fixme.txt
 mv /tmp/fixme.txt AreaOK1RR.tbl


#Next replacement round-----------------------------------------
# add your own definitions same way using sed  under this line






#--------------------------done---------------------------------
#remind to reload fixed files to cqrlog-------------------------
 echo '------------------------------------------------------------'
 echo 'Run now:  Window->QSOlist->File->"Import DXCC data"'   
 echo 'From dialog select: ".config/cqrlog/ctyfiles" folder open'
 echo 'Press "Open"'
 echo ''
 echo 'You need to run this script after every DXCC upgrade received'
 echo ''
 echo 'If you do not like the results delete files:'
 echo '  CallResolution.tbl'
 echo '  Country.tab'
 echo '  AreaOK1RR.tbl'
 echo '  cqrlog-cty.tar.gz'
 echo 'from ~/.config/cqrlog/ctyfiles/ directory, then'
 echo 'run CQRLOG again and confirm auto upgrade'
 echo '------------------------------------------------------------'

#done
--------------cut here---------------------------------------------------------

Colors & fonts

CQ-monitor has a new design. Window is adjustable and font + size can be changed.
Font style can not be changed as now “Qso never” (default Green) is printed also with bold while all other texts are in normal style.

Same color coding is applied also for locator grid.
Full locator (means 4 first characters of locator) worked before on this band and mode, this band but not this mode, some other band/mode and never on any band/mode.
If no hits found for full locator then main locator (2 first letters) are checked same way next . Worked before on this band and mode, this band but not this mode, some other band/mode and never on any band/mode.

Calls and locators that are worked before on this band and mode are also printed in lowercase letters while all others are printed with UPPERCASE.

NOTE: Using monospace fonts will keep monitor columns in order.

Alerts

At bottom there are 3 alerts to select. The priority of alerts is same as numbering here. Smaller number overrides previous having highest priority. Alert is executed only once per every decoding section.

1. ”My Alert” will alert if someone answers your cq-call. It is useful if you are reading your mails, Facebook or what ever on another desktop while calling CQ with Wsjt-x :)
   
2. “All”will extend “MyAlert” so that all lines that start with your callsign give alerts. There are stations that answer to CQ directly with report, so this wakes you up also then. When using FT8 this might be little annoying but is easy to check off.
   
3. ”Text [ ]Alert” will alert if text-in-text if typed text, case sensitive, compared to complete monitor line.
   Example: alert from new country by setting “w c” string to text alert. It fits in to the middle of “New country” string. Text can have spaces, but not at start or at end.
   Press button “Text” to change to call alerts.
   ”Call [ ]Alert” will alert if text-in-text if typed text, upcase, fits callsign of monitor line. As option, one asterisk can be used at start or end to indicate starts-with or ends-with search. Several search strings can be inserted with comma separation.
   Press button “Call” to change to text alerts.

   Text you have typed is read only after you leave edit box. Then spaces from start and end are removed and in case of “call alert” text is changed uppercase.
   To activate alert press ”Alert” to turn it’s text green. (it also takes you away from edit box)

   
   

4. ”Loc Alert” will alert when there is new main grid that you have not worked.

To make alerts do something you have to add a script file ~/.config/cqrlog/voice_keyer/voice_alert.sh
This script gets parameter $1 of “my”,”loc”,”text” or “call” depending of alert given.
By using these parameters with your script you can play sound that you want, or do anything else you like to happen when alert is issued.

NOTE: Try to keep script running time as short as possible.

voice_alert.sh:

--------------cut here---------------------------------------------------------
#!/bin/bash

#
//audio file name (prefix) played on alert

# //can be:'my' =
ansver to my cq,

# // 'loc' = new main grid,

# // 'text'=
text found from monitor line 

# // 'call'= text fits to the
callsign

# // create files you want to be played

# scirpt
is seeking names with '.wav' suffix! Change if needed 

#select
audio card(if needed) and play alert message

aplay ~/.config/cqrlog/voice_keyer/$1.wav

--------------cut here---------------------------------------------------------

Starting qso from wsjtx-monitor

Logging qso to cqrlog

When you either press “Log QSO” at wsjt-x main window, or get it open automatic when sending 73 by checking Wsjt-x's Configuration/Settings/Reporting/Prompt me to log qso ,you will have wsjt-x's logging form open.
Check it’s information, add power and remarks if needed. After finishing with it press it’s OK-buttonThen information is transferred to cqrlog.

NOTE: DO NOT press cqrlog/NewQSO/Save QSO [enter] - button to save qso!

If you have enabled auto search from QRZ.com/HamQth.com in cqrlog's preferences all information is fetched during your first transmit (report sending period).
You may alter that information in NewQSO form and it is saved along with wsjt-x logging information.

In case that fetched data has same, but longer locator than wsjt-x qso data has the longer is logged to cqrlog.
I.E wsjt-x data gives KP01, but QRZ.com KP01TN, the longer (more complete) is logged.
If locators differ wsjt-x data is used as it might be a portable or other special qth.

You can set preferences so that cqrlog will start fldigi and/or wsjt-x programs for you when you enter remote mode. This is very handy, but doing that has also one risk.
When fldigi or wsjt-x has been started as a child process of cqrlog they will die at the moment cqrlog crashes for some reason.
If you start them manually as processes of their own and then activate remote mode from cqrlog they keep on running if cqrlog dies. You can finish your ongoing qso, start cqrlog again, set remote mode on and then log the qso in normal manner.