PRO TRACKER & DATABASE - HOW TRACKING WORKS
=============================================

WHAT "TRACKING" ACTUALLY DOES
------------------------------
When you hit Play, the app does the following, over and over, several times
per second:

  1. Takes a screenshot of the PRO client window (just that window - not
     your whole screen, and not anything else running on your computer).
  2. Looks at that screenshot to figure out whether you're currently in a
     battle.
  3. If you are, it reads the small strip of text at the top of the battle
     screen ("Wild <Pokemon> appeared!") using OCR (Optical Character
     Recognition) - basically, it's reading the words on screen the same
     way you would, just automatically.
  4. It does the same thing for the catch result message ("Gotcha!" /
     "Oh no, it broke free!") and for shiny/rare-form popups.

That's it. The app never touches PRO's memory, never sends input to the
game, and never modifies anything about how PRO runs. It only ever *looks*
at pixels already on your screen and reads text out of them - the same
information you can already see with your own eyes. It works entirely from
outside the game, the same way a person watching over your shoulder and
writing down what they saw would.

THIS BUILD SUPPORTS WINDOWS, LINUX, AND MACOS
-----------------------------------------------
Both the "find the PRO window" step and the OCR detection step run on all
three. If you're on Linux or macOS, there's a separate README with the
one-time setup your OS needs (README-Linux-and-macOS-Setup.txt) - read that
first if tracking doesn't seem to be picking anything up at all.

WHY IT MIGHT MISS AN ENCOUNTER, OR MISREAD A NAME
----------------------------------------------------
OCR isn't perfect. A few things can throw it off:

  - The PRO client window being resized very small, or a very unusual GUI
    scale/zoom level - the text the app is trying to read gets too small
    or oddly shaped to recognize reliably.
  - A different in-game theme/skin than the one this was tuned against,
    if PRO has any UI customization options.
  - The PRO window being partially covered by another window while a battle
    starts, especially on macOS (see the other README - this matters more
    there than on Windows/Linux).
  - Genuinely fast game animations that come and go before a screenshot
    happens to catch them.

If it misses one encounter here and there, that's expected and not a bug to
report on its own. If it's missing encounters *consistently*, or reading
Pokemon names wrong most of the time, that's worth reporting - see below.

WHAT TO DO IF SOMETHING SEEMS WRONG
--------------------------------------
1. Check the message shown in the toolbar right next to the Start/Stop
   buttons - it usually explains what's happening ("Waiting for
   PROClient...", "Confirmed battle ended - ready for next encounter.",
   etc.). If it's stuck on "Waiting for PROClient...", the app can't find
   or capture the PRO window at all - that's almost always a Linux/macOS
   setup thing (see the other README) rather than an OCR problem.

2. Click "Report a Problem" in the menu bar (next to Appearance). This
   saves a screenshot of the app plus a copy of the day's log file to your
   Downloads folder, with matching filenames like:

       ProTracker-Report-20260820-153045.png
       ProTracker-Report-20260820-153045.log

   Nothing gets sent anywhere automatically - it just saves those two files
   so you can send them along yourself.

3. Send both files to the developer, along with a quick note on what you
   were doing when it happened (e.g. "just started a battle and it didn't
   register the encounter"). The log file especially - it has real
   timestamps and detail that's much more useful for tracking down a
   problem than a description alone.

WHAT TRACKING NEEDS TO WORK AT ALL
-------------------------------------
  - The PRO client needs to actually be running.
  - The PRO client window needs to be visible on screen (not minimized).
    It does NOT need to be the focused/active window on Windows or Linux -
    it can be in the background. On macOS it currently DOES need to not be
    covered by another window - see the other README for why.
  - You need to have picked a target Pokemon ("Set Target") before hitting
    Play.

That's genuinely all - there's no login, no separate account, no extra
software needed beyond what's already in this folder (aside from a couple
of small Linux tools - again, see the other README if that's you).
