{"id":18513172,"url":"https://github.com/tomzox/nxtvepg","last_synced_at":"2025-04-22T16:58:25.497Z","repository":{"id":154044380,"uuid":"271042711","full_name":"tomzox/nxtvepg","owner":"tomzox","description":"XMLTV EPG browser \u0026 Teletext EPG grabber","archived":false,"fork":false,"pushed_at":"2023-07-23T18:47:27.000Z","size":16899,"stargazers_count":3,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-29T16:51:15.553Z","etag":null,"topics":["capture","dvb","epg","gui","tcltk","teletext","tv-card","tv-guide","xmltv-epg"],"latest_commit_sha":null,"homepage":"http://nxtvepg.sourceforge.net/","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tomzox.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-09T15:39:50.000Z","updated_at":"2024-09-05T15:55:19.000Z","dependencies_parsed_at":"2023-07-26T06:46:59.022Z","dependency_job_id":null,"html_url":"https://github.com/tomzox/nxtvepg","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomzox%2Fnxtvepg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomzox%2Fnxtvepg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomzox%2Fnxtvepg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomzox%2Fnxtvepg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tomzox","download_url":"https://codeload.github.com/tomzox/nxtvepg/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250284670,"owners_count":21405295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["capture","dvb","epg","gui","tcltk","teletext","tv-card","tv-guide","xmltv-epg"],"created_at":"2024-11-06T15:36:43.542Z","updated_at":"2025-04-22T16:58:25.476Z","avatar_url":"https://github.com/tomzox.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# nxtvepg - XMLTV EPG browser \u0026 Teletext EPG grabber\n\nnxtvepg is a browser for TV programme schedules (EPG) stored in XMLTV format.\nnxtvepg supports flexible merging EPG from multiple sources and displaying the\nresult in a compact table view, or a grid view. It supports filtering the TV\nschedule based on a large number of attributes, a filter shortcut list in the\nmain window, adding custom columns to the view to mark programmes matching\npredefined filters, and reminders for individual programmes or filter\nshortcuts.\n\nnxtvepg also features an integrated Teletext EPG grabber, which uses a TV\ncapture card for automatically extracting TV schedules from programme tables in\nTeletext from a given list of channels. Acquired EPG data can be merged and\nbrowsed immediately in the nxtvepg GUI, or exported to files in XMLTV format\nfor use in another browser. Currently, only German TV networks are supported\nwell by the grabber; support for other networks can be added on request,\nprovided they transmit Teletext with usable TV schedules.\n\n*Historically*, nxtvepg was developed for receiving and browsing Nextview\nEPG. Nextview was an European standard for transmission of Electronic TV\nProgram Guides within analog TV broadcasts. However, as the world has switched\nto digital TV broadcast since, it is no longer transmitted today. Therefore,\nsupport for this standard has been removed from nxtvepg in release 3.0.\n\nFor a comprehensive description of features of this software, please refer\nto the manual page: In the source package, see [nxtvepg.pod](./nxtvepg.pod);\nafter installation, type `man nxtvepg` in a shell (UNIX only), or open\n`manual.html` (English language) or `manual-de.html` (German) included in the\npre-compiled package in a Web browser, or open\n\u003chttp://nxtvepg.sourceforge.net/man.html\u003e\n\n## System requirements\n\nFor browsing XMLTV files, any PC sold in the past 20 years will do.\n\nFor the Teletext EPG grabber, a DVB or analog TV tuner card is required\nand you need to be able to receive a network that transmits Teletext\nservice with programme tables.\n\nThe Linux version supports all Digital TV (DVB) cards and analog cards\nfor which a v4l2 (\"video 4 linux, version 2\") compatible driver exists\nthat supports teletext reception via /dev/vbi (e.g. bttv, saa7134,\ncx8800, possibly even USB TV boxes).  NetBSD and FreeBSD versions\nsupports all cards which are supported by the bktr driver.\n\nThe MS Windows version supports only analog TV cards that are supported via\nthe separately provided WDM driver interface DLL `VbiAcqWdmDrv.dll`.\nPre-requisite for that is a vendor-provided WDM driver module that supports\n\"VBI\" decoding (e.g. teletext). Digital TV cards (DVB) are currently not\nsupported for MS Windows.\n\n### Linux software requirements\n\n- For the Teletext EPG grabber (optional): Either V4L2 drivers (i.e. video for\n  Linux, API 2) when using analog TV capture cards, or Digital TV drivers for\n  DVB capture cards.\n- When compiling from source: GNU C++ Compiler with support for C++14.\n  You'll also need development (i.e. \"-dev\") versions of various\n  packages such as \"xorg\" so that header files are available.\n- Tcl/Tk version 8.5 or 8.6.\n  Sources available for download from \u003chttp://www.tcl.tk/\u003e\n- Any release of X11R5 or X11R6\n  Note: X11 and Tcl/Tk are not required if you only build the daemon\n\n### NetBSD software requirements\n\n- kernel \u003e= 1.5 including the bktr driver 2.17 or later,\n  available from \u003chttp://vulture.dmem.strath.ac.uk/bt848/\u003e\n- other dependencies are same as for Linux.\n\n### Windows software requirements\n\n- For the Teletext EPG grabber (optional): A WDM driver for your analog\n  TV card that supports VBI decoding. Use of the WDM driver (based on\n  DirectShow) requires DirectX 9 or later.\n- Windows 95: the winsock2 DLL is required (`ws2_32.dll`, for the daemon\n  feature) which - in contrary to newer Windows versions - was not included\n  with this OS.\n- All Windows versions starting with Windows 95 are supported.\n\nNote the Windows version currently does *not* support Digital TV capture\ncards.\n\n\n## UNIX installation procedure (when compiling from source)\n\n- Optional, for Teletext EPG grabber only: first install a teletext decoder\n  application (e.g. `aleVT`) to verify that your TV card drivers work correctly.\n\n- There's currently no \"configure\" script, so you have to manually check\n  path definitions at the top of the Makefile, esp. for the Tcl/Tk libraries,\n  include path and script libraries.\n\n- There are also several compile-time options in the Makefile which you\n  might want to consider, however the defaults should work everywhere.\n\n- If you compile on a operating system other than Linux, BSD or Windows,\n  then replace use of `epgvbi/btdrv4linux` in the Makefile with\n  `epgvbi/btdrv4dummy`. This will disable EPG acquisition via the TV card, but\n  you still can use network acquisition mode to receive data from a supported\n  platform.\n\n- `make`:\n    * Note: typing `make nxtvepg` will not work since there are other targets\n      which need to be built first.  Hence just start make without parameters.\n    * If compilation fails with massive syntax errors, check the type\n      definitions in epgctl/mytypes.h first.  Required types are: bool,\n      schar, uchar, sint, uint, slong, ulong.  Compilation may fail if these\n      are already defined in system header files; in this case you probably\n      have to comment out nxtvepg's definition.\n    * If compilation fails due to missing \"include files\", you probably lack\n      development versions of standard libraries. On Debian/Ubuntu you need:\n      `apt-get install tcl8.6 tcl8.6-dev tk8.6 tk8.6-dev`\n      `apt-get install libx11-dev libxmu6 libxmu-dev`\n      For Fedora and other RPM-based systems you need:\n      `yum install tcl-devel tk-devel libXmu-devel perl-Pod-Html`\n    * To build the \"nxtvepgd\" executable type `make daemon` or `make all`.\n      This will compile one extra module and otherwise just link a smaller\n      executable which does not contain the graphical user interface.\n    * To compile the tvsim test \u0026 development suite too, invoke `make all`\n      (Note these tools are not installed into system directories since they\n      are intended for temporary use in debugging only.)\n    * Intermediate objects and the binaries are generated in a subdirectory\n      named `build-\u003cplatform\u003e` (e.g. build-i386 for an Intel compatible)\n\n- `make install`:\n  This will copy the nxtvepg and nxtvepgd executables and their respective\n  manual pages into the system directories configured in the Makefile\n  via variable `prefix`. Usually you need to \"su root\" to have permission\n  to do so.\n\n- Invoke the build executable build/nxtvepg. For browsing XMLTV files,\n  simply add their path on the command line to load and display their\n  content. When started without arguments nxtvepg will initialls show an\n  screen with the nxtvepg logo and a small help text. Follow the help to\n  enable the Teletext EPG grabber, or read manual chapter \"Getting\n  Started\".\n\nIf the GUI shows up but does not react to any input, you probably\nneed to tell Tcl/Tk where to find its libraries. To do so, correct\nthe paths in `TCL_LIBRARY_PATH` and `TK_LIBRARY_PATH` in the Makefile.\nIf you need to change anything besides the Makefile, please let me\nknow about it (i.e. send me the diffs)\n\n\n## Windows installation procedure (for pre-compiled binary package)\n\n- Unpack the zip file into an empty directory.\n\n- When intending to use the Teletext EPG grabber: Make sure you've stopped\n  your TV viewing application and any other video applications, else\n  nxtvepg willl not be able to load data, because only one application\n  may use the TV card at the same time.)\n\n- Invoke the executable nxtvepg.exe\n\n    * For browsing pre-existing XMLTV files, simply load them via the\n      Control menu.\n    * For acquiring Teletext EPG, set up the TV card driver via the\n      \"TV card input\" and then enable the \"Teletext grabber\". Both\n      dialogs can be found in the Configuration menu.\n\n### Compilation from source for Windows\n\n- Note this is NOT required for regular releases for which a pre-compiled\n  binary release is provided. This is required only if you downloaded the\n  latest SW version from github, or if you want to change the software.\n- Fastest way is to cross-compile for Windows under Linux.  You need to\n  install \"gcc-mingw-w64\" package and then type `make -f Makefile.win`\n- Alternatively you can install GNU/Cygwin on your Windows host, see\n  \u003chttp://www.cygwin.com/\u003e.  Most important are packages for make, gcc,\n  mingw (\"Minimalistic GNU for Windows\") and win32 header files.  After\n  installing Cygwin, start a shell, cd to the nxtvepg directory and type\n  \"make\".  If you're not using NT or W2K you may have to adapt the OS\n  detection code in Makefile and/or Makefile.win, i.e.\n  `ifeq ($(OS),Windows_NT)`\n- To generate the help menus from the documentation in POD format you\n  need Perl5 (not essential unless you want to modify the help menus)\n  from \u003chttp://www.perl.org/\u003e or as Cygwin package\n\n\n## Problem and bug reports\n\nBefore you email me any bug reports, please check the manual page as well\nas the TODO and CHANGES files. And be *comprehensive* in describing your\nproblem. At least include names and version numbers of your operating system,\nnxtvepg, possibly the bttv driver and any other software that may be\ninvolved. If it looks like a hardware related problem (e.g. acquisition\ndoes not work at all) also include the exact name of you TV card hardware.\nIf DScaler or K!TV work with the same hardware, mail me the version number and\ndescribe your hardware configuration settings. If there is an error message,\nquote the message in full length and exactly as printed, even if you do not\nunderstand its relevance.\n\nIn case nxtvepg crashes, or if you suspect internal errors, you need to\nrecompile with debug support to allow me to analyze the problem.  Please\nadd the -g option to CFLAGS in the Makefile and enable all debug options in\nmytypes.h by assigning ON instead of OFF. If you know which modules are\nresponsible, you can also comment out `DPRINTF_OFF` at the top of those\nmodules. Then try to reproduce your problem and send me the resulting\ndebug.out log file.\n\nThe latest version of this software is available at:\n\u003chttp://github.com/tomzox/nxtvepg\u003e\n\nBest way to provide feedback is via email: tomzo (at) users.sourceforge.net\n\nhave fun.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomzox%2Fnxtvepg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomzox%2Fnxtvepg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomzox%2Fnxtvepg/lists"}