Getting Started with MediaBlaster
MediaBlaster turns your WordPress site into a media publishing platform. You manage movies, short videos, series, episodes, and podcasts as custom post types, then deliver them to HTML5 players on your website, podcast apps via RSS, and connected devices through the REST API and IPTV-style JSON feeds.
What you need
- WordPress 6.3 or newer
- PHP 7.4 or newer
- Video files hosted on a CDN or platform that provides direct HLS or MP4 URLs (Vimeo Pro/Business import is available when Enable Vimeo Integration is on in General Settings)
- Administrator access to configure plugin settings
First-time setup checklist
- Enable post types — Go to MediaBlaster → General Settings and turn on the content types you need (Movies, Short-form Videos, Series). See General Settings.
- Add video content — Create posts under Movies, Short Videos, Episodes, or Series. Fill in the Video Data metabox with media URL, duration, and metadata. See Video Data metabox.
- Connect Vimeo (optional) — Enable Vimeo Integration on General Settings, then connect under Integrations and import via the post editor or Mass Import. See Vimeo OAuth.
- Enable Podcasts (optional) — Turn on Enable Podcasts in General Settings to add Podcast Shows and Episodes, RSS feeds, and public pages. See Podcasts Overview.
Typical workflows
Publish a single video manually
- Create a Movie or Short Video post.
- Enter title, description, and featured image.
- In Video Data, set the Media URL (HLS
.m3u8or MP4), Duration, and Quality. - Save and preview with the
[tv-video-player]shortcode on a page. See Shortcodes.
Import from Vimeo
Requires Enable Vimeo Integration on General Settings.
- Connect Vimeo under MediaBlaster → Integrations.
- Configure import preferences under Vimeo Settings.
- Use Load Video Data on a post, or bulk-import via Vimeo Mass Import (select videos → Review & Import). See Vimeo Mass Import.
Enable subscriptions (optional)
Subscriptions are hidden until you opt in via wp-config.php:
- Add
define( 'WPST_SUBSCRIPTIONS_ENABLED', true );towp-config.phpand reload wp-admin. - Open MediaBlaster → Subscriptions to configure tiers, access groups, and Stripe.
- Subscription guides appear under MediaBlaster → Docs once enabled.
- Add
[wpst_subscribe]and[wpst_account]pages. See Subscriptions Overview.
Publish podcasts (optional)
Requires Enable Podcasts on General Settings.
- Configure Podcast Settings — public pages and RSS (save and reload after enabling podcasts).
- Create a Podcast Show under Podcasts → Add New Podcast.
- Fill in show metadata, artwork, and enable RSS Enabled for This Show.
- Add episodes via Add New Episode on the show or Podcasts → Podcast Episodes.
- On each episode, set Episode Media (audio upload or direct file URL) so RSS enclosures validate.
- Verify the feed at
/podcast-feed/{show-slug}/. See Podcast RSS.
REST API (3.0.0)
MediaBlaster exposes a JSON API for apps and integrations:
https://YOUR-SITE.com/wp-json/mediablaster/v3
Start with GET that URL for discovery links, then see the REST API section under MediaBlaster → Docs:
- REST API Overview
- Content API and Fields
- Vimeo REST API (when Vimeo is enabled)
- Subscriptions and Apps API (when subscriptions are enabled)
- REST API — Podcasts (when podcasts are enabled)
Important notes
- YouTube is not supported — YouTube does not provide direct stream URLs required for device playback.
- Legacy Roku feed (
/wp-json/tv/roku/) is removed in 3.0.0 — use the REST content API or export tools instead. - Trickplay is deprecated in 3.0.0 — prefer modern caption formats (WebVTT).
Where to get help
Use MediaBlaster → Docs in your WordPress admin for guides organized by settings page and tab. Subscription guides are listed only when WPST_SUBSCRIPTIONS_ENABLED is true. Vimeo guides appear only when Enable Vimeo Integration is on in General Settings. Podcast guides appear only when Enable Podcasts is on. Field-level help tooltips (hover the label or ? icon) appear on subscription settings screens when the module is enabled.