Status Line

QSL Image Panels

Immediately under the Radio/Rotor panels and to the right of the DX/Contest panels are the QSL Image panels. With each lookup that station's QSL Image (or country flag if your Call Book does not support QSL Images) is displayed. Subsequent look ups will shift the QSL images from the QSL Image panel on the left over to the other QSL Image panels. The number of QSL Image panels visible will depend on how much monitor real estate you have available for the MacLoggerDX window.

DX Panel

The DX Panel is optimized for data entry for DX chasing or rag chewing

Field Color codes

Grid (first 4 character), ITU, DXCC, CQ Zone, IOTA, State Text Color:
Red - Not in Log.
Brown - Worked in Log but Unconfirmed.
Black - Worked in Log and Confirmed.

If the click on the call sign in the DX de text field it will look up the DX de spotter's call sign.


The Locator field in the DX and Contest Panels will tell you what Geolocation method MacLoggerDX has used for each lookup:

MacLoggerDX resolves all call signs to the DXCC country level using the data published in the ARRL Operating guide: "Locator: Country".
Then it resolves specific prefix based locations - "Locator: Call".
QRZ, HamCall or lookup may provide a zip code which can be resolved with the US census zip to post office latitude and longitude data "Locator:Zip".
If the city is known and found the latitude and longitude can be resolved: "Locator: City".
If the call is in your log, that location data is found in a lookup "Locator: Log GS".
If QRZ, HamCall or Internet Lookup is enabled and if there is a grid square or Latitude and Longitude data provided on the Internet this will be used: "Locator: iNet GS", "Locator: iNet LL", this is usually the most accurate since the operator has provided this data himself.


MacLoggerDX keeps 2 separate sets of persistent values. When you manually change the radio mode or auto tune changes it MacLoggerDX chooses one set based on the mapped mode. If the mapped mode contains "SB", AM", or "FM", then one set is displayed and the other set is used for everything else. When you edit either set the new value is stored for that mode.

If your radio is in CW mode and you enter 599 that will be stored and reloaded the next time the radio is in CW, or RTTY etc.
If your radio is in USB mode and you enter 59 then that will be stored and reloaded the next time the radio is in SSB, AM, FM etc.

This all happens automatically - you just have to enter the values and they will be remembered.

We use the mapped mode so that if your radio is in USB but you have that mapped to a digital mode then the 599 set will be used.



Look Up Performs a look up on the call sign entered in the "Call" field. MacLoggerDX first resolves the dxcc country identity with an internal lookup of prefixes, dxpeditions and exceptions, then performs a lookup with which ever call book service you have selected in the Look Up Prefs.

The internal prefix, dxpedition, skcc and exceptions databases are updated when you select "Update Internet Files" from the File menu, or automatically at midnight and when you start MacLoggerDX if you have selected Check for Updates in the Station Prefs.

Previous switches to the Log Panel and searches for previous contacts based on the Call entered.

Time On Sets the Time On in the log to the current time (The default is the look up time)
Time Off Sets the Time Off in the log to the current time (The default is the logged time)
Log QSO Logs whatever information is displayed in the fields above to your current log.

Beam If a rotor controller is connected rotates the beam to the currect heading (displayed just above the "Call" field)
R If a rotor controller is connected rotates the beam to the reverse heading.

Stacking:The stacking register is a scratch pad to quickly make note of something you were tuned to so that you can tune back in a few minutes. It saves the frequency call sign and split.

+ Adds the current call and VFO Frequency to the stacking popup.
Stacking popup - Select any entry to set the call (which will trigger a lookup), VFO frequency and split from the stack. Selecting Edit from the popup will allow you to re-order, edit and delete entries.


Contest Panel

The Contest Panel is optimized for data entry during casual contesting.

You can TAB quickly from field to field and <shift> TAB to reverse the tabbing direction or use the menu commands Focus Call Sign, Clear Log Fields and Log QSO and Clear Fields to return focus to the call sign. You can also set your own keyboard shortcuts for any of these commands.

A complete exchange can be completed with a few tabs and then a keyboard shortcut to log the QSO clear the fields and start again with the non-persistant fields cleared.

The Call Sign field automatically upcases your typing and will do a lookup when you tab out of the field.

The Call Sign field will flash red if the call is already in your log as you type.


