QR Code Download Captures¶

The share service allows users to easily download images on the user's phone. The user simply scans the QR code to download.

gallery_detail — Scan the QR code to download image to smartphones.

Method A: Use the batteries included shareservice.
- ➕ Easy setup
- ➕ Convenient for user: Direct internet download
- ➕ Data saver: On the fly upload when QR code is scanned
- ➖ needs php online service (usually paid webhosting service)
- ➖ Images shared via (private) internet service might conflict with GDPR
Method B: Share via local WiFi-Hotspot.
- ➖ Inconvenient for user: Smartphones need to log in local WiFi
- ➕ No need to synchronize, no data usage
- ➕ Local solution don't need any online service
- ➕ Local solution less likely to conflict with GDPR
- ➖ Custom setup
Method C: Sync images (on your own) and provide a custom URL users can download images
- ➕ Convenient for user: Direct internet download
- ➕ Image backup on the fly
- ➖ Custom setup
- ➖ All images need to synchronize, uses more data
- ➖ needs online service (usually paid webhosting service)
- ➖ Images shared via (private) internet service might conflict with GDPR

Method A: Batteries included qr shareservice¶

Benefits¶

secure: the photobooth does not need to expose a service to the internet
saves data: only images that are requested via QR code are transferred via internet
works also with cellular internet service that usually provide no public ip address
simple: just one php file to setup

Working Principle¶

It's developed with ease of use in mind and shall work on most systems even with firewalled internet connection on photobooth side like cellular services. Once setup, the prinicple is as following:

photobooth starts and creates a long-term connection via internet (wifi, ethernet or cellular) to a php script on your webhosting service.
now if a QR code is scanned, the php script sends an upload request via the long-term connection to the photobooth
the photobooth uploads the requested file
once upload is finished, the image is displayed to the user

Setup (Method A)¶

download dl.php
edit the config variables on top of dl.php. see the comments in dl.php for reference.
place the edited dl.php on a public server, for example your shared hoster. The server must be available to the photobooth and the users downloading photos later.
Enable the qr share service in the admin config
Pair the dl.php script with photobooth app by configuring the qr shareservice settings in photobooth admin config, tab common:
- set shareservice_apikey to same value as in dl.php
- set shareservice_url to the public URL pointing to the dl.php script.
- choose whether to download the original file or the full processed version.
Now restart the photobooth app and try to scan a QR code in the gallery.

Troubleshooting¶

check php error log in the folder where dl.php is located.
ensure the dl.php directory has write-permission for the webserver.
check photobooth error log.
nginx needs to be configured for longrunning http-requests

If the shareservice is not what you want, you could create a local WiFi. Users log in that WiFi and can download directly from the photobooth. Setup the URL for the QR code to point to the image you would like to let the user download. There are several versions of the images available, see the list of mediaitem's directories.

Below an example URL to use in the QR code. {identifier} gets replaced by the acutal filename. Replace the IP and port by the actual data.

Setup (Method B/C)¶

DISABLE the qr share service in the admin config
Set the http URL for the QR code as below:

Share Custom Qr Url example for v5 and later

http://localhost:8000/media/full/{identifier}

Share Custom Qr Url example before v4

http://localhost:8000/media/processed/full/{filename}