Server Addon YouTube

Server Addon: YouTube

Description

Sermons hosted on a YouTube channel.

When to choose it: Most churches already on YouTube. Saves your bandwidth and gives visitors a familiar player.

How to Access

Components → Proclaim → Servers → New, then choose YouTube in the server type picker.

Note

The server type cannot be changed after the server is created. To switch platforms later, create a new server and move media across with Administration → Server Migration.

What you get at each level

Credentials are optional. YouTube works with none at all — they expand what Proclaim can do.

Level	You supply	You get
1	Nothing	Paste a video URL; it embeds and plays
2	API key	Browse your channel, pull titles and descriptions in, play statistics
3	OAuth client ID and secret	Push descriptions and titles back, download captions, playlist write-back, create live broadcasts

Description push is offered on the analytics drill-down once OAuth is connected and daily quota remains — both are checked before the option appears, so an unconfigured server simply does not show it.

Important

Level 3 is the only level that changes anything on your YouTube account. Levels 1 and 2 are read-only.

Set Up the Server

1. Choose YouTube as the type, give the server a name, and Save & Close.

That is a working YouTube server. Paste a video URL onto a media file and it plays. Everything below is optional.

Optional — add an API key

Worth doing if you want to browse your channel from inside Proclaim rather than copying URLs, and to see play statistics.

1. In the Google Cloud Console, create a project and enable YouTube Data API v3.
2. Under APIs & Services → Credentials, create an API key. Paste it into YouTube API Key.
3. Enter your Channel ID so Proclaim knows which channel to browse.
4. Select Test API Connection and confirm it succeeds before going further.
5. Save & Close.

Important

Daily Quota defaults to 10,000 units, which is what Google gives a new key. Front-end live-status polling and the stats task share that budget. If YouTube data stops updating partway through a day, this is almost always why — check Administration → YouTube Status.

Optional — add OAuth for write access

1. In the same Credentials screen, create an OAuth client ID of type Web application.
2. Set the authorised redirect URI as shown in the OAuth Credentials note on the form.
3. Paste the Client ID and Client Secret, save, then complete the connection. Connection Status shows where you stand.

Optional — live streaming

How do you stream to YouTube? decides how much Proclaim does:

• Direct — your encoder (OBS, or hardware) streams straight to YouTube, and Proclaim can create and manage the broadcasts.
• External — a restreaming service such as Resi or Restream creates the broadcast, and Proclaim follows along.

Set Default Broadcast Privacy and whether to go live when the encoder starts to match how your service runs.

Add a Media File

1. On the message, select Add Media File and choose this server.
2. Paste the video URL, or select Browse to pick from your channel — browsing needs the API key.
3. Adjust playback options if you want: start and end time, mute, loop, captions.
4. Save & Close.

To keep a whole playlist in step with a series automatically, see Help-playlists.

Screen Reference

Fields on the server

Field	What it is for
YouTube API Key	Enter your YouTube Data API v3 key from Google Cloud Console. Required for browsing channel videos.
Channel ID	YouTube channel ID (starts with UC...). Find this in your YouTube channel URL or use YouTube Studio.
Test API Connection	Click to verify your API key and channel ID are configured correctly.
Daily Quota (units)	Your YouTube Data API v3 daily quota limit. Default is 10,000 for new API keys. Both the frontend live-status polling and the platform stats task share this budget.
OAuth Credentials	OAuth 2.0 is required for write operations (sync descriptions, download captions). Create credentials in your Google Cloud Console under APIs & Services > Credentials. Set the Authorized redirect URI to your site admin U
Client ID	OAuth 2.0 Client ID from Google Cloud Console.
Client Secret	OAuth 2.0 Client Secret from Google Cloud Console.
Connection Status	—
How do you stream to YouTube?	Direct: your encoder (OBS, hardware) streams straight to YouTube, and Proclaim can create and manage the live broadcasts. External: a restreaming service (Resi, Restream, etc.) creates the broadcast — Proclaim will never
Default Broadcast Privacy	Privacy for new live broadcasts unless overridden on the media file. Unlisted is the safe default — nothing goes public by surprise.
Go live when the encoder starts	When on, a scheduled broadcast goes live automatically the moment your encoder starts sending — no YouTube Studio visit needed. Leave off if you start the encoder early for sound checks: with auto-start on, that would go
Encoder Connection	What your streaming encoder (OBS, hardware) points at. Provisioned automatically the first time Proclaim creates a live broadcast on this server, then reused for every broadcast — configure the encoder once.
Description Format Template	Template for the video description generated by the Copy Description button. Click the placeholder badges below to insert them at the cursor. Empty placeholders are removed automatically.

Fields on a media file

Field	What it is for
Url of Youtube Video	Use the Youtube URL from the share section or the url in the browser
youtube_browse_btn	—
Create Live Broadcast	Create a scheduled YouTube live broadcast when this media file is saved. Never automatic — only when you switch this on.
Broadcast Privacy	Privacy for this broadcast. Server Default uses the setting from the server's Live Streaming configuration.
Mute	Start the video muted. Required for autoplay in most browsers.
Start Time (seconds)	Start playback at this position in seconds. Useful for skipping intros.
End Time (seconds)	Stop playback at this position in seconds. Useful for clipping segments.
Loop	Loop the video continuously.
Player Controls	Show or hide the YouTube player controls.
Related Videos	When disabled, related videos will come from the same channel only.
Force Captions	Force closed captions to display when available.
Plays Inline (iOS)	Play video inline on iOS instead of fullscreen.

Display settings shared by every addon

Every server type also carries the same block of display settings — player choice, popup behaviour, the media button's text, colour, icon and size, and the image shown beside it. They work the same way whichever addon you pick, and are documented on Help-server and Help-mediafile.

Related Information

• Help-server — the server form in general
• Help-servers — the servers list
• Help-mediafile — the media file form
• Guide-Add-Audio-and-Video — choosing a host and attaching media
• Server-Addons — all sixteen addons compared