ezIPTV

by spencerthayer

GitHub Readme.md

ezIPTV v0.5

ezIPTV is a simple and free personal IPTV manager.

Services like Xtream Editor and IPTV EPG are clunky, expensive, and for the most part, suck. Editing large IPTV lists on these services is so annoying and slow making that it makes the fact that it costs money feel like a rip-off. While these services do offer a convenient and reliable solution for EPG a smart IPTV user should be able to find EPG data for free.

ezIPTV was created to be a DIY solution for IPTV enthusiasts. Instead of managing your M3U on a clunky website's database ezIPTV converts M3U files into CSV so that they can be manipulated easily with any spreadsheet software such as Google Sheets, Microsoft Excel, Libre Office Calc, and Apache Calc.

Oh, also it's all free. ezIPTV was created with the intention of using the free Heroku self-hosted services. And if you came here from Reddit thanks!

How to install on Heroku

Deploy

With Heroku, anyone can build their own ezIPTV for free in just a few minutes!

THAT'S IT!

How to install on a server

Note: ezIPTV cannot be run within a domain subdirectory as of right now!

Even on hosted servers ezIPTV installation is extremely easy.

  • Either clone the repository git clone https://github.com/spencerthayer/ezIPTV ezIPTV or download the zip.
  • Clone or extract ezIPTV into the root directory of your site.
  • Ensure ezIPTV has read/write permissions for all directories.
  • Open your new app and follow the instructions.
  • Ensure that the setup correctly created the .htaccess mod rewrite capabilities.

THAT'S IT!

How to use

Using ezIPTV isn't actually super easy, but it's not hard once you figure it out.

Format your M3U

  • Create a new link and copy and paste the links to the IPTV services into the field for the M3U links to be converted into a CSV file. You combine multiple M3Us.
  • Save your new link.
  • Click the CSV button to download the CSV file.
  • Now import that CSV file into your favorite Spreadsheet software.

To see an example CSV file download this sample.

Format your CSV file

ezIPTV converts the M3U scheme into the following table column names: ACTIVE, ERROR, REGION, CODE, CATEGORY, GROUP, TAG, ID, NAME, EPGID, LOGOURL, URL, EPGURL, PROVIDER, NOTES

  • ACTIVE: If the field is YES the channel will show in the M3U. Anything other than YES will not be published.
  • ERROR: If a channel has an error put the error code for the channel in this field. (This doesn't do anything at the moment but will in a later version.)
  • REGION: This is the region for the channel, typically it looks like USA or CANADA.
  • CODE: This is the country code for the channel, typically it looks like US or CA.
  • CATEGORY: This is the category for the channel, this is something like LOCAL or KIDS.
  • GROUP: This is used to supersede REGION and CATEGORY to group channels together, this can be something like NEWS.
  • TAG: This is a special note used to organize channels in regions, categories, and groups. This can most likely be used to make favorites with a special character like .
  • ID: This is the original ID of the channel from the M3U file unaltered. This should be left alone.
  • NAME: This can be used to change the names of channels.
  • EPGID: This is the EPG or TVG code ID for the channel. Use this to make sure you're getting accurate EPG data from your EPG XML.
  • LOGOURL: This is the URL to the channel logo.
  • URL: This is the streaming URL for the channel. This should be left alone.
  • PROVIDER: This an extra field to help organize the provider of the channel. (This doesn't do anything at the moment but will in a later version.)
  • NOTES: This is an extra field used for notes. It's good to keep notes and stay organized.

Publish your CSV file

As of this version, ezIPTV does not allow you to upload a CSV file. Until this changes, it is recommended publishing the CSV file to the web using Google Sheets to CSV.

Getting your new M3U file

  • Publish the Google Sheets CSV URL into the field for a link to the CSV used to generate the M3U.
  • Save your link.
  • Click the M3U button to get a link to your new M3U file.
  • Now import that CSV file into your favorite Spreadsheet software.

ToDo

If you can help me work out these issues or donate to support my development I would appreciate it.

  • Allow the application to run within a domain subdirectory.
  • CSV and M3U file management (Upload / Delete).
  • Backup site data (Import / Export).
  • One click code upgrades.
  • M3U list filtering.
  • EPG XML combination and compression.
  • YouTube URL to RSS conversion.
  • User management?

Dependencies

In a later version, this list of dependencies will automagically download to remain up to date. Right now, don't worry about it. It works.

Version Changes

  • v0.1: Release.
  • v0.2: General bug fixes.
  • v0.3: Security issues fixed without subdomain support.
  • v0.4: UI/UX improvements. Code cleaned up a little.
  • v0.5: File upload and management.