Home Theater

The home theater project is developed based on the Quectel Pi H1 single-board computer and uses the Kodi open-source media center software as its core to build a home theater system that integrates media playback, library management, and multi-scene adaptation. This project achieves one-stop integration and high-definition playback of local and online media resources, fully meeting the diverse needs of home audio-visual entertainment and providing users with a high-quality home entertainment experience.

Development Resources Summary

Development Accessories List

Physical Reference of Accessories

Get Started Quickly

Development Preparation

The Quectel Pi H1 comes pre-installed with Debian 13, so no re-flashing is required. Just follow the steps below.

Hardware Connection

Install Cooling Fan

Plug the fan cable into the FAN header on the board, then secure the heatsink clips into the mounting holes as shown:

Display Connection

Connect one end of the HDMI cable to the HDMI port of the single-board computer and the other end to the HDMI port of the monitor.

Input Device Connection

Connect the USB keyboard and mouse to the two USB-A ports on the single-board computer. If using a wireless input device, just plug the receiver into the USB port.

Network Connection

Connect one end of the Ethernet cable to the Gigabit Ethernet port of the single-board computer, and the other end to the Ethernet port of the router (ensure the router is already connected to the network).

Jumper Cap Connection

Locate the pin header labeled AUTO_POWER_ON at the upper left corner of the single-board computer, and ensure it is shorted with a jumper cap.

Power Connection

Connect the USB-A end of the USB-A power cable to the power supply, and connect the USB-C end to the power port of the single-board computer (usually labeled POWER IN).

Connection Complete Reference

Project Implementation

• Update Installation Sources

sudo apt update

• Install Kodi Service

sudo apt install kodi

• Install PVR Plugin

sudo apt install kodi-pvr-iptvsimple

• Ensure the video acceleration API initializes correctly during Kodi startup. To add the user to the groups, please use the following command:

sudo usermod -a -G cdrom,audio,render,video,plugdev,users,dialout,dip,input username
Example: sudo usermod -a -G cdrom,audio,render,video,plugdev,users,dialout,dip,input pi

• Ensure the user running Kodi belongs to the following groups (for example, for user pi)

groups username

• After restarting, select "Kodi on GBM" in the gear icon at the bottom right of the login screen to run the Kodi service.

After entering Kodi, we will be asked whether to enable the installed plugin. We can choose NO and set it later. Then the options Enter add-on browser and Remove this main menu item will appear. Click the gear icon in the upper left to enter settings.

• Add Plugin

For convenient operation, we can use "\" to switch Kodi between fullscreen and windowed mode.

We have already installed IPTV Simple Client through the terminal command. So we click Add-ons→My Add-ons→PVR clients to find IPTV Simple Client, then click Configure.

• Add Source

​The location defaults to remote path. You can switch to local path by clicking the up/down toggle on the right. Select the live source file directory in the M3U playlist path. (Live source files are generally M3U8, which can be searched online, downloaded and stored locally, or accessed via URL remote path.) Here we choose to load the live source via remote path. Enter the remote URL into the "M3U playlist URL bar", click OK, Enable, then press ESC to return to the navigation interface.

• Go to Settings->Player, click the gear to switch to Expert mode, allow DRM PRIME decoder and select EGL rendering.

• Press ESC to return to the main interface, click the TV bar, select your favorite program, and you can start watching.

Note: Currently, only low frame rate TV programs can be played. Hardware video decoding is still being adapted. Please pay attention to Quectel developer website for more information.