What Xteve does and why you might want it

Xteve is a program that sits between your TV tuner hardware and Plex, translating live television signals into a format Plex can understand and serve to your devices. If you have an antenna or cable box connected to your computer, Xteve lets you watch that live feed through Plex's interface alongside your recorded shows and movies — without paying for a separate streaming service.

The trade-off is technical: Xteve requires you to run software on a computer that stays on most of the time, manage the connection between your tuner and Xteve, and handle troubleshooting when the signal drops or the software crashes. You are also responsible for understanding what content you are legally allowed to capture and stream within your own home or network.

Xteve is free and open-source, meaning the code is public and anyone can modify it. That transparency is a security advantage — security researchers can spot problems — but it also means you are trusting a volunteer community rather than a company with liability insurance.

Key Takeaways

  • Xteve runs on Windows, Mac, or Linux and needs a TV tuner (USB or PCIe card) connected to an antenna or cable box to capture the signal.
  • You install Xteve separately from Plex, configure it to recognize your tuner, then add Xteve as a Live TV source inside Plex.
  • The computer running Xteve must stay powered on whenever you want to watch or record live TV through Plex.
  • You are responsible for understanding local laws about recording broadcast television and cable content, which vary by region and content type.
  • Xteve has no built-in support — troubleshooting happens through community forums and GitHub, so you need to be comfortable reading error logs and testing connections yourself.

Hardware you need before starting

Xteve cannot create a TV signal from nothing. You need a TV tuner — a device that receives broadcast or cable television and converts it to digital data. Common options are the HDHomeRun (a network-connected box that works with most systems), the Hauppauge WinTV (a USB stick or PCIe card), or the SiliconDust Flex (a newer multi-tuner option). Each tuner has different driver requirements and compatibility with Xteve, so check the Xteve documentation for your specific model before buying.

You also need an antenna (for broadcast TV like ABC, NBC, PBS) or a cable connection (for cable channels). An antenna is simpler — no monthly fee, no cable box — but you only receive channels available over the air in your area. Cable requires a cable subscription and sometimes a cable box, but gives you access to more channels.

Finally, you need a computer that can run Xteve continuously. This can be an old laptop, a desktop, or a dedicated small computer like a Raspberry Pi (though Pi performance is limited). The computer does not need to be powerful, but it does need to stay on and connected to your network whenever you want to watch live TV.

Installing Xteve on your computer

Go to the Xteve GitHub repository (search "Xteve GitHub" to find the official page) and read the version for your operating system — Windows, Mac, or Linux. Extract the downloaded file to a folder on your computer, such as C:\Xteve on Windows or /opt/xteve on Linux.

On Windows, double-click the Xteve executable file to start it. On Mac or Linux, you may need to open a terminal and run a command like ./xteve from the folder where you extracted it. The first time you run Xteve, it creates a configuration folder and starts a web interface, usually at http://localhost:6060 in your browser.

Open that address in your web browser. You should see the Xteve setup screen. If you do not, check that your firewall is not blocking port 6060, or try a different port number in Xteve's settings. Write down the port number you use — you will need it when you connect Xteve to Plex.

Connecting your TV tuner to Xteve

Plug your TV tuner into your computer (USB tuners go into a USB port; PCIe cards go into a slot inside the computer). Connect your antenna or cable line to the tuner's input port. Wait a few seconds for your operating system to recognize the tuner, then check Xteve's web interface.

In Xteve, go to the Tuners or Devices section (the exact name varies by Xteve version). You should see your tuner listed. Click on it and configure the input type — select Antenna if you are using an antenna, or Cable if you are using a cable connection. Save the settings.

Next, go to the Channels section in Xteve and run a channel scan. Xteve will search for all available channels on your antenna or cable line and list them. This can take several minutes. Once the scan finishes, you should see a list of channels with their names and numbers. If the list is empty or very short, check that your antenna or cable connection is plugged in firmly and that your tuner is recognized by your operating system.

Adding Xteve to Plex as a Live TV source

Open Plex on the computer where Plex is installed (or log into Plex Web at plex.tv). Go to Settings, then Live TV & DVR. Click Set Up Plex DVR or Add Live TV Source (the exact wording depends on your Plex version).

