ParkWatch — Windows Quick Start
========================================

WHAT YOU NEED FIRST
-------------------
Python 3, from https://www.python.org/downloads/
  ** During install, TICK THE BOX "Add Python to PATH" **
(The installer will send you there if it's missing.)


INSTALL
-------
1. Double-click  Install ParkWatch (Windows).bat

   If Windows says "Windows protected your PC":
   click "More info" -> "Run anyway".
   (This appears for any unsigned script downloaded from the internet.)

2. The installer copies everything to
      %LOCALAPPDATA%\ParkWatch
   registers the radio bridge with Chrome/Edge/Brave, and opens
   a 5-step guide plus Chrome's Extensions page.

3. Follow those 5 steps: turn on Developer mode, click "Load unpacked",
   and choose the "app" folder the installer opened in Explorer.

4. Click the ParkWatch tree icon in Chrome's toolbar.


SET UP LOG4OM LOGGING
---------------------
ParkWatch sends each QSO to Log4OM as an ADIF datagram over UDP.

In Log4OM:
  1. Settings -> Software Integration / Connection
  2. Under "Inbound connections", add a new entry:
         Type: ADIF_MESSAGE
         Port: 2236          (any free port; must match ParkWatch)
  3. Communicator -> Interfaces tab -> tick "Auto Start"
     so Log4OM is listening whenever it's running.

In ParkWatch (toolbar icon -> gear -> Logging):
  1. Tick "Send QSOs to my logging software (UDP)"
  2. In the destination table, tick the "Log4OM" row
     and confirm the port matches what you set above (2236)
  3. Save, then click "Send test QSO to all"
     -> a TE5T contact at K-0000 should appear in Log4OM

IMPORTANT — ONE PORT PER LOGGER
  Only the first program listening on a UDP port receives the data.
  If you also run Station Master Pro, give it a DIFFERENT port
  (it defaults to 2333, Log4OM to 2236). If they share a port,
  one of them silently receives nothing.

You can add as many loggers as you like with "Add destination" —
every QSO goes to all of them at once.


NOTHING TO LAUNCH
-----------------
After the installer runs, Chrome starts the bridge automatically
whenever ParkWatch needs it. There is no window to keep open.

If UDP ever reports "bridge unavailable", the fix is:
  run the installer again, then FULLY restart Chrome
  (close every window, not just the tab).

Fallback: bridge\start_bridge.bat runs a standalone bridge manually.


OTHER FEATURES WORTH A LOOK
---------------------------
  * Settings -> Alerts        mode/band filters, watchlist, do-not-spot list
  * Settings -> Rig control   one-click QSY over TCI
  * Settings -> Phone alerts  needed spots pushed to your phone
  * Toolbar icon              opens the movable ParkWatch window


TROUBLESHOOTING
---------------
"Python was not found"
    Install Python and tick "Add Python to PATH", then re-run the installer.

Extension loads but shows "No award data"
    Open https://pota.app and sign in. ParkWatch reads your hunter
    awards from that session to flag NEW PARK / NEW STATE.

Test QSO says sent, but nothing in Log4OM
    Check Log4OM's inbound port matches ParkWatch's, that the
    connection is enabled, and that no other program is already
    listening on that port.

MIT licensed. Not affiliated with Parks on the Air or WWFF.
