GuestLens: occasion photograph and video sharing with a QR code
GuestLens is a self-hosted PHP script for accumulating visitor photographs and movies
at occasions. A bunch creates an occasion and will get a QR code. Company scan it and
add photographs and movies from their telephone browser. There isn’t any app to
set up and no account to make. The host will get a dwell gallery, a big-screen
slideshow, a guestbook with voice notes, a photograph ebook PDF, a video of the
photographs, an offline album, and one ZIP file with every thing. The host can
additionally give their very own buyer, such because the couple, a personal hyperlink to the
occasion, and provides each occasion its personal look with the theme customizer.
You put in GuestLens by yourself server and run it as your personal service. You
are the tremendous admin. Your clients are the hosts: {couples}, occasion planners,
photographers, and venues. You set the plans and costs, take funds with
Stripe, PayPal, or financial institution switch, and put your personal model on each web page and
electronic mail. Model 4.0 added buyer entry, Google Drive storage, website
sponsors by plan, and deletes an occasion’s information from storage when the occasion
is deleted. Model 4.1 fixes bugs that consumers reported, and warns you when
your server’s PHP is lacking a safety repair. Model 4.2 lets a reserving ship
the shopper hyperlink, with an optionally available password, and provides extra fixes and small
adjustments that consumers requested for. Model 5.0 provides the theme customizer, a
photos-only slideshow, a plan picker for brand new occasions, the ZIP obtain as a
plan characteristic, your personal house web page, and a second model colour.
Reside demo
-
Demo:
https://guestlens-demo.jawad.work/ - Host login: [email protected] / demo-password-1
-
Tremendous admin login: [email protected] /
demo-password-1 -
Visitor web page (marriage ceremony, uploads look ahead to approval):
https://guestlens-demo.jawad.work/e/maya-and-daniel -
Visitor web page (birthday, uploads present instantly):
https://guestlens-demo.jawad.work/e/priya-turns-30 -
Buyer hyperlink of the demo marriage ceremony (open it in a personal
window):
https://guestlens-demo.jawad.work/c/demoCustomerLinkForTheGuestLensDocumentation0001 -
Reserving web page of the demo host:
https://guestlens-demo.jawad.work/book/rosewood
The login web page has one-click buttons for each logins. Open a visitor web page on
your telephone and add just a few photographs. The demo resets each day at 04:00 UTC.
Each photograph from the occasion, in a single place
Company scan a QR code and add from their telephone. The host sees each
add on one dashboard, and also you run the entire thing as your personal service.
For company: scan, add, completed
-
No app, no sign-up. The occasion opens in any telephone
browser. Company can add their title in the event that they wish to. -
Many information without delay. Company decide photographs and movies
collectively, and every file reveals its personal progress. -
Smaller information first. The telephone shrinks every photograph
earlier than sending it. A bunch can activate full high quality for an occasion. -
Uploads that survive unhealthy Wi-Fi. Information go up in small
items. If the connection drops, the add pauses and continues the place
it stopped. Nothing begins over. -
Brief movies. MP4, MOV, and WebM, as much as 60 seconds and
100 MB by default. A plan or an occasion can decrease these limits. -
A caption on every file. Company can add a caption of up
to 200 characters whereas the file uploads, or after. -
Guestbook with voice notes. Company write a message or
document as much as 60 seconds of audio, and listen to it earlier than they ship it. -
Reside gallery. New photographs seem as they arrive. Company
can like and remark. -
Privateness. Location knowledge (GPS) is faraway from each
photograph file.
For hosts: a gallery the host controls
-
Gallery order. The host units the order company see, and
writes or adjustments the caption on any file. -
One ZIP with every thing. Small occasions obtain proper
away. Giant occasions construct within the background, and the host will get an electronic mail
with the obtain hyperlink. Obtain every thing, accepted information solely, or one
visitor’s album. -
Personal occasions. Shield an occasion with a PIN or a
password, and set the dates when uploads open and shut. -
Eight occasion themes. Marriage ceremony Traditional, Marriage ceremony Backyard,
Birthday, Child Bathe, Company, Commencement, Anniversary, and Vacation
Get together. Every theme adjustments the fonts, colours, button shapes, decoration,
and canopy. The host can add a canopy photograph and a brand, or make a Customized
theme of their very own (5.0).
Moderation: approve it first
Nothing seems till the host approves it: photographs, movies, feedback, and
guestbook messages. The host can approve every thing without delay, choose many
information, or use the keyboard (A approves, R rejects). A bunch may flip
approval off for an occasion, so uploads present instantly. The guestbook saves
as a PDF.
Large-screen slideshow
One hyperlink for a TV or projector. New photographs and guestbook messages seem as
they arrive, subsequent to a QR code so extra company can be part of. Sponsors get a card
of their very own after each 8 photographs. The slideshow retains the display awake and
retains working if the community drops. Since 5.0, “Images solely” hides the facet
panel, and a photograph the host deletes leaves the display inside seconds.
QR codes and print
Obtain the QR code as PNG or SVG, within the host’s personal colour and with a brand
within the center. Print three desk card designs or a poster, with crop marks,
on US Letter or A4.
New in 5.0: each occasion in its personal look
-
The theme customizer. Subsequent to the eight themes, a bunch
makes a Customized theme for every occasion: the title font, the button colour,
the web page colour, the quilt colour, and the place the occasion title sits on the
cowl. -
A dwell preview. A telephone on the identical web page reveals the
visitor web page because the host adjustments every management. The quilt photograph is about on
the identical web page. Nothing adjustments for company till the host saves. -
Mild or darkish. The textual content colour follows the web page colour on
its personal, so a darkish web page will get mild textual content. The web page warns when a button
colour is simply too mild for white textual content. -
5 fonts, no font CDN. Fraunces, Playfair Show,
Dancing Script, Montserrat, and Inter ship with the script. A visitor web page
downloads a font solely when it makes use of it. -
Extra from consumers. A bunch with two or extra plans picks
which plan pays for an occasion. The ZIP obtain has its personal plan swap.
Put your personal house web page in a single file that updates by no means change. Branding
has an optionally available second colour.
Added in 4.0: share the occasion with the shopper
-
A non-public hyperlink for the host’s buyer. A photographer
or planner offers the couple, or the corporate that booked them, a hyperlink to
one occasion. The shopper opens it on any telephone or pc, with no
account. -
The host ticks what it opens. The slideshow hyperlink, QR
codes and printing, moderation, the guestbook, the gallery and
downloads, or the occasion settings. The occasion overview all the time opens. -
Secure by design. An optionally available password, a brand new hyperlink at any
time, and the shopper by no means sees the host’s different occasions, plan, or
billing. The audit log marks what was completed via the hyperlink. -
Straight from a reserving (4.2). When the host creates
the occasion from an accepted reserving, one field activates the shopper hyperlink
and emails it with the visitor hyperlink. The host can add a password and tells
it to the shopper. -
A plan swap. Buyer entry is on by default. Flip
it off in a plan to promote it solely in your greater plans.
Added in 4.0: Google Drive, sponsors by plan, and clear deletes
-
Google Drive storage. Preserve each photograph, video, and
voice notice in your personal Google Drive, one folder per occasion. It really works with
a free Google account and with Google Workspace. You join it with
your personal Google Cloud sign-in shopper. The documentation has each step. -
Web site sponsors by plan. Present a website sponsor on each
occasion made underneath the plans you decide, for instance your Free plan. -
Clear deletes. Deleting an occasion or a bunch deletes its
photographs, movies, voice notes, and exports out of your server, S3, or Google
Drive. -
Fixes requested for by consumers. A visitor web page notice you’ll be able to
change in Branding, error pages in your accent colour, plan limits of 0
that say “No restrict”, and visitor hyperlinks you’ll be able to click on to open.
Added in 3.0: hosts take bookings
-
A reserving web page for every host. A photographer, venue, or
planner lists as much as 12 packages and the times they work. Shoppers decide a
package deal and a free day and ship a request, with no account. -
Settle for, then one click on. The host accepts or declines.
An accepted reserving turns into an occasion with one click on, and the shopper will get
the visitor hyperlink and the QR code by electronic mail. -
Non-compulsory cost on-line. A bunch can ask for a deposit
or the total value, paid by Stripe or PayPal after the host accepts. You
maintain an optionally available charge (0% by default) and pay the remainder to the host. -
Emails at every step. The host and the shopper get an
electronic mail when a reserving is requested, accepted, declined, or canceled. The
shopper will get a calendar file too.
Added in 3.0: a photograph ebook, able to print
The photograph ebook is a fourth structure of the photograph report. Every photograph goes in
with the visitor’s title, the caption, and that visitor’s guestbook messages.
Select A4, US Letter, 20×20 cm, or 8×8 inches, with an optionally available 3 mm
bleed and crop marks for a print store. A giant ebook is made within the background,
nonetheless as one PDF.
Added in 3.0: an album that works offline
One HTML file with the accepted photographs and the guestbook inside it. It opens
in any browser, on a telephone or a pc, with no web. It has a photograph
grid, a full display view, a slideshow button, and voice notes that play. The
host may add an index.html album to the ZIP obtain, with the movies
included.
Added in 3.0: a video, and website sponsors
-
MP4 video of the photographs. The host’s personal browser makes
the video, with a title card, each accepted photograph, the voice notes, and
optionally available music. Select 1080p, 720p, or sq. for social media. Your
server solely sends the photographs. It wants no ffmpeg and shops nothing. -
Web site sponsors. You add your personal sponsors as soon as and present
them on all occasions, on the occasions of chosen hosts, or on chosen occasions.
Since 4.0, additionally on the occasions of chosen plans. Set the primary and final
day of a paid slot, and see the clicks from every occasion.
Added in 3.0: constructed for your small business
-
Spam safety. A hidden subject and a timer cease bots
on the sign-in, sign-up, password, and reserving varieties, with no setup. Add
Cloudflare Turnstile or Google reCAPTCHA in order for you. Visitor pages by no means
get a captcha. -
Host assist. Add a assist web page or a assist electronic mail, and
hosts get a Assist hyperlink. Paste the code of a chat service equivalent to Tawk.to
or Crisp, and the chat reveals on host pages solely. -
JSON API. Create hosts, give them plans, create occasions,
and browse add counts from your personal software program. Keys are learn solely or
full entry. -
Perfex CRM connector. An optionally available module manages
GuestLens hosts and occasions out of your Perfex clients, and offers a plan
when an bill is paid. Perfex CRM is offered individually and isn’t
included.
Added in 2.0: captions and a photograph report
-
A web page for every photograph. The host sees who shared it,
when, its dimension, and its caption, and might obtain it or use it because the
occasion cowl. -
Photograph report PDF. The accepted photographs in gallery order,
in three layouts: one photograph per web page, 4 per web page, or one photograph with
its particulars. Add a canopy, captions, names and dates, areas, and the
guestbook. US Letter or A4. -
Location, solely with consent. For inspections and website
visits. It’s off by default, and also you, the host, and the visitor every have
to say sure. The telephone’s place is saved with every photograph, solely the host
sees it, and “Open in map” opens OpenStreetMap. Telephones solely share a
place over https.
Added in 2.0: sponsors and visitor presents
-
Occasion sponsors. As much as six sponsors per occasion, every with
a reputation, a brand, a hyperlink, and a brief message. They present on the visitor
web page, on the slideshow, and on the desk playing cards. GuestLens counts the
clicks on every hyperlink. -
Visitor presents. Company ship the host a present of cash by
card (Stripe) or PayPal, on the gateway’s personal cost web page. You retain an
optionally available charge (0% by default) and pay the remainder to the host once they ask
for a payout.
For you: run it as your personal service
-
Plans. Set the worth, the variety of occasions, storage per
occasion, the visitor restrict, what number of days an occasion stays open, and which
options are included. Bookings, the video, the album, buyer entry,
the ZIP obtain, sponsors, presents, and placement stamping every have a
plan swap, so you’ll be able to promote them in your greater plans. A brand new set up
begins with 4 pattern plans: a free trial, and plans at $49, $99, and
$199. -
Funds. Stripe Checkout, PayPal, and financial institution switch
with a proof add. Card numbers by no means contact your server. If a cost
discover from Stripe or PayPal fails, a background verify confirms the
cost inside about 10 minutes. -
White label. Change the product title, brand, favicon,
accent colour, an optionally available second colour, login background, and footer
textual content. You can even present your personal house web page at your primary tackle. The
brand reveals at its personal form, and you’ll conceal the title subsequent to it. Each
electronic mail carries your branding. -
Storage. Preserve information by yourself server, in your personal
Google Drive, or on S3-compatible storage equivalent to Amazon S3, Cloudflare
R2, Wasabi, or DigitalOcean Areas. A take a look at button checks the connection. -
Customized domains. An occasion can use its personal area, on
plans that embody it. You add the DNS document and the SSL certificates in
your internet hosting panel. -
Host administration. Add, search, and droop hosts, change
their limits by hand, and log in as any host to see what they see. -
System well being. See the storage standing, the final cron
run, the add restrict, and failed jobs on one card. -
Updates. Add the brand new information over the previous ones, then
press one button within the admin. Images, settings, and hosts keep as they
are. -
Translations. Each piece of textual content comes from one
language file.
Runs on shared internet hosting
Add the information, open your area, and the installer takes you thru 4
steps: server verify, database, admin account, and cron. You by no means want the
command line.
-
No SSH, Node.js, Composer, ffmpeg, Redis, or queue employee
wanted.
The JavaScript and CSS come already constructed, and each library is within the
obtain. -
Small add limits are advantageous. GuestLens reads your
server’s add restrict and sends each file in items that match underneath it. -
One cron job. One line, each minute. URL cron works
too. - No CDN. Fonts and scripts load from your personal server.
-
No license server. There isn’t any buy code verify, so
a dwell occasion by no means stops as a result of a distant server is down.
What’s within the obtain
-
script/: the total utility, able to add, with
each library and the constructed JavaScript and CSS -
documentation/: 52 pages with annotated screenshots, to
learn offline -
licenses/: the license of each open-source package deal and
font used -
perfex-module/: the optionally available Perfex CRM connector, as
the zip file Perfex installs - README.txt and CHANGELOG.txt
Necessities
-
PHP 8.3 or newer. The installer warns when PHP is older than the October
2026 safety launch (8.3.36, 8.4.27, or 8.5.12). - MySQL 8.0+, MariaDB 10.6+, or SQLite 3.26+
-
PHP extensions: pdo_mysql or pdo_sqlite, gd, fileinfo, mbstring,
openssl, zip, curl - A cron job that runs each minute (URL cron is supported)
-
Shared internet hosting with no SSH works. S3-compatible storage is advisable
in case your plans permit video uploads. - https, in order for you location stamping or the API
- For the Perfex CRM connector: Perfex CRM 3.2 or later (offered individually)
Demo pictures
Photographs are for demo functions solely and usually are not included. The demo photographs and
video clips are free inventory information from Unsplash and Pexels.
Credit
- Laravel 13
- Blade, Alpine.js, and Tailwind CSS
-
Intervention Picture, Bacon QR Code, Dompdf, FPDI and FPDF, ZipStream-PHP,
Flysystem, the Stripe PHP library, and mp4-muxer -
Fonts: Fraunces, Inter, Playfair Show, Dancing Script, and Montserrat
(SIL Open Font License)
Documentation and assist
-
Documentation:
https://guestlens.jawad.work/docs/ - Questions before you purchase: ask within the feedback on this web page.

