macbookandrew

<p>Displays the current YouTube live video from a specified channel via the shortcode <code>[youtube_live]</code>.</p>
<h4>Setup Notes</h4>
<p>Your YouTube livestream must be set to “Public” or it will not work. This is a security feature of YouTube’s API and unfortunately there’s no way to work around it.</p>
<p>In addition, your live stream must be set to allow embedding on third-party sites. If that feature is unavailable, you may need to <a href="https://www.youtube.com/account_monetization" rel="nofollow ugc">enable monetization</a> for your account. See YouTube documentation for more information or help with allowing embedding.</p>
<h4>How It Works</h4>
<p>If no live video is available, you can display a specified video or a “channel player” showing all your recent videos.</p>
<p>You can also enable auto-refresh to automatically check for a live video every 30 seconds (warning: will increase server load, so use with caution).</p>
<p>By default, the server will check YouTube’s API and then cache that response for 15 minutes before checking the API again (you may change this value in the admin settings). If auto-refresh is enabled, clients will check against your server every 30 seconds and likely will hit that cache as well, so it can potentially take up to 16 minutes before a client will get a live video.</p>
<p>The length of both caches can be changed using the <code>wp_youtube_live_transient_timeout</code> filter (see below for more information).</p>
<p>If no live video is available when a page is loaded, several fallback options are available:</p>
<ul>
<li>“Show a custom HTML message” allows you to specify a custom message to show</li>
<li>“Show scheduled live videos” will show a player and countdown until your next live video</li>
<li>“Show last completed live video” will show your most recently-completed live video</li>
<li>“Show recent videos from my channel” will show a playlist of recent videos from your channel</li>
<li>“Show a specified playlist” will show a specified playlist</li>
<li>“Show a specified video” will show a specified video</li>
<li>“Show nothing at all” will show nothing at all</li>
</ul>
<p>When a video ends, users’ browsers will check your server again to see if a live video is available. If so, it will load that; if not, it will fall back as set in your options.</p>
<h4>Shortcode Options</h4>
<ul>
<li><code>width</code>: player width in pixels; defaults to what you set on the settings page</li>
<li><code>height</code>: player height in pixels; defaults to what you set on the settings page</li>
<li><code>autoplay</code>: whether or not to start playing immediately on load; defaults to false</li>
<li><code>auto_refresh</code>: (either <code>true</code> or <code>false</code>) overrides the auto-refresh setting on the settings page</li>
<li><code>fallback_behavior</code>: choose from the following: <code>upcoming</code>, <code>completed</code>, <code>channel</code>, <code>playlist</code>, <code>video</code>, <code>message</code>, <code>no_message</code>
<ul>
<li><code>upcoming</code>: the next upcoming scheduled video on the specified channel</li>
<li><code>playlist</code>: a specified playlist (shortcode must also include the <code>fallback_playlist</code> attribute)</li>
<li><code>video</code>: a specified video (shortcode must also include the <code>fallback_video</code> attribute)</li>
<li><code>message</code>: a specified message</li>
<li><code>no_message</code>: nothing at all</li>
</ul>
</li>
<li><code>fallback_playlist</code>: a playlist URL to show when there are no live videos</li>
<li><code>fallback_video</code>: a video URL to show when there are no live videos</li>
<li><code>fallback_message</code>: a message to show when there are no live videos</li>
<li><code>js_only</code>: (either <code>true</code> or <code>false</code>) workaround for some caching issues; if a caching plugin (W3 Total Cache, WP Super Cache, etc.) or proxy (CloudFlare, etc.) caches the HTML while a video is live, visitors may continue to see an old live video even if it has ended. If set <code>js_only</code> is set to <code>true</code>, the server never displays the player code in the initial request and instead sends it in response to uncached ajax requests. This may also result in the video player being slightly delayed on page load due to the extra request, depending on the clients’ bandwidth and latency.</li>
</ul>
<p>Example shortcode: <code>[youtube_live width="720" height="360" autoplay="true"]</code></p>
<h4>Filters</h4>
<p>The filter <code>wp_youtube_live_no_stream_available</code> will customize the message viewers see if there is no live stream currently playing, and takes effect <strong>after</strong> the <code>fallback_message</code> shortcode attribute is parsed (if <code>fallback_message="no_message"</code> is set in a shortcode, it will override the filter). For example, add this to your theme’s <code>functions.php</code> file:</p>
<pre><code>add_filter( 'wp_youtube_live_no_stream_available', 'my_ytl_custom_message' );
function my_ytl_custom_message( $message ) {
    $message = '<p>Please check back later or subscribe to <a target="_blank" href="https://youtube.com/channel/UCH…">our YouTube channel</a>.</p>
    <p><button type="button" class="button" id="check-again">Check again</button><span class="spinner" style="display:none;"></span></p>';
    return $message;
}
</code></pre>
<p>The filter <code>wp_youtube_live_transient_timeout</code> is available to customize the cache timeout length in seconds. For example, add this to your theme’s <code>functions.php</code> file to set the cache length to 15 seconds instead of the default 900:</p>
<pre><code>add_filter( 'wp_youtube_live_transient_timeout', 'my_ytl_custom_timeout' );
function my_ytl_custom_timeout( $timeout ) {
    return 15;
}
</code></pre>
<h4>Event Listener</h4>
<p>When a live stream is loaded, the <code>wpYouTubeLiveStarted</code> event is fired; you can use this to create custom front-end features on your site by adding an event listener:</p>
<pre><code>window.addEventListener('wpYouTubeLiveStarted', function() {
    /* your code here */
    console.log('stream started');
    /* your code here */
});
</code></pre>
<p>Development of this plugin is done on <a href="https://github.com/macbookandrew/wp-youtube-live/" rel="nofollow ugc">GitHub</a>. Pull requests are always welcome.</p>


