WinWarbler Logging

WinWarbler Online Help Contents

 

WinWarbler can log QSOs as ADIF records in a text file, referred to as the Minilog; you can select the file to be used for this purpose. WinWarbler can also log QSOs in real time to DXKeeper, a full-functioned logging program that records and manages QSOs, tracks progress towards DXing objectives, prints QSL cards and QSL labels, and synchronizes with both eQSL.cc and the ARRL's Logbook of the World (LotW).

At the top of its Main window, WinWarbler's QSO Info panel provides textboxes and selectors in which to collect the information to be logged.  After capturing a callsign with DXKeeper running, this panel also displays the number of logged QSOs with that callsign, and the details of the most recent QSO with that callsign. You can expand or contract the height of the QSO Info panel to display more information by clicking the button in the panel's upper right corner. When all information is visible in the QSO panel, the surface of this button changes to ; clicking the button in this state reduces the height of the QSO Info panel to its minimum, and changes the button surface back to .

The transceiver's Receive and Transmit frequencies are displayed in the Xcvr Freq panel's RX textbox and TX selector, respectively; these frequencies are combined with audio offsets to compute the actual receive and transmit frequencies displayed in each mode's Receive and Transmit panels, and logged with QSOs. If Commander is running, these frequencies are updated automatically; if not, you must set them manually.

Some information can be directly captured from decoded data by double-clicking on received words in a PSK receive pane or RTTY receive pane. Double-clicking a received callsign, for example, will place that callsign in the QSO Info panel's Call textbox, and initialize many items:

Manually keying a callsign into the Call textbox and then striking the Enter or Tab keys will also perform the above actions; if the Ctrl key is depressed while striking the Enter key, all QSO info panel textboxes except the callsign textbox will be cleared.

If DXKeeper is running, a ? button will be present to the right of the Call textbox's caption. Clicking this ? button invokes the Lookup operation, which performs several actions referencing the station whose callsign is shown in the Call textbox:

If WinWarbler can determine from DXView or DXKeeper that the station whose callsign is shown in the Call textbox is known to participate in ARRL's Logbook of the World (LotW) or is an Authenticity Guaranteed (AG) member of eQSL.cc, the Call textbox's background color is set to 

If SpotCollector is running, the background colors indicating LotW participation and AG membership are those specified on the Spot Database Display tab of SpotCollector's Configuration window - unless they are too dark.

Double-clicking the Comment textbox will display WinWarbler's Comment Editor window, which makes it easy to capture and/or edit lengthy notes. Anything you type in the Comment Editor window will be placed in the Comment textbox (though it may not all be visible), and vice versa.

Double-clicking a textbox's caption will direct DXKeeper (if running) to filter its log page display to show only QSOs that match the textbox's value, and underline that caption for 1 second. For example, double-click the word QTH in the QSO Info panel when the QTH textbox contains Miami will direct DXKeeper to filter its log page display to show only QSOs whose QTH is Miami. 

You can enable or disable Contest Mode via the Configuration window's Contest tab or via the Test box on the last row of the Main window's fully-expanded QSO info panel.

To indicate that a QSO has started, click the QSO info panel's Begin button; the start time will appear in the panel caption. If set QSO start when RST received is enabled, entering a received signal report in the rst R textbox will automatically set the QSO's start time (if not already set), whether this is done via keystroke or, by double-clicking on a received signal report. Executing a macro containing the <RSTsent> or <TX_serial_number> command will also set the QSO's start time. To update the QSO's start time, click the Begin button again.

To indicate that a QSO has ended, click the QSO info panel's End button; the end time will appear in the panel caption.

Double-clicking or striking the Enter key in the Grid 1 textbox directs DXView to display the specified gridsquare's location.  Depressing the Ctrl key while double-clicking the Grid 1 textbox directs DXView to display the specified gridsquare's location and rotate the antenna to the short-path heading; depressing the Alt key while double-clicking the Grid 1 textbox directs DXView to display the specified gridsquare's location and rotate the antenna to the long-path heading.

