Direct your race broadcast: drivers connect their camera and you decide who to show.
What it is for
DIRECTOR is a panel for broadcasting an iRacing race. Drivers connect their camera from the Suite and you see faces, standings and suggestions of who to show. The output goes to OBS.
You need iRacing on the broadcasting PC, the Suite open and OBS to stream.
How to open it
In the Suite menu, PIT group, click DIRECTOR and then OPEN.
Choose: I'm a driver, to go on air, or Create room, to broadcast a race.
If you are a driver
Open iRacing and join the session. Your name and number are read automatically.
Click I'm a driver.
Check your face in Your camera and leave Camera and Microphone on.
Type the six-letter Code you were given and click Connect.
Look at the sign: YOU ARE ON AIR means you are being seen. CONNECTED · NO VIDEO YET means not yet.
Cut stops the stream whenever you want. To change camera or mic, cut first.
If you broadcast: the room
A room is a race, with a code for the drivers.
Click Create room.
Put the name in Race.
Choose the Duration, with eight hours as the ceiling.
Choose the data cap: 10 GB for a short race, 30 GB is normal, 60 GB for endurance.
Check the Organiser key.
Tick the option to stream your own camera if you are racing too.
Click Create and share the code on Discord.
When the data cap or the closing time is reached, the cameras close by themselves. During the race you have drivers inside, live cameras, data used, time to closing, + 1 HOUR and CLOSE ROOM.
The director panel
On air: the camera of the car the simulator is showing.
The race: the standings by class. Each row says whether the driver has a camera: no, LIVE or NO SIGNAL. Click a row to cut to that car.
What to show: ranked suggestions. CERTAIN comes from the simulator; LIKELY comes from real data with a threshold.
At the bottom: engine, simulator, video, cars, classes, cameras and race data. The data figure turns amber and then red near the cap.
AUTOMATIC and MANUAL: who cuts. In automatic, clicking a row holds it for a few seconds.
Leader, Battle, Your car and General: quick shots. With a car number and GO you jump to that one.
Why it cuts here explains the last cut.
Going live
In OBS, copy the OBS OUTPUT link with COPY.
In OBS, add a 1920×1080 browser source with that link.
Leave off "Shutdown source when not visible" and "Refresh browser when scene becomes active". Otherwise the video cuts when you change scene.
Notices gives you the race notices line and OBS templates gives you the screen designs.
Common problems
"I need iRacing open": your name and number come from there.
"The code is six letters" or the code does not exist: ask for the code again.
Another program is using your camera: close it and try again.
No camera permission: grant it when asked.
NO SIGNAL on a row: that driver has not reported for a while.
"The data cap has been reached": the room no longer lets anyone back in. Create another with more data.
The simulator did not change camera: the cut is undone and it tells you. Check iRacing is open as a spectator.
Full reference
Every option, text and notice of the app, with its real name.
Looking for cameras
Looking for microphones
Checking
No camera found
No microphone found
Camera …
Microphone …
Couldn't get in TEST MODE · …. Connected to the gatekeeper, but NO video is being sent.
TEST MODE · data used … of … MB. No video yet.
No name
No data
… s ago
… min ago
(checked … s ago)
COPY
COPIED!
Disconnected · retrying in … s
… · retrying in … s
Video down · reconnecting… Video offline · waiting for it to come back
Couldn't copy
It didn't work
I can't reach the organisers
… h … min
… min
The organiser key: Close the room? All cameras are cut and it can't be reopened.
Create the room Fill this in, hit the button and share the code on Discord.
Race
ASRI · Road America Endurance
Duration
2 hours
4 hours
6 hours
8 hours (the maximum)
Data cap
Organiser key
I'll also broadcast my own camera
Create
Cancel
Live
OBS panel
Cameras & room
OBS templates
Alerts Identify yourself as a driver to go on air
I'm a driver To go on air with your name and your car
Set up a room to broadcast
Create room When you're about to broadcast a race
Engine…
Video…
What's on air right now
AUTOMATIC
MANUAL
LIVE
What's being broadcast
Why it cuts here
No cuts yet
Your most used cameras
Leader
Battle
Your car
Wide shot
Default shot: Leader
Default shot: closest Battle
Car no.… One click here takes over for 15 s, then automatic comes back by itself.
No data yet
Last data …
Data up to date · …
Engine not connected · …
The engine isn't responding · …
Engine connected, no new data · …
DIRECTOR isn't answering · …
WARNING · …
Video: … Video: no data (DIRECTOR isn't answering)
DIRECTOR
← Home
Back to the main screen
No session
On air
The race
What to show Here you'll see the camera of the driver you put on air, as soon as there are cars on track
Pos No.
Driver
Camera
To leader
Waiting for sim data Waiting for something to happen in the race
Engine
Sim
Video REPLAY · iRacing may skip data for cars off track
Cars on track
Classes
Cameras connected
Race data
Waiting for the first heartbeat
All cars
Class …
… · … cars The sim isn't giving the standings yet
Needs iRacing
NO SIGNAL
LIVE
No data now These standings are the last ones that arrived… · the sim isn't sending data
Position … · no. …
Connecting to their camera… This driver has no camera connected
That car has no number: the camera can't be sent to it
Cutting to ………
On air: …
The sim didn't change camera: …
No answer No connection to the sim: the camera didn't move
All quiet right now
Has camera
No camera
Camera dropped: …
This driver's signal is lost
I'M A DRIVER
CREATE ROOM
… drivers · … % of data · …
Checking…
OBS OUTPUT
+ 1 HOUR
CLOSE ROOM
Couldn't extend it
Couldn't close it Careful: … % of this race's data used
The organisers have closed the cameras
I couldn't enter the room: …
No reason given
No room: I can't request cameras
I couldn't show their camera: …
Your room · PL REALIZADOR
Your race's room A room is a race. Fill this in, hit the button and share the code on Discord. That's all.
10 GB · short race, few cameras
30 GB · the usual 60 GB · endurance with many cameras
If the cap is reached, cameras close by themselves and nobody overpays. You'll see it being used here and in the panel.
The one Push & Lift set at install The room is open. This is the code to share on Discord:
Drivers in
Live cameras
Data used
Closes in
Extend one hour
Close the room Your broadcast links, with the code already in:
The director's panel
The OBS output
The alerts line … · the room is open. The code, on Discord:
The room is closed There's no code to dictate with VDO.Ninja: each driver streams on their own link. Type in their car number, hit the button and copy it over on Discord. The «view» link is yours for OBS, which also mounts it with the comp obs --si command.
Share link Type the driver's car number.
Programme · PL REALIZADOR
No camera on air
The cameras are closed
Their camera isn't coming through
Car …
Behind …
… stop
… stops
Final standings
Race alerts
Unconfirmed
A car
CONFIRMED
LIKELY
SUSPECTED
Fastest lap
… just set the fastest lap
Retires
… has retired from the race
Pits in
… pits from position …
… pits from the track
Leaves the pits
… rejoins in position …
… rejoins the track
Off track
… has gone off track
Overtake
Passes
… passes … · now …
… moves up · now …
Lapping
… is lapping …
… is lapping … cars
Closing in
… is closing in · … s
Slow … has lost … s against their best lap
Possible contact … and … lose speed at the same time, very close together
Loses control … suddenly lost speed — may have spun
Stopped on track
… is stopped on track
Yellow flag Yellow flag on track: no overtaking
Restart
Green: the race resumes
Final lap
Final lap of the race
Time is up
The race is running out of time
Official incident
… has … incidents
… has 1 incident
Local yellow
New leader
… has taken the lead of the race
Close battle
… is … s behind the car ahead
Safety car
The safety car is on track
Radio call
… is on the radio
Long stop … stayed … s in the pits · the class average is … s
Class fastest lap
… sets their class's fastest lap
Closing in … could catch the car ahead in … laps · … s
… could catch the car ahead in 1 lap · … s
Yellow ahead
Yellow flag and … just ahead
Stop under yellow
… pits under a yellow flag
Jump start
… gained … places from the grid
Multiclass traffic
… is coming from a faster class
OBS templates · DIRECTOR
← Back to DIRECTOR
Templates for OBS Pick a ready-made screen, paste it into OBS as a Browser Source and you're done — camera, standings, map and flags are already in place, nothing to set up by hand.
Classic Standings and your camera. The combo almost everyone uses.
Complete Standings + map + your camera. The "broadcast" style, the busiest of the three.
Broadcast No camera of your own: big standings, map and flags. For broadcasting other people's race (Role 3).
Minimalist Just the map and your camera. Nothing covers the game — the lightest overlay in the study.
Relative Who's ahead and behind you, instead of the overall standings. For those living their own battle.
Duel The house 1-vs-1 comparator. For races with a clear rival to chase.
Engineer Pedals and fuel. To show how you drive, not just where you are.
Weather & Strategy Weather, fuel and delta. For long races where strategy matters.
Maximum Standings, map, relative, delta and flags — the study's "maximalist" style: everything at once.
Race Pace Lap history and delta. For qualifying sessions or time attack.
Or build your own, piece by piece
Camera and caption only The bare minimum: your race with the camera following the action by itself and the driver's name on screen.
+ Standings Adds the live position table, always visible in a corner.
+ Relative Adds who's ahead and behind you — the reference drivers use most on track.
+ Map Adds the track layout with every car live — widely used in broadcasts.
+ Flags Adds the flag alert when it changes (yellow, red, chequered...).
Add each source in OBS as a "Browser" source, 1920×1080. Leave "Shutdown source when not visible" and "Refresh browser when scene becomes active" unticked — if they stay ticked, the picture cuts out when you switch scenes.
Couldn't read the engine address
PUT IN OBS
One moment…
DONE!
Didn't work
No connection
… template · DIRECTOR
Standings
Relative
Map
Flags
Delta
Weather
Fuel
Pedals
Laps
That code doesn't exist
This race has reached its data cap This race is already over (time ran out)
The organisers have closed this race's cameras
This race is already over
The video service isn't configured
The video service said no
Couldn't talk to the video service
Cloudflare's relay (TURN) said no Cloudflare answered with no relay servers
Couldn't talk to Cloudflare's relay (TURN)
The code is 6 letters and numbers, no spaces or symbols
The code is 6 characters and you typed …
I need your iRacing number. Open the sim and try again
I need your iRacing number. Open the sim
Cameras are closed right now Every camera slot in this race is already taken
Your connection is no longer active
No. … has no live camera right now The organiser key hasn't been set (the double-click file)
That's not the organiser key Give the race a name: it's what the drivers will see
I couldn't come up with a free code
That room is already closed: extending won't reopen it
This room is already at its …-hour maximum: it can't be extended any further
Doesn't exist
Wait a minute between checks
Test room
No service DIRECTOR was opened without a gatekeeper (--portero): joining, cameras and heartbeats can't work. Open it from the Suite.
Test gatekeeper · no real video Fake in-memory gatekeeper (--portero=prueba): no video travels.
The gatekeeper is missing the video keys
The gatekeeper answers, but the two Cloudflare Realtime keys aren't set.
Cameras closed at the gatekeeper The gatekeeper answers, but has the cameras closed (its «abierto» setting).
Gatekeeper online · video unverified
The gatekeeper answers and has its keys set. That doesn't prove video gets through: that's proven when the panel receives a camera.
The gatekeeper answers with error …
The gatekeeper isn't answering
Can't reach the gatekeeper: …
Can't reach the gatekeeper: … I can't find OBS's settings — is it installed?
Couldn't start the OBS helper: …
OBS didn't answer as expected (…)
The engine doesn't serve it
The engine doesn't serve this: …
From outside DIRECTOR was opened without its gatekeeper: that way there can be no video. Open it from the Suite.
Mode must be AUTOMATICO or MANUAL
The car number is missing
The template address is missing
Streamer's manual click The race-event detector has crashed: …
Red flag: wide shot of the race The race-event detector has finished (the Node bridge has died, code …)
The engine couldn't change camera The video connection never got established
The video connection has failed
The gatekeeper said no
A track failed: …
The service returned no answer The video service rejected a track: …
The video service says: … The video service didn't say which channel the video arrives on (…)
Couldn't renegotiate
The room has been closed The car number must be 1 to 8 letters or digits
Usage can't be negative
Usage must be a number
VDO.Ninja · no server of your own The drivers' cameras run on VDO.Ninja links: no gatekeeper and no data usage. The links come from `comp enlaces` and the room.
DIRECTOR was opened without a gatekeeper: no room and no driver cameras (directing and OBS still work). Open it from the Suite or deploy your own gatekeeper with instalar_portero.py.
OBS isn't answering OBS is recording but won't say when it started
I can't find OBS's settings
The data engine isn't answering
Data engine up (version …)
… OBS templates available I can't find the OBS templates in the web folder
You must show the card or the table
The ticker text is missing The ticker is capped at 200 characters
The engine is up but can't see iRacing
IRacing in session (…) IRacing is in a live session, not a replay
IRacing is in a replay, not a race
The gatekeeper isn't healthy Action must be start, stop or status
The table shows 1 to 20 positions
Hide card, table, ticker or all Unknown graphics order: it must be mostrar, ticker, ocultar or auto
The simulator window measures … and the stream is 16:9 (…)
Test gatekeeper (in memory, no real video)
Gatekeeper online Mode must be directo, espectador or repeticion
No gatekeeper, no room: DIRECTOR is open without a gatekeeper, so there's no race to join. Deploy your own (instalar_portero.py) or open it with --portero .
The VDO.Ninja room only exists with the vdoninja provider (`comp usar vdoninja`)
Dorsals must be a list VDO.Ninja cameras are only set up with the vdoninja provider (`comp usar vdoninja`)
No driver links yet: run `comp enlaces --dorsal N` first
Action must be ocultar or mostrar
Action must be mostrar or ocultar
The key is missing
The scene name is missing
The source name is missing
Camaras must be 1, 2 or 3 The template and graphics addresses are missing
Type must be pronto, pausa or final
Seconds must be between 5 and 86400
The waiting-screen address is missing
The alert text is missing
The automatic one is for the card This DIRECTOR runs on VDO.Ninja and has no gatekeeper: cameras go by link (`comp enlaces`) and the room runs locally.
It takes on or off You must ask for instantanea, recorrer, parar, pausa, play, velocidad, buscar or ir_a
Manual click on the panel
Unreadable answer from the engine
No replay was running
From and to can't be negative
To must be greater than from The engine still hasn't said whether the session is a replay
The session is live, not a replay: open the replay you want to walk through in iRacing
Replay walk-through finished
Replay walk-through: … This machine has no user folder (APPDATA): the change can't be saved
Can't reach the engine: … The engine isn't answering the replay (code …)
From and to are in seconds A replay walk-through is already running
Couldn't save the profile in …: …
Prepare
Director settings
After the show
Comp mode
What is coming up
Nothing to cut to right now Open Push and Lift (the Suite): the engine is what reads the sim.
The data is getting old: check that iRacing is still in session.
The detector cannot see the race: restart DIRECTOR from the Suite.
The sim is not obeying cuts: check that iRacing is in session and the source has a camera.
Check Prepare: it says which piece is missing.
Engine down: no data is coming from the sim
Event detector down: the director cannot see the race
The standings are … s old (over …): automatic decides on stale data
The camera is not obeying: … cuts in a row ignored
Live
Spectator
Replay Checks the pieces you need to broadcast and what to do right now.
CHECK AGAIN
READY TO BROADCAST
SOMETHING IS MISSING
Next step:
Gatekeeper
OBS templates
IRacing mode
OK
HEADS-UP
MISSING
PUT IN OBS
SEE TEMPLATES
REFRESH
Scenes
Scene sources
Instant replay and capture
SAVE REPLAY
SEE THE OUTPUT
(no scene)
STREAMING
RECORDING
ON AIR
SWITCH
HIDE
SHOW
OBS has no scenes yet
The active scene has no sources
Replay saved: …
Capture of … saved (… KB): … The numbers the director uses to decide where to cut. Change what you like and hit Save.
SAVE
SAVED
… was not saved: …
You have not changed anything
Factory values
Your values
General
The battle
Priorities
Durations
Variety
Camera per event
Minimum shot (s)
Manual click lasts (s)
Battle starts at (s)
Still alive up to (s)
Opens at (s)
Cold shot (s)
Leader every (s)
Bonus for the leader
Bonus for the podium
Bonus for the points
Rotate camera on
Rotate every (s) Min,max — leave max empty for no cap
Actual, abordo or tv — comma-separated for several
Default shot
Flag
By hand
SAVE AS JSON
Time
Car
Event type
Reason
… cuts
OBS recording since …
No OBS recording Competition broadcast: the drivers share their cameras and you run everybody's feeds.
Chosen platform
The usual one (none) Press Choose to change it; the ones without a button are picked with the CLI comp usar command.
The video platform
The camera room
Room … · … · … drivers · … left No room yet: give it a name and hit Create room.
Links per car number
Car number…
ADD LINK Enter a car number and hit Add link
The driver
Your OBS
… cameras mounted in scene …
Camera status
No camera connected yet
No picture
Poor quality
Chosen
Not yet
Cut
Graphics What goes on screen over the live feed: driver card, standings table and tickers.
On screen
SHOW CARD
How many…
SHOW TABLE
Ticker text…
SEND TICKER
The card
The table
The ticker
HIDE ALL
Automatic card The card appears on its own when the camera shot changes.
TURN ON
TURN OFF
Current state Nothing on screen: no card, no table, no ticker.
Card for …
Table with … positions
Ticker: …
In OBS
ADD TO OBS
Source added to scene … Control iRacing's replay: pause, play, jumps and the instant replay.
Controls
PAUSE
PLAY
Speed
Jumps
START
END
◄ INCIDENT
INCIDENT ►
◄ LAP
LAP ►
Min:sec
Instant replay Goes back a few seconds, shows the event and returns to the live feed.
REPLAY NOW
Fires on its own in automatic mode
Setting: automatic instant replay
Back (s)
Lasts (s)
Max per minute
High priority ≤
Race walk-through Jumps from incident to incident while the director keeps cutting and OBS records, if it is on.
WALK THROUGH
STOP
Running · … jumps
No walk-through running I can't reach the simulator's replay: is iRacing open?
The session is live, not a replay: open the replay you want to watch in iRacing.
Status
Paused
Instant replay running Type the time as min:sec, for example 1:30
Choose The platform could not be changed: the previous one is still in use.
PUSH & LIFT
