Skip to content

feat: optional QR code on the start screen - #1675

Open
gambijul wants to merge 2 commits into
PhotoboothProject:devfrom
gambijul:feat/start-screen-qr
Open

gambijul wants to merge 2 commits into
PhotoboothProject:devfrom
gambijul:feat/start-screen-qr

Conversation

@gambijul

@gambijul gambijul commented Nov 8, 2026

Copy link
Copy Markdown

Summary

Adds an optional QR code on the start screen, for example to send guests to an online gallery.

New start_screen options, available in the admin panel next to the title and subtitle settings:

Option Default Description
qr_visible false Show the QR code
qr_url '' Link encoded in the QR code (nothing is shown while empty)
qr_text '' Optional caption under the code
qr_position top_right top_right, top_left, bottom_right or bottom_left

Implementation

  • template/components/start.qr.php renders the code server side as an inline PNG data URI with the existing QrCodeUtility, so there is no extra request and no JS. Errors are logged and the code is simply not shown.
  • assets/sass/components/_start-qr.scss places it in a white card (quiet zone for scanners) using the same 4rem corner offsets as the logo. The size scales with the viewport (clamp(8rem, 14vw, 14rem)) and can be overridden in private/overrides.css.
  • English admin labels and help texts are added; other languages go through Crowdin.

Test plan

  • Enabled on a Raspberry Pi 3 kiosk with a URL: the code shows in the selected corner, with and without caption, and does not overlap the centered logo or the action buttons.
  • Disabled, or enabled with an empty URL: nothing is rendered.
  • Scan with a phone to confirm the link.

🤖 Generated with Claude Code

gambijul and others added 2 commits November 8, 2026 14:02
Adds start_screen options to show a QR code in a corner of the start
screen, e.g. linking to an online gallery: qr_visible, qr_url, qr_text
(optional caption) and qr_position (top/bottom, left/right).

The QR code is rendered server side as an inline PNG with the existing
QrCodeUtility, so no extra request or JS is needed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The start screen QR keys were inserted after the subtitle key, so the
build re-sorted the file and the git status check failed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant