# 家庭影院
***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***
---
家庭影院项目基于Quectel Pi M2智能主控板开发，以Kodi开源媒体中心软件为核心，构建了一套集媒体播放、库管理、多场景适配于一体的家庭影院系统。该项目实现本地与网络媒体资源的一站式整合与高清播放，充分满足家庭影音娱乐的多样化需求，为用户提供高品质的家庭娱乐体验。
```{image} images/image_O0fmbFMBVoW9YsxDcfrcpYP8nSe.webp
:width: 1000px
:height: 625px
```
# 开发资源汇总
## 开发配件清单
|
配件名称
|
数量
|
规格参数
|
| --- | --- | --- |
|
Quectel Pi M2智能主控板
|
1块
|
Quectel Pi M2智能主控板
|
|
电源适配器
|
1个
| |
|
HDMI A 型对公线
|
1根
|
HDMI 2.0；线长1 m；接口：HDMI-A（公头）-HDMI-A（公头）
|
|
网线
|
1根
|
线长：1m；传输速率：千兆；
|
|
显示屏
|
1个
|
24英寸HDMI显示器
|
## 配件实物参考
```{image} images/image_VtR1bhjywoUEr5xDqXmcseScndc.webp
:width: 1049px
:height: 558px
:align: center
```
# 快速上手
## 开发准备
**Quectel Pi M2** 智能主控板出厂默认搭载 **Debian 13** 系统镜像，因此无需再次烧录镜像，仅需按照如下步骤操作即可。
## 硬件连接
完成以下所有硬件的连接操作，连接接口示意图如下：
```{image} images/image_TPMdbGZUWojJKDxBZsJctiDqnpe.webp
:width: 627px
:height: 463px
:align: center
```
1. **显示连接**：HDMI线一端接主控板HDMI接口，另一端接显示器HDMI接口；
2. **网络连接**：千兆网线一端接主控板千兆网口，另一端接路由器网口（替代方案：通过Wi-Fi接入同一局域网）；
3. **输入设备连接**：USB键盘、鼠标接入主控板的两个USB-A接口，无线输入设备则将接收器插入USB口即可；
4. **供电连接**：USB-A电源线的USB-A端接电源适配器，USB-C端接入主控板标注 **POWER IN** 的电源口。
## 项目实现
- 更新安装源
```bash
sudo apt update
```
- 安装Kodi服务
```bash
sudo apt install kodi -y
```
- 安装PVR插件
```bash
sudo apt install kodi-pvr-iptvsimple -y
```
- 确保在Kodi启动期间视频加速API能正确初始化。要将用户添加到组中，请使用以下命令：
```bash
sudo usermod -a -G cdrom,audio,render,video,plugdev,users,dialout,dip,input $USER
```
- 确保运行Kodi的用户属于以下组（例如，对于用户pi）
```bash
groups username
```
```{image} images/image_W3hubb7ohoMr3PxSqkQcd1Fynxb.webp
:width: 733px
:height: 317px
```
- 重新启动后，在登录界面右下角齿轮中选择 **"Kodi on GBM"** 运行Kodi服务。
```{image} images/image_QjEMbBu8koyqo3xM5DscUOP2n4w.webp
:width: 1224px
:height: 671px
```
进入Kodi后，会让我们选择是否让安装的插件生效，这时我们可以选择NO，后面再进行设置。然后会出现 **Enter add-on browser** 和 **Remove this main menu item** 的选项，我们直接点击左上方的齿轮进入设置。
```{image} images/image_HeCKbcVqQoHx8ZxatuvcODKEnsg.webp
:width: 1200px
:height: 633px
```
- Kodi中文设置
进入设置后，选择 **Interface→Skin→Fonts** 更换字体为 **Arial based**。选择 **Regional→Language→Chinese(Simple)**。
```{image} images/image_LUOqbEdH9oO340x2zIYc7MxmnJc.webp
:width: 1200px
:height: 629px
```
- 添加插件
为了方便操作，我们可以使用"\"对Kodi进行全屏和窗口切换。
我们在终端安装时就已经通过命令安装过IPTV Simple Client，所以我们点击 **设置→插件→我的插件→PVR客户端** 就可以看得到IPTV Simple Client，点击进入设置。
```{image} images/image_EaMFbM2ySol6KrxlIMmcmEDPnzc.webp
:width: 1653px
:height: 911px
```
- 添加源
位置默认是远程路径，可以通过点右边上下切换标志切换到本地路径，在M3U播放列表路径中选择直播源文件目录（直播源文件一般为M3U8，可在网上搜索下载存放到本地或者通过URL远程路径访问）。这里选择远程路径加载直播源，将远程URL输入 **"M3U播放列表URL栏"** 即可，点击 **确定** 后 **启用** 该配置，按下 **ESC** 回退到导航界面。
```{image} images/image_ZXkRbcBfDo9moMxnHLtcK2L1nsb.webp
:width: 1649px
:height: 919px
```
```{image} images/image_NZhkbhEYDod2pyxcNmuc4Ax2nVg.webp
:width: 1200px
:height: 677px
```
- 按下 **ESC** 回到主界面，点击电视栏，选择自己喜欢的节目，就可以进行观看了。
```{image} images/image_XgGQbA7IIoVgb9xeSp3c2R4bnPc.webp
:width: 1200px
:height: 668px
```
```{image} images/image_F28wbtRvBoFdTFxKE3ncVmYyneg.webp
:width: 1200px
:height: 664px
```
```{image} images/image_B2ZRbl0rso9M0QxmdqGcqyGknk5.webp
:width: 1137px
:height: 639px
```
> 注：目前只能播放较低帧率的电视节目，硬件视频解码还在适配中，更多信息请及时关注移远开发者官网。
# 进阶使用
下面介绍如何导入电影、视频等资源在Kodi上实现播放。
第一步：在Movies界面下点击 **Enter files section -> Add videos** 添加资源。
```{image} images/image_JaulbOjPioocTJxVyexcmsj9n5g.webp
:width: 1000px
:height: 563px
```
第二步：选择导入资源存放的路径然后点击 **OK**（这里我的资源存放在/home/pi/media下)。
```{image} images/image_Syf8b1xM1oiv9sxzj5Acjz8nnlc.webp
:width: 1226px
:height: 685px
```
第三步：设置资源类型为 **Movies**，其他选项默认即可，然后点击OK会提示是否更新信息，选择 **Yes** 即可，Kodi会自动扫描文件夹里的视频，从网上下载封面、简介等信息。等扫描完成后，回到 **Movies** 界面，就能看到带封面的电影了。
```{image} images/image_FRCSbUznVoYxxsxATswcAbKxn2g.webp
:width: 1230px
:height: 691px
```
```{image} images/image_WzLRbqLXOoD4yixx3Q4c0h6fnwc.webp
:width: 900px
:height: 504px
```
> 注：上述操作是在导入视频的信息能与网上资源匹配的情况下，若无法匹配则不能加载到 **Movies** 界面。
接下来介绍导入自定义资源的方法。
第一步：点击 **Movies** 界面进入视频存放文件夹，光标选择视频并按下鼠标右键，然后选择 **Scan to library**。
```{image} images/image_NwLTbxmR1oLKN3xhTMjcOIvcn0b.webp
:width: 1070px
:height: 599px
```
第二步：输入电影名，这里需要修改成能与网上资源匹配的名称，如：build.mp4。
```{image} images/image_GviObRLMPoJj1vx1Wqfcx9Aznwd.webp
:width: 1069px
:height: 599px
```
第三步：信息匹配后会弹出提示框，选择 **Yes** 即可，然后双击选择任意一个匹配的影片，再按下ESC回退到 **Movies** 界面，这时我们能看到没有加载出封面的自定义影片。
```{image} images/image_GQSjb9DPGo4wLsxagC7c0X8Fnkg.webp
:width: 1000px
:height: 559px
```
第四步：点击 **Movies** 界面，在自定义影片上右键选择 **Manage**，在这里可以修改电影名称、类型分类等；点击 **Choose art**->**Poster**，选择已存放在导入文件夹下的图片更改视频封面。
```{image} images/image_ShtEbKXpvoHXCGxd0T1cbn7ynrg.webp
:width: 1066px
:height: 595px
```
```{image} images/image_Akhpbs77koFdcdxJDKkcKI35n1c.webp
:width: 1069px
:height: 597px
```
第五步：按下Esc回到初始界面，然后在视频上右键选择Mark as Watched，最后返回 **Movies** 界面，就能看到更换封面后的自定义影片了。
```{image} images/image_FCdmb2vfqoL1UTx8nx4cZAGUnwf.webp
:width: 1149px
:height: 647px
```
```{image} images/image_SeRIbfexsoqV2UxdZKkcVVrqnsf.webp
:width: 1000px
:height: 558px
```
# 技术支持与贡献
如在使用过程中遇到问题，欢迎在 [移远官方论坛]() 提交技术咨询，我们的技术支持团队将及时为您解答。