Transform Your Media Library into Custom TV Channels Using This Free Open-Source Tool

In an era where flipping through television channels is becoming a relic of the past, the demand for personalized viewing experiences is on the rise. Traditional broadcasting often limits viewers, restricting access to content and inundating them with commercials. However, with the advent of innovative solutions like ErsatzTV, users can regain control over their viewing habits. This open-source application empowers users to transform their self-hosted media—from a Jellyfin server to local files—into curated, continuous streaming channels, similar to classic television programming.

Transform Your Media Collection with ErsatzTV

ErsatzTV serves as a free, open-source tool that allows users to convert their existing media libraries into a custom live TV experience. Functioning akin to a private IPTV server, it creates endless channels complete with an electronic program guide from already owned content. Users can run the application independently with local media folders or connect it to popular media servers such as Jellyfin, Plex, or Emby to leverage existing libraries and metadata.

The flexibility of ErsatzTV is key; users can freely mix various sources without any modifications to their original files. The concept centers around the creation of virtual TV channels, where multiple channels can be configured with personalized names, logos, and specific programming schedules. Whether it’s a dedicated channel for a particular show, a genre-specific stream, or a dynamic mix of films and episodes, the choice is entirely yours.

Unlike traditional TV where content is randomly selected, ErsatzTV offers enhanced playback management through collections and schedules. Users can opt for sequential playback, endless shuffling, or pre-defined blocks at specific times, allowing them to craft anything from a straightforward 24/7 loop to a more complex broadcast-style schedule.

Streaming happens seamlessly via standard IPTV formats, utilizing an M3U playlist and an XMLTV guide. Its default streaming method, HLS, ensures smooth playback, while optional transcoding is available if required. Depending on hardware capabilities, users can activate GPU acceleration for improved performance or choose direct streaming to eliminate the need for transcoding. Additionally, ErsatzTV permits the integration of fillers, such as bumpers, retro commercials, and offers a variety of customizable features for advanced users.

How to Set Up ErsatzTV

The setup process for ErsatzTV is straightforward, essentially involving three key steps: downloading the application, connecting to your media, and creating your first channel. No command-line skills or Docker knowledge is necessary; the pre-built installers simplify the installation process.

To begin, download the latest version of ErsatzTV compatible with your operating system. On Windows, simply extract the ZIP to a designated folder (e.g., “C:\ersatztv”) and launch ErsatzTV-Windows.exe. All necessary components, including FFmpeg, are bundled, allowing for seamless operation from the system tray.

For macOS users, after opening the.dmg file, drag ErsatzTV to the Applications folder, granting approval in System Settings upon the first launch. You will need to install FFmpeg separately, which can be easily done via Homebrew with the following command:

brew install ffmpeg

If you are using Linux, extract the tarball, run the ErsatzTV binary, and ensure you have FFmpeg and FFprobe installed. For many distributions, this can be accomplished with:

sudo apt install ffmpeg

After starting ErsatzTV, open a browser and navigate to http://localhost:8409 or use the appropriate server IP if you’re operating headless. This web interface is your cockpit for all necessary configurations.

Next, you need to connect to your media source. While this guide will focus on Jellyfin, the process is similar for Plex and other compatible platforms. To add Jellyfin, go to the Media Sources section and select Jellyfin. Input your Jellyfin server address, typically something like http://192.168.x.x:8096 or http://localhost:8096.

Then, generate an API key by going to the Dashboard and selecting Advanced → API Keys. Simply click the + button to create one.

After obtaining your key, copy it into the corresponding field in ErsatzTV and click Save Changes. This enables ErsatzTV to connect to your Jellyfin server without needing your login credentials.

If Jellyfin is not your media server, you can alternatively add local folders as your media source. Choose Local and allow ErsatzTV to scan these directories.

Screenshot showing Ersatztv Media Sources

Once your media is linked, it’s time to create a collection. Collections serve as playlists for your channels. You can easily add content from your library by browsing or searching.

Finally, you’ll want to set up your channel. Give it a distinct name and number, keeping the default settings for HLS streaming, which generally works well. Develop a schedule pointing to your newly created collection, choose to shuffle for continuous playback, and associate the schedule with your channel. Upon completion, your channel will be live.

Watching ErsatzTV on Your Devices

With ErsatzTV configured and your channels operational, it’s time to enjoy your creations. Each channel can be accessed as a standard IPTV stream, supported by an electronic program guide (EPG), which facilitates integration with various media applications. Here, we will demonstrate the process using Jellyfin, though similar steps apply to other applications like Emby.

To watch on Jellyfin, navigate to the admin dashboard and select Live TV. Create a new tuner device and choose M3U Tuner. Input the ErsatzTV playlist URL when prompted. Additionally, add the guide data by outlining a new XMLTV guide provider and pasting the ErsatzTV guide URL. Remember to save your settings and allow Jellyfin some time to process the information.

After completing these steps, recheck the Live TV section in Jellyfin. Your custom channels should appear complete with names, numbers, logos, and a comprehensive program guide. Click on a channel to start watching, replicating the experience of live television. Any device compatible with Jellyfin, such as smart TVs, can be used to access the channels Full-screen viewing is just a click away.

Since ErsatzTV utilizes standard M3U and XMLTV feeds, it offers flexibility beyond Jellyfin, allowing use with various IPTV applications including TiviMate, Kodi’s IPTV client, Channels DVR, or VLC by directing them to the same playlist and guide URLs.

While Plex does not directly allow arbitrary M3U sources in its user interface without a Plex Pass, it can integrate with ErsatzTV via emulating an HDHomeRun, a device readily detectable by Plex.

Although setting up ErsatzTV requires some initial investment of time and effort, the personalized and flexible viewing experience it provides makes it worthwhile. As you explore its capabilities, consider checking out additional apps that can enrich your TV viewing experience.

Source&Images