Skip to content
A flexible photobooth software
Branch: master
Clone or download
Latest commit 471fb07 Mar 11, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
photobooth Enclosed config changes in setActive/setIdle in try-catch-blocks to a… Jan 12, 2019
screenshots Some screenshots added Jul 3, 2018
supplementals State chart added Mar 11, 2019
.gitignore Update gitignore Aug 23, 2018 gphoto2-cffi made optional as a dependency, included optional depende… Jul 17, 2018
LICENSE.txt Structure made compatible to setuptools May 1, 2018 Added working i18n Aug 23, 2018 Update Aug 19, 2018 Added script to enable autostart of photobooth Aug 21, 2018
setup.cfg Added Babel commands to for #32 Aug 23, 2018 Added working i18n Aug 23, 2018


Buy me a coffee

A flexible Photobooth software.

It supports many different camera models, the appearance can be adapted to your likings, and it runs on many different hardware setups.


This is a Python application to build your own photobooth.


  • Capture a single or multiple pictures and assemble them in an m-by-n grid layout
  • Live preview during countdown
  • Printing of captured pictures
  • Highly customizable via settings menu inside the graphical user interface
  • Support for external buttons and lamps via GPIO interface
  • Theming support using Qt stylesheets


Screenshots produced using CameraDummy that produces unicolor images.

Theme pastel

Idle screen Greeter screen Countdown screen Postprocessing screen Settings screen

Theme dark

Idle screen Greeter screen Countdown screen Postprocessing screen

Technical specifications

  • Many camera models supported, thanks to interfaces to gPhoto2, OpenCV, Raspberry Pi camera module
  • Tested on Standard x86 hardware and Raspberry Pi models 1B+, 2B, 3B, and 3B+
  • Flexible, modular design: Easy to add features or customize the appearance
  • Multi-threaded for responsive GUI and fast processing
  • Based on Python 3, Pillow, and Qt5


I started this project for my own wedding in 2015. See Version 0.1 for the original version. Github user hackerb9 forked this version and added a print functionality. However, I was not happy with the original software design and the limited options provided by the previously used pygame GUI library and thus abandoned the original version. Since then it underwent a complete rewrite, with vastly improved performance and a much more modular and mature software design.

Installation and usage

Hardware requirements

  • Some computer/SoC that is able to run Python 3.5+ as well as any of the supported camera libraries
  • Camera supported by gPhoto 2 (see compatibility list), OpenCV (e.g., most standard webcams), or a Raspberry Pi Camera Module.
  • Optional: External buttons and lamps (in combination with GPIO-enabled hardware)

Installing and running the photobooth

See installation instructions.

Configuration and modifications

Default settings are stored in defaults.cfg and can either be changed in the graphical user interface or by creating a file photobooth.cfg in the top folder and overwriting your settings there.

The software design is very modular. Feel free to add new postprocessing components, a GUI based on some other library, etc.

Feedback and bugs

I appreciate any feedback or bug reports. Please submit them via the Issue tracker and always include your photobooth.log file (is created automatically in the top folder) and a description of your hardware and software setup.

I am also happy to hear any success stories! Feel free to submit them here

If you find this application useful, please consider buying me a coffee.


I provide this code under AGPL v3. See LICENSE.

You can’t perform that action at this time.