Subsection 7.1

7.1 iRacing to YouTube Chapter Markers

Notice: Note: Docs are currently being updated for v1.45.0.

Created Last edited

While you stream on YouTube, TiRST writes down the time each race starts and names it after the car and track. When the stream is over, you paste the list into the video's description and YouTube turns it into chapters, so viewers can jump straight to any race. Open it from Tools → YouTube Chapter Markers in the control panel. Each part of that page has its own section below.

How to use it

  1. Add your channel (once). In Settings → Streaming → YouTube, enter your handle (like @yourchannel) or channel link. Leave Detect when the channel goes live and when it ends ticked; it's on by default.
  2. Go live on YouTube as usual. Within about a minute, TiRST sees the stream and starts timing from YouTube's own start time. Without a channel, press YouTube is live instead.
  3. Race. TiRST adds a chapter at the start of every race, such as 12:41 Race – BMW M2 CS Racing @ Summit Point Raceway. Press Mark chapter (or your keyboard shortcut) for any other moment you want a chapter.
  4. End the stream. TiRST notices when the channel stops being live, or you can press Stream ended.
  5. Copy the list from For the video description and paste it into your video's description on YouTube. YouTube turns it into chapters.

The finished list looks like this:

00:00 Stream start
12:41 Race – BMW M2 CS Racing @ Summit Point Raceway
1:04:09 Race – Mazda MX-5 Cup @ Lime Rock Park

Live detection needs no YouTube account or API key: TiRST checks your channel's public live page once a minute.

Status and stream buttons

The top of the page shows where things stand. The title shows ● Live while a stream is being timed, or Stream ended afterwards. The line below says more:

  • Watching @yourchannel: TiRST is waiting for you to go live, with the time of its last check.
  • Live since …: how far into the stream you are, and whether YouTube found it automatically (with a link to open the stream) or it was started by hand.
  • The stream ran from … to …: the stream is over. Races aren't added until the next stream.
  • Live detection is off or Add your channel: press YouTube is live when you start streaming.
  • Couldn't check YouTube: the automatic check failed, but the buttons still work.

The buttons:

  • YouTube is live: start timing now, for when you don't use live detection. While live, it becomes Restart timer (live now).
  • Set the time I went live…: enter the exact date and time you went live, then Use this time. Handy if you forgot to press the button at the start.
  • Stream ended: stop adding chapters and save a copy of the list.
  • Check YouTube now: check your channel straight away instead of waiting up to a minute.

Starting a new stream after one has ended saves the old list and starts a fresh one.

Add a chapter automatically at

  • Start of qualifying: off by default. Adds a chapter like "Qualifying – car @ track".
  • Start of race: on by default. Adds a chapter like "Race – car @ track" at the green flag.
  • Chapter offset: moves each automatic chapter earlier (−) or later (+), up to 120 seconds either way. For example, −10 starts the race chapter 10 seconds before the green flag. It also applies to chapters already in the list. The default is 0.
  • Also move chapters added with Mark Chapter: applies the offset to your marked chapters too. Off by default.
  • Start the list with 00:00: on by default, since YouTube needs a first chapter at 00:00. First chapter's name is "Stream start" unless you change it.

Mark chapter

🔖 Mark chapter adds a chapter right now, named after the current (or last) car and track and, while you're driving, the lap you're on, such as "Mazda MX-5 Cup @ Lime Rock Park – Lap 7". Use it for a great battle, a crash or anything else worth jumping to.

Keyboard shortcut for Mark chapter: click the box, then press the keys you want to use. Clear removes the shortcut.

  • The shortcut works in any app, even while iRacing is in front.
  • F13 to F24 are a good choice: no keyboard has those keys, so they never clash with anything else.
  • Letters and digits need Ctrl, Alt or Win as well.
  • For a Stream Deck, add a Hotkey action that sends the same keys.

Chapters

The Chapters list shows every chapter for the current stream: its time in the video, its name, and what added it (🏁 race start, ⏱ qualifying or 🔖 marked), with the lap and any offset.

  • Rename a chapter by clicking its name and typing (up to 100 characters).
  • Delete one with ✕.
  • A ⚠ warning appears on a chapter that YouTube won't accept as it is: one that's before the stream started (it's shown at 00:00), or one less than 10 seconds after the previous chapter.

For the video description

This box holds the finished chapter list, ready to paste into YouTube.

  • Copy: copies the list so you can paste it into the video's description.
  • Download chapter list: saves it as youtube-chapters.txt.
  • Clear the list: removes every chapter.

YouTube only shows chapters when the list follows its rules: the first chapter at 00:00, at least 3 chapters, and chapters at least 10 seconds apart. Times over an hour are written like 1:04:09.

TiRST also saves a copy of every stream's list in the data/youtube-chapters folder inside your TiRST folder, so you can find it later.

Checking that it's working

  1. Before you go live, open Tools → YouTube Chapter Markers. The status should say Watching @yourchannel with a recent "last checked" time. If it says Add your channel or Live detection is off, check Settings → Streaming → YouTube.
  2. After you go live, wait a minute or click Check YouTube now. The title should show ● Live and the status Live since … Found on YouTube, with a link to your stream. The bottom bar of the control panel also shows that YouTube is live.
  3. Click Mark chapter (or press your shortcut). A 🔖 chapter should appear in the list with the current time into the stream. Delete it afterwards if you don't need it.
  4. Start a race. At the green flag, a 🏁 race chapter should appear.
  5. Look for ⚠ warnings before you paste the list into YouTube, and make sure there are at least 3 chapters.

If YouTube can't be reached, the status shows Couldn't check YouTube with the reason. Press YouTube is live to time the stream by hand; chapters will still be added.