Skip to content

huxuan/iptvtools

Repository files navigation

IPTVTools

A set of scripts that help to better IPTV experience.

CI CommitLint DevContainer Release Renovate Semantic Release Coverage Release PyPI PyPI - Python Version GitHub

pdm-managed pre-commit Checked with mypy Ruff Conventional Commits Pydantic v2 Copier Serious Scaffold Python Open in Dev Containers

Important

IPTVTools is in the Beta phase. Changes and potential instability should be anticipated. Any feedback, comments, suggestions and contributions are welcome!

Features

Scripts currently provided:

  • iptvtools-cli filter
    • Merge from different resources.
    • Check the tcp/udp connectivity.
    • Filter by custom criteria, e.g. resolution.
    • Match with templates and EPG.
    • Format the url with UDPxy if provided.
    • Unify channels' titles.

Features planned on the road:

  • Scan certain ip and port range to find new channels.
  • Establish a lightweight database for routine maintenance.

Besides, all scripts should be lightweight and able to keep running regularly after proper configuration.

Last but not least, any ideas, comments and suggestions are welcome!

Prerequisites

To filter by stream information, e.g., resolution/height, ffmpeg (or ffprobe more precisely) is needed, please install according to the documentation.

Installation

It is recommended to manage iptvtools via pipx:

pipx install iptvtools

Usage

Please refer to the documentation while some useful information in wiki.

📜 License

MIT License, for more details, see the LICENSE file.