Clicking the Log button also ends the QSO, and checks the information contained in QSO info panel's textboxes and selectors. Errors or omissions are flagged by flashing the offending item's caption  in red font; the flag invalid callsigns and require DXCC options are considered when identifying errors and omissions. If no errors or omissions are found, the information to be logged is recorded in the minilog and sent to DXKeeper, if running. If Contest Mode is disabled and the don't log contest, TX#, or RX# if contest mode setting is disabled, values from the Contest selector and the TX#, and RX# textboxes are not recorded with the QSO. Depressing the Ctrl key while clicking the Log button directs DXKeeper to immediately upload the information to eQSL.cc ; alternatively, checking the upload to eQSL.cc when logging box directs DXKeeper to upload each QSO as it is logged. To prepare for the next QSO, WinWarbler then clears all QSO info items except Freq and, if Contest Mode is enabled, TX#.

If you click the Log button with Audio Recording enabled,

Callsigns not containing at least one letter and one number are considered invalid unless flag invalid callsigns is disabled.

Clicking the X button in the QSO info panel's upper right corner will clear all items in the QSO info panel. If Audio Recording is enabled with the Automatically start and stop recording option also enabled, clicking this button will also stop audio recording and abandon the recorded audio file.

When operating PSK31 or PSK63, WinWarbler provides three receive panes, each capable of decoding an independent PSK signal. WinWarbler therefore independently records QSO information for each receive pane. The QSO info panel shows the information associated with the currently active receive pane, and the active receive pane is identified by number in the QSO info panel's caption. Making another receive pane active causes the QSO info panel to display information for the QSO being decoded in the newly-activated receive pane. This allows you to accumulate information captured from multiple signals, separately retaining each signal's information until a QSO is completed and logged.

When operating RTTY with both soundcard RTTY and an external modem both enabled, WinWarbler provides two receive panes, each capable of decoding an independent RTTY signal. By tuning both receive panes to the same signal, you can employ diversity decoding to more reliably capture information under difficult conditions. WinWarbler can thus be configured in two ways:

  1. Independently record QSO information from the soundcard RTTY and external modem receive panes. In this case, the QSO info panel shows the information associated with the currently active receive pane and the active receive pane is identified by number in the QSO info panel's caption. Making the other receive pane active causes the QSO info panel to display information for the QSO being decoded in the newly-activated receive pane. This allows you to accumulate information captured from two different RTTY signals, separately retaining each signal's information until a QSO is completed and logged.

  2. Merge QSO information from the soundcard RTTY and external modem receive panes, in which case the QSO info panel shows information captured from either receive pane. With both panes tuned to the same RTTY signal, this enables you capture information from whichever pane provides the best copy on a word-by-word basis.

The choice between these two configurations is governed by the RTTY Transmit panel's QSO Selector, which only appears when operating RTTY with both soundcard RTTY and an external modem both enabled. When the QSO Selector is set to S or X, QSO information captured from the two receive panes is merged; otherwise, QSO information is maintained independently for each receive pane.

To allow operation without removing one's hands from the keyboard, WinWarbler provides keyboard shortcuts for navigating among QSO info items and the Transmit Pane, and for invoking functions like starting or logging a QSO.

Macros can be invoked from QSO info text boxes and selectors by striking the appropriate Function key. Macro substitution commands are available for many QSO info items.

If DXKeeper is running, changes to items in WinWarbler's QSO info panel are immediately reflected in DXKeeper's Capture window; this allows you to begin logging a QSO in WinWarbler and complete it in DXKeeper's Capture window, should you desire to do so. However, changes to items in DXKeeper's Capture window are not reflected in WinWarbler's QSO info panel. If Contest Mode is enabled, logging a QSO via DXKeeper's Capture window will increment the Capture window's TX# textbox, but will not increment WinWarbler's TX# textbox; thus when switching from "logging from DXKeeper" to "logging from WinWarbler" in the middle of a contest, you must manually update WinWarbler's TX# textbox at the time you switch.