Contest Prefs

You can show or hide Contest Panel Fields and Labels based on the Contest Prefs check boxes.

The Contest ID popup in the Contest Prefs is loaded from the contest_id.dat file in the ~/Documents/MLDX_Logs/data_files/ folder. You can customize that file and place it in the top level MLDX_Logs folder if you want to override the defaults. The contest ID you select is used in the CONTEST_ID field of each QSO logged and is remembered in your Prefs between sessions.

The Map Rcvd popup in the Contest Prefs will automatically fill in some log fields based on the Rcvd field (SRX_STRING).


NE1RD's set of helpful hints for successful contesting:

Make the radio talk nice to the computer
Get a good connection to the rig via RS232C. I'm sure you've done this but I'll mention it anyway. Make sure that the radio and the computer are talking nicely. If you forget to set this up you'll log a bunch of folks in MacLoggerDX and you'll not even know what band you used! [I've done this; yes, it is embarrassing...]

Does anybody really know what time it is?
Set the clock on the Macintosh. I've got mine synchronized off the web so I never really think about it until contest time. Then, I just take a quick glance to make sure my log entries aren't from 1904 (presumably with spark gap!).

Read the contest rules
Read the rules for the contest before the contest begins. Really. Really really. Can you work somebody twice in the same contest? Can you work somebody on the same band if you use different modes?

Understand the exchange
Know what you need to capture for each QSO and how Contests almost always have some fixed exchange information such as RS(T), zone, year first licensed, serial number, etc.

Plan on using Cab-converter(tm)
If you are sending serial numbers, check out the item in the Contest preferences panel for auto incrementing the serial number. My program Cab-converter is a FREE program that can take an exported ADIF file from MacLoggerDX and translate it into a Cabrillo file for submission. You must read the contest-specific notes in the Cab-converter documentation to know where to put the exchange information and how that information should be formatted. Each contest is different and Cab-converter depends on having the exchange information stored properly for that particular contest. If you don't put the exchange information in the right place (and in the right form), Cab-converter won't be able to create a Cabrillo file for you.

Decide if you will use a separate log
Should you use a separate log file for a contest? MacLoggerDX can be a little more nimble if you start with a fresh, empty log. Merging this log back into your main log after the contest is as easy as importing an ADIF file. If you decide to try the fresh log approach, practice this well before the contest begins!

Check for duplicates during the contest
Use the "Previous" panel to check for repeats. Assuming you don't have this OM in the log 8 times, a quick glance will let you know if you've worked them this contest. This is where a fresh log really helps since you'll only see the QSOs that matter for this contest (and not the other twenty times you worked that OM in contests last year).

Going to all the trouble of making the QSO and then misunderstanding the exchange costs you points and costs points to the fellow you just worked. Listen and record the information carefully. Read and review your entry before and after you push "Log QSO". Here I must admit I don't always follow my own advice and, on those occasions where I didn't proofread my work, I've regretted it (and it cost me a couple of points). Here's my thinking: it is better to make fewer contacts because you spent a bit of time proofreading than to make 5 more QSOs with a buggy log.

After the contest is over
Extract the portion of your log relating to the contest and create an ADIF file. Run Cab-converter to generate your Cabrillo file. Send it off. You might also wish to peek in the file at the "Claimed score:" line. I've worked hard to try to accurately compute your score for the submission. While the contest sponsors have the final say on your score and might deduct points for broken QSOs, bad exchanges, etc., the "Claimed score:" line should give you an idea of how well you did.

Watch the web and those magazines
The lead time for contest results is mindbogglingly long in this age of instant information. Some contests don't report the results for nearly a year after the event. Still, it would be nice to see postings to the MacLoggerDX reflector with scores (or claimed scores) after contests so we MacLoggerDX users could see how our fellow contesters faired.

Look Up

A Look up is triggered when a call sign is entered in the DX Panel or the Contest Panel and return is pressed or you tab out of the Contest Call Sign field. A look up also occurs automatically if a DX Spot comes in on the DX Cluster and Auto Lookup is enabled, or if you triple click on a DX Cluster spot, double click on a History Panel list item or double click on a 2D or 3D Map item or click on a Bands Panel entry.

Look Up Previous in the Log menu will do a look up of the call and also show a list of previous QSOs in the Log panel.

