losenmann/iptv-service repository overview

⁠IPTV Service

⁠What is IPTV Service?

IPTV Service is a collection of all the necessary tools for convenient access to channels and program guides on a local network. The service allows you to convert the program guide into different formats with automatic updating via cron. In addition, you can convert the program guide from JTV to XMLTV. The service has a built-in proxy server for working with the Multicast stream and subsequent use via HLS. Taken together, the combination of various solutions allows you to simultaneously use different channel list formats and program guides, as well as use UDPXY.

⁠Supported Formats

• m3u | m3u8 | xspf⁠ - Channel list
• jtv | xmltv⁠ - Program guide

⁠Connection points

• http://example.com:4022/iptv/ - File server for program guide and channel lists
• http://example.com:4022/status - UDPXY web interface

⁠How to use this image

⁠Docker compose

version: "3.9"
services:
  iptv-service:
    container_name: "IPTV-Service"
    image: "losenmann/iptv-service:0.0.2"
    networks:
      - network-multicast
    expose:
      - 4022
    environment:
      - CRON_TVGUIDE=5 6 * * 1
      - CRON_PLAYLIST=5 6 * * 1
      - TVGUIDE_JTV_URL=https://programtv.ru/jtv.zip
      - PLAYLIST_HLS_URL=http://example.com/hls.xml
      - PLAYLIST_UDP_URL=http://example.com/udp.m3u
      - UDPXY_HOST=iptv.example.com
    healthcheck:
      test: ["CMD", "healt"]
      start_period: 20s
      interval: 30s
      timeout: 3s
      retries: 3
    restart: always

networks:
  network-multicast:
    name: "network-multicast"
    driver: "macvlan"
    driver_opts:
      parent: "eth0"
    ipam:
      config:
        - subnet: "192.168.98.0/24"
          gateway: "192.168.98.1"
          ip_range: "192.168.98.16/28"

⁠Environment Variables

• CRON_TVGUIDE - Setting up cron jobs to update tvguide
• CRON_PLAYLIST - Setting up cron jobs to update playlists
• PLAYLIST_HLS_URL - Link to playlist of HLS channels
• PLAYLIST_UDP_URL - Link to playlist of Multicast channels
• TVGUIDE_JTV_URL - Link to tvguide
• UDPXY_HOST - IP address or DNS name host of the UDPXY