🍓 IPTV on Raspberry Pi — Complete Setup 2026
Build a cheap IPTV box with a Raspberry Pi. Kodi, LibreELEC, Tvheadend or Jellyfin — all explained. From around €60 total.
🎯 Which Raspberry Pi?
| Model | 4K HEVC? | 4K AV1? | Price | Good for |
|---|---|---|---|---|
| Raspberry Pi 5 | ✅ Hardware decode | ⚠️ Software (CPU 80%) | ~€80 | 4K IPTV, everything |
| Raspberry Pi 4 (4GB) | ✅ Hardware decode | ❌ | ~€55 | 4K HEVC, 1080p |
| Raspberry Pi 400 | ✅ | ❌ | ~€75 | 4K + built-in keyboard |
| Raspberry Pi Zero 2 W | ❌ | ❌ | ~€20 | SD/720p only |
Recommended: Pi 5 if you want 4K, Pi 4 (4GB) if budget matters most.
📦 What else you need
- microSD card 32GB+ (Class 10 / A2) — ~€10
- Official USB-C power supply (Pi 5: 5V/5A, Pi 4: 5V/3A) — ~€10
- HDMI cable (micro-HDMI to HDMI on Pi 4/5) — ~€5
- Case with cooling (the Pi 5 runs hot) — ~€15
- Optional: USB ethernet for more stable streaming — ~€10
- Optional: USB SSD for recordings — from €30
Total: ~€100 for a complete Pi 5 setup, ~€75 for a Pi 4.
🚀 OS choice — which one for IPTV?
1. LibreELEC + Kodi (recommended for IPTV)
A lightweight Linux that only runs Kodi. Boots in 15 sec, works like an appliance.
- ✅ Fastest boot
- ✅ Optimised for Kodi
- ✅ Auto-updates
- ✅ PVR IPTV Simple Client built in
- ⚠️ Kodi only, no other apps
Install: Raspberry Pi Imager → Choose OS → Other specific-purpose OS → LibreELEC → flash to SD → boot the Pi.
2. Raspberry Pi OS + Kodi manually
- ✅ Full Linux desktop
- ✅ Kodi via
sudo apt install kodi - ✅ Other apps possible (browser, RetroPie)
- ⚠️ Slower boot
- ⚠️ More maintenance
3. Tvheadend (TV server backend)
Not a player but a server that delivers channels to other devices. Pair it with LibreELEC for the front end.
- ✅ A central "tuner" for the whole house
- ✅ Recording / DVR scheduling
- ✅ Web interface
- ✅ Works with a DVB-T tuner too
- ⚠️ Steep setup — not for beginners
4. Jellyfin (on Pi 5)
The Pi 5 is just powerful enough to run a Jellyfin server for 1-2 streams. For more, use a NAS.
⚙️ LibreELEC + Kodi setup
Step 1: Flashing
- Download Raspberry Pi Imager from raspberrypi.com
- Open Imager → Choose OS → Media player OS → LibreELEC
- Pick the correct Pi model
- Choose Storage → select the microSD
- Write → wait 5-10 min
- SD into the Pi, HDMI into the TV, power on
Step 2: First boot
- Language: English
- Configure WiFi (or ethernet — recommended)
- Set a hostname
- Enable SSH (for remote management later)
Step 3: IPTV (PVR IPTV Simple Client)
- Kodi → Settings (gear) → Add-ons → My Add-ons → PVR clients
- PVR IPTV Simple Client → Enable
- Configure → General → M3U Play List URL
- Paste your M3U URL (or a File Path to a local .m3u)
- EPG Settings → XMLTV → URL
- OK → Restart Kodi
- Home screen → TV appears
Step 4: A TiviMate-style skin
The default Kodi look is a bit dull. For an IPTV-friendly skin:
- Aeon Nox Silvo — the most popular IPTV skin
- Estuary MOD V2 — a modern look
- Confluence — classic
Install: Settings → Interface → Skin → Get more.
📡 Tvheadend setup (for pros)
Install
sudo apt update
sudo apt install tvheadend
# during install: create an admin user + password
Config
- Open
http://pi-ip:9981in a browser - Configuration → DVB Inputs → Networks → Add → IPTV Network
- Add Mux → URL = your M3U source
- Scan → channels load
- Map all services to channels
- EPG Grabber → XMLTV → set source
- Channel/EPG → Manage channels
Connect to Kodi
In Kodi: Add-on → PVR clients → Tvheadend HTSP Client → server IP + login. Kodi now uses Tvheadend as its tuner.
🎬 4K on Raspberry Pi
Pi 5 — 4K HEVC works out of the box
- 4K HEVC streams up to 60 fps
- HDR10 support via Kodi
- HDMI 2.0 — 4K @ 60Hz possible
- AV1 not hardware-decoded — avoid AV1 streams
Pi 4 — 4K HEVC works, but...
- 4K HEVC at 30 fps is fine, 60 fps can stutter
- HDR possible but not always stable
- For heavy 4K sport: Pi 5 or NVIDIA Shield recommended
🔧 Optimisation tips
- GPU memory split — for the Pi 4:
config.txt→gpu_mem=320for 4K - Overclock the Pi 5 — up to 2.8 GHz with good cooling (more CPU headroom = less stutter)
- USB SSD — faster than SD for cache + recordings
- Ethernet recommended — the Pi 4/5 have gigabit, WiFi is shakier
- Kodi cache in
advancedsettings.xml:<advancedsettings> <cache> <buffermode>1</buffermode> <memorysize>157286400</memorysize> <readfactor>4</readfactor> </cache> </advancedsettings>
🆚 Raspberry Pi vs Fire TV Stick vs NVIDIA Shield
| Pi 5 + LibreELEC | Fire TV Stick 4K Max | NVIDIA Shield Pro | |
|---|---|---|---|
| Price | ~€100 | €70 | €220 |
| 4K HEVC | ✅ | ✅ | ✅ |
| HDR | HDR10 | HDR10+, DV | HDR10+, DV |
| Multi-view | ⚠️ Kodi only | ✅ via TiviMate | ✅ up to 9 streams |
| App store | Limited | Amazon | Google Play |
| Can run a server | ✅ Tvheadend, Jellyfin | ❌ | ⚠️ Limited |
| Tweakability | ★★★★★ | ★★ | ★★★ |
Who it's for: Pi for tinkerers who want to customise everything + a server role. Fire TV for simple TiviMate. Shield for no-compromise 4K.