Features
Every feature of castgate, described one by one.
A description of every feature, grouped by area. For a guided walk through them, see the tutorial.
Sending video (ingest)
- RTMP: from OBS, vMix, Wirecast, ATEM Mini Pro and most hardware encoders. Server address and a personal stream key on the Overview page. H.264 video and AAC audio.
- SRT: the reliable way over poor internet (lost packets are resent). UDP port 9000, the key in the stream ID, optional passphrase. Works with OBS, vMix, Larix, Haivision and the castgate sender.
- Several qualities from the encoder (adaptive bitrate): besides the main key, up to four extra qualities (for example 1080p, 720p, 480p) sent with derived keys; players switch automatically.
- Lower qualities made on the server: on plans that include it, the server makes up to two lower qualities with ffmpeg, on the processor or a graphics card (NVIDIA, Intel, AMD).
- Go live from the browser: camera and microphone of a laptop or phone, no software; needs an https:// address.
- castgate desktop sender (Windows, Mac, Linux): a USB camera or HDMI capture stick to SRT, paired with a code, with a picture and sound check, automatic reconnection, a local backup copy and an optional lower quality.
- Reconnection: if the encoder drops, the same recording continues when it comes back within 90 seconds; viewers keep watching.
- Encoder alerts: the owner is told when the stream drops during a scheduled service.
Watching
- Your page (
/c/your-address): player, announcement, next service with countdown, recordings, chat, giving and website buttons, share buttons (link, Facebook, email, text message), your logo and color. - Player: HLS with adaptive quality, captions (CC), live captions and rewind; plays in every modern browser, on iPhone and Android.
- Rewind (DVR): viewers who join late watch from the start or jump back; the window depends on the plan (2 to 24 hours).
- Embed code: the player on your own website (responsive), also per recording.
- Links for apps and VLC: an HLS address with your playback key, for set-top boxes, IPTV apps and VLC.
- oEmbed: website builders turn your page link into a player when pasted.
- Your own web address (
live.gracechurch.org) with an automatic certificate. - Who may watch: geofencing by country, network and city, and blocked addresses (see Geofencing below).
- Private events: a scheduled event with an access code; the page asks for it.
- HTTP/3 (QUIC): faster start and fewer stalls on phones and busy Wi-Fi.
Schedule
- Events with title, category, speaker and description, once or weekly (local time kept across daylight saving time).
- Countdown on the page and "Next live" in the TV apps.
- Record only scheduled events (or always, or never).
- Replay as live: a recording played at a set time as if live.
- Private events with an access code.
Recordings and videos
- Automatic recording of every stream (or only scheduled events), without re-encoding.
- Editor: trim start and end, cut parts in the middle, undo; nothing is deleted from the original.
- Details: title, date, category, series, speaker, scripture, tags, description, thumbnail (choose a frame).
- Draft, published or private (with a password).
- Uploads: many files at once (up to 20 GB each) with a progress bar; details taken from the file (title, date, artist, description); optional re-encoding.
- Add from a link: direct file links, Dropbox and Google Drive share links, downloaded on the server.
- Qualities: 720p, 480p and 360p made for any recording or upload, aligned with the original.
- Captions: upload WebVTT or SubRip (up to 10 languages), automatic captions from a transcription server, translated captions; kept in step with cuts; listed in the HLS playlist so iPhones, Safari, TV apps and VLC show them.
- MP4 download for viewers (optional per recording) and a re-encoded copy.
- Per-recording links: page, embed code, HLS link, JSON data, feed entry.
- Bulk editing: publish, draft, category, add to the playlist, download on or off, make qualities, delete, for many recordings at once.
- Feeds: RSS (with Media RSS), JSON Feed, an M3U playlist, and a CSV of all recordings.
- Archive limits per plan (archive days, storage), with a clear message when storage is full.
24/7 channel and weekly grid
- 24/7 playout: when nobody is live, the channel plays your playlist, all published recordings or one category (newest, oldest or shuffled). Live takes over by itself; the recordings come back 30 seconds after you stop. Viewers keep watching without reloading.
- Playlist: your own running order, drafts allowed.
- Skip to the next recording.
- Weekly grid: fixed-time blocks per weekday (one recording, a category, the playlist, everything), started on time; the rotation (or nothing) between blocks.
- Program guide: on air now and up next with times and block names, on your page, in the TV apps and at
/api/v1/channels/{address}/guide. - Restream of the 24/7 channel to YouTube and Facebook, like live.
- "Up next" cards (1.3): an optional card of 3-30 seconds before each recording, with the logo, brand color, title and the date and speaker (or your own line); skippable, with a preview on the 24/7 page.
Restream
- YouTube, Facebook and any RTMP or RTMPS destination at the same time, from one upload.
- Status per destination with the last error; automatic reconnection.
- Number of destinations per plan.
Audience (statistics)
- Right now: viewers watching, live or recordings, countries, cities, devices; updates every few seconds.
- Reports for any date range: viewers, unique viewers, returning viewers, hours watched, average minutes, most at once and the channel's all-time record, compared with the previous period.
- Charts: viewers per day, watching at the same time, when they tune in.
- Where: world map (countries shaded, city dots), countries, cities, internet providers (with GeoLite2 databases).
- How: devices (computer, phone, tablet, TV), browsers and apps, where the player was embedded (your website, Facebook...).
- What they watched: live and each recording, with views, unique viewers, hours, average minutes, how much of each recording people watched and how many watched to the end.
- Viewing time: total, average and typical (median) viewing time; how long they stayed.
- 3D charts: a globe with a column per place, and viewers by weekday and hour; both turn with the mouse or a finger and show numbers on hover or tap.
- Audience retention for recordings: how many viewers are still watching at each point of the video.
- Playback quality measured by the web player: time to the first picture (typical and slowest 5%), time spent waiting (rebuffering), viewers who waited, bitrate, picture quality watched, player errors and dropped frames, per internet provider, country and device.
- Peer-to-peer figures (when it is on): share of video from other viewers, video the server did not send, video passed on by viewers, viewers connected to others, relays, per day, provider and country, and the streams being shared right now.
- CSV export of every section and a weekly email report to the owner.
Geofencing (who may watch)
- Per channel: allow only countries, networks (internet providers by ASN) and cities; block countries, networks, cities and addresses. Blocks win over allows.
- Server-wide blocked countries, networks and cities for every channel (administrator).
- Your own message for refused viewers on the page and in the TV apps.
- Check an address: where an address is and which rule lets it in or refuses it.
- Applied to the watch page, embeds, the TV apps, chat, audio, downloads and peer-to-peer. Local network viewers always may watch; without a location database the location rules are not applied.
Peer-to-peer playback
- Viewers in web browsers pass the video to each other over WebRTC, so the server sends each piece of video to fewer viewers. Falls back to the server at once.
- Switched on by the administrator for the server and by each channel for itself.
- STUN and TURN servers set by the administrator; TURN passwords minted per viewer from a coturn shared secret.
- A built-in TURN relay (1.2): no coturn needed. Limits per viewer address and in total, refuses private and own addresses, TLS on 5349 with the site's certificate, live counts, and a self-test that allocates and relays like a browser.
- Joining needs a token issued with the playback session; the geofence, blocks and viewer limits apply. Signaling is limited per address against abuse.
- Live view of every stream being shared (administrator and channel), and peer-to-peer figures in the Audience reports.
Simultaneous viewers and connections
- Viewers at once are counted per channel for every way of watching (web player, TV apps, links, VLC, radio) and limited by the plan; a full channel shows "viewer limit reached".
- Peaks: "most at once" per period, the channel's all-time record, the server's records.
- Connections (administrators): open web (HTTP/1.1, HTTP/2), HTTP/3 and encoder (RTMP, SRT) connections now, the most since start and the record, and the addresses holding the most; a per-address limit (
-max-conns-per-ip, 1000 by default) protects the server.
Chat, prayer and captions
- Chat beside the player: no account needed, a name and a message; open always or only while live; slow mode; blocked words; remove messages; block writers; the church's own messages marked; translation into each viewer's language.
- Chat on TV: the newest messages over the live picture in the TV apps (read only), can be switched off.
- Prayer requests: a form on the page (name and email optional), never shown publicly, an inbox with "Prayed for", email notification, spam protection.
- Live captions: speech turned into captions during the stream (with a transcription server), translated for viewers, saved with the recording.
Podcast and radio
- Podcast feed from your published recordings (all or one category): audio, cover art, author, categories, explicit flag; ready for Apple Podcasts, Spotify and other podcast apps.
- Radio stream: MP3 of the live sound (or the 24/7 channel) for TuneIn, radio apps, smart speakers and VLC, with "now playing" titles; listeners count as viewers.
TV apps
- Roku, Fire TV, Android TV (Google TV) and Fire TV on Vega.
- The castgate app: a directory of channels with search; viewers find a church by name.
- Your own app: your name, logo and color; a Roku package and an Android source kit generated for you, ready to publish in the stores.
- Universal apps for testing: ask for the server address on first start; Fire TV and Android TV APKs for the Downloader app.
- In the apps: Watch live, Watch from the start, Up next, recordings by category with search, read-only chat, captions, giving link, announcement; the church's look changes without an app update.
- Deep links (Roku): a channel, its live stream or one recording.
Settings, team and channels
- Settings: name, about, website, giving link, logo, brand color, announcement, time zone, categories, recording and publishing, directory listing, own web address, viewer restrictions.
- Team: members who stream, edit recordings and see the audience; the owner changes settings, keys and the team.
- Several channels per login (on plans that include them): each a full channel; a channel menu; roles per channel.
- Two-step sign-in with an authenticator app and recovery codes; forgot password by email.
- Getting started: a checklist that ticks itself off, and a step-by-step guide.
Public pages
- Home page with pricing, features and questions, edited by the administrator.
- Explore: live now with live pictures and viewer counts, a featured live channel, events coming up in the next two weeks, the newest recordings and videos, and the listed channels, with search; friendly pages when nothing is live yet.
- Channel pages with the channel's logo, a LIVE badge and viewer count, the next event, a live picture before playing, events coming up, and recordings with their length.
- Help, this feature list, the tutorial and troubleshooting, open to everyone.
Billing
- Sell the plans through a billing site (encrypted.com, or any system that follows the billing integration): checkout links per plan on the home page and on each owner's Billing page.
- Signed webhooks (HMAC-SHA256 with a timestamp, each event applied once) tell castgate about purchases, renewals, plan changes, failed payments, cancellations and refunds.
- Automatic accounts: a new customer gets a one-use sign-up code by email; the account they create is linked to the subscription.
- Automatic access: renewals extend the paid period, plan changes apply at once, failed payments start a grace period and then pause the account, cancellations pause at the end of the paid period, a payment resumes a paused account. Administrators' own suspensions are never lifted by billing.
- Owner Billing page: plan, status, paid until, last payment, manage subscription, change plan.
- Admin → Billing: connection settings, webhook address and shared secret, checkout links, accounts with their billing status, paid sign-ups not yet used, the event log, a test event.
Administration
- Accounts: plans and limits per account, suspend with a reason, open a church's dashboard to help, delete.
- Plans: prices and limits (viewers at once, storage, rewind, archive, destinations, 24/7, server qualities, private events, uploads, channels per login).
- Signup codes with plan, trial, uses and expiry.
- Users: all logins with their channels and two-step status; turn off two-step sign-in for someone who lost their phone.
- TV apps: every church's app settings and downloads.
- Home page editor (texts, features, questions, legal pages, colors).
- Audience for the whole server.
- Settings: site name and address, streaming address (CDN), email (with presets and a test), translation and transcription servers, encoder (processor or graphics card), segment length, weekly reports, required two-step sign-in.
- Blocking: manual and automatic blocking of abusive addresses (wrong passwords, wrong stream keys, floods).
- System: CPU, memory, disk, traffic, simultaneous connections and viewers, setup checks with exact fixes, Prometheus metrics, backup download.
- Audit log of every administrative change.
Server and operations
- One program (Go), no database to install: settings in
store.json, recordings as files. - Automatic certificates (Let's Encrypt) for the site, the streaming address and churches' own domains; HTTPS, HTTP/2 and HTTP/3.
- Graceful restarts: encoders reconnect, recordings continue.
- Daily copies of the settings (14 days), atomic saves, and a guard that pauses new recordings and uploads when the disk is nearly full (administrators are emailed).
- Monitoring at
/metrics; health check at/healthz. - Security: CSRF protection, rate limits, request size limits, security headers (HSTS with real certificates), private files, sign-in throttling, automatic blocking.
- systemd unit with hardening, a log in the journal.
Added in 1.2
- 24/7: where viewers watch: the 24/7 page lists the page link, embed code, stream link, M3U playlist, TV apps and restreams; the Overview shows "24/7" while recordings play.
- Playback figures from the TV apps: Roku, Android TV, Fire TV and Vega report start time, waiting, errors, picture height and (Roku, Android) bitrate, so Audience → Playback quality covers them.
- Remove a channel yourself: owners remove a channel they own (not their last); it stops at once and is deleted after 7 days unless restored.
- Radio as HLS:
/c/{slug}/listen.m3u8, audio-only AAC copied from the live stream (packed audio with ID3 timestamps), for phones, smart speakers and cars.
Added in 1.7.2
- Security audit: a Content-Security-Policy on every page, sign out of all other devices (Security page), a password reset signs out everywhere, and restreaming and imports refuse every internal address. Results in docs/READINESS.md.
- Run in the foreground for testing (
deploy/run-foreground.sh, docs/TESTING.md) and a load-test measurement.
Added in 1.7.1
- One-command install and upgrade (
deploy/install.sh),castgate -preflight(for main and edge servers) and docs/GO-LIVE.md.
Added in 1.7
- Recording storage (S3-compatible): a second copy of every recording in a bucket; optional removal of this server's copy after N days, with playback from the bucket through the server or by signed links; jobs bring files back by themselves; deletes reach the bucket; Test storage; Admin → System status. Signatures checked against AWS's own SDK; tested against an S3 emulator.
- Chromecast and AirPlay on the web player: the TV plays the stream by itself, with its own viewer session.
Added in 1.6
- Downloads that work out of the box: the release's encoder packages are put in place at start;
/downloadoffers the visitor's computer first (Windows, both Macs, Linux) with three steps; an Apps link in the header. - All TV apps on one page with install steps per device; a Roku app set up for this site at
/download/roku.zip. - Broadcast page: viewers minute by minute and the live audience's countries, cities, devices and apps.
- Help Quick start.
Added in 1.5
- Edge servers (
-edge https://main): the same program as a video cache on other machines. Segments are fetched from the main server once per piece (concurrent viewers share the fetch); everything else passes through, so counting, limits, geofencing and sign-in stay central. Admin → System lists the edges with hit rate, traffic and version. - Captions when rewinding: rewind and archive playlists carry the live caption track, for as far back as the plan allows (at most 6 hours).
- Mac encoder with ffmpeg inside: nothing to install; it sends RTMP with the included ffmpeg and SRT with Homebrew's, chosen by itself.
- Raspberry Pi encoder package (Linux ARM 64-bit).
- Vega Fire TV app: shows the caption track (Up key), remembered on the device.
Added in 1.4
- Phone sender (
/send): iPhone (Safari) and Android (Chrome or the castgate Sender app) send their camera live. Paired with a code like the desktop encoder, listed and removable on Overview; front/back camera, 480p/720p/1080p, sound on/off, screen kept awake, short drops ridden out. Can be added to the home screen as an app. - Android Sender app built into the server (
/download/sender.apk); iPhone app source (apps/ios-sender, XcodeGen). - Camera formats: the desktop encoder reads the formats a camera offers (Windows
-list_options, macOS supported modes) and opens a supported one; MJPEG on Windows webcams whose raw 720p is slow; exact Mac frame rates; 59.94/60 for capture cards. - Mac cameras by name: an iPhone appearing as a camera no longer swaps cameras; old settings are converted.
/download: one page for the desktop encoder, phone sender and TV apps, with QR codes; Overview links to it.- Live broadcasts on the Audience page (and CSV): length, most at once, live viewers and hours, average, replays, reach, top country.
- Weekly audience email on Monday mornings (Settings).
Added in 1.3.2
- Encoder downloads for Windows, Mac (Apple and Intel) and Linux:
encoder/package-all.shbuilds all four packages; the release carries them indist/encoder/. Overview lists them by system, and the public page/download(no sign-in) lists them with how to start each one. - Admin → System → Desktop encoder downloads says which systems are missing.
- Help → Set up SRT in other encoders: OBS, vMix, hardware and ffmpeg settings (caller mode, port, stream ID, latency, passphrase). The desktop encoder help covers every system.
- The Mac encoder finds Homebrew's ffmpeg when started from Finder.
Added in 1.3.1
- Peer-to-peer readout: add
?p2pinfo=1to a channel page address to see Peer-to-peer ON/OFF, viewers connected, the share from viewers and the upload over the player. Switches: Admin → Peer-to-peer → Settings (server) and the channel's Settings (channel). - A grid block that starts during an "Up next" card now goes on air on time; the rotation keeps its turn.
- docs/AI-VIDEO-SCRIPT.md: narration, scene prompts and a feature table for an explainer video.
Added in 1.3
- "Up next" cards between 24/7 recordings: logo, brand color, "UP NEXT", the title and a line under it (date and speaker, or the channel's own text); 3-30 seconds, skippable; preview on the 24/7 page; made once with ffmpeg and cached (last 20 per channel).
- Live captions inside the stream: while live captions are on, the live HLS playlist carries them as a WebVTT subtitle track ("Live captions"), one file per segment on the segment's own timestamps (
X-TIMESTAMP-MAP), listed once transcribed. Players that use it start 30 seconds behind live (EXT-X-START) so captions are on time: Safari and iPhone full screen, ExoPlayer (the Android TV and Fire TV app now follows the TV's caption setting and has a captions button), Roku, IPTV apps. - Peer-to-peer field test: a link from Admin -> Peer-to-peer, valid 24 hours, opens a page on any device that shows where it appears to be and tests STUN, the relay (a relay-only connection) and signaling from that network; results are listed on the admin page.
-turn-allow-private: lets the built-in relay reach private addresses, for tests on a local network only.
This guide is also in the castgate package as docs/FEATURES.md.