The Suggest IOTA check box will suggest IOTA values based on the call sign in the absence of call book IOTA data which is always used. False positives can occur. Must Be Verified in QSO.

The Suggest CQ Zone check box will suggest CQ Zone values based on the call sign in the absence of call book CQ ZOne data which is always used. False positives can occur. Must Be Verified in QSO.

The Suggest ITU check box will suggest ITU values based on the call sign in the absence of call book ITU data which is always used. False positives can occur. Must Be Verified in QSO.

How MacLoggerDX determines IOTA, ITU and CQ Zones

  1. If the data is contained in the QRZ or HamCall lookup, MacLoggerDX assumes it to be correct and uses it.
  2. If you have Suggest IOTA, Suggest ITU Zone or Suggest CQ Zone enabled MacLoggerDX will try and determine them from the prefix but obviously this will not always produce accurate results and will sometimes produce a list of suggestions separated by commas.
  3. If you have previously logged the call and the Call Book values are blank MacLoggerDX will assume that the logged data is correct and use it for the new QSO.

If the call is in the log, the logged First Name will override the call book first name and will be displayed in italics.

With portable call signs there is no algorithmic way to ensure the correct zones are logged. If the station you are logging has not included his zone data in QRZ or HamCall then you must verify while in QSO or not log the zone data.

The Include Comments check box will include comments from the call book server and the dx cluster spot.

The Local Filter text edit box will set the distance away from you that spotters reports will be filtered out if you check the Local filter in the DXClusters Panel.

The Call Book popup determines which call book service is to be used for look ups.

Make sure to set your Call Book to None in the Lookup Prefs if you are contesting unassisted.

If you are having a problem with your look ups, please check your Look Up Preferences to make sure your call book service is selected in the Call Book popup.

If this is set to “None” cached lookups and your log will provide some stored data for some calls but lookups for totally new calls will only provide DXCC info.

How MacLoggerDX determines QSL Via

  1. If the data is contained in the Callbook lookup, MacLoggerDX assumes it to be correct and uses it.
  2. Otherwise, if the call is in the HB9BZA list MacLoggerDX will indicate it with "LoTW." (Note the period).

The Local Time Server popup will show the local time of the QSO looked up in the DX Panel Local field. The accuracy of this time depends on the accuracy of the location data for the call looked up.

Live lookups require an internet request of the or server so you may want to turn this option off if the dxcluster is busy and you have AutoLookup enabled. A period "." after the date and time indicates that it was calculated from a cached GMT offset result rather than a live lookup. If you want to force a non-cached (live) local time lookup select the call sign and press return. An "e" after the date and time indicates a server error and the time zone has been estimated from the longitude.

Lookup Sequence

MacLoggerDX separates the call into prefix/base call/suffix and then resolves all call signs to the DXCC country level using the data published in the ARRL Operating guide subject to special issue call overrides in it's internal dxpedition database and discards non identifying prefixes and suffixes like "MM" etc..

Then a lookup is done in the user selected call book QRZ, HamCall, WM7D or QRZ CD ROM and in the case of the QRZ XML Service a QSL Image is downloaded, cached and displayed. You need a username and password for the QRZ XML subscription service distinct from your username and password...

Finally MacLoggerDX looks for the call in your Log.

Call Book Options

Service QRZ CD-ROM/Download QRZ XML Online HamQTH QRZCQ
Speed Fastest Faster (depends on Internet bandwidth) Faster (depends on Internet bandwidth) Faster (depends on Internet bandwidth) Faster (depends on Internet bandwidth) Faster (depends on Internet bandwidth)

2 x $29.95 USD/Year + S&H -Discontinued

$29.95 USD/Year $52.00 USD/Year $0.00 $0.00 €12.99/Year
Updates 6 months instant instant instant instant instant
Detail Good Excellent Excellent Good Good Good
QSL Images Yes Yes No No Some Some
Other Considerations Does not require Internet connection for portable operation. Requires Internet connection. Requires Internet connection. Limited lookups. Requires Internet connection. Limited international content. Requires Internet connection, Registration Requires Internet connection. No email field shown.

Web Lookups

The MacLoggerDX Log menu Look Up on WWW menu item has several sub-menus that will ask your default browser to look up the current call using any of the popular www based call books.

