Skip to content

Home

Jump to bottom
Kalan Dominick edited this page Nov 3, 2025 · 5 revisions

Welcome to the Piparr wiki!

Intro

Piparr is a stream ingress server that stands in the middle of your media server (Plex/Jellyfin) and your live TV service providers.

Setup Guide

The recommended way to setup is to use Docker, however it is possible to also run by using Node.js (18+) directly.

Docker

Install Docker

sudo docker pull ghcr.io/domkalan/piparr:latest
sudo docker run -d --name piparr --restart always -v /opt/piparr-data:/app/data -p 34400:34400 ghcr.io/domkalan/piparr:latest

Docker-compose

services:
  piparr:
    image: ghcr.io/domkalan/piparr:latest
    container_name: piparr
    restart: always
    ports:
      - "34400:34400"
    volumes:
      - /opt/piparr-data:/app/data

Direct

git clone https://github.com/domkalan/piparr
cd piparr/

# install deps
npm i

# build
npm run build-client
npm run build-server
npm run build-workers

# 
npm run start

Steams and Channels Concept

The overall design of Piparr allows you to define channels that are independent of stream providers, meaning a channel can source from multiple streams. If one provider goes down or is at its max connection limit, Piparr will automatically switch to the next stream provider. Once you have provided a stream, it will be parsed on the next update cycle and the available channels on the stream can be bound using the channel editor.

Stream Providers

I do not make any recommendations on which TV streaming provider to use, however a quick Google search will usually provide you with some good information on who to choose. There are some important thing to note when choosing a provider:

  • Simulcast/concurrent connections limit
  • HLS/M3U provided access URL (direct .apk or web client TV providers are not supported)
  • EPG provided access URL (optional but makes for a better experience)
  • Streaming format and codec, M3U/HLS and Direct H264 (AVC) are supported

EPG Providers

Similar to the stream providers above, I do not make recommendations on where to source your EPG data from. There are a few public providers out there that provide a reasonable service at low or no cost.

Clone this wiki locally