RogerATC 1.28 beta · user guide

Installing and flying with RogerATC

Everything you need to go from download to your first call: the free Copilot EFB account, the installer for macOS or Windows, RogerATC Setup, binding push-to-talk in X-Plane, and what to say to the controller and the instructor — with examples in English and Spanish.

01

What RogerATC is and what you need

RogerATC replaces X-Plane 12's built-in ATC with an AI air traffic controller you talk to by voice. You hold a push-to-talk key, speak the way you would on a real frequency, let go, and the controller answers on COM1 or COM2 — in English or Spanish. A second voice, the virtual instructor, sits on the cabin intercom and answers questions about your flight.

The AI only works out what you asked for. What the controller says is decided by a rules engine and worded from phraseology templates written by people, with their sources. Runways, taxiways, frequencies, fixes and procedures come from your own X-Plane installation, add-on scenery included: if something is not in your data, the controller never says it.

What you need

  • X-Plane 12.4 or later.
  • macOS 11 or later (Apple Silicon or Intel) or Windows 10/11, 64-bit. Windows support is new in this beta.
  • A free Copilot EFB account. RogerATC uses it to check your account and to fetch your keys.
  • An OpenAI API key with credit, entered in Copilot EFB. You pay OpenAI directly for what you use.
  • An internet connection, and a headset with a microphone (strongly recommended: a built-in microphone picks up the simulator's own sound).

RogerATC and Copilot EFB are free during the beta. This is version 1.28 beta: expect rough edges, and check the changelog on rogeratc.app for what changed.

02

Before you install: your Copilot EFB account and keys

RogerATC does not have its own sign-in. Your Copilot EFB account is your RogerATC account, and it is where every provider key lives. Do these three things first — they take five minutes.

1. Create your Copilot EFB account

Open copilot.rogeratc.app/sign-up, enter your name, email and a password, and confirm the six-digit code sent to your email. The account is free during the beta, and the EFB is a complete flight bag you can also use on its own.

2. Copy your Copilot EFB API key

In Copilot EFB, open Settings → API access. Every account has a personal key that starts with rat_live_. Use the copy button. This is the only key you will ever paste into RogerATC.

3. Enter your OpenAI key in Copilot EFB

In Copilot EFB, open Settings → Keys used by RogerATC and paste your OpenAI key. RogerATC uses it for speech recognition, the controller's voice and the language model. The plugin fetches your keys from your account every time it starts, so you never type a provider key into RogerATC.

The other keys in that section are optional. Without them, the feature is simply absent:

KeyRequired?What it gives you
OpenAIYesSpeech recognition, the voices, and the language model that understands what you said.
openAIPNoUp-to-date airspace for the instructor, instead of the copy that came with X-Plane.
WindyNoA second winds-aloft forecast for the instructor, only when it has neither the simulator's own nor NOAA's GFS model, which is free and needs no key.
Flightradar24NoHow busy your frequency sounds follows the real traffic around you. Only a count is fetched. Without it, the free real-world traffic does the same.
TavilyNoWeb search for the instructor, limited to aviation sources such as ANAC, FAA, ICAO, EASA and SKYbrary.
Other AI providersNoOnly if you choose another provider and model as the language model. They are the same keys the EFB's assistant uses. Without the key, RogerATC goes back to the default provider.

When Copilot EFB itself uses the same key (for example openAIP for its map), Settings marks it Used by Copilot EFB and RogerATC. Change it in one place and both apps use the new one; RogerATC picks it up the next time it starts.

03

Installing on macOS

  • Download RogerATC-1.28-beta-macOS.dmg from rogeratc.app and open it.
  • Drag RogerATC Setup onto the Applications folder in the same window.
  • Open RogerATC Setup from Applications.

The first time: "Open Anyway"

This beta is not notarized by Apple, so the first time macOS refuses to open it and says it cannot check it for malicious software. To allow it:

  • Close the message.
  • Open System Settings → Privacy & Security and scroll down to the Security section.
  • Next to the line about RogerATC Setup, click Open Anyway and confirm with your password or Touch ID.

The microphone

The first time you press push-to-talk in X-Plane, macOS asks for permission to use the microphone. Allow it. If you clicked Don't Allow, open System Settings → Privacy & Security → Microphone and switch on X-Plane (or RogerCore, if it appears there), then restart X-Plane.

04

Installing on Windows

Windows support is new in this beta. The installer works for your user only and does not ask for administrator rights.

  • Download RogerATC-1.28-beta-Windows-Setup.exe from rogeratc.app and run it.
  • The installer is not code-signed in this beta, so Windows SmartScreen shows "Windows protected your PC". Click More info, then Run anyway.
  • Accept the licence, keep the suggested folder and click Install. At the end, leave Run RogerATC Setup ticked.

The microphone

Open Settings → Privacy & security → Microphone and make sure Microphone access and Let desktop apps access your microphone are both on. If Windows asks the first time you press push-to-talk, allow it.

05

RogerATC Setup, step by step

RogerATC Setup links your account, installs the plugin into X-Plane and holds every setting, in English or Spanish. Inside the simulator, Plugins › Roger ATC AI › Open RogerATC Setup… opens it.

Link your account

Paste your Copilot EFB key (rat_live_…) and link it. Setup checks it, shows the account name and lists which provider keys your account holds — names only, never values. If OpenAI is missing, add it in Copilot EFB before you fly. The key is stored in the macOS keychain or the Windows Credential Manager, never in a plain file.

Install the plugin into X-Plane

Setup finds your X-Plane 12 installations and shows whether RogerATC is installed in each. Choose yours and click Install; the same place offers Update, Repair and Uninstall. Close X-Plane first — Setup does not touch the plugin while it runs. Then Start X-Plane launches the simulator.

The plugin goes into its own folder; nothing else in X-Plane is changed:

X-Plane 12/Resources/plugins/RogerATC

Settings

Every setting is chosen in Setup. Most can also be changed mid-flight from Plugins › Roger ATC AI › Settings, and take effect from the next transmission.

SettingWhat it doesDefault
LanguageEnglish or Spanish: the phraseology, the voice and what the recogniser expects.English
RegionWhich country's phraseology you hear. Automatic follows the aerodrome, so crossing a border changes the wording. Generic ICAO or one of twelve regions can also be fixed.Automatic
VoicesThe tower's and the instructor's synthetic voices, different on purpose. Ground, approach and centre each take another voice of their own.marin · cedar
Speech rateHow fast the controller speaks, 1.0× to 1.6×.1.15×
Radio effectBandwidth, noise and the click of a VHF radio.On
ATIS weatherThe simulator's weather, or the real METAR if you fly with real weather.Simulator
Language modelThe AI provider and model you choose, on your own key, or a local model running on your computer. Recognition and voices still use OpenAI.OpenAI
Controller and instructor modelThe model that understands the radio and the one that answers as the instructor, from that same provider. Automatic uses the one we measured fastest; you can pick another from the list or type its name.Automatic
InstructorOff, Quiet (answers only when called, never speaks on its own), On (also says what matters at once: configuration on the take-off roll, limits, fuel) or Proactive (also the cautions and advisories).On
Your nameWhat the instructor calls you. Empty uses the first name on your Copilot EFB account; changing it here does not change the account.From your account
Instructor makes radio callsAsk the instructor on the intercom to call the tower or ground for you, and it transmits; you hear both sides.On
Instructor reads my EFB messagesWhen you have unread messages in Copilot EFB, the instructor tells you and reads them one by one on the intercom — never over the radio, never on take-off or landing. Say "stop" to leave them for later or "skip" for the next one. Also in the plugin window's Instructor tab.On
Call signWhat you are called on the radio when it is not the aircraft's registration: ARG1234 for an airline flight, Condor 21 for a military one.The registration
Type of flightGeneral aviation, airline or military: how the controller treats you — an airline's telephony and handoff after take-off, and, in English, HEAVY and the military overhead join. Automatic decides from your call sign and the aircraft. Also in the plugin window.Automatic
Traffic on frequencyOther aircraft on the frequency: off, quiet, normal or busy.Quiet
Real-world trafficReal aircraft around you, from adsb.lol (free, no key): real call signs on the frequency and the real sky for the instructor.On
Network weatherFetch real METAR and TAF from NOAA (no key) when the simulator has none.On
Wait toneA short tone while the answer is prepared: a blip for the controller, a chime for the instructor.On
Data sourceBoth (the default): X-Plane plus your filed flight plan, aircraft profile — the take-off briefing needs its speeds — and missing frequencies from Copilot EFB. Simulator: X-Plane only. EFB: your aerodrome cards also win on frequencies.Both
EFB syncStatistics (always on) or Full, which adds a trimmed transcript.Statistics
EFB live linkShares your aircraft's position and cockpit state with your own EFB, so you or an instructor can follow the flight.Off
Visual debugAn overlay saying what RogerATC is doing right now.Off

Setup also shows a notice when a newer RogerATC is published, and Open the logs folder opens the folder with the logs and session records.

06

Your first flight

Bind the keys

In X-Plane, open Settings → Keyboard (or Joystick for a yoke button), search for Roger ATC and assign:

CommandWhat it does
Roger ATC: push-to-talk on COM1Talk to the controller on COM1. The one you need.
Roger ATC: push-to-talk on COM2Talk to the controller on COM2.
Roger ATC: talk to the virtual instructor (intercom)Talk to the instructor on the cabin intercom, not on the radio.

Hold the key while you speak and release it when you have finished: releasing is what ends the transmission, so a pause in the middle never cuts you off. A very short tap is ignored as an accidental press.

Start a flight

  • Load a flight on the apron of an aerodrome with a tower or ground frequency, engines off.
  • Look at Plugins › Roger ATC AI › About or Diagnostics: they show that RogerATC is running, which aerodrome it found and which runway is in use.
  • Tune COM1 to the ground frequency (or the tower, if there is no ground station): the frequency decides who answers. Any controlled aerodrome within sixty miles (ten on the ground) answers on its own frequency.
  • Hold the key and make your first call: the station, then your call sign. Release and wait for the answer.

The controller starts speaking as soon as its first phrase is ready, each station in a voice of its own. While the answer is being prepared you hear the wait tone; if you hear nothing at all, see Troubleshooting.

07

Talking to the controller

Talk like a pilot: station, call sign, position and request in one call. Standard phraseology works best, but you do not have to be word-perfect. The Spanish is native phraseology, not translated English.

The exchanges below are illustrative. The exact wording depends on your aerodrome, your region setting and the situation — the controller remembers what it already told you and does not repeat it.

Contact, start-up and taxi

A station that has not spoken to you yet introduces itself and greets according to the aerodrome's local time. The taxi route is worked out on the real taxiways of the airport you are at, from your own scenery.

In English
PILOT  Ezeiza Ground, LV-GKM, on the apron, information Delta, request start-up.
ATC    LV-GKM, Ezeiza Ground, good morning. Start-up approved, QNH 1013, squawk 4321.
PILOT  Start-up approved, QNH 1013, squawk 4321, LV-GKM.
ATC    LV-GKM, readback correct.
PILOT  LV-GKM, request taxi.
ATC    LV-GKM, taxi to holding point runway 11 via Juliett, Echo, Alfa,
       hold short of runway 17.
PILOT  Taxi to holding point runway 11 via Juliett, Echo, Alfa,
       hold short of runway 17, LV-GKM.
In Spanish
PILOTO  Ezeiza Rodaje, LV-GKM, en plataforma, información Delta, solicito puesta en marcha.
ATC     LV-GKM, Ezeiza Rodaje, buen día. Puesta en marcha aprobada, QNH 1013,
        transpondedor 4321.
PILOTO  Puesta en marcha aprobada, QNH 1013, transpondedor 4321, LV-GKM.
ATC     LV-GKM, correcto.
PILOTO  LV-GKM, solicito rodaje.
ATC     LV-GKM, Ezeiza Rodaje, ruede a punto de espera de pista 11 vía calle de rodaje
        Juliett, Echo, Alfa. Mantenga antes de pista.
PILOTO  Ruedo a punto de espera de pista 11 vía Juliett, Echo, Alfa, LV-GKM.

Take-off, the circuit and landing

In English
PILOT  Ezeiza Tower, LV-GKM, holding point runway 11, ready for departure.
ATC    LV-GKM, Ezeiza Tower, runway 11, cleared for take-off, wind 270 degrees 8 knots.
PILOT  Runway 11, cleared for take-off, LV-GKM.
       ...
ATC    LV-GKM, number one, report final.
PILOT  LV-GKM, final runway 11.
ATC    LV-GKM, wind 270 degrees 8 knots, runway 11, cleared to land.
       ...
ATC    LV-GKM, vacate the runway, contact ground 121.9.
In Spanish
PILOTO  Ezeiza Torre, LV-GKM, punto de espera pista 11, listo a la salida.
ATC     LV-GKM, Ezeiza Torre, pista 11, autorizado a despegar,
        viento 270 grados 8 nudos.
PILOTO  Pista 11, autorizado a despegar, LV-GKM.
        ...
ATC     LV-GKM, número uno, notifique en final.
PILOTO  LV-GKM, en final pista 11.
ATC     LV-GKM, viento 270 grados 8 nudos. Pista 11, autorizado a aterrizar.
        ...
ATC     LV-GKM, libere pista, pase con rodaje 121.9.

The circuit is understood the way pilots say it — crosswind, downwind, base, final — and checked against where you actually are. Report a leg the data contradicts and you hear "negative" and where you really are.

Requests: ATIS, QNH, frequencies and more

In English
LV-GKM, request ATIS.
LV-GKM, request QNH.
LV-GKM, request the tower frequency for Rosario.
LV-GKM, request the METAR for Rosario.
LV-GKM, request the VOR frequency.
LV-GKM, request touch and go.
LV-GKM, request to cross runway 17.
In Spanish
LV-GKM, solicito ATIS.
LV-GKM, solicito QNH.
LV-GKM, ¿cuál es la frecuencia de torre de Rosario?
LV-GKM, solicito el METAR de Rosario.
LV-GKM, solicito la frecuencia del VOR.
LV-GKM, ¿me autoriza un toque y motor?
LV-GKM, solicito cruzar pista 17.

Answers come from your own data, for any aerodrome; a frequency your scenery does not publish comes from your EFB or the world reference, and you ask by name, code, spelled code or IATA code — an aerodrome's ILS or VOR too. If nothing anywhere has it, the controller says so instead of guessing. If you did not report the ATIS, you are given the information in force and the QNH when you taxi out or call inbound. Pushback, de-icing, zone transits, special VFR, flight plans filed or closed by radio, and position and level reports are understood too.

Readbacks and "say again"

Read back every clearance. A correct readback is confirmed with "readback correct" ("correcto" in Spanish); a wrong one is corrected with the right value. If you did not catch something, ask for it again: the repeat is marked so you know nothing changed.

In English
PILOT  Taxi to holding point runway 29, LV-GKM.
ATC    LV-GKM, negative I say again, runway 11.

PILOT  Say again.
ATC    LV-GKM, I say again. Taxi to holding point runway 11 via Juliett, Echo, Alfa.
In Spanish
PILOTO  Ruedo a punto de espera de pista 29, LV-GKM.
ATC     LV-GKM, negativo repito, pista 11.

PILOTO  Repita.
ATC     LV-GKM, repito. Ruede a punto de espera de pista 11 vía Juliett, Echo, Alfa.

Traffic, crossings and go-arounds

When something is on final, a request to line up can be held and released when the traffic has gone. The tower can also order a go-around, and you can report one yourself.

In English
ATC    LV-GKM, hold short runway 11, traffic on final, I will call you.
       ...
ATC    LV-GKM, cross runway 17, report runway vacated.
ATC    LV-GKM, go around, I say again, go around, runway occupied.
       Climb to 1500 feet, report downwind.
In Spanish
ATC     LV-GKM, mantenga fuera de pista 11, tránsito en final, lo llamo apenas quede libre.
        ...
ATC     LV-GKM, cruce pista 17, notifique pista libre.
ATC     LV-GKM, ida al aire, ida al aire, pista ocupada.
        Ascienda a 1500 pies, notifique tramo a favor del viento.

Emergencies

MAYDAY and PAN PAN are always recognised and answered — never with "say again". PAN PAN is not treated as a MAYDAY, and minimum fuel gets "no delay expected", not priority, as the rules say.

In English
PILOT  MAYDAY MAYDAY MAYDAY, Ezeiza Tower, LV-GKM, engine failure,
       four miles south, 2000 feet, returning to the field.
ATC    LV-GKM, Ezeiza Tower, roger. Emergency services alerted. Runway 11 available,
       wind 270 degrees 8 knots. Report your intentions and souls on board.

PILOT  PAN PAN PAN PAN PAN PAN, Ezeiza Tower, LV-GKM, passenger unwell, request priority.
PILOT  LV-GKM, minimum fuel.
In Spanish
PILOTO  MAYDAY MAYDAY MAYDAY, Ezeiza Torre, LV-GKM, falla de motor,
        cuatro millas al sur, 2000 pies, regreso al aeródromo.
ATC     LV-GKM, Ezeiza Torre, recibido. Servicios de emergencia alertados. Pista 11 a su
        disposición, viento 270 grados 8 nudos. Notifique intenciones y personas a bordo.

PILOTO  PAN PAN PAN PAN PAN PAN, Ezeiza Torre, LV-GKM, pasajero indispuesto, solicito prioridad.
PILOTO  LV-GKM, combustible mínimo.

Getting understood

  • Use a headset. A built-in microphone hears the engine.
  • Say your call sign in every transmission; it can go at the start or the end.
  • Say designators, do not spell them: "via Kilo Two", not "via K2". The controller always answers with the ICAO alphabet — Alfa, Juliett, Xray — and understands "Alpha" and "Juliet" too.
  • The frequency is simplex: key the mic while the controller is talking and you cut it off, as on a real radio.

By voice, the stations that answer you today are Tower and Ground. Approach and area control are not yet stations you can call; IFR instructions reach you through the EFB live link instead (see IFR practice below). At an aerodrome with no tower in your scenery nobody answers, as at a real uncontrolled field.

08

What the controller does on its own

A real tower does not wait to be asked, and neither does this one. It works out where you are from your position and heading relative to the runway in use and speaks when a controller would:

  • Turning downwind: your number in the sequence and "report final"; on final without a clearance, the landing clearance.
  • Entering a runway without a take-off clearance: "hold position". Runway vacated: over to Ground.
  • Another aircraft getting close, the runway in use changing with the wind, a new QNH: you are told unprompted.
  • A transponder code with your clearance, and a check if the code is wrong, on standby on the runway, or IDENT is pressed.
  • An airline flight is handed to the next unit after take-off, on the frequency your own data has for it — or not at all if there is none.

Other aircraft on the frequency

With Traffic on frequency on, you hear other pilots call for start-up and taxi, report downwind and get cleared to land, in their own voices. They never talk over you and nothing said to you refers to them: you are sequenced only against aircraft your simulator actually shows.

Real-world traffic

With Real-world traffic on, the default, RogerATC asks adsb.lol — a community network of ADS-B receivers, free and with no key — which aircraft are really flying near you. The data is published under the Open Database Licence: adsb.lol (ODbL).

  • Real call signs on the frequency. The traffic you hear uses the call signs of aircraft really on the ground or in the circuit at your aerodrome, when there are any.
  • Real density. How busy the frequency sounds follows the real count, unless a Flightradar24 key in your Copilot EFB already sets it.
  • The real sky, from the instructor. Ask what is flying around you and it tells you — always as real-world aircraft, never as traffic in your simulator.
  • Named only when you can see it. The controller gives an aircraft's type only when your simulator shows that aircraft too — for example with a real-traffic injector such as LiveTraffic. Traffic your simulator does not show is never given to you as traffic.

Switched off, or with no internet, everything works exactly as before.

09

The virtual instructor

Hold the intercom key and talk normally. The instructor answers in your language, close and clean, without the radio effect, in its own voice. It knows where you are, the weather, the frequencies, the airspace and your aircraft's state.

Things to ask, in English
What's the crosswind on runway 11 right now?
How far am I from Ezeiza, and which runway is in use?
What is my pivotal altitude at this ground speed?
Give me the frequency of the San Fernando VOR.
How far out should I start down, and at what rate?
Let's do a steep turn to the left.
Remember that in this aeroplane we take the first stage of flap at 85 knots.
What's flying around us right now?
Tell the tower we're ready.
Things to ask, in Spanish
¿Cuál es el viento cruzado en la pista 11 ahora?
¿A cuánto estoy de Ezeiza y qué pista está en uso?
¿Cuál es mi altura pivotal a esta velocidad respecto al suelo?
Dame la frecuencia del VOR de San Fernando.
¿A qué distancia empiezo el descenso y con qué régimen?
Hagamos un viraje escarpado a la izquierda.
Acuérdate de que en este avión sacamos el primer flap a 85 nudos.
¿Qué está volando cerca de nosotros ahora?
Avísale a la torre que estamos listos.
  • Every number is calculated, never remembered. Crosswind, distances, pivotal altitude, the radial you are on, where to start down: all computed from the simulator and your data. When there is no way to work something out, it tells you so.
  • Winds aloft from the sky you fly in. The wind at your altitude and above comes from the simulator itself — the wind your aircraft is actually flying in — before any forecast.
  • Regulations with a source. With a Tavily key it looks things up in a closed list of aviation sources and tells you where the answer came from; check it against the current edition before relying on it.
  • Drills. Steep turns, a level 360, slow flight, straight-and-level, turns around a point, a course reversal and a holding pattern. Start one by voice or from Plugins › Roger ATC AI › Instructor: it briefs it, corrects you while you fly it and scores you at the end.
  • Its memory is yours. Ask it to remember something and it writes it, one note per line, in Documents/RogerATC/instructor-memory.txt, a text file you can edit by hand.

Take-off briefing and debriefing

Say "give me the take-off briefing" (or "…IFR") and the copilot gives it in order: taxi to the runway in use, the tower, the take-off roll with engine parameters and airspeed alive, rotation and climb speeds, flaps up, the departure turn and the emergencies — abort on the roll, land ahead with runway remaining, no more than 45° without it, and the turn back only above your minimum height. Every figure comes from the simulator, your flight plan and your aircraft in Copilot EFB; anything not entered is said as missing, never invented.

  • Say the briefing yourself and the copilot checks it item by item: what is right, what is wrong with the correct value and its source, and what you left out.
  • Debriefing. Offered once as you taxi in after landing; you can also ask ("debriefing", "how did I fly?"). Safety first, then caution, technique and what went well, each with its figure. It is saved with the session in Copilot EFB. If you study in the EFB's aviation theory course, it ends with up to two lessons that explain what to work on, and only ever names lessons your course has.
  • Warnings in time. Parking brake or flaps on the take-off roll, transponder off, the wrong frequency, gear down at 1,000 ft, a level or heading bust: the warning goes ahead of anything waiting, never over the controller or you.
  • Enter V1 (multi-engine), the flap retraction height and your minimum turn-back height on your aircraft in Copilot EFB; without the last one 800 ft above the runway is used, and the briefing says so.

It makes radio calls for you

Ask the instructor on the intercom, in your own words, to talk to the tower or ground — "tell them we're ready", "ask to go to San Fernando", "say we'd like three thousand" — and it works out what you mean and makes the call on the radio, in its own voice, with correct phraseology and the details a controller needs: your aircraft type on first contact, the ATIS letter, your distance and direction from the field, your altitude, your destination. Then it stays on the frequency: it reads back, repeats if asked, reports its position, says "wilco", and passes you the questions only you can answer — "The tower's asking… what do I tell them?". Key COM1 yourself, or say "I have the radio", and it hands the radio back.

In English
PILOT       [intercom] Tell ground we're off to San Fernando.
INSTRUCTOR  [radio] Morón Ground, Lima Victor Alfa Bravo Charlie, Cessna 172,
            on the apron, information Bravo, request taxi,
            destination San Fernando.
ATC         Lima Victor Alfa Bravo Charlie, taxi to holding point runway zero two
            via Alfa.
INSTRUCTOR  [radio] Taxi to holding point runway zero two via Alfa,
            Lima Victor Alfa Bravo Charlie.
In Spanish
PILOTO      [intercomunicador] Avísale a superficie que salimos para San Fernando.
INSTRUCTOR  [radio] Morón Superficie, Lima Victor Alfa Bravo Charlie, Cessna 172,
            en plataforma, con información Bravo, solicito rodaje,
            con destino San Fernando.
ATC         Lima Victor Alfa Bravo Charlie, ruede a punto de espera de pista cero dos
            por Alfa.
INSTRUCTOR  [radio] Rodamos a punto de espera de pista cero dos vía Alfa,
            Lima Victor Alfa Bravo Charlie.
  • Twenty-one calls: a radio check, start-up, taxi, ready for departure, a clearance to a destination, inbound, downwind, final, a position report, a level change, touch-and-go, runway vacated, crossing a runway, crossing a zone, closing your flight plan, traffic information, the QNH, the wind, say again, wilco and roger.
  • Written phraseology, as with the controller. The AI only works out what you asked for; every word it says on the radio comes from a template, and every place, runway and number in it comes from your own data and the simulator. Emergencies stay yours to declare.
  • It asks rather than refusing. If something the call needs is missing — which runway, which destination — it asks you for it, and your next words are read as the answer.
  • It never touches your radios. If you name a station COM1 is not tuned to, it asks you to switch first, then makes the call.
  • On by default. Switch it off with Instructor makes radio calls in RogerATC Setup.

It calls you by name

Now and then the instructor calls you by your first name: the first word of the name on your Copilot EFB account. To change it, open the Instructor tab in the plugin window, click the name, type and press Enter — or set Your name in RogerATC Setup. The X-Plane window takes plain letters only, so type a name with accents in RogerATC Setup. Your account is not changed.

It reads your EFB messages

When a copilot or the administrator writes to you in Copilot EFB, the instructor tells you once the radio is quiet and reads the unread messages one by one, oldest first. Each one counts as read on every device once you have heard it through, or when you said "skip" while it was playing. They are checked every five minutes. Ask "any messages?" at any time; say "skip" or "stop". Switch it off with Instructor reads my EFB messages in RogerATC Setup or the plugin window's Instructor tab.

Proactive mode

Set the instructor to Proactive and it also speaks up unasked: flap speed, a high sink rate close to the ground, gear up on final, an altimeter that does not match the QNH, a strong crosswind, low fuel, controlled airspace ahead.

Warnings at once, and how to silence them

With the instructor On (the default) it tells you once, at the moment, what matters: the take-off roll with the parking brake set, with the mixture short of full rich below 3,000 ft density altitude (leaning at a high field, as your POH says, is never questioned) or with the trim well away from the take-off setting; a fuel imbalance between the sides; the endurance inside your reserve. It uses your Copilot EFB profile's imbalance limit and reserve when it has them, otherwise a conservative default it names as its own. If you do not want it to speak on its own, choose Quiet in RogerATC Setup or the Instructor tab: it still answers when you call it.

If you get lost

Say "unsure of position" or "lost". The controller assists: a transponder code (7700 only if you declared MAYDAY and had no code), your last known position, heading and altitude, and once your endurance and persons on board; once it has identified you it tells you where you are and the heading to fly to the nearest suitable aerodrome, or your destination when it is close; otherwise a QDM. It keeps you on the frequency until you say "reoriented".

10

IFR by voice: Delivery, Departure and Approach

Where your scenery publishes them, Delivery, Departure and Approach answer on their own frequencies. Delivery reads out your IFR clearance from the plan on file — the destination, the SID your own CIFP publishes for the runway in use, the level, the squawk and the departure frequency. After take-off the tower hands every IFR flight to departure. Approach identifies you, descends you to the altitude the approach publishes and vectors you to final: a base leg, an intercept of thirty degrees at most, the approach clearance, and the tower once you are established.

Illustrative exchange: the procedure, the levels and the frequencies come from your own data, so yours will differ. A heading is never given without your aircraft's magnetic variation, and an approach your CIFP does not publish is never cleared.

In English
PILOT  Aeroparque Delivery, ARG1234, information Bravo, request IFR clearance to Córdoba.
ATC    ARG1234, Aeroparque Delivery, cleared to Córdoba, Tovar One Alfa departure,
       flight planned route, climb via SID to flight level 350, squawk 4521,
       when airborne contact Aeroparque Departure 120.6.
PILOT  Cleared to Córdoba, Tovar One Alfa, flight planned route, climb via SID
       flight level 350, squawk 4521, departure 120.6, ARG1234.
ATC    ARG1234, readback correct.
       ...
PILOT  Aeroparque Departure, ARG1234, passing 2500 climbing.
ATC    ARG1234, Aeroparque Departure, radar contact, climb to flight level 350.
       ...
PILOT  Aeroparque Approach, ARG1234, 5000 descending, information Charlie.
ATC    ARG1234, Aeroparque Approach, radar contact, descend to 2500 feet, QNH 1013,
       vectoring for RNAV approach runway 31.
ATC    ARG1234, turn right heading 115.
ATC    ARG1234, 12 miles from the threshold, turn left heading 245, maintain 2500 feet
       until established, cleared RNAV approach runway 31, report established
       on the final approach course.
ATC    ARG1234, contact Aeroparque Tower 118.85.
In Spanish
PILOTO  Aeroparque Autorizaciones, ARG1234, información Bravo, solicito autorización IFR a Córdoba.
ATC     ARG1234, Aeroparque Autorizaciones, autorizado a Córdoba, salida Tovar Uno Alfa,
        plan de vuelo, ascienda vía SID a nivel de vuelo 350, transpondedor 4521,
        en el aire contacte Aeroparque Salida 120.6.
PILOTO  Autorizado a Córdoba, salida Tovar Uno Alfa, plan de vuelo, vía SID a nivel 350,
        transpondedor 4521, Salida 120.6, ARG1234.
ATC     ARG1234, correcto.
        ...
PILOTO  Aeroparque Salida, ARG1234, pasando 2500 ascendiendo.
ATC     ARG1234, Aeroparque Salida, contacto radar, ascienda para nivel de vuelo 350.
        ...
PILOTO  Aeroparque Aproximación, ARG1234, 5000 descendiendo, información Charlie.
ATC     ARG1234, Aeroparque Aproximación, contacto radar, descienda para 2500 pies,
        QNH 1013, vectores para aproximación RNAV pista 31.
ATC     ARG1234, vire derecha rumbo 115.
ATC     ARG1234, posición 12 millas de la pista, vire izquierda rumbo 245, mantenga
        2500 pies hasta establecido, autorizado aproximación RNAV pista 31,
        notifique establecido en el curso de aproximación final.
ATC     ARG1234, contacte Aeroparque Torre 118.85.

Your plan from SimBrief

In Copilot EFB, Flight plan → Import from SimBrief brings in your latest SimBrief plan on a tap, shows every field and saves it as one of your plans. RogerATC reads it within five minutes: the route with its SID and STAR, the level and, for an airline flight, the call sign — nothing to type in the simulator. Persons on board and field 19 are not in a SimBrief plan; complete them in the EFB before filing.

The ATIS now tells you which approach to expect, and its letter changes only when the weather really changes.

11

IFR practice with Copilot EFB

With the EFB live link on, an instructor — or a friend playing ATC — follows your flight in Copilot EFB and asks the controller for the next instruction of the lesson. You hear it on COM1 from the same controller as everything else, read it back, and the readback is checked.

Set it up

  • In RogerATC Setup, switch EFB live link on. Optionally set EFB sync to Full so the console also shows the radio transcript.
  • Start X-Plane and fly. On a tablet or computer, open Copilot EFB with the same account and go to the RogerATC screen.
  • The aircraft appears on a map that follows it and draws its track, with its altitude, speeds, heading, squawk, COM1 and wind, and a vertical profile over the terrain below; the light reads LIVE while the plugin is reporting.
  • Tap an instruction, check the values (they open filled in from where the aircraft is) and send it. Below, you see whether it was spoken, with the exact words, or refused and why.

What can be asked for

  • Holds with their entry, course reversals, radials, DME arcs, headings, levels, squawk and frequency changes.
  • Approaches by type — ILS, GLS, LOC, VOR, NDB, TACAN, RNAV, RNP, visual and contact — plus circling, vectors to final, and SRA and PAR approaches talked down mile by mile.
  • Missed approaches, SIDs, STARs, direct to a fix and diversions — and VFR circuit work, landing, go-around and the QNH.
A precision radar approach, in English
ATC  LV-GKM, this will be a precision radar approach runway 02, check your minima.
ATC  LV-GKM, six miles from touchdown, slightly left of track, slightly above glide path.
ATC  LV-GKM, four miles from touchdown, check gear down, on track, on glide path.
ATC  LV-GKM, approach completed, if runway not in sight, go around.
The same, in Spanish
ATC  LV-GKM, esta será una aproximación con radar de precisión pista 02, verifique sus mínimos.
ATC  LV-GKM, seis millas del punto de toma de contacto, ligeramente a la izquierda del rumbo,
     ligeramente por encima de la senda de planeo.
ATC  LV-GKM, cuatro millas del punto de toma de contacto, verifique tren abajo, en el rumbo,
     en la senda de planeo.
ATC  LV-GKM, aproximación completada, si no tiene la pista a la vista, ida al aire.

The controller still decides

Every procedure, fix and frequency is looked up in your own X-Plane navigation data. One that is not there is refused with a reason the instructor sees; the controller never substitutes another. Nothing is said while the simulator is paused or during an emergency, and a request not collected within two minutes expires instead of being given late.

12

Instructed transit sessions

A transit session is planned in Copilot EFB (RogerATC → Transit sessions) and flown with RogerATC: the controller gives you one part of the plan, you fly it and report, and it gives you the next. You need the EFB live link on in RogerATC Setup and the session marked Ready in the EFB. In a novice session the instructor explains on the intercom how to fly each part the tower gives.

How it runs on the radio

  • Call for the transit. Nothing is said until you call: ask for the clearance or the transit, make your first contact in the air or, on the ground, say you are ready to copy. The controller gives you the first step.
  • Read back what you are cleared, as always; the readback is checked.
  • Fly the part and report what it asked for: “established”, “in the hold”, “one lap complete”, “level”, “turn complete”, field in sight or your position. Some steps end on their own by measurement: airborne at 400 ft, on the runway below 40 kt, parked.
  • The controller answers in one transmission: “roger”, the next part and what to report next.
  • The instructor briefs the manoeuvres on the intercom. You can ask it anything at any time: it knows which step you are flying and which comes next.
  • A step your navigation data cannot fly — a procedure that is not in your CIFP, for example — is refused with its reason, and the session goes on to the next.

Emergencies and position requests

If you chose them for the session, at random moments — never on the runway and never in the last two minutes of an approach — the controller asks for your position, and RogerATC writes one of the chosen emergencies into the simulator: a real failure, or a change of wind, turbulence or visibility. The session waits until you declare it and deal with it; an engine failure in a single ends the session, on the ground. One can also be injected from the EFB at any moment.

From the EFB

The EFB's RogerATC screen shows the step being flown and what is awaited, and can skip the step or end the session. If X-Plane closes halfway, RogerATC resumes the session from the step it had reached when you open it again.

Everything RogerATC changed in the simulator — failures and weather — is restored when the session ends, whether completed, ended from the EFB, with the plugin disabled or when X-Plane quits. This is simulator practice: not an approved training device.

13

What RogerATC sends to Copilot EFB, and what never leaves your computer

Every time it starts

RogerATC checks your account with Copilot EFB, sending a random identifier for this installation, the RogerATC, operating system and X-Plane versions, and a few settings (language, region, language model, instructor, traffic, data source, EFB options). Then it fetches your provider keys over an encrypted connection. If Copilot EFB cannot be reached, it keeps working for up to 14 days since the last successful check, with a copy of your keys kept in your system's keychain or Credential Manager.

After every session

RogerATC always sends a session summary to your own Copilot EFB account, where you and the service's administrators can see your plugin usage:

LevelWhat is sent
Statistics (always)Times, versions, language and region, your aircraft's registration and type, the aerodromes visited, and counts: transmissions, say-agains, readbacks right and wrong, emergencies, response times; and how much each AI model was asked to do — requests, tokens, seconds of audio — so the EFB can estimate what your keys spend.
Full (optional)All of the above, plus up to two hundred trimmed lines of what was heard and what was said.

If you are offline the summary waits on disk and is sent later. A session you delete in the EFB is deleted on every device.

Only if you switch them on

  • EFB live link: every few seconds, your aircraft's current position and state — altitude, speeds, heading, altimeter setting, the height of the terrain below, the winds aloft, both radios, the transponder code and mode, fuel, flaps, gear and autopilot — the aerodrome, the runway in use and the simulator traffic near you. Each report replaces the last and the server forgets it ten minutes later: a position, never a track. The track on the EFB's map is drawn by that device from the reports it received, and stays there only for the session.
  • Data source Both or EFB: RogerATC reads your filed flight plan, your aircraft profile and your aerodrome cards' frequencies from your account.
  • Your G1000 route: with any data source, the tower knows the route loaded in the aircraft's navigator (G1000, GNS or FMS) and takes it as your filed plan. If your account holds a plan for the same flight, it uses that one, with all its details.

What never leaves your computer for us

  • Your voice. Audio goes from your computer straight to OpenAI on your key, for recognition. It never passes through our servers and is never sent to Copilot EFB.
  • Navigation data. Your X-Plane navigation data is licensed to you and is read where it is. It is never uploaded, and no runway, frequency or navaid list is ever sent. Transcripts are the words spoken on the radio, so they can contain names the controller said — taxiways, stands, runways — but no navigation data file or extract ever leaves your computer.
  • Your keys are sent only to the provider that issued them. Copilot EFB records which key names were fetched and when, never their values.

Other services — NOAA, Windy, openAIP, Flightradar24, Tavily — are contacted only for what you enabled, with your own keys. adsb.lol, for real-world traffic, needs no key and is asked only with your position, to find the aircraft around it. Session records and logs stay on your computer:

macOS
~/Library/Application Support/RogerATC
Windows
%APPDATA%\RogerATC
14

Updating

RogerATC checks for a new version every time it starts — in X-Plane and when you open RogerATC Setup. When there is one, X-Plane shows a notice with Update and Later, and RogerATC Setup shows Update now. Either way, Setup downloads the new version, checks that it is exactly the file published on rogeratc.app, installs it and restarts. Later hides the notice until tomorrow; Help & logs › Check for updates looks again at any time.

  • Click Update in X-Plane (or Update now in RogerATC Setup).
  • If X-Plane is open, RogerATC Setup says Close X-Plane to finish updating RogerATC and updates the plugin as soon as X-Plane quits. It never touches the plugin while X-Plane runs.
  • When it says RogerATC <version> is ready, start X-Plane.

If the update cannot replace RogerATC Setup where it is (for example, an Applications folder you cannot write to), it opens the new version in Finder: drag RogerATC Setup onto Applications and replace the old one. You can always install by hand: download the installer from this site and run it over the old one (macOS: drag to Applications; Windows: run the .exe). Your settings, your linked account and your session records are kept.

15

Uninstalling

macOS

  • Close X-Plane, open RogerATC Setup and click Uninstall. This removes the plugin folder from X-Plane.
  • Drag RogerATC Setup from Applications to the Trash.

Windows

Open Settings → Apps → Installed apps, find RogerATC and choose Uninstall. It asks whether to remove the plugin from X-Plane as well.

Removing everything

Your settings, session records and stored keys are kept on purpose, so a reinstall does not lose them. To remove them too, delete the RogerATC support folder shown under What RogerATC sends above and the RogerATC folder in your Documents (the instructor's memory). Then remove the stored keys: on macOS, open Keychain Access and delete the items named ai.rogeratc; on Windows, open Credential Manager → Windows Credentials and remove the entries starting with ai.rogeratc.

16

Troubleshooting

"Link your Copilot EFB account in RogerATC Setup"

The plugin has no valid key, or the key was rotated in the EFB. Open RogerATC Setup, paste the current key from Settings → API access in Copilot EFB, link it, and restart X-Plane. If the account has been paused, the message stays until it is resumed.

"RogerATC needs to reach Copilot EFB once every 14 days"

Connect to the internet and restart X-Plane. One successful check unlocks it for another 14 days.

The controller does not answer

  • Check the push-to-talk key is bound to the RogerATC command and that you hold it while speaking.
  • Check the microphone permission (see the installation sections) and that your headset is the system's input device.
  • Check COM1 is tuned to a frequency of the aerodrome. On the wrong one, the station tells you which frequency to use.
  • Open Plugins › Roger ATC AI › Diagnostics: it shows whether RogerATC is running and why not.
  • If you fly on VATSIM with xPilot connected, RogerATC stays out of the way on purpose and tells you so.

It hears me but never answers, or the voice is missing

Your OpenAI key is missing, wrong or out of credit. Check it in Copilot EFB → Settings → Keys used by RogerATC and your balance on OpenAI's platform, then restart X-Plane: keys are fetched when the plugin starts.

It keeps saying "say again"

Use a headset, say your call sign, say designators instead of spelling them, and stay in the language you chose. If a taxiway or runway is not in your scenery, the controller will not accept it — check the aerodrome in X-Plane's map.

Setup does not find X-Plane, or will not install

Start X-Plane 12 once so it records where it is installed, then reopen Setup, or point Setup to your X-Plane folder yourself. Installing, updating and uninstalling only work with X-Plane closed.

Where the logs are

Click Open the logs folder in RogerATC Setup, or open the support folder shown under What RogerATC sends above. The sessions folder holds one record per flight (the twenty most recent are kept); attach the latest one when you report a problem.

17

For simulation and practice only

RogerATC is for flight simulation and radio communication practice. It is not an approved training device and does not replace certified flight instruction. Its phraseology is built from published sources, but real procedures vary by country, aerodrome and controller: in a real aircraft, follow your instructor, the official publications and the instructions of real ATC.