Save time by automatically logging YouTube chapter markers during your livestream.

The data will be saved into Notion. This tutorial explains how to conform the Notion data into a format that YouTube can read as Chapter Markers.

Once this connection has been established, you can reliably set-and-forget. Companion will always remember the connection during your livestream logging.

This video tutorial demonstrates the process, and there are written steps below.



1. Connect a Notion “Integration” to a “Parent Page”

  1. Create a free account if you don’t already have one (you can sign up with an email address, or your Google or Apple account)
  2. CREATE AN INTEGRATION: Go to Settings & Members > Connections >” Develop or manage integrations”
  3. Create a new integration
  4. Give the integration any name
  5. Copy the secret key & save to enter into Companion later on
  6. CREATE A PARENT PAGE: Click “New Page” and give it any title:
  7. In the three-dot menu at the top right, choose Add Connection, and select the new integration you just made in the previous step (tip: if it’s not there, try refreshing the page)
  8. Confirm permission for Connection to access the Parent Page and all its child pages.
  9. Copy the last string of characters from the URL of the Parent Page (everything after the page name). Save this to enter into Companion in the next step.

2. Connect Companion to Notion

  1. Open Companion > Connections > Add Connection… search for “notion”, then Add “Notion: Timestamp”
    1. Label: name the connection whatever you like
    2. Notion API Key: Paste the Secret Key from the prior step
    3. Parent Page ID: Paste the last string of characters from the Parent Page’s URL from the prior step.
  2. Save the Connection. The status column should turn to a green checkmark if successful.


3. Create Timestamps during your Livestream (or offline record!)

During your livestream, start a Timestamp session, and capture Notion markers using three different methods:

  1. Manually press a button – create a button and add a Notion marker action. Manually press the button to log that moment. You can download my Free ATEM Switcher profile which contains a MARK button to manually timestamp.
  2. Linked to other Companion actions – markers are created in conjunction with an action. For instance, if you have DJF CUE, each time you advance to the next cue, a marker is automatically created
  3. Automatic Triggers – under the Triggers tab, create a condition whereby if a variable is True, then a Marker is created. For instance, the DJF 4.0 Control profile contains a Trigger that creates a marker every time the H2R Graphics chat variable comes on air, thereby logging when viewer comments are displayed in the livestream.


4. Conform Notion data

Once you have completed your livestream or recording session, and the associated Notion capture session, you need to format the data so YouTube can read it.

  1. In Notion, located the session data (it will be a new child page, under the Parent Page created previously)
  2. Right-click the column header “companionTimeDate” to “Sort Ascending”
  3. Drag the “timestampValue” column to be the first column
  4. Find the first and last marker entries you wish to sync with the YouTube timecode. Click and drag a marquee to select the data in both the “timestampValue” and “message” columns.
  5. Copy the data (Command+C)


4. Re-sync markers in Google Sheets

  1. Open the free read-only Google Sheet DJF CUE 4.0 – Notion Timestamp Conform
  2. Go to File > “Make a copy”… to make an editable copy of the spreadsheet
  3. Paste the Notion data from the previous step into the yellow highlighted box
  4. This is the critical part to sync the Notion timecode to how it appears in YouTube: In your completed livestream on YouTube, move your playhead to find the timecode point that you want to sync with the first selected Notion marker. Make a note of that time in YouTube in H:MM:SS format. In the example below, 0:03:35 is the timecode in YouTube that aligns with the “SHOW START” marker in my Notion log.
  5. Enter that first YouTube timecode duration H:MM:SS into the spreadsheet box with blue text. In the above example, the show started on YouTube at 0:03:35, so this number was used in the blue text box in the spreadsheet.
  6. The yellow fields now show the corrected YouTube timecode. Make any edits you wish to the description field.
  7. Copy the yellow fields (Command+C), and Paste into the YouTube Description field.
  8. Make sure the first entry begins at 0:00:00 (this signifies to YouTube to create chapters)