Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › ErsatzTV

How to turn a Jellyfin library into live TV channels with ErsatzTV

By Freedom251 Team · · 11 min read

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

There is not a documented Jellyfin plugin that automatically converts your library into live channels. The supported workflow described for this use case connects Jellyfin to ErsatzTV, which schedules selected Jellyfin media into virtual channels and publishes two feeds: an M3U playlist for channel playback and an XMLTV feed for programme-guide data. You then add those feeds in Jellyfin under Dashboard → Live TV. The result behaves like a channel lineup built from your own films and shows; it is not over-the-air television and does not require a physical tuner.

What you are building

The finished system has three roles. Jellyfin remains your media server and the place where you watch the channels. ErsatzTV reads selected Jellyfin libraries, applies the schedules you create, and presents each virtual channel as a stream. Jellyfin’s Live TV screen consumes the channel list and programme metadata through separate network endpoints.

As an Amazon Associate I earn from qualifying purchases.

Component Job What it needs
Jellyfin Stores or serves your films and series and displays the resulting Live TV lineup A reachable server address and an API key for ErsatzTV
ErsatzTV Synchronizes chosen libraries, creates schedules and exposes channel feeds Access to Jellyfin over the network; optionally, access to the same media paths
M3U endpoint Describes the virtual channels and their stream addresses Added in Jellyfin as an M3U tuner
XMLTV endpoint Describes programme titles and times for the guide Added in Jellyfin as an XMLTV TV Guide Data Provider

Because the channel streams are generated from your existing library, a broadcast antenna, cable subscription or dedicated TV tuner is not part of this setup. A physical tuner is a separate input option for bringing live broadcast television into Jellyfin.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What you need before starting

  • A working Jellyfin server. Know its server address as seen from the machine running ErsatzTV. Use the address that the two services can actually reach, rather than assuming that localhost is valid across separate machines or containers.
  • An ErsatzTV installation. Installation details and product versions change, so use the current ErsatzTV installation documentation for your operating system instead of copying an old command. The available setup material does not establish a single current version or universal installation command.
  • Libraries worth scheduling. Decide which Jellyfin libraries should be synchronized. You can use different selections for different channel concepts, such as a film-only lineup or a genre-focused schedule.
  • Network access between services. ErsatzTV must reach Jellyfin’s API and stream the selected items. If both services run on different hosts, check firewall rules, container networking and the address advertised by Jellyfin.
  • Administrative access to Jellyfin. Creating an API key and changing Live TV settings require an administrator account.

Create the Jellyfin API key

ErsatzTV uses Jellyfin’s API rather than a manual export of your library. Create a dedicated key so you can identify and revoke this integration without changing a personal password.

#1 Best Overall
Mygica A681B USB 2.0 TV Tuner Card, ATSC HD Digital External HDTV Tuner Stick Dongle Adapter for Windows PC Computer + Laptop + Android TV - Black
  • 1. Precautions before use: Please download the latest electronic version of the instructions from the Mygica official website and read it carefully. This product is not ready for use after purchase. User needs to install the corresponding driver and playback software.
  • 2. Product introduction: A681B is a TV tuner that allows users to watch digital TV programs on desktop computers and laptops. After installation, there is no need for WiFi network to watch digital TV. It is a very practical product for viewers who like to watch various live sports games and TV programs.
  • 3. Product features: small, portable, supports 1080P HDTV. After installing the playback software "HiDTV", you can record and play back the video.
  • 4. Compatible devices: A681B is compatible with Windows desktop computers, Windows laptops, Android TV, Android car machines and other Android devices (Android version of the playback software must be installed). Note: This product is not compatible with MacBook.
  • 5. Compatible operating system versions: Compatible with Windows 7/ Windows 10 / Windows 11 / Linux ubuntu 20.04.1, kernel:5.4
  1. Sign in to Jellyfin with an administrator account.
  2. Open Dashboard → Advanced → API Keys.
  3. Create a new key and give it a recognizable name, such as ErsatzTV. Copy the key immediately and store it securely; you will enter it in ErsatzTV.
  4. Confirm that the Jellyfin server address you plan to enter is reachable from the ErsatzTV host.

