iptv

README

free5GC IPTV

This is an simple IPTV Server that you can self host on Linux / Windows base on FFmpeg and Go.

This project is maintained by free5GC for validation of IPTV applications in 5G core network.

Installation

Install Dependencies

• FFmpeg

  sudo apt install -y ffmpeg
  

• node.js

  sudo apt-get install nodejs
  

• yarn

  sudo apt install -y curl
  curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
  echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
  sudo apt update && sudo apt install yarn
  

• npm

  sudo apt-get install python-software-properties
  sudo add-apt-repository ppa:gias-kay-lee/npm
  sudo apt-get update
  sudo apt-get install npm
  

• golang

  wget https://dl.google.com/go/go1.12.9.linux-amd64.tar.gz
  sudo tar -C /usr/local -zxvf go1.12.9.linux-amd64.tar.gz
  mkdir -p ~/go/{bin,pkg,src}
  echo 'export GOPATH=$HOME/go' >> ~/.bashrc
  echo 'export GOROOT=/usr/local/go' >> ~/.bashrc
  echo 'export PATH=$PATH:$GOPATH/bin:$GOROOT/bin' >> ~/.bashrc
  echo 'export GO111MODULE=off' >> ~/.bashrc
  source ~/.bashrc
  

Build Project

• Install go package

  go get -u github.com/gin-contrib/static
  go get -u github.com/gin-gonic/gin
  go get -u github.com/urfave/cli
  go get -u gopkg.in/yaml.v2
  

• Build Web Client

  cd web-client
  yarn install
  yarn build
  cd ..
  vim iptvcfg.conf # Configure iptv details
  mkdir hls        # Create chache folder, default is ./hls
  go run iptv.go
  

How to watch IPTV

The IPTV channel playlist's location depends on what you configure in iptvcfg.conf's IPTVServer -> ServerAddr

And the playlist's location will be: IPv4:Port/iptv/index.m3u

1. Generally Using Web to check IPTV channel is an general way to do it. You can use our web to view IPTV channel.

   Open your web browser, goto the ip:port you have configured in iptvcfg.conf's ServerAddr.

2. On PC You can use:

   • VLC
   • Kodi
   • IINA (only on OSX)

3. On Android

   • NET IP TV
   • Kodi

4. On iOS

   • GSE SMART IPTV
   • Movie Stream: Cast & Streaming

Contact Information

You can contact free5gc.org@gmail.com.

License

We are using Apache 2.0 for the project.

Release Note

v2020-03-31-01

• Implement unicast IPTV server
• Verify IPTV application running on 5G core network