Code Monkey home page Code Monkey logo

tempest-epg-generator's Introduction

Tempest EPG Generator

The Most Advanced Programmable GUI XMLTV EPG Generator

CC Release PHP TempestWIKI Issues

Total Available Siteconfigs Total Covered Countries Total Available Channels
260 149 +183000



     Creative Commons License


This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.

Copyright © 2019-2022 by Kivanc Altug

Contact Info:
📧 [email protected]

tmpstr

What is Tempest?

Tempest is a fully programmable XMLTV formatted EPG(Electronic Program Guide) generator bundled in a single php file with;

    ✔ Graphical User Interface (GUI) & Optimization For Mobile Devices
    ✔ Multiple Website Configuration Support
    ✔ The Highest Scrapping/Generating Speed
    ✔ The Lowest Memory Consumption For Best Performance On All Devices
    ✔ Multiple Platform Support (Windows/Unix etc.)
    ✔ All-in-One Single File Without Need For Any External Library/Software
    ✔ Multiple Async URL Support Up to 10
    ✔ Full Support For XMLTV Standart Elements
    ✔ Daylight Saving Time(DST) Support For Automatic Time Offset Changes
    ✔ Easy Configuration Maker & Editor
    ✔ Powerful & Simple Command Syntax For Combo-Operations/Modifications
    ✔ Unlimited Command Usage
    ✔ Scrapping Engine Built with Regex (Regular Expression) For Powerful Operations
    ✔ Built-In Cyclone Module to Add Alternative For Failed Channel
    ✔ Built-In Time Converter to Change Times of All Shows Into Requested Time Offset (DST Support)
    ✔ Built-In Inverter Module to Modify/Move XMLTV Elements Into Other Elements With Requested Order & Style
    ✔ Built-In Fusion Module to Keep Previous Dated Shows Upto 15 Days For Catch-Up Service
    ✔ Built-In GUI Configuration Maker With Channel Picker/Editor & Auto-Duplicate Channel Verification
    ✔ Built-In GUI Configuration Debugger
    ✔ Built-In File Downloader (via GUI) & Gz/Zip Compression Support
    ✔ Multiple Configuration File Support Up to 5000 Channels For Each
    ✔ Scheduled Operations (such as crontab etc.)
    ✔ Remote Access, Operations & Downloading (port-forwarding required)
    ✔ Support For Scrapping From HTML,XML,CSV,TXT,XLS,PDF(Experimental) & More..
    ✔ Many More Features

How can I run Tempest?

All you need to do is downloading "tempest.php" file and locate it to root or any other place in your php server directory. Then you can call it from your browser as an example;

"http://localhost:port/tempest.php"

or from your commandline;

"php /path/of/your/server/tempest.php"

Tempest will generate its own subfolder structure and necessary files on first start-up. It is that easy.

Note: It is strongly advised for Unix users to set proper ownership/permissions of their php server before first start-up to let Tempest generate its folder/files.

What else I need for Tempest?

Basicly, nothing except a running PHP server for GUI operations or php.exe file which can be downloaded from official php page. Tempest is developed on PHP 7 enviroment but should work fine with any PHP version > 5.3. Also some quick tests are showing that Tempest will work fine on PHP 8 (tested on PHP 8.1)

How can I use Tempest?

Once you run Tempest, you can choose one of the modes from drop-down list as;

    🔹 Siteconfig Maker => You can create your own website configuration file
    🔹 Siteconfig Debugger => You can debug choosen website configuration file
    🔹 EPG Generator => You can generate your EPG file from choosen Tempest Configuration file
    🔹 Channel Generator => You can generate channel list from choosen website configuration file
    🔹 Siteconfig Editor => You can edit/modify or delete choosen website configuration file
    🔹 Tempest Configurator => You can create/edit or delete choosen Tempest Configuration file

Also you can download ready-to-use website configuration files from repo and paste into tempest_config/site_config subfolder to use.

How can I create my own website configurations with Tempest?