The Minilog

The Minilog is a text file whose simple name is the operator's callsign (with any forward slashes or back slashes replaced by hyphens) and whose suffix is .adi; the Minilog resides in the folder whose pathname is specified in the Minilog panel's pathname textbox. 

Every time you log a QSO, an ADIF record is appended to the Minilog's contents, whether or not DXKeeper is running. You can load the information contained in a Minilog into any logging application capable of importing standard ADIF. After importing the Minilog's contents into a logging application, you may wish to clear the contents of the Minilog; you can do so by clicking the Clear button on the Config window's Log tab.

If you will be importing the Minilog into the logging program DXbase, select export for DXbase in the Minilog panel on the Log tab of the Configuration window; this ensures that frequencies are represented in a format acceptable to DXbase.

User-defined Items

By fully expanding the QSO Info panel, you can log up to 8 user-defined items with each QSO. DXKeeper provides the ability to specify a caption, style, alignment, and default value for each user-defined item; you can choose from among 11 styles, including a list style that lets you choose from among a pre-specified set of values. If DXKeeper is not running, WinWarbler's QSO Info panel displays these 8 items with the names user-defined 0 through user-defined 7, and accepts all alphanumeric characters. If DXKeeper is running, the QSO Info panel displays the these 8 items with the captions specified on the User Items tab of DXKeeper's Configuration window, and enforces the constraints imposed by each item's style.

Capturing Information from Decoded Data

To facilitate logging, WinWarbler provides several mechanisms for copying information from decoded data into textboxes in the QSO info panel.

Summary of QSO info destinations when double-clicking a decoded word in a receive pane

contains letters contains numbers valid
grid
valid URL Alt depressed Ctrl depressed contest mode text destination QSO info textbox
no yes no no disabled received rst R
no yes no no disabled transmitted rst S
no yes no no enabled RX#
yes no no no name
yes yes no no call
no no yes no QTH, State, Province
no yes yes no (navigates browser to URL)
yes yes no Grid 1
no yes Via
yes yes disabled Comment
yes yes enabled RX#

If, when you click the Log button, one or more QSO info panel textboxes contain invalid information, their labels will blink in red font until you correct their contents and again click the Log button; callsigns not containing at least one letter and one number are considered invalid unless the flag invalid callsigns box is unchecked. Log entries are appended to a file that WinWarbler creates in its application folder; this file's simple name is your callsign, and its file extension is .ADI -- e.g. AA6YQ.ADI

If you are using a ADIF-compatible logging application other than DXKeeper, you can import the log entries in this file into your logging program; this can be done while WinWarbler is running. After successfully importing these entries, click the Clear button in the Minilog panel on the Log tab of WinWarbler's Configuration window  to delete all log entries from WinWarbler's log file.

Information Logged

The following table lists all information logged with a QSO, macro substitution commands and  ADIF tags for each. The QSO info panel column indicates whether the item is always visible in the QSO info panel, only visible when the QSO info panel is expanded, or never visible:

 

Item Contents Notes QSO info panel Macro Substitution Command ADIF tag
  geomagnetic A-index from SpotCollector, if running   no   A_INDEX
