IPTV-ReStream - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #typescript #golang #go #rust #docker #nodejs #java #windows #kubernetes #security #mcp #openai

IPTV-ReStream

(★ 113)

An app to forward source specific multicast streams via HTTP

File Explorer

Download Latest Version (.zip)

- - bump-version.yml
  - ci.yml
  - codeql-analysis.yml
  - create-release.yml
- dependabot.yml
- .gitignore
- - style.css
- - connection.ts
  - station.ts
- - config.ts
  - connection.ts
  - m3u.ts
  - station.ts
  - stream.ts
  - xspf.ts
- - index.ts
  - live.ts
  - station.ts
  - status.ts
- app.ts
- header.ejs
- nav.ejs
- stations.ejs
- status.ejs
.eslintrc.json
.gitignore
docker-compose.example.yml
Dockerfile
LICENSE
package-lock.json
package.json
README.md
tsconfig.json

# Installation Guide

1. Get the code

git clone https://github.com/n-thumann/IPTV-ReStream

Downloads the entire project code from GitHub to your computer.

cd IPTV-ReStream

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

docker compose -f docker-compose.example.yml up -d --build

Runs the command against the services defined in the compose file.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

3. Node.js

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# IPTV-ReStream #
This app allows remotely viewing source-specific multicast RTP streams (e.g. Deutsche Telekom MagentaTV), by forwarding it using HTTP.

![Status Page](https://user-images.githubusercontent.com/46975855/67150900-fa160a80-f2bd-11e9-91e3-944d8f5272c3.png)
![Stations Page](https://user-images.githubusercontent.com/46975855/67150901-faaea100-f2bd-11e9-8776-e07fafba408a.png)

## Features
* lightweight: there is no de- or encoding happening, the stream is simply forwarded
* simple Dashboard with Statistics
* Station List with Images
* VLC-ready playlist included
* Open stream directly in VLC (iOS & Android only)
* automatic running program detection (from MPEG-TS stream)

## Installation
1. Install [Node.js](https://nodejs.org/en/) (v13.1 or higher)
2. Clone this Repo: `git clone https://github.com/n-thumann/IPTV-ReStream` or click 'Download'
3. Install dependencies `npm install` and transpile `npm run build`
4. Download [this list](https://db.iptv.blog/multicastadressliste.json) of stations (by [iptv.blog](https://db.iptv.blog/multicastadressliste)) and place it in the `data` directory
5. Export environment variables (see below), if necessary
6. Run `npm start`

Or with Docker (Linux only):
1. [Install](https://docs.docker.com/v17.12/install/) Docker
2. run `docker run -d --network host --restart always --name IPTV-ReStream [-e HOST="127.0.0.1" | -e PORT=3000 | -e MCAST_IF="0.0.0.0" | -e XSPF_PROTOCOL="https" | -e XSPF_HOST="my.server.com:8080" | -e XSPF_PATH_PREFIX="/iptv" | -e ALLOW_UNKNOWN="false" | -e DEBUG="iptv-restream:*"] nthumann/iptv-restream:latest` (parameters in brackets are optional)

The image is also available on GitHub Container Registry (use `ghcr.io/n-thumann/iptv-restream:latest`).
### Configuration ###
It's highly recommended running this application behind a Reverse Proxy ([nginx](https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/) or [Apache httpd](https://httpd.apache.org/docs/2.4/howto/reverse_proxy.html)) that enforces authentication (and encryption). When using a reverse proxy it's probably mandatory to adjust environment variables `XSPF_PROTOCOL`, `XSPF_HOST` and `XSPF_PATH_PREFIX`, otherwise the application may generate an invalid VLC XSPF-Playlist. For example, if the application is reachable over a Reverse Proxy via https://my.server.com:8080/iptv, then run `export XSPF_PROTOCOL=https XSPF_HOST=my.server.com:8080 XSPF_PATH_PREFIX=/iptv`. Also, if the clients real IP and Port should be visible on the Dashboard, make sure to pass HTTP Headers `X-Real-IP` and `X-Real-Port` from the Reverse Proxy to the Application.

### Environment Variables
| Variable | Description |
| -------- | ----------- |
| HOST | Web interface Listen Host (default: empty to listen on all interfaces) |
| PORT | Web interface Listen Port (default `3000`) |
| MCAST_IF | joins the multicast group using this interface (default `0.0.0.0`, lets OS choose automatically) |
| XSPF_PROTOCOL | Protocol (`http`/`https`) for generating XSPF |
| XSPF_HOST | Host and Port for generating XSPF |
| XSPF_PATH_PREFIX | Path Prefix for generating XSPF |
| ALLOW_UNKNOWN | Allow forwarding streams that are not in the station list (default `0`/`false`) |
| DEBUG | Enable Debug Logging (`iptv-restream:*`) |

### Usage
Open the web interface and navigate to `Stations`, then download the XSPF Playlist for VLC and open it. Done!
If you're running iOS or Android, you can also simply hit the play button in the web interface to open up VLC automatically.

It is also possible to access the source-specific multicast streams directly by opening `/live/mcast_source@mcast_group:mcast_port` (e.g. `/live/87.141.215.251@232.0.20.35:10000` for Das Erste HD) or by using the shortcut at `/live/station/station_title` (e.g. `/live/station/ZDFSD` for ZDF SD).
Please note that running on Windows only supports streaming one program. For streaming multiple programs concurrently use Linux.

## Under the hood ##
For example MagentaTV delivers the H.264 video stream via MPEG-TS, wrapped into RTP packets over source specific multicast. Therefore, it is not possible to access this stream when connected to a non-MagentaTV line. This app is proxying the video stream: It receives it, just as usual, at your Telekom line at home and re-streams it over HTTP to your other devices. This concept is inspired by [udpxy](https://github.com/OmegaVVeapon/udpxy).