Documentation

Help & FAQ

Everything you need to get started and make the most of GeoFS Flightradar.

Getting Started

The userscript connects your GeoFS session to the Flightradar, broadcasting your position in real-time.

  1. Install a userscript manager — Tampermonkey (recommended) works on Chrome, Firefox, Edge, and Safari.
  2. Open Tampermonkey's dashboard and click Create a new script.
  3. Paste the userscript code (grab the latest version from our GitHub repo) and save.
  4. Visit geo-fs.com — the script activates automatically once GeoFS finishes loading.
  5. A small HUD overlay will confirm the connection. Your blip will appear on the radar.
Make sure the userscript's server URL points to geofs-flightradar.duckdns.org. If you self-host, update the URL constant at the top of the script.

Linking your Discord account unlocks flight history, stats, and community features.

  1. Click the profile / login button in the top-right corner of the radar page.
  2. Select Login with Discord and authorise the app on Discord's OAuth page.
  3. You'll be redirected back. A profile badge confirms your login.
  4. Optionally enter your GeoFS User ID in the link form to associate your flight data.
Your GeoFS User ID is visible in the GeoFS URL when logged in, or find it via the /whois bot command.
Airline Registry

Any GeoFS virtual airline can apply to have its logo and callsign prefix appear on the radar.

  1. Join our Discord server and head to the #airline-registry channel.
  2. Use /airline apply and follow the prompts — provide your ICAO callsign prefix, airline name, and a square logo (PNG, min 128×128 px).
  3. An admin will review your submission. Approval usually takes 1–3 days.
  4. Once approved, flights using your prefix display your logo on the radar and flight list panel.
Callsign prefixes must be unique. If another virtual airline already holds yours, contact an admin.

Only the airline owner or an admin can update logos.

  1. Prepare a new logo — PNG, square aspect ratio, at least 128×128 px, transparent background preferred.
  2. Use /airline update logo in the bot and attach the new image.
  3. Changes take effect within a few minutes as the cache refreshes.
Jet-Photos & Gallery

Approved photos appear as map markers and in the community gallery.

  1. Make sure you're logged in with your Discord account.
  2. Click Upload Photo in the top bar of the radar page.
  3. Select your image (JPG or PNG, max 10 MB). Add a caption, aircraft type, and location tags.
  4. Submit — your photo enters a review queue. Admins typically approve within 24 hours.
  5. Once approved, a pin appears on the map at the photo's coordinates.
GeoFS screenshots embed GPS EXIF data automatically. For manually captured photos, tag the location in the upload form.

All photos are moderated. Submissions are approved if they:

  • Show a GeoFS aircraft clearly — no black screens, menu UI, or loading screens
  • Are not duplicates of an existing approved photo
  • Do not contain offensive or inappropriate content
  • Are reasonably sharp — extreme blur or solid fog shots will be rejected
Repeated submission of rejected photos may result in upload privileges being suspended.
Radar Features

ATC Mode switches the map to a high-contrast radar scope style — green aircraft tags on a dark background — designed for use during ATC sessions.

Toggle it with the radio button in the bottom-right control bar..

ATC Mode pairs well with the OpenAIP layer, which overlays airways, fixes, and airspace boundaries.

The system monitors squawk codes from all connected aircraft. These codes trigger a Discord alert:

  • 7700 — General emergency
  • 7600 — Radio failure (NORDO)
  • 7500 — Hijacking

Each code triggers a maximum of one alert per flight. The alert includes callsign, position, altitude, and a map link.

The bot pings you on Discord when approaching your penultimate waypoint, so you can prepare for descent.

  1. Make sure your Discord account is linked.
  2. Use /reminder enable
  3. The bot watches your position and sends a DM at the penultimate waypoint.
  4. Use /reminder disable to remove an active reminder.
Discord Bot Commands
CommandDescription
/linkLink your Discord account to a GeoFS User ID
/statsView flight statistics — hours, distance, total flights
/flightsShow your recent flight history
/whoisLook up a GeoFS user's linked Discord account
/reminderSet a waypoint approach reminder for your active flight
Troubleshooting
  • The userscript is enabled in Tampermonkey and GeoFS has fully loaded
  • Browser console (F12) shows no WebSocket errors — look for WS connected to geofs-flightradar…
  • Ad-blockers or firewall rules aren't blocking the WebSocket connection, this offen happens on firefox or brave.
  • Maybe SeaBus is fixing something.

This is a known cosmetic issue with trans-Pacific routes crossing the antimeridian (±180°). The radar uses longitude unwrapping to minimise this, but very long trails may still jump across the map.

If you see a persistent bug, report it in #bug-reports on Discord with your route details.

Join our Discord server — it's the fastest way to get support, report bugs, or suggest features. Use #support for technical questions and #general for everything else.

When reporting issues, include your browser, OS, and any errors from the browser console (F12).