Automation script intended to assist in photo booth management.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


I started this project to help me operate a photo booth for an event later this year. When I found myself editing images, superimposing overlays, and printing on the fly, I said that there had to be a way to automate this. I found some pre-made software online already, but it didn't quite fit my needs so this project came to be. I hope others may find a use for this in support of some small events they may have have.

Base directory watch structure built off of Bruno Rocha's guide

What this does:

Stacks an overlay image over incoming base images (in my use case from a tethered DSLR)

What you'll need first

Get the good stuff

git clone

Getting it working

From /PATH/photo-booth-automation/

pip install -r requirements.txt

You may want to replace overlay.png with your own overlay image. Currently overlay image needs to be named overlay.png. Overlay image should share the same dimensions as incoming images

- Scalable overlay images to come in the future. -

Hit the ground running

Navigate to /PATH/photo-booth-automation/ and run

python [path/to/watch/directory/parent]

Program will run in root directory if none is given.

Note: see /tests/ for testing instructions.

Taking pictures

Once the script is running, your watch-folder/ should be the destination directory for any pictures being taken. Adobe Lightroom tethered shooting is a great option, but I found entangle was a good open source alternative for Linux.

Whether you decide to use this script to support tethered shooting or you just want to stack the overlay over images as a bulk process, it could be done. Your watch-folder/ directory will handle this completely. If you have your tethered shooting to save directly to the watch-folder/, the images will be processed as soon as they are taken. You can also simply drop a copy of any images to be processed in the watch-folder/ as well.


Please read for details on our code of conduct, and the process for submitting pull requests to us.


We use SemVer for versioning. For the versions available, see the tags on this repository.


  • Joshua Wu - Initial work

See also the list of contributors who participated in this project.


This project is licensed under the MIT License - see the file for details


  • Thanks to AlChiu, psyduc, phuchle, and rainrivas for putting up with 24 hour activity notifications, catching my mistakes, and putting up with all of my review requests.


  1. git clone
  2. cd /PATH/photo-booth-automation
  3. pip install -r requirements.txt
  4. Replace overlay.png with your own.
  5. python
  6. Take or add pictures to watch-folder/
  7. View images in save-folder/