WP YouTube Live

This plugin worked great for me for streaming my youtube live video.

I appreciated the error messages that were displayed when I initially had used wrong info.

Great for simple Channel streaming

I needed a plugin to show a livestream if there was one live, and otherwise to just show the most recent video. using it for a church website.

Did exactly what I needed


Would really be a great plugin just wondering why it keeps throwing the debugging log even when you disable it, the size options for the channels also do not work, wondering if this is because am using it in a pagebuilder or its a plugin issue


Needs an update

Displays the current YouTube live video from a specified channel.

Santiago Jiménez H.

<p>Radio Player Page <strong>provides dedicated, standalone player pages</strong> for your radio broadcasts on WordPress. It lets you create a full weekly radio schedule, manage your broadcasts, and present everything on pages designed for reliable playback without theme conflicts.</p>
<h4>The Power of Standalone Player Pages</h4>
<ul>
<li><strong>Standalone Player Pages</strong> – Each station lives on its own independent HTML page, completely bypassing your WordPress theme. This ensures <strong>zero theme conflicts, optimal performance, and one clear URL</strong> per station.</li>
<li><strong>Full Radio Scheduling</strong> – Create a weekly lineup with named radio shows and optional logos. The player intelligently displays the current and next radio show, with timezone-aware calculations and overlap prevention.</li>
<li><strong>Universal Stream Compatibility</strong> – Works seamlessly with Icecast, Shoutcast, HLS (.m3u8), DASH (.mpd), and MP3 streams. Automatic protocol detection with native iOS Safari support for HLS.</li>
</ul>
<h4>Broadcast Management</h4>
<ul>
<li><strong>Multi-Station Control</strong> – Manage multiple independent stations from a single WordPress installation, each with its own stream, schedule, and branding.</li>
<li><strong>Broadcast Timezone Clock</strong> – Keep a global audience informed. When your station’s timezone differs from the listener’s, a discreet clock shows the station’s local time and the offset.</li>
<li><strong>Media Session API</strong> – Professional integration with device lock screens and media controls, displaying station art and info.</li>
<li><strong>Radio Schedule Block</strong> – Add a Gutenberg block (Block Editor) to any post or page to display the full weekly radio schedule for a selected station. Design is controlled by the editor and theme (Block Supports, theme.json).</li>
<li><strong>Radio Shows List Block</strong> – Add a Gutenberg block to list all radio shows for a selected station, with optional image, extended description, and broadcast schedule.</li>
</ul>
<h4>Listener Experience</h4>
<ul>
<li><strong>Informed Listening</strong> – The player clearly shows <strong>what’s on air now and what’s coming next</strong>.</li>
<li><strong>Visual Customization</strong> – Choose from 8 color themes and 4 real-time audio visualizers (powered by Web Audio API) to match your station’s brand.</li>
<li><strong>Station Branding</strong> – Upload custom background images and logos for each station.</li>
<li><strong>Convenience Features</strong> – Sleep timer, responsive design, and social sharing meta tags for rich link previews.</li>
</ul>
<p><strong>Built for Modern Web Performance</strong><br />
The player is a self-contained application built with <strong>React 19, TypeScript, and Vite</strong>, ensuring a fast, accessible, and maintainable experience. It uses manifest-based asset loading for seamless updates.</p>


Radio Player Page

Dedicated player pages for your radio stations, with scheduling and continuous playback.

WP YouTube Live vs Radio Player Page