RAID ALARM for ROB RUN  -  version 2.1
======================================
Never lose your base while you sleep. Raid Alarm watches your screen for
"YOUR BASE IS UNDER ATTACK!" and wakes you up with a loud alarm sound,
phone notifications, and Telegram texts and calls.

GETTING STARTED
  1. Double-click RobRunRaidAlarm.exe. Nothing to install.
     (Windows may say "Windows protected your PC" because the app isn't
     signed. Click "More info" -> "Run anyway".)
  2. Open ROB RUN in Borderless or Windowed mode and leave it on screen.
  3. On the Dashboard, press "Start watching" (or F8).
  4. Press "Test sound" once to make sure it's loud enough to wake you.

THE MENU
  Dashboard  Live radar, status, and how long you've been protected.
  Alerts     Phone notifications and Telegram texts/calls.
  Tutorial   Step-by-step setup for push notifications, Telegram texts
             and Telegram calls, with buttons that open the right links.
  Hotkeys    Change your keys. Defaults: F8 = start/stop watching,
             F9 = stop the alarm. They work even while you're in-game.
  Settings   Max volume on a raid, start watching on launch, intro
             animation, silent mode, and the alarm sound picker.

ALARM SOUND
  - Pick a sound in Settings > Alarm sound: Air-raid siren, Hi-lo siren,
    Red alert klaxon, Whoop alarm, Fire alarm, Alarm clock beeps, or your
    own .wav file. Press Preview to hear 3 seconds of it.
  - "Alarm sound on a raid" (Dashboard or Settings): turn it off for a
    silent PC, so a raid only sends your phone alerts. If no phone alerts
    are set up, the sound plays anyway so you never miss a raid.
  About      How it works.

  Raid Alarm is free. Every feature is included.

PHONE NOTIFICATIONS (free, optional)
  - Install the "ntfy" app on your phone (Play Store / App Store).
  - In Alerts > Push notifications you'll see a topic made just for you
    (like robrun-1a2b3c4d). In the ntfy app tap +, type that exact topic,
    and subscribe. Press "Send test" - your phone should buzz.
  - During a raid you get an urgent alert every minute until you stop the
    alarm. Keep your topic private: anyone who knows it can see your alerts.
  - ntfy's free server allows roughly 250 alerts a day.

TELEGRAM TEXTS & CALLS (free, optional)
  - Install Telegram and set a username (Settings > Username).
  - Texts: in Telegram, open @CallMeBot_txtbot and send /start.
  - Calls: open https://api2.callmebot.com/txt/login.php and log in with
    Telegram (sending /start is NOT enough for calls). In Telegram, set
    Settings > Privacy and Security > Calls to Everybody (or add
    @CallMeBot_API to your contacts).
  - Type your @username in Alerts > Telegram, then press Test text /
    Test call.
  - During a raid: a text every 5 seconds until you stop the alarm, and a
    call (retried if the free call service is busy).
  - HEADS UP: everyone shares CallMeBot's free call line, so it's usually
    full. Calls can come late or not at all. Raid Alarm retries every 70
    seconds, but turn on push notifications and texts too. For reliable
    calls, CallMeBot sells a private line for about $15/month (not part
    of Raid Alarm): https://www.callmebot.com/telegram-call-api/
  - iPhone: calls ring but may have no sound when answered (a Telegram
    bug). The ringing still wakes you.

BEFORE YOU SLEEP
  - Keep ROB RUN on screen (not minimized).
  - Make sure your PC won't sleep or turn off the screen:
    Settings > System > Power > Screen and sleep > "Never".

PRIVACY
  Raid Alarm only takes screenshots of your screen to look for the raid
  banner. It never reads or changes the game.

FOR DEVELOPERS
  To rebuild the .exe: install Python (tick "Add python.exe to PATH"),
  then double-click BUILD_EXE.bat.
