This guide will help you learn how to use TVHplayer.

TVHplayer is a user-friendly application designed for streaming and recording live TV content. It is a desktop client app for Tvheadend, a popular open-source TV streaming server.

⚠️ TVHplayer does not provide a built-in server. You must set up your own Tvheadend server to use this app. See below for more information.

Tvheadend is a TV streaming server that enables you to watch and record live TV. In modern terminology, it allows you to "stream" live TV from a tuner to the network and watch television on your devices. It works by receiving TV signals from a tuner (such as an HDHomeRun or a USB DVB device) or an M3U playlist (for IPTV) and then streaming the channels to devices like TVHPlayer.

For more details, refer to the official Tvheadend documentation. There are multiple ways to set up a Tvheadend server, including an easy setup using Docker.

TVHplayer is for users who already have a working Tvheadend server and would like to watch/record live TV on PC.

• Stream live TV channels
• View the Electronic Program Guide (EPG)
• Schedule recordings
• Record locally on your computer
• User-friendly interface
• Free and open-source
• Cross-platform: TVHplayer works on Linux, macOS, and Windows

To install TVHplayer, download the app from the official website or Flathub.

To connect TVHplayer to your Tvheadend server:

1. Make sure both digest and plane authentication are enabled in your server.
2. Open TVHplayer and click the small cog icon above the channel list to add your server.
3. Enter the address and port number of your Tvheadend server (including http:// or https://).
4. Enter your Tvheadend username and password.
5. Save the settings and test the connection.

Press the Play button or double-click a channel in the channel list to start watching.

TVHPlayer has basic support for Electronic Program Guides (EPG). To view the program guide:

1. Right-click on the channel name.
2. Select Show EPG.

Note: The EPG data must be provided by your Tvheadend server.

• Recording a live program using Tvheadend's DVR function:

  1. Click the Record button below the player.
  2. Set the duration for the recording.
  3. The recording will be stored on the server.

• Scheduling a recording from the EPG:

  1. Right-click on the channel name.
  2. Select Show EPG.
  3. In the EPG window, press the Record button next to your desired show.

• Recording live TV locally on your computer:

  • Press the Local Record button (the downward arrow).

If you encounter any issues while using TVHplayer, try the following steps:

• Ensure your Tvheadend server is running and accessible.
• Check your network connection.
• Verify that you have entered the correct IP address, port number, username, and password in the app settings.
• Restart the TVHplayer app and your device.

For more information and support, refer to the official Tvheadend documentation.

---

Thank you for using TVHplayer!