Git Product home page Git Product logo

photobooth's Introduction

Photobooth v4

A Photobooth web interface for Linux and Windows.

Photobooth was initially developped by Andre Rinas to use on a Raspberry Pi, you can find his source here. In 2019 Andreas Blaesius picked up the work and continued to work on the source. With the help of the community Photobooth grew to a powerfull Photobooth software with a lot of features and possibilities.

(The full changelog can be found on https://photoboothproject.github.io.)

Chat on Telegram

Translate on Crowdin

Latest stable release: Lint gulp-sass Build

Latest development version: Lint gulp-sass Build

πŸ“· Screenshots

βš™οΈ Supported Platforms and Cameras

Hardware-Platform Software-Platform Supported Cameras
Raspberry Pi 3 / 4 / 5 Raspberry Pi OS 64bit Bullseye / Bookworm Camera Modules, gphoto2 DSLR, webcam *2
Raspberry Pi 3 / 4 / 5 Raspberry Pi OS 32bit Bullseye / Bookworm *1 Camera Modules, gphoto2 DSLR, webcam *2
Generic PC Debian/Ubuntu gphoto2 DSLR, webcam *2
Generic PC Windows digiCamControl, wsl + Debian/Ubuntu subsystem, webcam *2

*1 On Raspberry Pi OS 32bit Bullseye you must add arm_64bit=0 to your /boot/config.txt and reboot once before installing Photobooth. The Raspberry Pi foundation uses a 64bit kernel while the system is 32bit. The Installation fails because the v4l2loopback module can't be compiled for a 32bit OS while using a 64bit kernel.

*2 Capture from webcam is possible e.g. using fswebcam, else it only works on access via http://localhost

βš™οΈ Prerequisites

Software Required version Note
Node.js >=v18.17.0 Currently only v18 is tested. Our installer will check your Node.js version and suggest an update/downgrade if needed. Versions below v18 aren't supported anymore.
npm >=v9.6.0
php >=v8.2
Webserver Apache, Nginx or lighttpd is needed. By default Apache webserver is installed by our installer.

😍 Features

  • Works on Windows and Linux.
  • Images are processed with GD.
  • Gallery based on PhotoSwipe v5
  • Standalone Gallery based on PhotoSwipe v5 (localhost/gallery).
  • Standalone Slideshow based on PhotoSwipe v5 (localhost/slideshow).
  • Access login via localhost/login.
  • Offline manual with settings explained at localhost/manual.
  • Offline FAQ at localhost/manual/faq.
  • Disk usage page, access via admin panel or directly at localhost/admin/diskusage.
  • Settings can be changed via Admin Panel at (localhost/admin):
    • Multi-language support:
    • Login to protect Admin Panel, Start page and/or Manual & FAQ can be enabled.
    • Hardware Button functionality, supports two separate modes of operation (select via admin panel):
      • Button Mode: Distinct hardware buttons can be connected to distinct GPIOs. Each button will trigger a separate functionality (i.e. take photo).
      • Rotary Mode: A rotary encoder connected to GPIOs will drive the input on the screen. This enables to use the rotary to scroll through the Photobooth UI buttons, and click to select actions.
    • Gallery: allow to adjust the look and feel (settings explained inside the manual).
    • Choose between date-formatted or random image names.
    • Choose an image filter after taking a picture.
    • QR-Code to allow downloading pictures from your Photobooth.
    • Pictures can be directly downloaded from the gallery.
    • Print feature:
      • Optional: Print a frame on your picture
      • Optional: Print text on your picture.
      • Optional: Print QR-Code on the right side of your picture.
      • Optional: Auto print function
      • Optional: allow to delay auto print
      • Optional: allow to adjust time "Started printing! Please wait..." is visible
      • Optional: allow to trigger print via defined key
      • Optional: options to show the print button independent (e.g. can be only visible on gallery)
    • Pictures can be sent via e-mail.
    • Different Live Preview options
    • Event specific (e.g. wedding, birthday) config to show a symbol (e.g. heart) between some text on the start page.
    • Chroma keying
    • Photo collage function: take pictures in a row with or without interruption and let it generate a collage out of it. Choose between different collage layouts!
    • Save pictures with a Polaroid effect.
    • Adjust take picture and print commands.
    • Adjust the style of Photobooth via admin panel.
  • ... And many more options to adjust and style Photobooth for your personal needs

πŸ”§ Installation & Troubleshooting

Please follow the installation instructions here to setup Photobooth.

If you're having trouble or questions please take a look at our FAQ before opening a new issue.

For local testing and development, the docker setup can be used with docker-compose up --build.

πŸ” Changelog

Please take a look at the changelog available on https://photoboothproject.github.io.

⚠️ Security advice

Photobooth is not hardened against any kind of targeted attacks. It uses user defined commands for tasks like taking photos and is allowed to replace its own files for easy updating. Because of this it's not advised to operate Photobooth in an untrusted network and you should absolutely not make Photobooth accessible through the internet without heavy modifications!

©️ License

Photobooth source is licensed under the MIT license.

Once build, Photobooth incorporates several parts and optimizations that are covered by a different license which could apply to Photobooth as well. All dependencies include their respective LICENSE files.

πŸŽ‰ Donation

If you like our work and consider a donation, we have to tell you that we don't accept any money. We're happy about every contribution to this project and strive to make it better every day. Just get in touch with us on Telegram to say thank you or help us find ways to improve.

If you still want to donate money to make us happy: consider a donation to the seal station Norddeich (donate via Paypal).

Thanks for reading!

πŸŽ“ Tutorial

Raspberry Pi Weddingphotobooth (german) Raspberry Pi Fotobox fΓΌr Hochzeiten und Geburtstage (German) Raspberry Pi Photobooth in a classic vintage plate camera

πŸ‘ Contributors and thanks to

photobooth's People

Contributors

andi34 avatar andreasremdt avatar andreknieriem avatar benjaminkott avatar cfmjk avatar dadav avatar dened1 avatar dependabot-preview[bot] avatar dependabot[bot] avatar diy89 avatar eccob avatar f4bsi avatar fmiccolis avatar jacques42 avatar jarettrude avatar ledsi avatar lix0st avatar metropo avatar mhellmeier avatar nihilor avatar raukze avatar rawbertp avatar s-dinda avatar spike-78 avatar styne13 avatar sualko avatar thatonedude3470 avatar thymon13 avatar up-87 avatar vrs01 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.