Rpisurv配置文件完全指南display1.yml逐项参数解析【免费下载链接】rpisurvRaspberry Pi surveillance项目地址: https://gitcode.com/gh_mirrors/rp/rpisurvRpisurv 是一款将树莓派变成专用监控显示终端Raspberry Pi surveillance的开源软件安装完成后绝大多数个性化设置都集中在/etc/rpisurv目录的 YAML 配置文件中。其中display1.yml 负责第一块显示器上的全部画面布局与轮播逻辑是 Rpisurv 配置文件中最核心、也最值得精读的一份。这篇配置指南将逐项拆解 display1.yml 的每个参数、默认值与适用场景帮你快速上手树莓派监控画面配置少走弯路。 上图是 Rpisurv 建立视频流连接时显示的过渡画面图片文件位于surveillance/images/connecting.png安装后也可以替换成你自己的图片。一、display1.yml 在哪里Rpisurv 配置文件一览Rpisurv 安装后会在/etc/rpisurv目录下生成以下配置文件文件作用general.yml全局高级选项统计上报、屏幕缓存、内存检测普通用户基本不用动display1.yml第一块显示器HDMI 1的屏幕与视频流配置display2.yml第二块显示器HDMI 2的屏幕配置单显示器时不会读取logging.yml日志等级与输出位置配置项目仓库中带完整注释的示例分别位于surveillance/conf/display1.yml、surveillance/conf/display2.yml、surveillance/conf/general.yml和surveillance/conf/logging.yml安装脚本会将其复制到/etc/rpisurv。修改配置后需要重启服务才能生效sudo systemctl restart rpisurv⚠️ 注意display1.yml 是 YAML 格式缩进必须使用空格而非 Tab否则程序会解析失败这是新手最容易犯的错误。二、配置文件结构总览essentials、screens、camera_streams 三层关系display1.yml 的逻辑结构非常清晰只有三层嵌套essentials → screens → camera_streamsessentials最顶层控制自动轮播开关与屏幕列表screens屏幕列表Rpisurv 会按顺序循环轮播这些屏幕只定义一个屏幕则不会轮播camera_streams每个屏幕内的画面列表一个屏幕可同时包含多路摄像头画面或图片。核心骨架如下具体参数下面逐一讲解essentials: screens: - camera_streams: - url: rtsp://user:pass192.168.1.100:554/videoMain duration: 30三、essentials 顶层参数解析disable_autorotation 关闭自动轮播essentials下目前只有一个可选参数参数默认值作用disable_autorotationFalse设为 True 后画面不再自动轮播screens必填要显示的屏幕列表disable_autorotation开启后屏幕不会自动切换但你仍可长按 F1-F12 或小键盘数字键手动调出指定屏幕。适合需要长时间固定观察某个监控画面的场景例如门卫值班室常驻大门画面。四、屏幕级参数解析duration、nr_of_columns、disable_probing_for_all_streamscamera_streams列表之外每个屏幕还支持 3 个可选参数参数默认值作用camera_streams必填该屏幕要显示的画面列表duration30轮播时该屏幕停留的秒数nr_of_columns2画面按几列排列行数由屏幕分辨率自动计算disable_probing_for_all_streamsFalse是否禁用所有视频流的连通性探测duration屏幕每次轮播的停留时间。注意如果设得太短比如 5 秒而画面构建耗时更长Rpisurv 会等构建完成后再开始计时不会生硬切换。nr_of_columns一行排几路画面默认 2即 2 列。改为 3 就是三列布局比手动计算坐标省事得多这也是自动布局最常用的参数。disable_probing_for_all_streams不建议开启。关闭探测后失效的视频流不会被移除画面不会自动重排断线恢复也会变慢。画面数量不足时剩余空白位置会显示占位图见下图源码位于surveillance/images/placeholder.png五、视频流级参数逐项解析camera_streams 的重点配置camera_streams列表中的每一项代表一路画面url是唯一必填项其余参数均可选参数默认值作用url必填视频流或图片地址支持 rtsp/http/https/file/rtmp 协议imageurlFalse设为 true 表示该 url 是图片而非视频流force_coordinates无手动指定画面坐标[左上x, 左上y, 右下x, 右下y]showontopFalse让该画面叠加显示在其他画面之上画中画probe_timeout3连通性探测超时时间秒rtsp_over_tcpFalseRTSP 改用 TCP 传输解决“拖影”问题network_caching_ms500网络缓存毫秒数平滑度与延迟的权衡enableaudioFalse是否播放该路流的音频freeform_advanced_vlc_options空直接透传 VLC 高级命令行参数各参数使用建议url摄像头 RTSP 地址如rtsp://用户名:密码IP:554/videoMain、HTTP/HTTPS 视频流、本地文件file:///路径/xxx.m4v均可。图片流需要配合imageurl: true。imageurl把地址当作图片处理图片在远端或本地变化时 Rpisurv 会自动重新加载。可用来做数字相框、信息发布屏等场景。注意图片流不支持showontop。force_coordinates格式为[左上角x, 左上角y, 右下角x, 右下角y]手动精确控制画面位置。一旦对某个屏幕使用该屏幕的布局就由你全权负责其他未指定的画面仍会自动计算可能与手动画面重叠需要自行协调。showontop配合force_coordinates可做出画中画效果比如主画面全屏、小画面叠加在角落演示配置里就有现成例子。probe_timeout部分摄像头或弱网环境连接较慢可调大到 5-10 秒避免被误判为“不可连接”而提前移出画面。rtsp_over_tcp遇到画面“拖影”smearing时设为true往往能解决。network_caching_ms值越大播放越流畅但延迟越高监控直播对延迟敏感可调小本地视频回放可适当调大。freeform_advanced_vlc_options进阶玩法直接传入 VLC 参数例如--no-keyboard-events。属于高级选项组合效果未必全部经过测试建议有经验的用户使用。六、一份可直接套用的最小配置示例把下面的内容复制进/etc/rpisurv/display1.yml改成你自己的摄像头地址即可使用essentials: screens: - camera_streams: - url: rtsp://user:pass192.168.1.100:554/videoMain - url: rtsp://user:pass192.168.1.101:554/videoMain duration: 30 nr_of_columns: 2这段配置会显示两路摄像头画面2 列布局每 30 秒轮播一次。七、常见问题排查连不上、画面异常怎么办某一屏幕所有画面都无法连接时Rpisurv 会全屏显示提示图见下图源码位于surveillance/images/noconnectable.png建议先用 VLC 验证摄像头地址能否正常播放再写入 display1.yml可以过滤掉大部分“配置看着没问题但就是不出画”的烦恼。排查日志位于/usr/local/bin/rpisurv/logs/可在logging.yml中开启 DEBUG 级别查看每个流“可连接/不可连接”的详细过程。相关解析逻辑在源码surveillance/core/Screen.py屏幕级参数与surveillance/core/CameraStream.py视频流级参数中遇到疑难问题可以对照阅读。写在最后display1.yml 的参数不多但组合灵活nr_of_columns控制整体布局、duration控制轮播节奏、imageurl让屏幕不止能放监控还能放图片再加上force_coordinates与showontop就能自由定制画中画。对照这份参数解析从最小配置开始逐步叠加你很快就能配出一套满意的树莓派监控大屏。【免费下载链接】rpisurvRaspberry Pi surveillance项目地址: https://gitcode.com/gh_mirrors/rp/rpisurv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Rpisurv配置文件完全指南：display1.yml逐项参数解析
Rpisurv配置文件完全指南display1.yml逐项参数解析【免费下载链接】rpisurvRaspberry Pi surveillance项目地址: https://gitcode.com/gh_mirrors/rp/rpisurvRpisurv 是一款将树莓派变成专用监控显示终端Raspberry Pi surveillance的开源软件安装完成后绝大多数个性化设置都集中在/etc/rpisurv目录的 YAML 配置文件中。其中display1.yml 负责第一块显示器上的全部画面布局与轮播逻辑是 Rpisurv 配置文件中最核心、也最值得精读的一份。这篇配置指南将逐项拆解 display1.yml 的每个参数、默认值与适用场景帮你快速上手树莓派监控画面配置少走弯路。 上图是 Rpisurv 建立视频流连接时显示的过渡画面图片文件位于surveillance/images/connecting.png安装后也可以替换成你自己的图片。一、display1.yml 在哪里Rpisurv 配置文件一览Rpisurv 安装后会在/etc/rpisurv目录下生成以下配置文件文件作用general.yml全局高级选项统计上报、屏幕缓存、内存检测普通用户基本不用动display1.yml第一块显示器HDMI 1的屏幕与视频流配置display2.yml第二块显示器HDMI 2的屏幕配置单显示器时不会读取logging.yml日志等级与输出位置配置项目仓库中带完整注释的示例分别位于surveillance/conf/display1.yml、surveillance/conf/display2.yml、surveillance/conf/general.yml和surveillance/conf/logging.yml安装脚本会将其复制到/etc/rpisurv。修改配置后需要重启服务才能生效sudo systemctl restart rpisurv⚠️ 注意display1.yml 是 YAML 格式缩进必须使用空格而非 Tab否则程序会解析失败这是新手最容易犯的错误。二、配置文件结构总览essentials、screens、camera_streams 三层关系display1.yml 的逻辑结构非常清晰只有三层嵌套essentials → screens → camera_streamsessentials最顶层控制自动轮播开关与屏幕列表screens屏幕列表Rpisurv 会按顺序循环轮播这些屏幕只定义一个屏幕则不会轮播camera_streams每个屏幕内的画面列表一个屏幕可同时包含多路摄像头画面或图片。核心骨架如下具体参数下面逐一讲解essentials: screens: - camera_streams: - url: rtsp://user:pass192.168.1.100:554/videoMain duration: 30三、essentials 顶层参数解析disable_autorotation 关闭自动轮播essentials下目前只有一个可选参数参数默认值作用disable_autorotationFalse设为 True 后画面不再自动轮播screens必填要显示的屏幕列表disable_autorotation开启后屏幕不会自动切换但你仍可长按 F1-F12 或小键盘数字键手动调出指定屏幕。适合需要长时间固定观察某个监控画面的场景例如门卫值班室常驻大门画面。四、屏幕级参数解析duration、nr_of_columns、disable_probing_for_all_streamscamera_streams列表之外每个屏幕还支持 3 个可选参数参数默认值作用camera_streams必填该屏幕要显示的画面列表duration30轮播时该屏幕停留的秒数nr_of_columns2画面按几列排列行数由屏幕分辨率自动计算disable_probing_for_all_streamsFalse是否禁用所有视频流的连通性探测duration屏幕每次轮播的停留时间。注意如果设得太短比如 5 秒而画面构建耗时更长Rpisurv 会等构建完成后再开始计时不会生硬切换。nr_of_columns一行排几路画面默认 2即 2 列。改为 3 就是三列布局比手动计算坐标省事得多这也是自动布局最常用的参数。disable_probing_for_all_streams不建议开启。关闭探测后失效的视频流不会被移除画面不会自动重排断线恢复也会变慢。画面数量不足时剩余空白位置会显示占位图见下图源码位于surveillance/images/placeholder.png五、视频流级参数逐项解析camera_streams 的重点配置camera_streams列表中的每一项代表一路画面url是唯一必填项其余参数均可选参数默认值作用url必填视频流或图片地址支持 rtsp/http/https/file/rtmp 协议imageurlFalse设为 true 表示该 url 是图片而非视频流force_coordinates无手动指定画面坐标[左上x, 左上y, 右下x, 右下y]showontopFalse让该画面叠加显示在其他画面之上画中画probe_timeout3连通性探测超时时间秒rtsp_over_tcpFalseRTSP 改用 TCP 传输解决“拖影”问题network_caching_ms500网络缓存毫秒数平滑度与延迟的权衡enableaudioFalse是否播放该路流的音频freeform_advanced_vlc_options空直接透传 VLC 高级命令行参数各参数使用建议url摄像头 RTSP 地址如rtsp://用户名:密码IP:554/videoMain、HTTP/HTTPS 视频流、本地文件file:///路径/xxx.m4v均可。图片流需要配合imageurl: true。imageurl把地址当作图片处理图片在远端或本地变化时 Rpisurv 会自动重新加载。可用来做数字相框、信息发布屏等场景。注意图片流不支持showontop。force_coordinates格式为[左上角x, 左上角y, 右下角x, 右下角y]手动精确控制画面位置。一旦对某个屏幕使用该屏幕的布局就由你全权负责其他未指定的画面仍会自动计算可能与手动画面重叠需要自行协调。showontop配合force_coordinates可做出画中画效果比如主画面全屏、小画面叠加在角落演示配置里就有现成例子。probe_timeout部分摄像头或弱网环境连接较慢可调大到 5-10 秒避免被误判为“不可连接”而提前移出画面。rtsp_over_tcp遇到画面“拖影”smearing时设为true往往能解决。network_caching_ms值越大播放越流畅但延迟越高监控直播对延迟敏感可调小本地视频回放可适当调大。freeform_advanced_vlc_options进阶玩法直接传入 VLC 参数例如--no-keyboard-events。属于高级选项组合效果未必全部经过测试建议有经验的用户使用。六、一份可直接套用的最小配置示例把下面的内容复制进/etc/rpisurv/display1.yml改成你自己的摄像头地址即可使用essentials: screens: - camera_streams: - url: rtsp://user:pass192.168.1.100:554/videoMain - url: rtsp://user:pass192.168.1.101:554/videoMain duration: 30 nr_of_columns: 2这段配置会显示两路摄像头画面2 列布局每 30 秒轮播一次。七、常见问题排查连不上、画面异常怎么办某一屏幕所有画面都无法连接时Rpisurv 会全屏显示提示图见下图源码位于surveillance/images/noconnectable.png建议先用 VLC 验证摄像头地址能否正常播放再写入 display1.yml可以过滤掉大部分“配置看着没问题但就是不出画”的烦恼。排查日志位于/usr/local/bin/rpisurv/logs/可在logging.yml中开启 DEBUG 级别查看每个流“可连接/不可连接”的详细过程。相关解析逻辑在源码surveillance/core/Screen.py屏幕级参数与surveillance/core/CameraStream.py视频流级参数中遇到疑难问题可以对照阅读。写在最后display1.yml 的参数不多但组合灵活nr_of_columns控制整体布局、duration控制轮播节奏、imageurl让屏幕不止能放监控还能放图片再加上force_coordinates与showontop就能自由定制画中画。对照这份参数解析从最小配置开始逐步叠加你很快就能配出一套满意的树莓派监控大屏。【免费下载链接】rpisurvRaspberry Pi surveillance项目地址: https://gitcode.com/gh_mirrors/rp/rpisurv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考