Public Repository

Last pushed: 2 days ago
Short Description
๐Ÿ“บ Watch and ๐Ÿ“ป listen ๐Ÿ‡ต๐Ÿ‡น RTP Play without a ๐Ÿ’ป browser
Full Description

:tv: Watch and :radio: listen ๐Ÿ‡ต๐Ÿ‡น RTP Play without a :computer: browser

Watch 8 TV and listen 14 radio channels on any device that can play HTTP Live Streaming.

<p align="center"><img src="share/github/overview.gif" width="620"></p>


  • 8 TV channels :tv:
  • 14 radio channels :radio:
  • Uses Request on Steroids to rate limit, retry and circuit break outgoing HTTP requests :white_check_mark:
  • Launch :rocket: inside a Docker container :whale: so you don't need to manage the dependencies :raised_hands: :white_check_mark:
  • Quickly deploy :runner: and easily scale :two_men_holding_hands: the number of servers by using Rancher :white_check_mark:

How to use

Use it in your terminal

Run the Docker image in a container exposing the port 4543

docker run -d -p "4543:3000" hfreire/watch-rtp-play

Play RTP1 with ffmpeg player

ffplay http://localhost:4543/playlist.m3u8?channel=rtp1

AirPlay RTP1 to Kodi (use gist) localhost:36667 http://localhost:4543/playlist.m3u8?channel=rtp1

Cast RTP1 to Chromecast (use castnow)


Available REST API endpoints

Swagger documentation available at http://localhost:4543/docs.

Available environment variables

Variable Description Required Default value
PORT The port to be used by the HTTP server. false 3000
API_KEYS The secret keys that should be used when securing endpoints. false undefined
SO_TIMEOUT TCP socket connection timeout. false 120000
LOG_LEVEL The log level verbosity. false info
ENVIRONMENT The environment the app is running on. false undefined
ROLLBAR_API_KEY The server API key used to talk with Rollbar. false undefined

How to build

Clone the GitHub repo

git clone

Change current directory

cd watch-rtp-play

Run the NPM script that will build the Docker image

npm run build

How to contribute

You can contribute either with code (e.g., new features, bug fixes and documentation) or by donating 5 EUR. You can read the contributing guidelines for instructions on how to contribute with code.

All donation proceedings will go to the Sverige fรถr UNHCR, a swedish partner of the UNHCR - The UN Refugee Agency, a global organisation dedicated to saving lives, protecting rights and building a better future for refugees, forcibly displaced communities and stateless people.


Read the license for permissions and limitations.

Docker Pull Command