An API key grants programmatic access to the server. Treat it like a credential: do not paste it into public posts, commit it to a configuration repository, or include it in a URL that you share.

Connect ErsatzTV to Jellyfin

In ErsatzTV, add Jellyfin as a media source. Enter the Jellyfin server address and the API key you created, then select the libraries that ErsatzTV should synchronize. Synchronization determines which items are available when you design schedules; it does not require you to duplicate the media files.

Allow the initial synchronization to finish before diagnosing missing programmes. A library that has not completed its sync can make a channel appear empty even though Jellyfin itself plays the same title normally. If you later add a new library or large batch of media, return to the media-source settings and synchronize again so ErsatzTV can use the additions.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose a sensible library scope

  • One subject per source or channel group: Selecting focused libraries makes it easier to build a predictable lineup.
  • Separate films and series when schedules differ: A film channel and an episodic channel have different programme lengths and guide expectations.
  • Avoid syncing content the service cannot play: Start with a small, known-good library, verify playback, then expand the selection.

ErsatzTV’s current interface is the authority for creating channels, schedules and their names. Product labels can change, but the output you need from it is stable: an M3U URL and an XMLTV URL for the channels you configured.

Make sure ErsatzTV can reach the media

There are two ways for ErsatzTV to obtain the actual video. By default, it can stream items through Jellyfin. In that arrangement, ErsatzTV asks Jellyfin for the media and does not need to see the underlying disk path.

Rank #2
Digital Converter Box for TV, OWERSLYN ATSC TV Tuner for 1080P Live with Program Recording & Playback, USB Media Player, HDMI/AV Output(AV Cable Included), 2-in-1 Remote, Free Digital Channels
  • Digital TV Converter Box: 2026 OWERSLYN Mini Digital Converter Box for TV receives ATSC broadcast signals from an antenna and outputs them to a TV, Projector, or a Monitor, allowing you to watch TV programs with ease. its compact design lets you conveniently hide it behind your TV.
  • 75% smaller than normal ATSC tuner that can be plugged into your TV’s HDMl port and powered by TV’s USB or 5V USB Charger, can tuck neatly behind your TV. IR infrared sensor and 2-in-1 Remote control with learning function so you don't have to use the old remote control as well. Note: CH3/CH4 channel switching is not supported.
  • TV converter box features an HDMI output that supports 1080P HD resolution and offers three video output options: HDMI, 3RCA, and component. Both HDMI and 3RCA cables are included in the package, so there's no need to buy additional video cables—just plug and play. *Note: Not compatible with TVs that only have an RF input.
  • You can play video,music and view photos, or recorded TV shows from your USB storage device.Real-time DVR recording of digital converter box allows you to record TV shows for future watch, timer setting can be scheduled recording at any time you want. (Incompatible with streaming programs)
  • What You Get: 1 x TV Tuner Stick,1 x 2 in1 Remote Control,1 x HDMI Cable, 1 x 3RCA Cable, 1 x USB to DC Cable, 1 x lR Receiver with display, 1 x Manual.📞 Enjoy lifetime support, one-year warranty, and quick responses within 24 hours. Important Note: This device receives Over-The-Air signals via an antenna. It does NOT work as a replacement for a Cable Box. An external antenna (sold separately) is required.

Direct disk access is another option. It can be useful when your deployment is designed for both services to read the same files, but it introduces a path-mapping requirement. Both services must be able to access the same shares or mounts, and the path visible to Jellyfin may not be identical to the path visible to ErsatzTV.

When to use path replacements

