# TVx

TVx is an IPTV and EPG viewer that plays M3U playlists from Tunarr (Plex/Jellyfin) through a nostalgic analog TV interface with scanlines, flicker, and vintage lens effects. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3424/tvx

## Description

TVx is an IPTV and EPG viewer that plays M3U playlists from Tunarr (Plex/Jellyfin) through a nostalgic analog TV interface with scanlines, flicker, and vintage lens effects.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

45/100 (Fair), based on 4 of 5 factors.
- Maintained: 70 (last commit 10 days ago)
- Popular: 32 (38 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 20 (1 serious finding, 21 minor, CI)

## Security check

1 serious finding: Uses fast-xml-parser 5.3.0, which has a known critical vulnerability.
Automated checks on commit 66862f6, 14 Nov 2026. Not an audit.

## Links

- Unraid: https://ca.unraid.net/apps/tvx-0z8q2jm0deywxi?q=TVx
- Documentation: https://dopeytree.github.io/TVx/

## Common questions

### Does TVx connect directly to Plex or Jellyfin, or does it require Tunarr?

TVx is a client-side frontend that uses Tunarr to provide the M3U playlist and XMLTV EPG. It displays metadata and artwork from your Plex media server.

### What environment variables must be set, and how are URL changes applied?

Set VITE_M3U_URL to the Tunarr M3U playlist URL and VITE_XMLTV_URL to the Tunarr XMLTV guide URL. If you change these later, clear the browser cache with Ctrl+Shift+R to see the updates.

### What port should I expose for the web UI?

The Docker examples map host port 8777 to container port 80. Use that host port to open TVx in a browser.

### Where should I look if channels or the EPG do not appear?

The docs list troubleshooting sections for channels not loading, EPG not showing, video not playing, Docker issues, browser console errors, and logging. Start with the section that matches the symptom.

---
Source: Our Local Host (https://ourlocalhost.com/app/3424/tvx), the self-hosted and open-source app directory.
