neterraproxy

A python version of the neterra proxy java app written by @sgloutnikov


License
MIT
Install
pip install neterraproxy==0.3.0

Documentation

NeterraProxy

This is a Python version of the neterra proxy java app written by @sgloutnikov.

What?

NeterraProxy is an on-demand m3u8 playlist/playback daemon for Neterra.tv, running on Python (2.7.x).

Why?

Have the freedom to watch on your desired IPTV player or TV (Perfect Player, Kodi IPTV Simple, Android Live Channels, GSE Smart IPTV Player, etc). Play links issued by Neterra expire after 12 hours to prevent abuse. Traditional playlist generators need to be run again in order to generate new links. This is not the case for NeterraProxy.

How?

NeterraProxy generates a specialized playlist that points to itself rather than Neterra. When NeterraProxy receives a playback request it determines the context of the request and responds with a 301 redirect to a valid corresponding Neterra play link. It automatically re-authenticates if the session has expired.

Electronic Program Guide (EPG)

The application has a built-in scheduler that downloads an XMLTV file with the program guides for the most of the offered by Neterra.tv channels. The scheduler runs every 4 hours. Please note that the application does not perform the download on start - you need to keep it running for 4 hours. The xmltv file is downloaded in the specified data directory (see the section Instructions).

Instructions

  1. Install the Python package pip install neterraproxy.
  2. Start the application with python -m neterraproxy your_nettera_username your_nettera_password the_proxy_data_directory
    • Active subscription for nettera.tv is required for the provided above user.
    • The script data directory is used to store the proxy log file and the xmltv epg file.
  3. Leave the proxy application running in the terminal. Ctrl + C will terminate NeterraProxy.
  4. Use the following URLs to connect NeterraProxy with your favorite IPTV player:

Run as Linux Service

  1. Install the package as per the instruction above
  2. Download the netteraproxy.service unit file from here
  3. Edit the file and provide your username, password and data directory in the line Environment='ARGUMENTS=-m neterraproxy your_neterra_username your_neterra_password the_proxy_data_directory'
  4. Copy the unit file in /lib/systemd/system
  5. Start the service with sudo systemctl start neterraproxy.service
  6. Check the status with sudo systemctl status neterraproxy.service and verify the proxy functions properly
  7. Enable the service to start with the OS sudo systemctl enable neterraproxy.service

Acknowledgements

  • @sgloutnikov for his Java proxy and the answers during the development of the Python version
  • Kodi Fan Forum BG for collecting and hosting the XMLTV EPG file