pimhwang
/
ErsatzTV
mirror of https://github.com/ErsatzTV/ErsatzTV.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Stream custom live channels using your own media
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2199 Commits
9 Branches
149 Tags
39 MiB
 
 
 
 
Tree: dfb36f49a4
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'dfb36f49a4'
${ noResults }
ErsatzTV/README.md

2.9 KiB
Raw Blame History

ErsatzTV (Community Fork)

ErsatzTV lets you transform your media library into a personalized, live TV experience — complete with EPG, channel scheduling, and seamless streaming to all your devices.

This repository is a community-maintained fork of the original ErsatzTV project, which is currently archived.

It includes fixes and improvements to keep the project usable in modern setups.

contact features community

epg-example

Important Notice

The original ErsatzTV repository has been archived and is no longer actively maintained.

This fork exists to:

  • maintain compatibility with modern environments
  • fix bugs affecting real-world deployments
  • continue improving the project for the community

All credit for the original work belongs to the ErsatzTV maintainers and contributors.

Fixes in this Fork

JWT + HLS Streaming Fix

When JWT authentication is enabled (JWT__ISSUERSIGNINGKEY), HLS players request the playlist with an access_token query parameter.

However, the original implementation generated segment URLs without propagating this token.

Example before: /iptv/hls-direct/1.ts?index=1

This caused segment requests to fail with:

401 Unauthorized

Example after:

/iptv/hls-direct/1.ts?index=1&access_token=TOKEN

This change allows authenticated playback with IPTV and HLS players that do not support sending Authorization headers for segment requests.

Tested successfully with:

  • IPTV Smarters
  • HLS players
  • JWT-protected IPTV streams

How It Works

  1. Install ErsatzTV: Download and set up the server on your system.
  2. Add Your Media: Connect your media libraries and collections.
  3. Create Channels: Design and schedule your own live channels.
  4. Stream Anywhere: Watch on any device with IPTV and EPG support.

Key Features

  • Custom channels: Create and schedule your own live TV channels.
  • IPTV & EPG: Stream with IPTV and Electronic Program Guide support.
  • Hardware Transcoding: High-performance streaming with hardware acceleration (NVENC, QSV, VAAPI, AMF, VideoToolbox)
  • Media Server Integration: Connect Plex, Jellyfin, Emby and more.
  • Music & Subtitles: Mix music videos and enjoy subtitle support.
  • Open Source: Free, open, and community-driven project.

Documentation

Documentation is available at:

https://ersatztv.org/docs/

Credits

This project is inspired by:

License

This project is released under the zlib license.

See the LICENSE file for details.