Set up your server, manage your feeds, and keep things running.
Start here
Setup
These three settings get your server ready. Save each card when you're done.
🌐
FastChannels Server URL
Set the address players and other devices should use to reach this server
Configured
The address other devices use to reach FastChannels. Include http:// and a port if needed, for example http://192.168.1.50:5523.
No port specified — this is fine if you're behind a reverse proxy, but most direct installs need :5523.
Connection help & detected addresses
Browser address: https://fast.home.santiago.wtf
Detected server address: https://fast.home.santiago.wtf
Generated feed, image, and playback URLs use this field exactly, even if you open the admin UI from another address. In Docker, localhost usually isn't reachable by other devices.
This changes generated URLs only. To move the web UI to another port, change the Docker compose port mapping and restart the container.
📺
Channels DVR
Register feeds as custom M3U sources in your DVR with one click
Configured
Your Channels DVR server address, usually on port 8089. Save the address before testing the connection.
Find your DVR address or troubleshoot a connection
Open my.channelsdvr.net → Settings → General to find your server address. If both apps are on the same machine and the LAN IP fails, try the Docker host gateway: http://172.17.0.1:8089.
Auto-refresh guide data hourly
When enabled, FastChannels forces Channels DVR to re-import guide data for all registered FastChannels lineups once per hour. Applies to feeds added with "Add to Channels DVR". Save this card to apply the change.
🕒
Time Zone
Control how timestamps display across the admin UI and FastChannels logs
Configured
Search for a city or region. Controls timestamps in the admin UI and FastChannels logs.
Time zone format & system defaults
Use an IANA name such as America/New_York or Europe/London, rather than an alias like US/Eastern (full list ↗). Saving here overrides the container's TZ for the app.
Interface
Choose how much you see in the admin interface.
Show advanced sources & features
Lite mode keeps setup simple. Advanced mode includes subscriptions, TV Everywhere, and DRM playback. Features you already use stay visible. Your channels, schedules, and playlists stay the same. You can also switch with the mode menu (Lite mode / Advanced mode) at the top right of any page.
Auto-saves
Feeds & Guide
Choose what goes into your feeds and how guide data and artwork are delivered. Switches save automatically.
Channel & artwork defaults
Applies across your feeds. Individual sources can override new-channel approval.
Auto-allow new channels into feeds
Add newly discovered channels to feeds automatically. When off, channels wait for approval in Channels → Needs review.
Auto-saves
Fill the guide before and after events
Show “Event Not Started” and “Event Ended” blocks so event channels don't have empty guide rows.
How event filler works
Hourly blocks show the event start time until it begins, then “Event Ended” for 24 hours afterward. They have no categories, so they stay out of Sports and other genre filters. Without filler, some players show placeholders named after the channel.
Auto-saves
Cache channel logos & guide artwork
Serve cached images through FastChannels for reliable delivery. When off, image URLs point to the provider. Some sources, including Roku, need proxying for artwork to display correctly.
Auto-saves
🎬
Gracenote Guide Data
Control automatic guide ID assignment during scraping
Auto-assign Gracenote IDs
When enabled, scrapers populate Gracenote guide IDs for channels that support it. Channels with manually assigned IDs are never affected.
Auto-saves
Community Map URL
Remote CSV fetched on startup and refreshed daily. Leave blank to use the default FastChannels community Gist.
Disable & clear Gracenote
Turn off automatic assignment and clear existing Gracenote IDs. Review the confirmation before applying.
📡
Native Feed Output
Optional scraped-only M3U playlists and XML guides for every feed
Enable native feeds
This switch applies to every feed. When off, FastChannels stops generating native M3U and XML files, hides their links on Feeds, and returns 404 from native URLs. Existing DVR sources using those URLs will stop working until you turn it back on. Standard, mixed, Gracenote and bridge outputs keep working.
Last native URL request (M3U or EPG):
How native guide refresh works
While enabled, each native file refreshes routinely for seven days after its first build or last request. After that, the switch stays on and the URL remains available; routine refreshes pause for that file. Its next request may wait for a rebuild and starts a new seven-day window.
Auto-saves
TV Everywhere
Save your TV provider credentials, then sign in to the networks you use.
📡
TV Everywhere
Shared provider credentials for legal TVE-backed sources
TV Provider Sign-In
Choose your TV provider, then enter the same username and password you use on that provider's site. These credentials are stored only in the local FastChannels database and are never returned to the browser after saving.
Used by TVE sources such as A+E Networks TVE.
One-time Google sign-in, so every YouTube TV network below can authorize without opening a browser again.
No auth test has run yet.
⚠ TVE is disabled — the enable switch is off, so every network's scraper and every "Sign in" click will fail until it's turned back on and saved.
Enable TV Everywhere
Network sign-ins
TVE network sign-in status — sign in to each network individually below, or all at once.
Sign in with:
Loading…
Reset TV Everywhere
Deletes saved provider credentials, cached sign-in tokens, and the browser's saved login session.
Sign in for TV Everywhere
Launching browser…
Enter this code on the page below:
Scan the QR code with your phone's camera, or open the link below on any phone or computer, and sign in to your TV provider there. This window updates by itself once you're done.
Use a private/incognito tab if that browser is already signed in to a different TV provider account.
If Spectrum says to select "Cox Spectrum" (IDLI-4213), choose Cox as your provider above and start again.
Each link works for about 10 minutes.
Admin Access
Manage the login used to open the admin UI.
🔒
Admin login
Off — anyone who can reach this server can open the admin UI
Requires a sign-in for the admin UI and its API (settings, sources, database backup/restore). Playlists, guides, streams, images and the /watch page stay open, because Channels DVR, Plex, IPTV players and the DRM bridges can't sign in, so anyone who can reach this server can still pull your M3U/EPG and play channels. Changing the password signs out every other browser.
Forgot it? Add FC_AUTH_DISABLED=1 to the container's environment, restart, then change or turn off the login here.
Adds tvc-stream-timestamps="rewrite" to generated M3U entries for Channels DVR. This may help recordings with bad durations or timestamp corruption, but can affect in-progress playback on some streams.
Auto-saves
Debug logging
Adds extra diagnostic detail to the logs for modules that support it (currently: Spectrum sign-in). Off by default — turn this on only while reproducing a specific issue, since it's more verbose than normal; equivalent to setting the FC_DEBUG environment variable.
Auto-saves
Community Gracenote Map
Channels with curated community IDs. Applying sets the channel to Manual mode — it won't be overwritten by future scrapes.
Status legend
Applied
Community tmsid is already the active ID on this channel
Available
No Gracenote ID set, in auto mode — community tmsid can be applied
Has native ID
Channel is in auto mode with a scraped ID that doesn't match the community tmsid
Manual
Channel is in manual mode with a different tmsid than the community one
Off
Gracenote is disabled for this channel entirely
Channel
Source
ID
Status
Loading…
Checking…
Checking…
Loading…
Loading suggestions…
Restore from Auto-Backup
These nightly snapshots live on the server in
/data/backups.
Restoring replaces the current database. This cannot be undone.
Restart the container afterward so all background workers pick up the restored data.
Loading…
PrismCast setup test
Checks reachability, the watch-page secure context, and runs a real capture end-to-end.
…
Export ah4c scripts
Generates a prebmitune.sh /
bmitune.sh /
stopbmitune.sh /
reboot.sh set for
ah4c, so it can drive
FastChannels Player instead of Hulu/YouTube TV — useful if your HDMI encoder isn't the one FastChannels
documents directly. Extract into ah4c's mounted scripts directory and set
STREAMER_APP=scripts/<dir>/<name>
to match.
Pre-filled from this page's own address — confirm it, since the ah4c container may run on a different machine/network than the one you're browsing from.
Disable Gracenote?
This will disable automatic Gracenote ID assignment and clear all Gracenote IDs
(including manually assigned ones). Channels will use scraped guide data only.
To re-enable per-channel, use Set Auto on the Channels page.
🎉 Update Available
Current: v5.9.0→v6.0.0
Your database, settings, and channel data are stored in a Docker volume
and are not affected by the update.
Run this command from your FastChannels directory: