家里有块树莓派和电子纸屏幕，想让它每天轮流显示天气、时钟、漫画，而不是接上电源就黑屏吃灰，PaperPi 就是为这个场景做的插件化信息展示程序。它跑在 Raspberry Pi 上，把天气、时钟、音乐、漫画这类内容按插件组织起来，循环渲染到电子纸屏幕上，适合做一面长期放在桌边或玄关的家庭信息面板。先把一句话说在前面：据项目说明，当前主分支的版本 2 正在重写、暂时不可用，想马上部署要走 v1 分支，不要直接拉主分支当成品用。
PaperPi 能展示什么
PaperPi 的核心不是某一块固定内容，而是一套插件循环展示的框架。每个插件负责一种信息，程序按配置依次渲染，电子纸低功耗、不发光的特性又正好适合长期挂在墙上或放在桌角慢慢刷新。按项目说明，目前可覆盖的内容方向包括以下几类：
- 天气：展示当日与近期的天气信息，适合放在玄关，出门前看一眼就走。
- 时钟：大字时钟是最基础的常驻画面，也是电子纸面板最不容易出错的用法。
- 音乐：展示音乐相关信息，适合把面板放在书桌或音响旁边当氛围屏。
- 漫画：循环展示漫画内容，电子纸的纸感显示效果比普通屏幕更贴合阅读场景。
- 其他周期性信息：插件机制允许继续扩展新的展示内容，不必为每种信息单独写一套轮播程序。
插件机制还带来一个实际好处：展示内容、配置和存储目录是分开管理的，换内容改配置即可，不用动程序本身。想长期维护一块家庭面板的人，最怕的就是每次换个内容就要重写一遍主程序，PaperPi 把这层工作收进了插件里。
信息表
| 项目 | 内容 |
|---|---|
| 软件名 | PaperPi |
| 适用硬件 | Raspberry Pi 及兼容电子纸显示器 |
| 适用系统 | Linux，针对 Raspberry Pi OS trixie 说明 |
| 实现语言 | Python |
| 展示方式 | 插件循环渲染到电子纸屏幕或 PNG 文件 |
| 部署方式 | systemd 服务，随设备启动、崩溃后自动重启 |
| 当前可用版本 | v1 分支；主分支版本 2 正在重写、暂时不可用 |
| 获取方式 | 见文末 GitHub 仓库按钮 |
上手指南
PaperPi 的部署思路是先在 v1 分支上把程序跑起来，再慢慢调自己的面板内容。没有实体屏幕也可以先玩起来，这是它对新手比较友好的一点。下面是按项目说明整理的关键步骤，不含多余的折腾环节：
- 确认分支：部署前先分清 v1 分支和正在重写的主分支，立即可用的部署走 v1 分支的安装说明，不要把主分支当成可部署版本。
- 准备环境：按 v1 分支的安装说明准备 Raspberry Pi 与电子纸硬件，开发与运行环境涉及 Python 3.13、uv、ruff，以及树莓派上的 gcc 与 python3-dev，屏幕通信依赖 Linux 下的 spidev 与 gpiod。
- 生成示例配置：用 paperpi example-config 生成一份示例配置文件，里面已包含虚拟屏幕、时钟和天气的配置块，照着改比从零手写省事。
- 先渲染验证：用 paperpi render 命令把插件渲染成 PNG 文件，不需要实体屏幕和网络就能检查输出效果，画面不对先在 PNG 上调，调对了再上屏。
- 装成系统服务：按文档把程序安装为 systemd 服务，让它随设备启动，并在崩溃后自动重新启动，面板才能长期无人值守地跑下去。
- 再扩展插件：基础画面跑稳之后，再按插件文档加自己想要的展示内容，配置、存储目录与示例数据按插件各自的说明分开维护。
取舍与对比
同样是给电子纸屏幕找内容，PaperPi 不是唯一解法，选它还是选别的办法，关键看你愿不愿意为一块长期面板付出配置成本：
| 方案 | 适合谁 | 不适合谁 |
|---|---|---|
| PaperPi 插件面板 | 已有树莓派和电子纸屏，想长期轮换多种信息、愿意按文档配置的人 | 只想立刻亮屏、不想碰配置和分支区别的人 |
| 现成电子纸相框或成品屏 | 不想折腾硬件和部署，买回来就能显示固定内容的人 | 想自由换天气、时钟、漫画等多种插件内容的人 |
| 自己写脚本轮播图片 | 只需要一两张固定图轮换、且自己会写脚本的人 | 想持续加新内容、又不想每次都改主程序的人 |
明确推荐是：如果你已经有树莓派和电子纸硬件，并且接受先读 v1 分支安装说明、接受没有网页配置界面这个现状，PaperPi 值得一试。反过来，如果你现在还没有硬件，或者指望网页点一点就能配置、Docker 一键装好，那就先别急，等版本 2 的相关能力完成再评估，那些目前只是后续计划，不是现成功能。
常见问题
主分支的版本 2 现在能部署吗？据项目说明不能，版本 2 正在重写、暂时不可用，立即可用的部署走 v1 分支。
没有实体电子纸屏幕，能先体验吗？可以，paperpi render 能把插件渲染成 PNG 文件，配合虚拟屏幕配置，不用实体屏幕和网络也能检查输出。
支持哪些电子纸屏幕？屏幕通信依赖 Linux 下的 spidev 与 gpiod，具体硬件兼容范围要以项目说明或源码为准，部署前先核对自己的屏幕型号。
网页配置界面和 Docker 安装现在有了吗？据项目说明还没有，IT8951 显示器支持、网页配置界面和 Docker 安装都被列为版本 2 的后续计划，不能当成当前已提供的能力。
面板断电重启后要手动再开一次吗？按文档装成 systemd 服务后不用，程序会随设备启动，并在崩溃后自动重新启动。
获取方式
GitHub 国内访问较慢，如打不开可多刷新几次
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
