Need help with pseudotv?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

160 Stars 29 Forks MIT License 45 Commits 58 Opened issues


Create live TV channels from your own media. Access the streams using the simulated HDHomerun tuner or the generated M3U URl.

Services available


Need anything else?

Contributors list

No Data


Create live TV channel streams from media on your Plex servers.

Project recently migrated from gitlab to github to improve development flow (docker builds and binary releases).

Configure your channels, programs, commercials and settings using the PseudoTV web UI.

Access your channels by adding the spoofed PseudoTV HDHomerun tuner to Plex, or utilize the M3U Url with any 3rd party app.

EPG (Guide Information) data is stored to



  • Docker image and prepackage binaries for Windows, Linux and Mac
  • Web UI for channel configuration and app settings
  • Select media (desired programs and commercials) across multiple Plex servers
  • Sign into your Plex servers using any sign in method (Username, Email, Google, Facebook, etc.)
  • Ability to auto update Plex DVR guide data and channel mappings
  • Auto update the xmltv.xml file at a set interval (in hours). You can also set the amount EPG cache (in hours).
  • Continuous playback support
  • Commercial support. 5 commercial slots for a program (BEFORE, 1/4, 1/2, 3/4, AFTER). Place as many commercials as desired per slot to chain commercials.
  • Media track selection (video, audio, subtitle). (subtitles disabled by default)
  • Subtitle support (some subtitle formats may cause a delay when starting an ffmpeg session) Supported subs below.
    • Internal Subs
      • ASS (slow)
      • SRT (slow)
      • PGS (fast)
    • External Subs
      • ASS (moderate)
      • SRT (moderate)
  • Ability to overlay channel icon over stream
  • Auto deinterlace any Plex media not marked
    "scanType": "progressive"

Useful Tips/Info

  • Internal and External SRT/ASS subtitles may cause a delay when starting stream (only when subtitles are activated). For internal SRT/ASS subtitles, FFMPEG needs to perform a subtitle track extraction from the original media before the requested stream can be started. External SRT/ASS subtitle files still need to be sliced to the correct start time and duration so even they may cause a delay when starting a stream. Image based subs (PGS) should have little to no impact.
  • Utilize your hardware accelerated encoders, or use mpeg2 instead of h264 by changing the default video encoder in FFMPEG settings. Note that some encoders may not be capable of handling every transcoding scenario, libx264 and mpeg2video seem to be the most stable.
    • Intel Quick Sync:
    • MPEG2
    • H264
    • MacOS
    • Enable the option to log ffmpeg's stderr output directly to the pseudotv app console, for detecting issues
  • Host your own images for channel icons, program icons, etc.. Simply add your image to
    and reference them via
  • Use the Block Shuffle feature to play a specified number of TV episodes before advancing to the next available TV show in the channel. You can also specify to randomize the TV Show order. Any movies added to the channel will be pushed to the end of the program lineup, this is also applicable the "Sort TV Shows" option.
  • Plex is smart enough not to open another stream if it currently is being viewed by another user. This allows only one transcode session for mulitple viewers if they are watching the same channel.
  • Even if your Plex server is running on the same machine as the PseudoTV app, use your network address (not a loopback) when configuring your Plex Server(s) in the web UI.


  • Plex Pass is required to unlock Plex Live TV/DVR feature
  • Only one EPG source can be used with Plex server. This may cause an issue if you are adding the pseudotv tuner to a Plex server with Live TV/DVR already enabled/configured.
  • PseudoTV does not watch your Plex server for media updates/changes. You must manually remove and readd your programs for any changes to take effect. Same goes for Plex server changes (changing IP, port, etc).. all media will fail..


Please delete your old

directory before using the new build. I'm sorry but it'd take more effort than its worth to convert the old databases..

Unless your are using Docker/Unraid, you must download and install ffmpeg to your system and set the correct path in the PseudoTV Web UI.

By default, pseudotv will create the directory

wherever pseudotv is launched from. Your
file and config databases are stored here.

Binary Release

Download and run the PseudoTV executable (argument defaults below)

./pseudotv-win-x64.exe --port 8000 --database ./pseudotv


The Docker repository can be viewed here.

Use Docker to fetch PseudoTV, then run the container.. (replace

with your desired config directory location)
docker pull defendore/pseudotv
docker run --name pseudotv -p 8000:8000 -v C:\.pseudotv:/home/node/app/.pseudotv defendore/pseudotv

Building Docker image from source

Build docker image from source and run the container. (replace

with your desired config directory location)
git clone
cd pseudotv-plex
docker build -t pseudotv .
docker run --name pseudotv -p 8000:8000 -v C:\.pseudotv:/home/node/app/.pseudotv pseudotv

Unraid Install

to your "Template repositories" in the Docker tab. Click the "Add Container" button Select either the pseudotv template or the pseudotv-nvidia template if you want nvidia hardware accelerated transcoding. Make sure you have the Unraid Nvidia plugin installed and change your video encoder to h264_nvenc in the pseudotv ffmpeg settings.

From Source

Install NodeJS and FFMPEG

git clone
cd pseudotv-plex
npm install
npm run build
npm run start

Plex Setup

Add the PseudoTV spoofed HDHomerun tuner to Plex via Plex Settings.

If the tuner isn't automatically listed, manually enter the network address of pseudotv. Example:

When prompted for a Postal/Zip code, click the

"Have an XMLTV guide on your server? Click here to use that instead."

Enter the location of the

file. Example (Windows):

Do not use the Web UI XMLTV URL when feeding Plex the xmltv.xml file. Plex fails to update it's EPG from a URL for some reason (at least on Windows). Use the local file path to


App Preview


Building/Packaging Binaries: (uses

npm run build
npm run compile
npm run package

Live Development: (using

npm run dev-client
npm run dev-server

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.