To create your own website configuration(siteconfig) files, you will need an internet browser with "inspection" feature in order to find data urls and required url parameters. Then all these data may be inserted to predefined slots of "Siteconfig Maker". Tempest supports total of 10 async urls (4 for indexing, 2 for additional detail pages and 4 for channel list creating) which may be used with GET,POST,HEAD,OPTIONS,DELETE and PUT request methods. For scrapping EPG data from captured url response, you will also need basic level of regex(regular expression) knowledge which lots of how-to website may be found in internet, as minimum. Once you click "Save" button, your siteconfig file will be created in tempest_config/site_config subfolder. Regarding how to use XMLTV elements and Tempest command syntax, please take a look into TempestWiki document. tmpst

How can I create/update channel list with Tempest?

To create or update channel list, choose "Channel Generator" and search for desired siteconfig name in drop-down list. Once you click "Generate" button, new channel list will be created in tempest_config/site_config subfolder.

chgn

How can I prepare Tempest Configuration?

Tempest configuration file is an instruction list for Tempest to generate EPG file(s) in requested way/order. To create or update Tempest configuration files, you can choose new or an existing config name from drop-down list of "Tempest Configurator". In "File Configuration" tab you can set;

    🔹 Name of xml file(s) to be generated
    🔹 Timespan
    🔹 Page/channel delays & retry/timeouts
    🔹 Time converter module
    🔹 Fusion module
    🔹 Inverter module
    🔹 Index-only mode
    🔹 Logging

flcfg

In "Channel Configuration" tab you can add/remove/change position of channels only with a few click and "Register" your channels.

chcfg

In "Channel Indexer" tab you can edit channel ids,xmltv_ids,display names and set cyclone module for channels. Cyclone module will automatically run when selected channel failed or returned with no data and update failed channel with selected cyclone alternative. Also auto-duplicate check for xmltv_ids will be done silently and duplicated xmltv_ids will be highlighted.

cindx

How can I start generating xmltv files?

After saving Tempest configuration file, you are ready to start generating your xmltv file(s) by choosing "EPG Generator" tab and selecting Tempest configuration file which you want to use, from drop-down list. Also from same tab, you can choose .gz compression for the files will be generated and download option for remote users. Please note that if you tick multiple file download options, you will download a single .zip file which contains all the files you requested.

gnrtr

And clicking "Generate" button will start the process..

stgrb

Important Note for UNIX Users

There is 1 very important setting needs to be done by UNIX users since UNIX OS is not allowing me to set this parameter from script side.
For NGINX;

fastcgi_read_timeout

and for APACHE;

TimeOut

parameter which server default is 300(5 mins), needs to be set some higher value such as 1800(30 mins) or 3600(1 hour). Otherwise you may have a timeout during the process after 5 minutes of initialisation. These parameters may be set as below for NGINX;

in /etc/nginx/nginx.conf file, set under http directive. It will look like;

http {
#.....
fastcgi_read_timeout 1800;
#..
}

and for APACHE; you need to change TimeOut value in your httpd.conf or vhost config file. New setting will be applied after server reload as below;
for NGINX;

sudo service php7.0-fpm reload ("php7.0-fpm" is the one I use so you have to modify it based on php version you use)
sudo service nginx reload

and for APACHE;

sudo service apache2 reload
or
sudo systemctl reload apache2

For Windows, I didnt see such setting or limitation. I think it is set to "no limit" by default for Windows.

For more detailed information about usage and features, please take a look into Declaration and TempestWIKI documents..

If you like the project, please consider a donation to support

Wise Account (Europe & General)

Account Owner : Kivanc Altug Mutal
Currency : € (Euro)
BIC : TRWIBEB1XXX
IBAN : BE25 9670 4163 4382
Bank Address : Avenue Louise 54, Room S52, Brussels, 1050, Belgium

Wise Account UK

Account Owner : Kivanc Altug Mutal
Currency : £ (GBP)
Sort Code : 23-14-70
Account No : 84736167
IBAN : GB18 TRWI 2314 7084 7361 67
Bank Address : 56 Shoreditch High Street, London, E1 6JJ, United Kingdom

Wise Account US

Account Owner : Kivanc Altug Mutal
Currency : $ (USD)
Routing No : 084009519
Account No : 9600000000354348
Account Type : Checking
Bank Address : 19 W 24th Street, New York NY, 10010, United States

tempest-epg-generator's People

Contributors

k-vanc avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.