Skip to main content

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

Project description


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


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


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.


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 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).


  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 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


  • @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

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

neterraproxy-0.3.0.tar.gz (11.5 kB view hashes)

Uploaded source

Built Distribution

neterraproxy-0.3.0-py3-none-any.whl (11.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page