You can make the Web QRZ - Look Up on WWW sub-menu a keyboard short cutF14 (or any other key combination) which will take you to the QRZ web page for the current call sign, with one keystroke.

You can also use Web HamCall, QRZCQ etc.


DXCC Prefix update process

MacLoggerDX resolves all prefixes to DXCC country using internal databases for mapped, exception, ambiguous and dxpedition call signs. Using a customized version of MacLoggerDX, we lookup all dxcluster spots world wide continuously and compare MacLoggerDX's prefix result against QRZ and HamQTH DXCC Lookup.

If a discrepancy is found we compare the call sign with Club Log's historical data to determine if the prefix is mapped correctly or is an exception.

Sometimes MacLoggerDX is wrong, sometimes QRZ is wrong, sometimes HamQTH DXCC is wrong and sometimes the DXCC has changed (as with non-continental U.S. stations moving to the mainland or some European/Asiatic/Kaliningrad Russian stations since 2010 etc.) If MacLoggerDX is incorrect we update the dxcclist.dat file and/or the dxpeditions.dat file and upload them to our server.

The next time you run MacLoggerDX with Check for Updates enabled in the Station Prefs or select Update Internet Files from the File Menu, your copy of MacLoggerDX will reflect the change in future lookups.

Please note that MacLoggerDX maintains a mapping to current DXCC entities - if your log contains a QSO with a DXCC entity which has changed or been deleted in the past you may have to edit the DXCC fields manually.

If you have logged a call with incorrect DXCC name or numeric value - set the DXCC numeric ID to 0, clear the DXCC Country field to blank and then Update Selected Log Entries with the new call and the new DXCC and DXCC Country will be entered automatically. This will never overwrite existing data - only fill in empty string or zeroed numeric fields.

If you find a call that maps to a different DXCC than the operator identifies with or receive an error from one of the online log books please let us know so that we can update our databases.

Look Up prefs

Online Log books

Logged QSOs can be automatically uploaded when logged (Club Log, LoTW, eQSL, QRZ Logbook and HRDLOG), or Individual QSOs can be uploaded and confirmations requested (LoTW and eQSL) in the Log panel contextual (right-click) menu.

If QSO upload or confirmation errors occur, MacLoggerDX will display short error descriptions in the Look Up prefs error status field for each service and in an Error Alert. Longer error descriptions can be found in the Debug Log (File menu Show Debug Log).

eQSL prefs

The first time you request Confirmations, all confirmed QSOs will be downloaded and checked against your log - marking QSL Received. The next time you run Confirmations, only confirmed QSOs since the saved Last Report time will be downloaded and checked against your log. You can Reset the Report Time to download all confirmations.


LoTW prefs

You can display your Callsign Certificate Properties in the tqsl application if you are unsure if the certificate is password protected or expired.

The Location needs to be the same as one of your locations in tqsl (outlined in red in the screen shot below). If you have multiple call signs and locations in tqsl, make sure that the Station Location names are all unique. Do not use the same Station Location name for more than one call sign. Location is optional if you have only one.

The first time you request Confirmations, all confirmed QSOs will be downloaded and checked against your log - marking QSL Received. The next time you run Confirmations, only confirmed QSOs since the saved Last Report time will be downloaded and checked against your log. You can Reset the Report Time to download all confirmations.

If a LoTW upload (either live or from the Log panel contextual menu) appears to hang, check that the tqsl app is not waiting for input - this can happen if an incorrect password was entered.

MacLoggerDX does not flag duplicates it replaces them. To flag a duplicate would require a switch to the tqsl application user interface which would hang the process. The other alternative is to toss the duplicate - which would not allow you to upload corrected QSOs.

If you are having problems with LoTW uploads from MacLoggerDX, make sure you can sign and upload a small ADIF file using tqsl by itself. The ARRL LoTW help is here.


QRZ XML prefs

The call sign in the My Call field of the QSO you are uploading (Station Prefs Call Sign) must match the call sign of the QRZ Logbook you are uploading to.

Enter the API Key from the QRZ Logbook web page Settings into the Upload Key text box - This is not your QRZ XML Account Checker Key and will look something like this: 3BCE-0D7E-AECE-29DF


HRDLOG prefs