Virtual.ink documentation
Share
Share is the main delivery page that operators and guests use to distribute captured outputs. It shows recent datasets as cards and offers delivery actions depending on the active sharing configuration.
Who Uses This
- Photobooth operators delivering results to guests during an event
- Photographers sharing tethered captures with clients on-site
- Teachers distributing session results to students
- Studio operators sending processed outputs to production teams
What You See
The Share page displays a grid of dataset cards. Each card shows a thumbnail of the captured session.
Depending on the share configuration, cards can show:
- a QR code overlay or sidecar for instant mobile access
- action buttons for email, print, or download
- a tap action that triggers the primary sharing method directly
The number of columns and the card layout adapt to the screen size. On tablets and phones, the grid collapses to fewer columns for touch-friendly operation.
Sharing Actions
| Action | How it works |
|---|---|
| QR Code | Displays a QR code that the guest scans with their phone to view or download the output |
| Opens an email form where the guest enters their address and receives the output by email | |
| Sends the output to the configured printer | |
| Download | Provides a direct download link for the output files |
Not all actions are visible at the same time. The active sharing preset in Share Settings determines which actions appear and how they behave.
QR Code Options
QR codes can appear in several positions depending on the configuration:
- Overlay: The QR code is rendered on top of the card thumbnail
- Sidecar: The QR code appears beside the card
- None: QR codes are not shown on the Share page
QR Delivery Modes
Share supports two QR workflows.
| Mode | What the guest scans | What happens |
|---|---|---|
| Online relay | One QR code | Opens a hosted share page where the guest can view or download the media |
| Offline QR | Two QR codes in the share modal | The first joins local Wi-Fi. The second opens the local download page |
When normal online QR sharing is active, the QR code links to a hosted page.
When offline QR sharing is enabled, the cloud relay is bypassed and the QR flow becomes local.
Offline QR Mode
When Offline QR Sharing is enabled in Share Settings:
- the app ensures the local sharing hotspot is running before generating QR codes
- the share modal changes into a two-step flow
- the first QR code joins the guest to the local Wi-Fi network
- the second QR code opens a local download URL for the selected dataset or batch
- the modal also offers a copy-link action for the local download URL
On single-dataset actions, the modal shows:
- Join Wi-Fi
- Open Download
On bulk actions, the download QR can point to more than one selected dataset.
Multi-Select
When bulk selection is enabled in the share configuration, operators can select multiple datasets and trigger a single sharing action for the batch. This is useful when a guest wants all datasets from their session delivered at once.
Email Form
The email sharing flow can include:
- recipient email address (single or multiple, depending on configuration)
- custom fields defined in share settings
- terms and conditions that must be accepted before sending
- a branded email template with the output attached or linked
Tap Actions
The share configuration can assign a default tap action to card interactions:
- tapping a card can trigger QR display, email form, or download directly
- this streamlines the guest experience during high-volume events
Connection
The Share page requires a running share service on the server. If the service is not connected, a status indicator shows the connection state. Connectivity settings are managed in Share Settings.
Important behavior:
- normal QR delivery depends on internet access plus the relay connection
- offline QR mode bypasses the cloud relay for QR delivery
- relay status can still be shown while offline QR is active, but it becomes informational rather than required for the QR flow
Used By
- Virtual.ink
- Sharing Server