If Jellyfin reports a file under one path and ErsatzTV sees that share under another, configure a path replacement in ErsatzTV that maps the Jellyfin path to ErsatzTV’s local path. For example, a mount presented as one directory inside Jellyfin may be mounted under a different directory in the ErsatzTV host or container. The mapping must point to the real location that ErsatzTV can read.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Test that the ErsatzTV service account can read a representative file.
  • Check capitalization and trailing slashes in both paths.
  • Prefer the Jellyfin-streaming method if shared mounts are difficult to maintain.

A path replacement fixes file-location mismatches; it does not grant permissions. Operating-system, share and container permissions still have to allow the ErsatzTV process to read the media.

Build and publish your virtual channels in ErsatzTV

Use ErsatzTV’s channel and scheduling tools to decide what each channel plays and in what order. A channel can represent a genre, a library, a studio collection or any other grouping supported by the media and scheduling controls available in your installed version. The important distinction is that the channel is a programmed stream, not a new copy of every file.

After you have at least one usable channel, locate the integration endpoints in ErsatzTV. You need both:

Rank #3
Mygica A681B Analog USB TV Tuner Card Antenna, Recast ATSC HD Digital External HDTV Tuner Stick Dongle Adapter for Window, Linux, for PC Computer Laptop Android TV Box, Android Car Navigation
  • 1. Precautions before use: Please download the latest electronic version of the instructions from the Mygica official website and read it carefully. This product is not ready for use after purchase. You need to install the corresponding driver and playback software.
  • 2. Product introduction: A681B is a TV tuner that allows users to watch digital TV programs on desktop computers and laptops. After installation, there is no need for WiFi network to watch digital TV. It is a very practical product for viewers who like to watch various live sports games and TV programs.
  • 3. Product features: small, portable, supports 1080P HDTV. After installing the playback software "HiDTV", you can record and play back the video.
  • 4. Compatible devices: A681B is compatible with Windows desktop computers, Windows laptops, Android TV, Android car machines and other Android devices (Android version of the playback software must be installed). Note: This product is not compatible with MacBook.
  • 5. Compatible operating system versions: Compatible with Windows 7/ Windows 10 / Windows 11 / Linux ubuntu 20.04.1, kernel:5.4
  • M3U: the playlist Jellyfin reads to discover channel names and stream addresses.
  • XMLTV: the guide feed Jellyfin reads to show programme titles and times.

Keep the two URLs from the same ErsatzTV configuration. If you change channel names or schedules, use the current endpoints and refresh Jellyfin’s data rather than mixing an old playlist with a newer guide.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Add the M3U playlist to Jellyfin

  1. In Jellyfin, open Dashboard → Live TV.
  2. Choose Add tuner device.
  3. Set the tuner type to M3U Tuner.
  4. Enter the M3U URL supplied by ErsatzTV. Jellyfin can use a web URL or a local playlist file; the web URL is the natural choice when ErsatzTV is serving the feed.
  5. Save the tuner and wait for Jellyfin to retrieve the channel list.

Jellyfin’s M3U settings also expose a simultaneous-stream limit. Set a limit only when you need to protect the server or the upstream stream source; a low value can prevent legitimate household viewing. Some remote playlist sources require a custom user agent, but that is a source-specific setting rather than a requirement of the ErsatzTV workflow. Enable auto-loop only when a stream fails to play correctly without looping; it is not a general fix for guide or channel-discovery problems.

Add the XMLTV guide feed

  1. Remain in Dashboard → Live TV and add a TV Guide Data Provider.
  2. Select XMLTV as the provider type.
  3. Enter the XMLTV URL supplied by ErsatzTV.
  4. Save the provider and allow Jellyfin to import the guide data.

The M3U feed and XMLTV feed solve different problems. A working playlist can produce playable channels with no programme names, while a working XMLTV feed cannot create a channel that is absent from the playlist. Configure both before judging the result.

Map guide data when Jellyfin requests it

