本页目录

树莓派开源照相亭(pibooth)

pibooth · pibooth/pibooth

pibooth 是用纯 Python 编写的开源照相亭(Photo Booth)应用,宣称开箱即用,主要面向树莓派。它支持 gPhoto2、OpenCV 及树莓派摄像头等相机,可连拍 1~4 张照片并拼接成成片,支持树莓派 GPIO 硬件按钮与指示灯、键盘/鼠标/触摸屏操作...

其他 Pygame Python 动画系统 UI 系统 初级
★ Stars 844 Forks 205 License MIT 更新 2026-11-19

国内开发环境适配

Windows
未知
Linux
官方声明支持
macOS
未知
引擎 / 框架:Pygame 暂无中文教程标记 未标记站长实测
README 未提供国内网络或镜像专项说明。项目通过 PyPI 发布,国内安装可考虑配置 PyPI 镜像;同时需准备 gPhoto2、OpenCV、树莓派 GPIO、CUPS 等系统依赖,具体包名与安装方式待核验。若使用树莓派摄像头与 GPIO,需在树莓派系统环境中验证。

中文项目介绍

pibooth 是一个用纯 Python 编写的开源照相亭(Photo Booth)应用,主要面向树莓派,也面向与 OpenCV 兼容的设备。它强调“开箱即用”:把相机、屏幕、按钮或触摸屏、打印机组合起来,就能搭建一个可自助拍照、合成并输出照片的互动装置。它并不是传统意义上的电子游戏,更接近展会、婚礼、活动中的互动拍照程序;在游戏精选库中可归入“其他”类,作为树莓派互动装置与 Python 应用案例参考。README 给出的 Python 版本徽章为 3.10+,项目文档发布在 Read the Docs,GitHub Wiki 中还展示了用户的实际搭建成品。

核心功能

核心特性

  • 界面支持丹麦语、荷兰语、英语、法语、德语、匈牙利语、挪威语、葡萄牙语(葡萄牙与巴西)、西班牙语和瑞典语,并可自定义。
  • 一次拍摄 1 到 4 张照片,并将它们拼接为最终成片。
  • 支持与 gPhoto2、OpenCV 以及树莓派摄像头兼容的相机。
  • 支持树莓派 GPIO 上的硬件按钮和指示灯。
  • 可完全通过硬件按钮、键盘、鼠标或触摸屏操作。
  • 支持树莓派开机自启动。
  • 空闲时播放上一组拍摄序列的动画。
  • 保存最终成片,也保留每张单拍照片。
  • 通过 CUPS 服务器打印最终照片,并显示打印队列状态。
  • 可在成片上添加自定义文字,字体、颜色、对齐方式均可配置。
  • 支持自定义背景和叠加层。
  • 所有设置保存在配置文件中,常用选项可在图形界面中调整。
  • 提供插件系统,可安装社区发布在 PyPI 上的插件,也可自行开发插件。

技术架构分析

技术要点

从仓库主题标签可以看到 gphoto2、OpenCV、Pillow、Pygame、python3、Raspberry Pi Camera 等关键词,说明项目围绕 Python 图像采集、图像合成和树莓派外设交互展开。相机层兼容多种来源:gPhoto2 负责一类相机,OpenCV 负责另一类兼容设备,树莓派摄像头也有对应支持。输入层既接受 GPIO 硬件按钮与灯,也接受键盘、鼠标和触摸屏。输出层把单拍照片和拼接成片写入存储,并可交给 CUPS 打印。界面、文字、背景、叠加层和空闲动画构成最终的拍照体验,配置文件与插件机制则让这些行为可以扩展。

构建与运行

README 说明项目是纯 Python、以 PyPI 包形式发布,并给出 Python 3.10+ 的版本徽章;具体安装与配置步骤应参考官方文档(pibooth.readthedocs.io)和 Wiki。运行环境以树莓派为主,需要准备相机、显示设备、输入设备以及可用的 CUPS 打印服务。若要使用 GPIO 按钮和灯,还需要树莓派 GPIO 环境。项目支持开机自启,适合做成专用照相亭设备。README 未在摘录中给出完整命令行安装步骤,因此实际部署时建议先按文档完成相机与系统依赖配置,再调整配置文件中的拍摄张数、界面语言、打印与自启动选项。

补充说明

插件生态

pibooth 的扩展性来自插件系统。README 列出了 pibooth 组织维护的插件,包括图片模板、Google Photo、音效、Dropbox、二维码、额外灯光等;也列出了第三方插件,例如 LCD 显示、OLED 显示、NeoPixel SPI、Telegram 上传和 S3 上传。用户可以从 PyPI 搜索 pibooth 相关插件,或按照插件机制开发自己的扩展。对活动场景来说,这些插件可用于改变成片样式、增加上传渠道或连接外设显示。

学习建议

这是一个适合学习 Python 与树莓派硬件结合的项目:可以研究相机采集抽象、GPIO 输入、图像拼接与文字/背景合成、CUPS 打印队列、配置文件管理和插件架构。建议先在树莓派上跑通官方文档的最小配置,再逐步替换背景、文字和插件;如果用于活动,需要提前测试相机兼容性、打印队列和断电重启后的自启动行为。它不属于游戏玩法项目,分类上更适合作为“其他”类互动应用参考。

开源许可证与版权说明

许可证标识:MIT。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目