ARRL ARRL Section yes ARRL_SECT
Az antenna azimuth   if expanded   ANT_AZ
Path antenna path (Short-path, Long-path, Grey-line, or Other)   if expanded   ANT_PATH
Band band associated with QSO frequency   no   Band
Buro check to indicate that a QSL should be sent via the QSL Bureau yes QSL_SENT_VIA
Call callsign 1,2 yes <callsign> CALL
Comment miscellaneous comments
Special Callsign Tags
6, 14 if expanded 6   COMMENT
CQ CQ zone   yes   CQZ
Contest contest name   if expanded <contest_id> CONTEST_ID
Continent continent designator    yes   CONT
Country code numeric DXCC entity identifier  9 no   DXCCID
County US county 3 yes   CNTY
Distance distance from your location to the station's location via the antenna path no DISTANCE
DOK the station's DARC DOK (only visible for stations in Germany) yes APP_DXKEEPER_DOK
DXCC DXCC entity prefix 4 yes   APP_DXKeeper_DXCCPREFIX
End time QSO end time    no   TIME_OFF
eQSL check to indicate that the call is an Authenticity Guaranteed member of eQSL.cc if expanded APP_DXKeeper_EQSL_MEMBER
Grid 1 Maidenhead grid square 10 yes <grid> GRIDSQUARE
Grid 2 second Maidenhead grid square for a QSO partner operating on a grid square boundary   if expanded   APP_DXKeeper_Grid2
Grid 3 third Maidenhead grid square for a QSO partner operating on a grid square boundary   if expanded   APP_DXKeeper_Grid3
Grid 4 fourth Maidenhead grid square for a QSO partner operating on a grid square boundary   if expanded   APP_DXKeeper_Grid4
IOTA IOTA tag   if expanded   IOTA
ITU ITU zone   yes   ITUZ
K geomagnetic K-index from SpotCollector, if running   no   K_INDEX
Latitude the station's latitude no LAT
Longitude the station's longitude no LON
LotW check to indicate that the call is known to participate in the ARRL's Logbook of the World if expanded APP_DXKeeper_LotW_MEMBER
Mode PSK31, PSK63, RTTY, CW, SSB, AM, or FM 8 no   MODE
My Grid your Maidenhead grid square no <mygrid> MY_GRIDSQUARE
My Latitude your latitude no <mylatitude> MY_LAT
My Longitude your longitude no <mylongitude> MY_LON
Name operator name   yes <name> NAME
Operator operator callsign   no <mycall> OPERATOR
Pri Sub primary administrative subdivision yes STATE
Province Canadian province (abbreviation) 7 yes   VE_PROV
Pwr transmitter power   if expanded <transmit_power> TX_POWER
QSL check to indicate that a QSL card or label should be sent   yes   QSL_SENT
QSL msg message to be printed on an outgoing QSL card or label 6 if expanded 6   QSLMSG
QTH location   yes <QTH> QTH
Receive Freq receive frequency  5 12   FREQ_RX
Region the station's Region as defined by CQ for its Marathon award and DARC for its WAE award (only visible in the Awards panel for stations in Austria, Italy, Scotland, Svalbard, and Turkey) yes APP_DXKEEPER_REGION
rst S outgoing signal report  15 yes <RSTsent> RST_SENT
rst R received signal report  15 yes <RSTreceived> RST_RCVD
RX# received contest exchange   if expanded <rx_serial_number> SRX
  solar flux from SpotCollector, if running   no   SFI
Sec Sub secondary administrative subdivision yes CNTY
SOTA Summits on the Air reference   if expanded   SOTA_REF
Start date QSO start date   no   QSO_DATE
Start time QSO start time   no   TIME_ON
State US state 3 yes   STATE
Transmit Freq transmit frequency 11 13   FREQ
TX# transmitted contest exchange   if expanded <tx_serial_number> STX
User-defined 0 configurable if expanded APP_DXKeeper_User_Defined_0
User-defined 1 configurable if expanded APP_DXKeeper_User_Defined_1
User-defined 2 configurable if expanded APP_DXKeeper_User_Defined_2
User-defined 3 configurable if expanded APP_DXKeeper_User_Defined_3
User-defined 4 configurable if expanded APP_DXKeeper_User_Defined_4
User-defined 5 configurable if expanded APP_DXKeeper_User_Defined_5
User-defined 6 configurable if expanded APP_DXKeeper_User_Defined_6
User-defined 7 configurable if expanded APP_DXKeeper_User_Defined_7
Via QSL Manager's callsign   yes <via> QSL_VIA