Plex will ask you to choose a tuner source. Select Network Tuner or Other, then enter the address of your Xteve server. This is usually http://localhost:6060 if Xteve and Plex are on the same computer, or http://[your-computer-ip]:6060 if they are on different computers. (To find your computer's IP address, search "what is my IP" on that computer, or check your router's device list.)

Plex will test the connection. If it succeeds, you will see your channel list from Xteve appear in Plex. If it fails, double-check the address, make sure Xteve is running, and verify that your firewall allows Plex to reach port 6060.

Watching live TV and recording shows

Once Xteve is connected to Plex, you can watch live TV by opening Plex on any device (phone, tablet, computer, or Plex app on a TV) and going to the Live TV section. You should see your channels listed. Click a channel to start watching.

To record a show, go to the show's listing in Plex (either in Live TV or in your guide) and select Record. Plex will record the show to your Plex library when it airs. Recordings are stored on the computer running Xteve, so make sure that computer has enough free disk space — a one-hour HD recording typically uses 5 to 10 gigabytes.

Remember: the computer running Xteve must be on and connected to your network for live TV to work. If the computer goes to sleep or shuts down, you cannot watch or record. Set your computer to never sleep while Xteve is running, or use a scheduled task to wake it up before shows you want to record.

Troubleshooting common problems

If Plex cannot find Xteve, verify that both programs are running on the same network (not separated by a firewall or VPN). Ping the Xteve computer from the Plex computer using its IP address to confirm they can reach each other. If the ping fails, check your router settings or network configuration.

If channels appear in Xteve but not in Plex, try removing and re-adding the Xteve source in Plex's Live TV settings. Sometimes Plex caches the channel list and needs to refresh it.

If you see channels but cannot watch them, check that your tuner is still connected and recognized by your operating system. Unplug and replug the tuner, or restart Xteve. If the problem persists, check Xteve's logs (usually in the Xteve folder under logs or debug) for error messages that describe what went wrong.

If recordings fail to start, make sure the computer running Xteve is actually on at the scheduled time. Check that you have enough free disk space on the drive where recordings are stored. If a recording starts but stops partway through, your tuner may have lost signal — check your antenna or cable connection.

Understanding the legal and privacy side

Recording broadcast television (over-the-air channels like ABC, NBC, PBS) for personal use is legal in most countries, including the United States. Recording cable channels is more complicated — your cable contract may prohibit it, or the content may have copy protection that Xteve cannot bypass. Check your cable provider's terms of service.

Streaming recorded shows to devices outside your home network raises additional questions. Plex allows you to stream your library remotely, but doing so with copyrighted content you recorded may violate your cable contract or local law. Stick to streaming within your home network, or check your cable provider's policy.

Because Xteve is open-source software maintained by volunteers, there is no company responsible if something goes wrong. If Xteve stops working after a software update, or if a security problem is discovered, you are responsible for fixing it or rolling back to an older version. Join the Xteve community forums or GitHub discussions if you need help — that is where troubleshooting happens.

Frequently Asked Questions

Can I use Xteve without Plex?

Yes. Xteve has its own web interface where you can watch live TV and manage recordings. You do not need Plex. Using Xteve alone is simpler but gives you fewer options for organizing and streaming your content to other devices.

What if my tuner is not recognized by Xteve?

Check that your tuner's drivers are installed on your operating system. Visit the tuner manufacturer's website and read the latest drivers for your model and OS. Restart your computer after installing drivers, then restart Xteve. If Xteve still does not see the tuner, check the Xteve logs for error messages or ask in the Xteve community forums with your tuner model and operating system.

Can I use multiple tuners with Xteve?

Yes, if your tuners are compatible with Xteve. You can connect multiple tuners to the same computer and configure them all in Xteve. This lets you watch or record more than one channel at a time. Check the Xteve documentation for your specific tuner models to confirm they work together.

Do I need a Plex Pass subscription to use Xteve?

No. Xteve works with the free version of Plex. However, some Plex features like remote streaming and DVR scheduling may require a Plex Pass. Check Plex's current pricing and features to see what applies to your setup.

What happens if my internet goes down?

If your internet connection drops, you can still watch live TV on devices connected to your local network (the same network as your Xteve computer). You cannot stream to devices outside your home. Once your internet is back, remote streaming works again.