Settings

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.
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

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.

System

Back up your database, check server health, and troubleshoot issues.

💾
Database Backup
Back up and restore your FastChannels database
Create
Download a gzip-compressed copy of fastchannels.db — all channels, sources, feeds, settings, and Gracenote assignments. Store it somewhere safe.
Restore database
Replaces the current database, then reloads workers. This cannot be undone — download a backup first.
From a nightly auto-backup
Checking…
From a file (.db / .db.gz)
No file chosen
📊 System Stats
Loading…
Advanced controls Experimental playback options & debug logging
⚙️
Advanced controls
Experimental output and troubleshooting
Rewrite stream timestamps in M3U Experimental
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
AppliedCommunity tmsid is already the active ID on this channel
AvailableNo Gracenote ID set, in auto mode — community tmsid can be applied
Has native IDChannel is in auto mode with a scraped ID that doesn't match the community tmsid
ManualChannel is in manual mode with a different tmsid than the community one
OffGracenote is disabled for this channel entirely
ChannelSourceIDStatus
Loading…