Iris
Add to Discord
Docs

YouTube

Announce new uploads and live streams from YouTube channels.

Configure YouTube in the dashboard →

Overview#

YouTube notifications announce a new upload minutes after it goes public. Iris checks the channels you are watching every 10 minutes and posts the video where you told it to, with the thumbnail attached.

Watch as many channels as you like. Each one has its own destination channel and its own optional ping role, so your own uploads and a partner channel do not have to share a feed.

The announcement is designed once per platform and reused by every channel you add. Turn the shared design off for one creator and that creator gets an embed of its own.

Live streams are announced separately. They have their own check, their own announcement design and their own per-channel switch, so going live reads as going live rather than as another upload. A stream is never announced twice, which is why it is left out of the upload notification.

Setup#

  1. Open the dashboard and go to Notifications > YouTube.

  2. Design the announcement under Announcement design and save it. This has to exist before a channel can be added.

  3. Customise the Live stream announcement if you want one of your own. The built-in wording is used until you do.

  4. Press Add notification.

  5. Enter the Channel name, the handle from the channel URL after youtube.com/@. A full URL or a channel id also works.

  6. Pick the channel it Posts to.

  7. Leave Announce live streams on, or turn it off for a channel whose streams you do not want announced.

  8. Under Advanced settings, set a Ping role and pick which video types to announce.

Settings#

SettingTypeDefaultWhat it does
Embed titleText{title}Heading of the announcement. Part of the shared design.
Embed descriptionText**{channel}** uploaded a new videoBody of the announcement.
Embed footerTextNoneSmall line at the foot.
Large image URLTextNoneImage below the text. The video thumbnail is attached on its own.
Thumbnail URLTextNoneSmall image in the top right.
Channel nameText-The handle after youtube.com/@. One entry per channel watched.
Posts toChannel-Where this channel announces. Set per entry.
Use the announcement designToggleOnReuse the shared design. Off gives this creator its own embed.
Ping roleRoleNo pingMentioned at the start of every notification for this channel.
Notify for these video typesListBothShorts and videos. Clear one to stop announcing it.
Announce live streamsToggleOnPost the live stream announcement when this channel starts streaming. Set per entry.
Live stream announcementEmbedBuilt-in wordingThe design used when a channel goes live, separate from the upload design. Defaults to {title} as the heading and **{channel}** is now live on YouTube as the body, with the stream thumbnail attached.

Variables#

The same three tokens work in both designs. In the live announcement {title} is the stream title and {url} links to the stream.

VariableBecomes
{channel}The YouTube channel name
{title}The video or stream title
{url}A link to the video or stream

Commands#

  • /alerts Manage platform alerts for this server from chat. Manage Server
  • .youtube live <channel> <on|off> Turn live stream announcements on or off for one watched channel. Manage Server
  • .youtube help Add, list and remove watched channels from chat. Manage Server

Permissions#

PermissionWhy Iris needs it
View ChannelsSees the channel announcements post to.
Send MessagesPosts the announcement.
Embed LinksThe announcement is an embed.
Mention EveryoneOnly if your ping role is not mentionable on its own.

What it looks like#

I
Iris APP Today at 11:22 PM

@Uploads

I rebuilt my entire setup in a weekend

Channel Name uploaded a new video

Video thumbnail
A new upload, announced with the shared design.

Tips and gotchas#

The channel was not found.

Use the handle exactly as it appears after youtube.com/@, with no spaces. A full channel URL or the channel id works too.

How quickly does it post?

Within about 10 minutes of the video going public, which is how often Iris checks.

Can two channels post to the same place?

Yes. Each entry has its own destination, and several can share one.

Nothing has posted at all.

Check the announcement design has been saved once, and that Iris can send and embed in the destination channel.