Notes:

  1. striking the Enter or Tab keys after keying in a callsign is equivalent to clicking the ? button - the Lookup operation is invoked

  2. if the callsign begins with an exclamation point or ends with an /am or /mm suffix, WinWarbler will not check it for validity and DXKeeper will ignore it from an awards tracking perspective

  3. the State and Country items will appear when the DXCC selector is set to K, KH6, or KL7

  4. letting the mouse cursor hover over the contents of the DXCC selector will display an explanatory popup bearing the full name of the selected DXCC entity

  5. WinWarbler logs the actual receive frequency -- the transceiver receive frequency modified by specified offsets in CW, Phone, and FSK RTTY modes, and modified by the audio offsets in PSK and AFSK RTTY modes 

  6. the Comment and QSL msg items share space; to toggle between them, click the ~ button to the right of the currently-visible item

  7. the Province item appears when the DXCC selector is set to VE

  8. the Mode is primarily determined by the Main window's Mode panel; if Phone is selected, the Mode is determined by the Phone Xcvr Mode setting

  9. the proper Country Code is automatically set whenever a DXCC entity prefix is selected

  10. striking the Enter or Tab keys after typing a grid square into the Grid 1 item directs DXView, if running, to display the location of that grid square

  11. if the transceiver is operating split, WinWarbler logs the actual transmit frequency -- the transceiver transmit frequency modified by specified offsets in CW Phone and FSK RTTY mode, and modified by the audio offsets in PSK and AFSK RTTY modes

  12. the receive frequency is taken from the frequency displayed in the Main window's Receive panel for the currently active mode

  13. the transmit frequency is taken from the frequency displayed in the Main window's Transmit panel for the currently active mode

  14. double-clicking in the Comment textbox displays the Comment Editor window

  15. typing Ctrl-1 through Ctrl-9 with the cursor in the rst R or rst S textboxes will set the signal report to 51 through 59 if the Main window's Operating Mode panel is set to phone, or to 519 through 599 if the Operating Mode panel is not set to phone

DXCC Entity Prefixes

The QSO info panel's DXCC selector contains an entry for each current DXCC entity. If DXKeeper is running and Automatic Lookup is enabled or if DXView is running, then entering or capturing a callsign will trigger a DXCC database lookup that sets the DXCC selector to the DXCC prefix associated with the callsign's DXCC entity; otherwise, the user must manually set the DXCC selector to the appropriate DXCC prefix.

On startup, the DXCC selector is populated with prefixes obtained from the file DXCC.txt. If DXView is installed, WinWarbler will preferentially reference the file DXCC.txt found in DXView's Databases folder, as this file will be maintained automatically by future versions of DXView. If DXView is not installed, or if its Databases folder does not contain a DXCC.txt file, then WinWarbler populates its DXCC selector with prefixes from the file DXCC.txt in its own Databases folder. When DXCC entities are added or deleted, the file DXCC.txt being used by WinWarbler should be updated accordingly.

Recording Audio

You can initiate and terminate the recording of an audio file in .wav format at 6K bytes per second.

The Main window's Log QSOs panel provides an Audio button between its Begin and  Log buttons. The icon present on this button indicates the current state of audio recording, and the action that will be taken when the button is next clicked:

Audio button icon current state action when clicked action when CTRL-clicked action when Shift-clicked action when Alt-clicked
  Disabled    display the Audio Recording Configuration window     
Ready start recording, new state: Recording display the Audio Recording Configuration window start recording, new state: Recording start recording, new state: Recording
Recording stop and save audio to file, new state: Recorded stop and save audio to file, new state: Recorded stop and save audio to file, new state: Ready stop and discard, new state: Ready
Recorded start playing the last recorded audio file stop playback new state: Ready discard recorded audio file, new state: Ready