Jellyfin’s guide workflow may ask you to map guide entries to the corresponding tuner channels. Match each XMLTV channel to the channel with the same identity in the M3U lineup. If a channel plays but shows “No data” or an unrelated schedule, recheck the mapping rather than changing the media files.

Refresh and verify the result

  1. Open Jellyfin’s Live TV overview and confirm that the tuner is present and reports a healthy status.
  2. Use the available manual refresh control in the Live TV settings after changing an endpoint or schedule. Guide data is also refreshed periodically, so an immediate change may not appear until the next refresh.
  3. Open one virtual channel and let it play long enough to confirm that the stream starts and advances.
  4. Open the programme guide and check that the current and upcoming entries correspond to the schedule you created in ErsatzTV.
  5. Test a second channel. One successful stream proves connectivity for that channel, not necessarily that every mapped path, codec or schedule is correct.

Verify playback from the clients your household actually uses. A channel that works in a browser but fails on a television app can indicate a client-format or transcoding limitation rather than a broken M3U or XMLTV configuration.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
ZJBOX Digital Converter Box for TV,1080P ATSC tv Tuner Box with hdmi Output and 3RCA Cables Hidden Behind TV,with Power Adapter,2-in-1 Remote,TV Program Recording&Playback,USB Media Player
  • 📺【TV Tuner】 ZJBOX 2024 Mini Digital Converter Box is used to receive ATSC broadcast signals from antennas or cables, and output them to TVs, projectors, or even monitors for watching TV programs. The converter box can be hidden behind the TV and is powered by a 5V USB adapter included in the package, making it especially suitable for wall-mounted TVs.
  • 🔍【HDMI&1080P】The converter box with HDMI output supports 1080P HD. It provides three types of video output interfaces: HDMI, 3RCA, and component. HDMI and 3RCA cables provided in the package, so there's no need to purchase additional video cables; they can be used directly. Note: This depends on the resolution supported by your TV.
  • 🔦【Two-in-One Remote Control】The two-in-one remote control features a learning function, allowing you to control both the digital converter stick and the TV without the need for two separate remotes. Pairing is required before use, with four programmable buttons (SET, TV/AV, VOL-, VOL+) available. It supports only infrared remote control.Battery Requirement: Requires AAA batteries (not included). Customers need to prepare batteries separately.
  • 📼【DVR Recording】Record all your favorite TV shows and movies for future viewing. You can schedule recordings using a timer, and the TV programs will be stored on your external hard drive for convenient access whenever you want. Note: This device has better compatibility with external hard drives of up to 4TB with the FAT32 file system or up to 32GB flash drives.
  • 📲【Many Features】This device has a variety of functions, including auto-channel selection, electronic program guide, channel favorites, instant/scheduled recording, CC subtitles, multifunctional remote control, timer power on/off, parental controls, and multimedia playback. These features can meet most of your needs.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot by symptom

No channels appear after saving the M3U tuner

  • Open the M3U URL from the ErsatzTV host or another machine on the same network. If it cannot be reached, fix the address, firewall or container network first.
  • Confirm that the URL is the current playlist endpoint and that ErsatzTV has completed its library synchronization.
  • Check that at least one channel has a schedule and playable media. An empty configuration can yield no useful lineup.
  • Use Jellyfin’s manual tuner refresh after correcting the source.

Channels appear, but playback fails

  • Test the same item directly in Jellyfin. If it fails there, resolve Jellyfin’s media or permission issue before debugging the integration.
  • If ErsatzTV is configured for direct paths, verify shared mounts, service-account permissions and path replacements.
  • Switching to streaming through Jellyfin can isolate a path-mapping problem.
  • Check whether the failure affects every channel or only media stored in one location. A location-specific pattern usually points to a mount or replacement error.

Playback works but the guide is blank

  • Confirm that the XMLTV provider was added separately from the M3U tuner.
  • Verify that the XMLTV URL is reachable and comes from the same ErsatzTV setup as the playlist.
  • Run a manual guide refresh and allow for the provider’s import cycle.
  • Map XMLTV entries to the matching tuner channels if Jellyfin presents a mapping screen.

