displaycameras快速上手5步完成安装让你的RTSP摄像头上墙【免费下载链接】displaycamerasSystem for displaying RTSP feeds from IP cameras on the Raspberry Pi项目地址: https://gitcode.com/gh_mirrors/di/displaycamerasdisplaycameras是一款专为树莓派Raspberry Pi打造的免费开源工具它能把 RTSP 监控摄像头的视频流以网格窗口方式投屏到显示器上让你用一台树莓派一块屏幕轻松搭出多路摄像头实时墙。它借助 omxplayer 实现硬件加速播放并通过 DBUS 对每一路画面做守护与自动修复是家庭安防、小型店铺和监控中心的理想方案。下面这份指南将带你用 5 个步骤完成安装与配置。1 分钟了解 displaycameras 能做什么️网格播放把屏幕划分为 2×2、3×3 甚至更复杂的窗口矩阵每个窗口播放一路 RTSP 流⚡硬件加速调用树莓派 GPU 解码多路视频也不卡轮巡上墙摄像头比窗口多时可让画面在屏幕内外轮换全部摄像头都能露脸自动修复内置看门狗 定时修复任务repaircameras.cron流断了自动重连分辨率自适应可自动检测外接显示器分辨率并套用对应的布局配置文件示例见 example_layouts/ 目录⚠️重要提示displaycameras 依赖 omxplayer 的硬解能力而该组件自 Raspbian Bullseye 起已弃用。请务必使用Raspbian Buster推荐 Lite 版系统若使用 RPi4B视频编码需有对应的 GPU 硬解支持。安装前检查确认你的硬件与系统项目要求硬件Raspberry Pi1代/2代/3代/4代均可系统RaspbianBuster Lite强烈建议系统systemd 作为初始化系统网络摄像头与树莓派在同一局域网如果系统不符合请先重装或升级降级到 Buster 再继续。快速上手5步安装与配置流程第 1 步克隆 displaycameras 代码在树莓派终端中执行git clone https://gitcode.com/gh_mirrors/di/displaycameras cd displaycameras第 2 步运行一键安装脚本chmod ux ./install.sh sudo ./install.sh安装脚本 install.sh 会自动完成全部脏活安装依赖包 omxplayer 与 fbi复制主脚本 displaycameras 及辅助脚本如 omxplayer_dbuscontrol、rotatedisplays到 /usr/bin/部署配置模板到 /etc/displaycameras/ 目录按内存大小自动设置合理的gpu_mem显存分配可手动指定 64~512MB关闭显示器 overscan保证分辨率自动检测准确注册并启用 systemd 服务开机自启看到 Installation Successful! 即代表安装完成 ✅第 3 步编辑全局配置 displaycameras.conf打开 /etc/displaycameras/displaycameras.conf模板见 displaycameras.conf重点理解几个全局参数omx_timeout30建立播放的网络超时秒摄像头多或网络慢时可调大startsleep3/feedsleep1启动/重连时每路摄像头的休眠间隔画面不稳时调大retry5重试等待时间#displaydetecttrue取消注释可开启分辨率自动检测进阶功能第 4 步填写摄像头流与窗口布局这是核心步骤。编辑 /etc/displaycameras/layout.conf.default模板见 layout.conf.default按以下顺序填写windows窗口名称列表如 2×2 布局windows(upper_left upper_right lower_left lower_right)window_positions每个窗口的坐标起始X 起始Y 结束X 结束Y1080p 屏幕上四个 960×540 窗口即可铺满camera_names摄像头名称⚠️ 只能含[A-Z][a-z][0-9]_且不能以数字开头DBUS 命名限制camera_feeds与名称一一对应的 RTSP 流地址 摄像头越多屏幕放不下怎么办在文件中把窗口加到屏幕外坐标超出屏幕并取消注释rotatetrue即可开启轮巡。第 5 步启动服务并验证效果sudo systemctl start displaycameras # 启动 sudo systemctl status displaycameras # 查看状态想实时观察启动过程可手动运行sudo /usr/bin/displaycameras start按提示微调feedsleep和startsleep直到重试消失再用sudo /usr/bin/displaycameras stop清理测试进程。上图是 displaycameras 屏幕清屏功能使用的黑色背景图black.png轮巡切换画面时会先清屏避免闪现终端内容进阶玩法让摄像头墙更专业分辨率自适应在 displaycameras.conf 中开启displaydetecttrue并为每种外接显示器准备layout.conf.1280x720、layout.conf.1920x1080.3x3这类命名的布局文件example_layouts/ 下有 10 多种现成示例可抄作业插到不同屏幕都会自动适配。轮巡步长与翻屏模式在布局文件中设置seq_step控制每次轮换的窗口数设成等于屏幕可容纳的摄像头数即可实现整屏画面翻屏切换。屏幕清屏取消注释blanktrue轮巡切换时先显示黑屏背景画面更干净。流分辨率要匹配摄像头流的分辨率应小于或等于窗口大小树莓派降分辨率很吃力。性能不够时可调大 /boot/config.txt 中的gpu_mem显存分配。常见问题排查清单❓画面起不来先用 VLC 在同一网络播放该 RTSP 地址验证流本身再在树莓派上执行sudo omxplayer --no-keys --no-osd --avdict rtsp_transport:tcp 摄像头地址 --live -n -1 --timeout 30单独测试。❓启动频繁重试依次调大feedsleep和startsleep网络较差或摄像头超过 6 路低码流时把omx_timeout调到 30 秒以上。❓服务管理命令速查sudo systemctl start displaycameras # 启动 sudo systemctl stop displaycameras # 停止 sudo systemctl restart displaycameras # 重启 sudo /usr/bin/displaycameras status # 脚本级调试状态升级与卸载升级重新下载代码后执行sudo ./install.sh upgrade不会动你已有的配置文件、定时任务和 GPU 显存设置。卸载停止并禁用服务 → 删除 /etc/displaycameras 配置目录、/etc/systemd/system/displaycameras.service 服务文件、/usr/bin/ 下相关脚本、/etc/cron.d/repaircameras 定时任务最后可选sudo apt-get purge omxplayer fbi -y清理依赖。至此5 步走完全流程你的 RTSP 摄像头已经稳稳地上墙了 从安装到轮巡displaycameras 把复杂的守护逻辑全部封装成后台服务——你只需要专注把摄像头画面挂上屏幕。【免费下载链接】displaycamerasSystem for displaying RTSP feeds from IP cameras on the Raspberry Pi项目地址: https://gitcode.com/gh_mirrors/di/displaycameras创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考