To enable audio recording,

  1. depress the CTRL key while clicking the QSO Info panel's button.

  2. In the Audio Recording Configuration window that appears, check the Enable box; this will set the state of audio recording to Ready, replacing the QSO Info panel's button with its button.

In the Recording or Recorded states,

Enabling the Audio Recording Configuration window's Automatically start and stop recording option will automatically record each QSO's audio and include the audio filename with the logged QSO:

To display the Audio Recording Configuration window, depress the CTRL key while clicking the QSO Info panel's   or   buttons, or click the Audio Recording button at the bottom of the Configuration window's General tab.

 

Generating DX Spots

If SpotCollector is running and configured to generate outgoing cluster spots, clicking the QSO info panel's Spot button will generate an outgoing spot for the station designated by the call textbox on the current receive frequency; if the Spot button is disabled ("grayed out"), then either SpotCollector is not running, or its running but not configured to generate outgoing cluster spots.You can specify default spot notes; if no default spot notes are specified, the outgoing spot note will indicate the QSO's mode

If you want SpotCollector to generate a local spot rather than one sent to all clusters, depress the Alt key or the Shift key while clicking the Spot button. 

Depressing the Ctrl key while clicking the Spot button will display WinWarbler's Outgoing Spot window, which enables you to specify spot notes and a Propagation Indicator .

If the  Transmit and Receive panel's frequencies are different and the spot split frequency option is enabled, the difference will be included in the spot notes as a split if

If the QSO frequency is 50 MHz or higher

valid DXGrid valid SpotterGrid DXGrid>SpotterGrid format SpotterGrid<P>DXGrid format Spot Notes Format Example Spot Notes
no no doesn't matter doesn't matter  
no yes doesn't matter doesn't matter > SpotterGrid CW > CM97eq, up 3
yes no doesn't matter doesn't matter DXGrid CW JD14qo, up 3
yes yes selected not selected DXGrid>SpotterGrid CW JD14qo>CM97eq, up 3
yes yes not selected selected SpotterGrid<P>DXGrid CW CM97eq<ES>JD14qo, up 3

You can configure WinWarbler to automatically generate a local spot when a callsign is acquired.

 

Keyboard Shortcuts

To allow operation without removing one's hands from the keyboard, WinWarbler provides keyboard shortcuts for navigating among the QSO Info items, Xcvr Freq items, and the Transmit Pane, and for initiating actions. Keyboard shortcuts can be used whenever the mouse cursor resides in a QSO Info item or the Transmit pane.

Destination CTRL shortcut ALT shortcut
Call textbox C C
CQ textbox   X
Contest selector   T
County textbox   O
DXCC selector   D
Xcvr Freq TX selector X F
Xcvr Freq RX textbox   M
Grid 1 textbox G G
IOTA textbox   I
ITU textbox   Y
Name textbox N N
Comment textbox D E
QSL Msg textbox F H
QTH textbox Q Q
rst R textbox R R
rst S textbox S S
RX# textbox Z Z
State selector   A
Transmit Pane T /
TX# textbox   W
TX Pwr textbox   K
Via textbox   V

 

Action CTRL shortcut ALT shortcut
Select all characters in textbox A  
Clear QSO Info panel W  
Log QSO L J, L
Start QSO   B
Toggle QSL checkbox   U

 

Action shortcut
Set PSK transmit frequency to that of active PSK receive pane F1
Start transmission in the current operating mode F2, Insert
Send CW ID at end of PSK transmission F3
Stop transmission when all characters have been transmitted F4
Stop transmission immediately Esc, End

 

 

Typing Ctrl-1 through Ctrl-9 with the cursor in the rst R or rst S textboxes will set the signal report to 51 through 59 if the Main window's Operating Mode panel is set to phone, or to 519 through 599 if the Operating Mode panel is not set to phone.