The guide shows the wrong programme

  • Check that the channel identity in the XMLTV data matches the channel selected in Jellyfin.
  • Refresh both feeds after renaming channels or changing schedules.
  • Look for an old tuner or provider entry that is still enabled; duplicate sources can make it appear that a change was ignored.

Only some titles are missing

  • Confirm that the relevant Jellyfin library was selected for synchronization.
  • Wait for synchronization after adding or moving files.
  • For direct access, compare the path stored by Jellyfin with the path visible to ErsatzTV and update the replacement mapping.
  • Check permissions on the specific share or file rather than assuming the whole library is unavailable.

Virtual channels versus broadcast television

Question Library-generated channels Broadcast or other live input
Where does the content come from? Your synchronized Jellyfin libraries, scheduled by ErsatzTV An antenna, cable source, network tuner or another live provider
Is a physical tuner required? No Often, depending on the broadcast source and Jellyfin integration
How does Jellyfin receive channel data? M3U playlist plus XMLTV guide from ErsatzTV A tuner-specific source and whatever guide provider that source supports
What does the viewer see? A continuous, scheduled lineup made from existing files Live broadcasts, subject to the capabilities and availability of the input source
Does this replace the media library? No. The library remains the underlying collection No. Broadcast input is an additional source

Jellyfin supports HDHomeRun and M3U tuners, and its documentation notes that additional tuner types can be supplied through plugins. That plugin capability should not be confused with the ErsatzTV arrangement: here, Jellyfin is consuming an M3U and XMLTV integration, not installing a plugin that generates channels from library files.

Operational choices and trade-offs

Stream through Jellyfin or share the disks?

Streaming through Jellyfin minimizes filesystem coordination and is the default ErsatzTV behavior. Shared filesystem access can reduce an extra streaming hop in some layouts, but it requires stable mounts, matching permissions and path replacements whenever the two services use different directory names.

Use one broad lineup or several focused channels?

A broad lineup is simpler to maintain but less predictable for viewers. Focused channels make the guide easier to understand and let you schedule by genre, library or collection, at the cost of more schedules and more channel mappings to maintain. Start with a small lineup, confirm both feeds, then add channels incrementally.

How much concurrency should you allow?

The simultaneous-stream setting in Jellyfin’s M3U tuner is a control, not a performance guarantee. Set it according to the capacity of your server and network and the number of viewers you expect. If playback stops when a second viewer joins, inspect this limit before changing the guide configuration.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Maintenance checklist

  • Keep the ErsatzTV and Jellyfin server addresses stable, or update the integration when they change.
  • Regenerate or revoke the Jellyfin API key if it is exposed, and update ErsatzTV with the replacement.
  • Resynchronize libraries after adding content or changing which libraries are included.
  • After changing channel names or schedules, refresh the M3U tuner and XMLTV provider in Jellyfin.
  • Periodically test one channel from each media location and one guide entry from each channel group.
  • Review current ErsatzTV installation and upgrade instructions before applying a version-specific update; installation commands and product versions are not fixed by this setup description.

What this setup does not provide

  • It does not receive antenna, cable or satellite broadcasts.
  • It does not make a physical tuner mandatory.
  • It does not eliminate the need for an XMLTV provider when you want programme-guide information.
  • It does not bypass Jellyfin or ErsatzTV permissions; both services still need access to the API and media stream.
  • It does not guarantee that every Jellyfin client can play every generated stream without transcoding.

For the library-to-channel use case, the practical answer is therefore an ErsatzTV-to-Jellyfin integration: synchronize the libraries, create schedules in ErsatzTV, add its M3U URL as Jellyfin’s tuner, add its XMLTV URL as the guide provider, map channels if prompted, and refresh the Live TV data.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

ErsatzTVJellyfinlive TVM3Umedia serversXMLTV

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.