ZipZup

לזפזופ ולתפאָרת

M3U Tuner (with XMLTV guide) for Israeli TV channels with websites

Why I made this

I wanted to integrate the news channels I watch into apps that I use (Kodi, Jellyfin, NextPVR, VLC). I have no desire to download each and every channel's app to my phone/computer/TV.

Note the existence of the idanplus plugin for Kodi. I found it would freeze on certain channels and of course it only works on Kodi.

M3U IPTV is so widely supported that I believe you could stream it from a potato (though I have not tried).

Setup (Docker Compose)

(If you haven't heard of docker or don't know how to use it I'm sure ChatGPT can help you)

You will need a machine to host the server. This can be your computer for example if that is the only device you will use to watch. Alternatively if you want to give constant access to your whole LAN you'll need a machine that's always on and connected to your LAN.

1. Install Docker

2. Make a new folder zipzup

3. Make a docker-compose.yaml file in zipzup

   services:
       zipzup:
           image: ghcr.io/szaionz/zipzup:stable
           ports:
               - "5000:5000"
           depends_on:
               redis:
                   condition: service_healthy
               postgresql:
                   condition: service_healthy
           environment:
               POSTGRES_USER: zipzup
               POSTGRES_PASSWORD: zipzup
               POSTGRES_DB: zipzup
               POSTGRES_HOST: postgresql
   
       redis:
           image: valkey/valkey:8.1.2-alpine3.22
           healthcheck:
               test: redis-cli ping || exit 1
               interval: 1m30s
               timeout: 30s
               retries: 5
               start_period: 1m
               start_interval: 5s
       
       selenium:
           image: selenium/standalone-chromium
           healthcheck:
               test: 'curl -f http://localhost:4444/wd/hub/status || exit 1'
               interval: 1m30s
               timeout: 30s
               retries: 5
               start_period: 1m
               start_interval: 5s
   
       postgresql:
           image: postgres:16-alpine
           environment:
               POSTGRES_USER: zipzup
               POSTGRES_PASSWORD: zipzup
               POSTGRES_DB: zipzup
           healthcheck:
               test: >-
                   pg_isready --dbname="$${POSTGRES_DB}" --username="$${POSTGRES_USER}" || exit 1; Chksum="$$(psql --dbname="$${POSTGRES_DB}" --username="$${POSTGRES_USER}" --tuples-only --no-align --command='SELECT COALESCE(SUM(checksum_failures), 0) FROM pg_stat_database')"; echo "checksum failure count is $$Chksum"; [ "$$Chksum" = '0' ] || exit 1
       
       
               interval: 5s
               start_interval: 5s
               start_period: 5m
   
           volumes:
               - postgres_data:/var/lib/postgresql/data
   
       worker:
           image: ghcr.io/szaionz/zipzup:stable
           entrypoint: "/app/worker_entrypoint.sh"
           user: root
           environment:
               POSTGRES_USER: zipzup
               POSTGRES_PASSWORD: zipzup
               POSTGRES_DB: zipzup
               POSTGRES_HOST: postgresql
           depends_on:
               selenium:
                   condition: service_healthy
               redis:
                   condition: service_healthy
               postgresql:
                   condition: service_healthy
   
           
   
   volumes:
       postgres_data: {}

4. Run

   docker compose up -d

You should then be able to find the tuner at http://localhost:5000 and the guide at http://localhost:5000/epg.xml.

Access (Kodi)

1. Install IPTV Simple Client
2. Go to the addon settings and click 'Edit "<something in quotes>"'
3. Under General, ensure M3U playlist URL is set to http://localhost:5000 (or wherever your server is hosted):
4. Under EPG, ensure XMLTV URL is set to http://localhost:5000/epg.xml
5. Enjoy:

Jellyfin (סנפיריבה)

Final Notes

If someone wants to pay for a VPS to host this on the internet, let me know (through an issue or PR).