Step-by-step:. Make edits → Verify behavior → Click Save Changes → Confirm Snackbar → Optionally back up appsettings.json

<h2 id="summary">Summary</h2><ul><li>The Global Settings screen centralizes configuration for the entire FMX application.</li><li>Changes you make in tabs update the in-memory configuration immediately for preview/testing.</li><li>Nothing is written to disk until you click the Save Changes button on the Global Settings screen.</li></ul><h2 id="where-settings-are-stored">Where settings are stored</h2><ul><li>Path (source tree): C:/FMX/appsettings.json</li><li>Format: JSON, human-readable, versioned by app updates</li></ul><h2 id="in-memory-vs-disk-how-changes-apply">In-memory vs disk: how changes apply</h2><ul><li>Immediate preview (in-memory):</li><li>When you adjust a control (e.g., toggle, slider, dropdown) the setting updates the live runtime state immediately where supported.</li><li>This enables testing before committing.</li><li>Persist to disk (by user action):</li><li>Persisting requires an explicit Save via the Save Changes button.</li><li>If you close FMX or switch projects without saving, in-memory changes are discarded on next launch.</li><li>Error behavior:</li><li>&#xA0;If a save fails, your in-memory changes remain active; you can correct the issue and try saving again.</li></ul><h2 id="single-point-of-control-for-saving">Single point of control for saving</h2><ul><li>Designated save entry point:</li><li>Only the Save Changes button in GlobalSettingsView writes to appsettings.json.</li><li>&#xA0;It performs validation, logs with the [SAVE-BUTTON] prefix, and shows user feedback via Snackbar.</li><li>What happens on save:</li></ul><ol><ol style="list-style-type: decimal;"><li>Validate settings across all tabs.</li><li>If valid write appsettings.json atomically if supported by the environment.</li><li>Show a Snackbar with success or error (see UI feedback below).</li></ol></ol><ul><li>Logging (if enabled):</li></ul><ol><ol style="list-style-type: decimal;"><li>Success: [SAVE-BUTTON] Settings saved successfully</li><li>Validation fail: [SAVE-BUTTON] Validation error: &lt;details&gt;</li><li>IO fail: [SAVE-BUTTON] Save failed: &lt;exception&gt;</li></ol></ol><h2 id="allowed-exception-selected-event">Allowed exception: selected Event</h2><ul><li>Event selection updates may save the selected Event ID immediately using SaveSelectedEventToSettings() (internally calls settingsService.SaveAsync()).</li><li>This is the only allowed exception to the &#x201C;Save button only&#x201D; policy because event selection is critical for sync and state management.</li><li>No other general settings should persist automatically on property changes.</li></ul><h2 id="what-does-not-save-automatically-examples">What does not save automatically (examples)</h2><ul><li>Changing camera, audio, display, media, or sharing options in tabs does not persist to disk until Save Changes is clicked.</li><li>Adjusting workflow, triggers, sync toggles, or diagnostics levels also requires Save Changes.</li><li>Bulk edits or importing presets still require an explicit Save to commit.</li></ul><h2 id="recommended-workflow">Recommended workflow</h2>Step-by-step:<ol><li>Open Global Settings and navigate to the relevant tab(s).</li><li>Adjust values and verify behavior live (where supported).</li><li>Click Save Changes.</li><li>Look for the Snackbar confirmation. If an error appears, fix issues and save again.</li></ol><h2 id="ui-feedback-snackbar">UI feedback (Snackbar)</h2><ul><li>Success (uses centralized status resources):<ul><li>Style: SnackbarWarning/Error styles are reserved for status; success uses the app&#x2019;s default success/info style.</li><li>Message: &#x201C;Settings saved successfully.&#x201D;</li></ul></li><li>Error (must follow project status style):<ul><li>Color: Error #FF5630</li><li>Icon: Error icon per centralized resources</li><li>Message: concise cause + &#x201C;See logs for details.&#x201D;</li></ul></li><li>Warning (non-blocking issues):<ul><li>Color: Warning #FFAB00</li><li>Icon: Warning icon per centralized resources</li><li>Message: guidance on potential side effects</li></ul></li></ul><h2 id="backup-restore-and-reset">Backup, restore, and reset</h2><ul><li>Backup:<ul><li>Manually copy Config/appsettings.json before large edits or upgrades.</li></ul></li><li>Restore:<ul><li>Replace with a known-good backup while FMX is closed, then reopen FMX.</li></ul></li><li>Reset to defaults:<ul><li>Otherwise, replace appsettings.json with a default template from your version&#x2019;s distribution.</li></ul></li></ul><h2 id="troubleshooting">Troubleshooting</h2><ul><li>Settings revert after restart:<ul><li>You likely didn&#x2019;t click Save Changes. Reopen Global Settings, reapply, then Save.</li></ul></li><li>Save button disabled:<ul><li>One or more tabs may be in an invalid state. Resolve inline validation errors first.</li></ul></li><li>Save fails (IO/permissions):<ul><li>Ensure write permission to the config directory. Check disk space and antivirus/EDR interference. Review logs.</li></ul></li><li>Unsaved edits lost after a crash/restart:<ul><li>In-memory changes are not persisted until saved. Reapply and Save.</li></ul></li></ul><h2 id="quick-checklist-operators">Quick checklist (operators)</h2>Make edits &#x2192; Verify behavior &#x2192; Click Save Changes &#x2192; Confirm Snackbar &#x2192; Optionally back up appsettings.json<h2 id="dodont-summary">Do/Don&#x2019;t summary</h2><ul><li>Do use only the Save Changes button to persist general settings.</li><li>Do look for [SAVE-BUTTON] entries in logs when auditing saves.</li><li>Don&#x2019;t rely on auto-save; it is intentionally disabled by design.</li></ul>

Overview and Save Behavior

The About tab shows your FMX version, build details, and license status. Use it to verify what you’re running, manage your license, and quickly share system info with support. FMX Version: the installed version (for example, 3.x.x). Build Number/Date

<img src="https://attachments.gorgias.help/JEmYL2naMXn6oMgQ/hc/bgJ1Q6QrLw2vXKOM/2025092017-b8af6513-1a1b-4deb-8cd9-d3282e286b90-about.jpg" class="fr-fic fr-dii"><h2 data-start="0" data-end="9" id="isPasted">Summary</h2><ul data-start="11" data-end="194"><li data-start="11" data-end="87">The About tab shows your FMX version, build details, and license status.</li><li data-start="88" data-end="194">Use it to verify what you&#x2019;re running, manage your license, and quickly share system info with support.</li></ul><h2 data-start="196" data-end="210" id="what-you-see">What you see</h2><ul data-start="212" data-end="767"><li data-start="212" data-end="276">FMX Version: the installed version (for example, 3.x.x).</li><li data-start="277" data-end="335">Build Number/Date: the exact build you&#x2019;re running.</li><li data-start="336" data-end="386">Edition: your FMX edition (if applicable).</li><li data-start="387" data-end="457">License Status: Activated, Trial (days remaining), or Expired.</li><li data-start="458" data-end="529">License/Device ID: identifiers used for activation and support.</li></ul><h2 data-start="769" data-end="785" id="common-actions">Common actions</h2><ul data-start="787" data-end="1299"><li data-start="787" data-end="863">Verify your version: Open About &#x2192; read FMX Version and Build Number.</li><li data-start="864" data-end="957">Change license: Logout at the bottom left of the tab.</li><li data-start="958" data-end="1052">Provide info for support: Copy System Info &#x2192; paste in your support message.</li></ul><h2 data-start="1301" data-end="1321" id="field-explanations">Field explanations</h2><ul data-start="1323" data-end="1886"><li data-start="1323" data-end="1402">FMX Version: the main version you should quote when contacting support.</li><li data-start="1403" data-end="1489">Build Number/Date: the exact build; helps support identify fixes in your copy.</li><li data-start="1490" data-end="1551">Edition: which package/features your license unlocks.</li><li data-start="1552" data-end="1803">License Status:<ul data-start="1578" data-end="1803"><li data-start="1578" data-end="1632">Activated: everything is enabled per your license.</li><li data-start="1635" data-end="1731">Trial: FMX is running with time-limited access. Consider activating to unlock full features.</li><li data-start="1734" data-end="1803">Expired: activation required to continue using licensed features.</li></ul></li><li data-start="1804" data-end="1886">License/Device ID: codes used for license validation and support tracking.</li></ul><h2 data-start="1888" data-end="1910" id="recommended-workflow">Recommended workflow</h2><ol data-start="1912" data-end="2146"><li data-start="1912" data-end="1936">Open the About tab.</li><li data-start="1937" data-end="1985">Confirm Version and Build for your records.</li><li data-start="1986" data-end="2028">If needed, Logout.&#xA0;</li></ol><h2 data-start="2275" data-end="2292" id="troubleshooting">Troubleshooting</h2><ul data-start="2294" data-end="2969"><li data-start="2294" data-end="2444">License shows Trial/Expired but suppose to be activate: Contact the support team.</li><li data-start="2445" data-end="2574">Logout fails: Check internet connection. If needed, try again later or contact support.</li><li data-start="2718" data-end="2870">Support asked for &#x201C;system info&#x201D; or &#x201C;logs&#x201D;: Print Screen System Info and provide it to them.</li><li data-start="2871" data-end="2969">About tab won&#x2019;t open: Close and reopen FMX. If it persists, restart Windows and try again.</li></ul><h2 data-start="2971" data-end="2988" id="quick-checklist">Quick checklist</h2><ul data-start="2990" data-end="3108"><li data-start="2990" data-end="3108">Confirm Version and Build &#x2192; Copy System Info for support (when requested)</li></ul><h2 data-start="3110" data-end="3128" id="dodont-summary">Do/Don&#x2019;t summary</h2><ul data-start="3130" data-end="3362" data-is-last-node data-is-only-node><li data-start="3130" data-end="3197">Do keep a note of your Version and Build when reporting issues.</li><li data-start="3251" data-end="3293">Don&#x2019;t share your license key publicly.</li><li data-start="3294" data-end="3362" data-is-last-node>Don&#x2019;t skip updates if you rely on recent fixes and improvements.</li></ul>

About Tab

The Camera tab supports Canon DSLR/mirrorless cameras and any Windows-compatible webcam. Use it to connect your device, preview the scene, and set exposure/white balance/focus. Changes take effect immediately for testing; click Save Changes to keep t

<h2 data-start="0" data-end="9" id><img src="https://attachments.gorgias.help/JEmYL2naMXn6oMgQ/hc/bgJ1Q6QrLw2vXKOM/2025092017-2a5b7234-3e37-4780-af21-431820fb5d54-camera.jpg" class="fr-fic fr-dii"></h2><h2 data-start="0" data-end="9" id="isPasted">Summary</h2><ul data-start="11" data-end="291"><li data-start="11" data-end="103">The Camera tab supports Canon DSLR/mirrorless cameras and any Windows-compatible webcam.</li><li data-start="104" data-end="195">Use it to connect your device, preview the scene, and set exposure/white balance/focus.</li><li data-start="196" data-end="291">Changes take effect immediately for testing; click Save Changes to keep them for next time.</li></ul><h2 data-start="293" data-end="329" id="supported-devices-and-requirements">Supported devices and requirements</h2><ul data-start="331" data-end="725"><li data-start="331" data-end="569">Canon DSLR/Mirrorless (USB tether):<ul data-start="377" data-end="569"><li data-start="377" data-end="441">Connect via USB directly to the PC (avoid hubs if possible).</li><li data-start="444" data-end="491">Turn off Wi-Fi/Bluetooth/NFC on the camera.</li><li data-start="494" data-end="569">Use a full battery or AC adapter. Disable Auto Power Off on the camera.</li></ul></li><li data-start="571" data-end="725">Windows Webcams (UVC):<ul data-start="604" data-end="725"><li data-start="604" data-end="673">Any webcam that shows up in Windows Camera settings is supported.</li><li data-start="676" data-end="725">Plug and play; drivers are usually automatic.</li></ul></li></ul><h2 data-start="727" data-end="760" id="device-selection-and-properties">Device selection and properties</h2><ul data-start="762" data-end="1778"><li data-start="762" data-end="924">Choose Device:<ul data-start="787" data-end="924"><li data-start="787" data-end="870">Select &#x201C;Canon Camera&#x201D; (your model) or a &#x201C;Webcam&#x201D; (name varies by manufacturer).</li><li data-start="873" data-end="924">Click Refresh if you just connected the device.</li></ul></li><li data-start="926" data-end="1538">Webcam: automatic property builder<ul data-start="971" data-end="1538"><li data-start="971" data-end="1057">FMX reads all controls the webcam driver supports and builds the UI automatically.</li><li data-start="1060" data-end="1368">Typical controls (availability depends on your webcam/driver):<ul data-start="1131" data-end="1368"><li data-start="1131" data-end="1214">Resolution/FPS, Exposure, Gain/ISO, Brightness, Contrast, Saturation, Sharpness</li><li data-start="1219" data-end="1302">White Balance (Auto/Manual with temperature), Focus (Auto/Manual with distance)</li><li data-start="1307" data-end="1368">Backlight Compensation, PowerLine/Anti-Flicker (50/60 Hz)</li></ul></li><li data-start="1371" data-end="1443">If a control isn&#x2019;t supported by your webcam it will appear disabled.</li><li data-start="1446" data-end="1538">Tip: For stable booth results, start with Auto exposure/WB, then lock them if supported.</li></ul></li><li data-start="1540" data-end="1778">Canon: photo settings via camera and app<ul data-start="1591" data-end="1778"><li data-start="1591" data-end="1659">Exposure: Shutter, Aperture, ISO (prefer Manual mode on camera).</li><li data-start="1662" data-end="1702">White Balance: presets or Custom WB.</li><li data-start="1705" data-end="1778">Focus: AF or Manual (for fixed distance booths, prefer Manual Focus).</li></ul></li></ul><h2 data-start="1780" data-end="1833" id="live-view-and-photo-capture-important-differences">Live View and photo capture (important differences)</h2><ul data-start="1835" data-end="2504"><li data-start="1835" data-end="2030">Webcam (frame grab):<ul data-start="1866" data-end="2030"><li data-start="1866" data-end="1947">Keep Live View ON to capture; FMX grabs a high-quality frame from the stream.</li><li data-start="1950" data-end="2030">Do not stop live view before capturing; the still comes from the video feed.</li></ul></li><li data-start="2032" data-end="2327">Canon DSLR/Mirrorless (still capture):<ul data-start="2081" data-end="2327"><li data-start="2081" data-end="2188">Live View is for preview only. At capture, FMX stops Live View, triggers shutter, then resumes preview.</li><li data-start="2191" data-end="2242">Expect a brief preview blackout during capture.</li><li data-start="2245" data-end="2327">For photo booths: lens stabilization OFF (tripod use); disable Auto Power Off.</li></ul></li><li data-start="2329" data-end="2504">Workflow switching (Live &#x2192; Photo &#x2192; Live):<ul data-start="2381" data-end="2504"><li data-start="2381" data-end="2434">Webcam: stream stays running; capture is instant.</li><li data-start="2437" data-end="2504">Canon: Live View stops, photo is taken, then Live View resumes.</li></ul></li></ul><h2 data-start="2506" data-end="2534" id="recommended-baseline-setup">Recommended baseline setup</h2><ul data-start="2536" data-end="3116"><li data-start="2536" data-end="2824">Canon DSLR/Mirrorless:<ul data-start="2569" data-end="2824"><li data-start="2569" data-end="2589">Mode: Manual (M)</li><li data-start="2592" data-end="2618">Shutter: 1/125s&#x2013;1/200s</li><li data-start="2621" data-end="2644">Aperture: f/5.6&#x2013;f/8</li><li data-start="2647" data-end="2663">ISO: 200&#x2013;800</li><li data-start="2666" data-end="2725">White Balance: Custom WB (under booth lights) or preset</li><li data-start="2728" data-end="2768">Focus: Manual Focus for fixed setups</li><li data-start="2771" data-end="2793">Stabilization: OFF</li><li data-start="2796" data-end="2824">Auto Power Off: Disabled</li></ul></li><li data-start="2826" data-end="3116">Webcam:<ul data-start="2844" data-end="3116"><li data-start="2844" data-end="2903">Resolution/FPS: 1920&#xD7;1080 (30fps) or 1280&#xD7;720 if needed</li><li data-start="2906" data-end="2957">Anti-Flicker/PowerLine: 50 Hz (EU) / 60 Hz (US)</li><li data-start="2960" data-end="3026">Exposure/WB: start Auto; switch to Manual and lock if unstable</li><li data-start="3029" data-end="3065">Focus: Manual/Fixed if supported</li><li data-start="3068" data-end="3116">Lighting: keep constant to avoid auto shifts</li></ul></li></ul><h2 data-start="3118" data-end="3142" id="how-to-test-your-setup">How to test your setup</h2><ol data-start="3144" data-end="3578"><li data-start="3144" data-end="3211">Select your device in the Camera tab and confirm Live Preview.</li><li data-start="3212" data-end="3269">Adjust exposure and WB; confirm colors look natural.</li><li data-start="3270" data-end="3336">Set focus: Manual for fixed distance, or AF and confirm lock.</li><li data-start="3337" data-end="3491">Trigger a Test Capture:<ul data-start="3369" data-end="3491"><li data-start="3369" data-end="3427">Webcam: keep Live View on; still should match preview.</li><li data-start="3431" data-end="3491">Canon: Live View stops, photo captured, preview returns.</li></ul></li><li data-start="3492" data-end="3531">Verify saved image in your folder.</li><li data-start="3532" data-end="3578">Click Save Changes to keep your settings.</li></ol><h2 data-start="3580" data-end="3609" id="saving-your-camera-settings">Saving your camera settings</h2><ul data-start="3611" data-end="3773"><li data-start="3611" data-end="3654">Settings apply immediately for testing.</li><li data-start="3655" data-end="3724">Click Save Changes on the Global Settings screen to persist them.</li><li data-start="3725" data-end="3773">Closing FMX without saving discards changes.</li></ul><h2 data-start="3775" data-end="3792" id="troubleshooting">Troubleshooting</h2><ul data-start="3794" data-end="4510"><li data-start="3794" data-end="3940">Device not detected:<ul data-start="3825" data-end="3940"><li data-start="3825" data-end="3868">Try a different port/cable; avoid hubs.</li><li data-start="3871" data-end="3899">Close other camera apps.</li><li data-start="3902" data-end="3940">Power cycle device; click Refresh.</li></ul></li><li data-start="3942" data-end="4078">No live preview:<ul data-start="3969" data-end="4078"><li data-start="3969" data-end="4012">Webcam: check Windows privacy settings.</li><li data-start="4015" data-end="4078">Canon: confirm photo mode; ensure no other app is using it.</li></ul></li><li data-start="4080" data-end="4225">Blurry photos:<ul data-start="4105" data-end="4225"><li data-start="4105" data-end="4168">Canon: faster shutter (e.g., 1/160s), tripod, Manual Focus.</li><li data-start="4171" data-end="4225">Webcam: lock focus if available; improve lighting.</li></ul></li><li data-start="4227" data-end="4311">Flicker or banding:<ul data-start="4257" data-end="4311"><li data-start="4257" data-end="4311">Match Anti-Flicker/PowerLine to region (50/60 Hz).</li></ul></li><li data-start="4313" data-end="4424">Colors look wrong:<ul data-start="4342" data-end="4424"><li data-start="4342" data-end="4367">Canon: set Custom WB.</li><li data-start="4370" data-end="4424">Webcam: disable Auto WB and set fixed temperature.</li></ul></li><li data-start="4426" data-end="4510">Camera goes to sleep (Canon):<ul data-start="4466" data-end="4510"><li data-start="4466" data-end="4510">Disable Auto Power Off; prefer AC power.</li></ul></li></ul><h2 data-start="4512" data-end="4529" id="quick-checklist">Quick checklist</h2><ul data-start="4531" data-end="4727"><li data-start="4531" data-end="4617">Pick device &#x2192; Confirm Live Preview &#x2192; Adjust exposure/WB &#x2192; Set focus &#x2192; Test Capture</li><li data-start="4618" data-end="4658">Webcam: keep Live View ON to capture</li><li data-start="4659" data-end="4710">Canon: expect Live View blackout during capture</li><li data-start="4711" data-end="4727">Save Changes</li></ul><h2 data-start="4729" data-end="4747" id="dodont-summary">Do/Don&#x2019;t summary</h2><ul data-start="4749" data-end="4991" data-is-last-node data-is-only-node><li data-start="4749" data-end="4801">Do keep webcam Live View running during capture.</li><li data-start="4802" data-end="4864">Do expect Canon Live View to stop briefly; this is normal.</li><li data-start="4865" data-end="4908">Do disable lens stabilization (photo booth).</li><li data-start="4909" data-end="4957">Don&#x2019;t run other camera apps while using FMX.</li><li data-start="4958" data-end="4991" data-is-last-node>Don&#x2019;t forget to Save Changes.</li></ul>

Camera Tab

The Cloud tab controls how FMX syncs your photos, videos, and GIFs to Foto Master Cloud (online gallery). You choose which media types to sync. FMX uploads in the background and updates the gallery. QR codes can link to a media landing page that work

<h2 data-start="0" data-end="9" id><img src="https://attachments.gorgias.help/JEmYL2naMXn6oMgQ/hc/bgJ1Q6QrLw2vXKOM/2025092018-df3f69c3-84de-45ba-b7c7-764116a0fd74-cloud_tab.jpg" class="fr-fic fr-dib"></h2><h2 data-start="0" data-end="9" id="isPasted">Summary</h2><ul data-start="11" data-end="321"><li data-start="11" data-end="120">The Cloud tab controls how FMX syncs your photos, videos, and GIFs to Foto Master Cloud (online gallery).</li><li data-start="121" data-end="217">You choose which media types to sync. FMX uploads in the background and updates the gallery.</li><li data-start="218" data-end="321">QR codes can link to a media landing page that works immediately, even before the file is uploaded.</li></ul><h2 data-start="323" data-end="355" id="online-gallery-and-qr-behavior">Online gallery and QR behavior</h2><ul data-start="357" data-end="934"><li data-start="357" data-end="618">Media landing page link<ul data-start="391" data-end="618"><li data-start="391" data-end="440">QR points to <code data-start="406" data-end="438">https://&lt;Cloud_URL&gt;/media/&lt;id&gt;</code></li><li data-start="443" data-end="535">If the file isn&#x2019;t uploaded yet, the page shows &#x201C;not uploaded yet&#x201D; until upload finishes.</li><li data-start="538" data-end="618">Direct download (if workflow requests it): appends <code data-start="591" data-end="604">?download=1</code> to the URL.</li></ul></li><li data-start="620" data-end="817">Placeholders<ul data-start="643" data-end="817"><li data-start="643" data-end="738">FMX creates a placeholder entry for the Final Photo at session start so QR works instantly.</li><li data-start="741" data-end="817">Once the Final Photo exists, FMX replaces the placeholder with the file.</li></ul></li><li data-start="819" data-end="934">No fallback<ul data-start="841" data-end="934"><li data-start="841" data-end="934">When configured for media landing page links, FMX does not fall back to the gallery view.</li></ul></li></ul><h2 data-start="936" data-end="972" id="what-uploads-to-the-online-gallery">What uploads to the online gallery</h2><ul data-start="974" data-end="1456"><li data-start="974" data-end="1186">Media types (toggles)<ul data-start="1006" data-end="1186"><li data-start="1006" data-end="1042">Final Photo &#x2192; Sync Final Photo</li><li data-start="1045" data-end="1081">Final Video &#x2192; Sync Final Video</li><li data-start="1084" data-end="1116">Final GIF &#x2192; Sync Final GIF</li><li data-start="1119" data-end="1151">RAW Photo &#x2192; Sync RAW Photo</li><li data-start="1154" data-end="1186">RAW Video &#x2192; Sync RAW Video</li></ul></li><li data-start="1188" data-end="1348">RAW vs Final video classification<ul data-start="1232" data-end="1348"><li data-start="1232" data-end="1304">Determined by output folder path (e.g., <code data-start="1274" data-end="1284">RawVideo</code> vs <code data-start="1288" data-end="1300">FinalVideo</code>).</li><li data-start="1307" data-end="1348">Correct toggle must be ON for upload.</li></ul></li><li data-start="1350" data-end="1456">Deduplication<ul data-start="1374" data-end="1456"><li data-start="1374" data-end="1456">FMX skips duplicates if same file path or MediaId already uploaded or pending.</li></ul></li></ul><h2 data-start="1458" data-end="1490" id="how-syncing-works-background">How syncing works (background)</h2><ul data-start="1492" data-end="2289"><li data-start="1492" data-end="1654">Background worker<ul data-start="1520" data-end="1654"><li data-start="1520" data-end="1589">New media are enqueued as Pending and uploaded in the background.</li><li data-start="1592" data-end="1654">Toggling Sync for videos forces re-check of pending items.</li></ul></li><li data-start="1656" data-end="1772">File must exist<ul data-start="1682" data-end="1772"><li data-start="1682" data-end="1772">FMX waits until the file exists, logs &#x201C;File not yet available,&#x201D; retries automatically.</li></ul></li><li data-start="1774" data-end="1857">Logged in<ul data-start="1794" data-end="1857"><li data-start="1794" data-end="1857">If not signed in, uploads are delayed until login succeeds.</li></ul></li><li data-start="1859" data-end="2046">Verification<ul data-start="1882" data-end="2046"><li data-start="1882" data-end="1961">After upload, FMX checks the event gallery and links the item when visible.</li><li data-start="1964" data-end="2046">&#x201C;Sent&#x201D; may appear before gallery UI refreshes; usually updates within seconds.</li></ul></li><li data-start="2048" data-end="2170">Baseline coalescing (Final Photo)<ul data-start="2092" data-end="2170"><li data-start="2092" data-end="2170">Ensures exactly one upload per session, tying the file to its placeholder.</li></ul></li><li data-start="2172" data-end="2289">Recovery<ul data-start="2191" data-end="2289"><li data-start="2191" data-end="2289">On startup, FMX reconciles Pending items with gallery and marks already-present files as Sent.</li></ul></li></ul><h2 data-start="2291" data-end="2318" id="controls-on-the-cloud-tab">Controls on the Cloud tab</h2><ul data-start="2320" data-end="2812"><li data-start="2320" data-end="2377">Sync Final Photo &#x2192; ON uploads final layout photo.</li><li data-start="2378" data-end="2427">Sync RAW Photo &#x2192; ON uploads raw captures.</li><li data-start="2428" data-end="2490">Sync RAW Video &#x2192; ON uploads videos in RawVideo folder.</li><li data-start="2491" data-end="2557">Sync Final Video &#x2192; ON uploads videos in FinalVideo folder.</li><li data-start="2558" data-end="2612">Sync Final GIF &#x2192; ON uploads final GIF outputs.</li><li data-start="2613" data-end="2728">Override assets with same name<ul data-start="2654" data-end="2728"><li data-start="2654" data-end="2700">ON: replace existing files with same name.</li><li data-start="2703" data-end="2728">OFF: skip duplicates.</li></ul></li><li data-start="2729" data-end="2812">Cloud Base URL (advanced)<ul data-start="2765" data-end="2812"><li data-start="2765" data-end="2812">Diagnostic field, normally fixed per build.</li></ul></li></ul><h2 data-start="2814" data-end="2842" id="event-selection-and-saving">Event selection and saving</h2><ul data-start="2844" data-end="3125"><li data-start="2844" data-end="2951">Selected Event<ul data-start="2869" data-end="2951"><li data-start="2869" data-end="2911">Uploads always go to the active event.</li><li data-start="2914" data-end="2951">Changing event saves immediately.</li></ul></li><li data-start="2953" data-end="3125">Save Changes (other settings)<ul data-start="2993" data-end="3125"><li data-start="2993" data-end="3054">Sync toggles and options persist only after Save Changes.</li><li data-start="3057" data-end="3125">Without saving, settings remain active but reset on next launch.</li></ul></li></ul><h2 data-start="3127" data-end="3149" id="recommended-workflow">Recommended workflow</h2><ol data-start="3151" data-end="3415"><li data-start="3151" data-end="3201">Select the correct event (saves immediately).</li><li data-start="3202" data-end="3257">Turn ON sync toggles for the media types you need.</li><li data-start="3258" data-end="3373">Run a test session:<ul data-start="3286" data-end="3373"><li data-start="3286" data-end="3328">Scan QR &#x2192; may show &#x201C;not uploaded yet.&#x201D;</li><li data-start="3332" data-end="3373">After upload &#x2192; same link shows media.</li></ul></li><li data-start="3374" data-end="3415">Click Save Changes to keep settings.</li></ol><h2 data-start="3417" data-end="3434" id="troubleshooting">Troubleshooting</h2><ul data-start="3436" data-end="3824"><li data-start="3436" data-end="3517">QR says &#x201C;not uploaded yet&#x201D; &#x2192; normal right after capture; wait for upload.</li><li data-start="3518" data-end="3598">Nothing uploads &#x2192; check Sync toggle ON, file exists, logged in to Cloud.</li><li data-start="3599" data-end="3688">RAW/Final video misclassified &#x2192; confirm files are in RawVideo/FinalVideo folders.</li><li data-start="3689" data-end="3752">Gallery already has file &#x2192; turn ON Override to replace.</li><li data-start="3753" data-end="3824">Pending items stuck &#x2192; toggle Sync OFF&#x2192;ON for videos to requeue.</li></ul><h2 data-start="3826" data-end="3841" id="save-reminder">Save reminder</h2><ul data-start="3843" data-end="3916"><li data-start="3843" data-end="3916">Event selection saves instantly; other settings require Save Changes.</li></ul><h2 data-start="3918" data-end="3935" id="quick-checklist">Quick checklist</h2><ul data-start="3937" data-end="4028"><li data-start="3937" data-end="4028">Select event &#x2192; Enable Sync toggles &#x2192; Capture + scan QR &#x2192; Confirm gallery &#x2192; Save Changes</li></ul><h2 data-start="4030" data-end="4048" id="dodont-summary">Do/Don&#x2019;t summary</h2><ul data-start="4050" data-end="4305" data-is-last-node data-is-only-node><li data-start="4050" data-end="4109">Do match Sync toggles with what your workflow produces.</li><li data-start="4110" data-end="4172">Do expect QR to work instantly, even if upload is pending.</li><li data-start="4173" data-end="4239">Don&#x2019;t worry about &#x201C;not uploaded yet&#x201D;&#x2014;it updates automatically.</li><li data-start="4240" data-end="4305" data-is-last-node>Don&#x2019;t forget to enable Override if you need to replace files when syncing events.</li></ul>

Cloud Tab

The Devices tab is the control center for all booth hardware (other than cameras). Here you can see what’s connected, refresh detection, and configure printers, microphones, LED ring, key fob remote, proximity sensor, hand scanner, and payment termin

<img src="https://attachments.gorgias.help/JEmYL2naMXn6oMgQ/hc/bgJ1Q6QrLw2vXKOM/2025092018-09980d01-2b12-4f05-b5ad-cd481c51c394-devices_tab.jpg" class="fr-fic fr-dib"><h2 data-start="0" data-end="9" id="isPasted">Summary</h2><ul data-start="11" data-end="349"><li data-start="11" data-end="259">The Devices tab is the control center for all booth hardware (other than cameras). Here you can see what&#x2019;s connected, refresh detection, and configure printers, microphones, LED ring, key fob remote, proximity sensor, hand scanner, and payment terminal (Nayax).</li><li data-start="260" data-end="349">Changes apply immediately for testing; click Save Changes to keep them for next time.</li></ul><h2 data-start="351" data-end="377" id="device-list-and-scanning">Device list and scanning</h2><ul data-start="379" data-end="680"><li data-start="379" data-end="486">Device tiles: LED Ring, Key Fob, Proximity, Scanner, Printer, Microphone, Payment Terminal (Nayax).</li><li data-start="487" data-end="576">Status: Connected (green) or Disconnected (red), with notes such as printer name.</li><li data-start="577" data-end="680">Refresh: click Refresh/Scan to re-detect devices. &#x201C;Last scanned&#x201D; shows the last detection time.</li></ul><h2 data-start="682" data-end="692" id="printers">Printers</h2><ul data-start="694" data-end="1316"><li data-start="694" data-end="766">Use Default Printer: ON &#x2192; FMX prints to Windows default printer.</li><li data-start="767" data-end="839">Select a printer: OFF &#x2192; choose a specific printer from the list.</li><li data-start="840" data-end="949">Strips printer (2&#xD7;6): select a dedicated printer for strips if supported, otherwise leave as Default.</li><li data-start="950" data-end="1088">Printer Pool &amp; Load Balancing: add multiple printers, enable Load Balancing to distribute jobs. Badge shows &#x201C;Pool: N&#x201D; when active.</li><li data-start="1089" data-end="1243">Print sizing/borderless: target 4&#xD7;6 in borderless (may appear as 10&#xD7;15 cm, Borderless, or No Margins in drivers). Templates must match paper size.</li><li data-start="1244" data-end="1316">Copies: workflow decides print count; Devices tab sets defaults.</li></ul><h2 data-start="1318" data-end="1330" id="microphone">Microphone</h2><ul data-start="1332" data-end="1427"><li data-start="1332" data-end="1380">Select the audio input used by FMX features.</li><li data-start="1381" data-end="1427">List shows Windows-recognized microphones.</li></ul><h2 data-start="1429" data-end="1455" id="led-ring-arduino-based">LED Ring (Arduino-based)</h2><ul data-start="1457" data-end="1957"><li data-start="1457" data-end="1508">Purpose: visual feedback around the camera.</li><li data-start="1509" data-end="1567">Auto-detection: appears as &#x201C;LED Ring&#x201D; on COM port.</li><li data-start="1568" data-end="1659">FMX usage: effects for attract, countdown, processing; rainbow greeting on startup.</li><li data-start="1660" data-end="1754">Patterns: Spinning Wheel, Rainbow, Glitter, Scanner, Right/Left Fill, Right/Left Ball.</li><li data-start="1755" data-end="1854">Colors: White, Red, Green, Blue, Purple, Yellow, Cyan, Orange (ignored by Rainbow/Glitter).</li><li data-start="1855" data-end="1890">Speeds: Slow, Medium, Fast.</li><li data-start="1891" data-end="1957">COM handling: automatic detection; avoids Nayax conflicts.</li></ul><h2 data-start="1959" data-end="1991" id="key-fob-remote-arduino-based">Key Fob Remote (Arduino-based)</h2><ul data-start="1993" data-end="2270"><li data-start="1993" data-end="2078">Purpose: hands-free control (advance steps, open menu, restart, full screen).</li><li data-start="2079" data-end="2134">Auto-detection: shows as &#x201C;Key Fob&#x201D; on COM port.</li><li data-start="2135" data-end="2196">Buttons A&#x2013;D: mapped to actions (editable in Devices).</li><li data-start="2197" data-end="2270">Noise protection: FMX debounces signals to avoid double triggers.</li></ul><h2 data-start="2272" data-end="2290" id="proximity-sensor">Proximity Sensor</h2><ul data-start="2292" data-end="2565"><li data-start="2292" data-end="2347">Purpose: trigger steps based on guest presence.</li><li data-start="2348" data-end="2405">Auto-detection: shows as &#x201C;Proximity&#x201D; on COM port.</li><li data-start="2406" data-end="2477">Threshold (1&#x2013;1000): adjust sensitivity; start near default (5).</li><li data-start="2478" data-end="2565">Behavior: FMX monitors readings, triggers when values exceed threshold briefly.</li></ul>Hand Scanner (Flatbed)<ul data-start="2597" data-end="2978"><li data-start="2597" data-end="2659">Purpose: scan hands as part of &#x201C;Scan&#x201D; workflow steps.</li><li data-start="2660" data-end="2718">Detection: FMX finds scanners via Windows WIA/USB.</li><li data-start="2719" data-end="2826">How it works: captures image, rotates, crops, compresses to JPEG; saves to Event folder under Scan.</li><li data-start="2827" data-end="2911">Placeholder: if no scanner, FMX inserts a placeholder so workflow continues.</li><li data-start="2912" data-end="2978">Trigger: workflow proceeds once scan/placeholder is saved.</li></ul><h2 data-start="2980" data-end="3006" id="payment-terminal-nayax">Payment Terminal (Nayax)</h2><ul data-start="3008" data-end="3547"><li data-start="3008" data-end="3062">Purpose: accept payments before session/print.</li><li data-start="3063" data-end="3115">Enable: Payment Provider = Nayax; toggle ON.</li><li data-start="3116" data-end="3180">COM Port: select correct port (list hides ports in use).</li><li data-start="3181" data-end="3252">Baud Rate: defaults to 115200 unless vendor requires otherwise.</li><li data-start="3253" data-end="3349">Currency &amp; Amounts: set currency code, default charge (in cents), optional product code.</li><li data-start="3350" data-end="3408">Flow options: pre-selection mode, product timeout.</li><li data-start="3409" data-end="3480">Machine identity: advanced fields for model/serial/vendor info.</li><li data-start="3481" data-end="3547">Diagnostics: debug logs, optional simulator EXE (lab use).</li></ul><h2 data-start="3549" data-end="3577" id="recommended-setup-sequence">Recommended setup sequence</h2><ol data-start="3579" data-end="4079"><li data-start="3579" data-end="3699">Printers &#x2192; install drivers, select printer, set paper (4&#xD7;6, borderless), configure pool/load balancing, test print.</li><li data-start="3700" data-end="3738">Microphone &#x2192; select input device.</li><li data-start="3739" data-end="3812">LED Ring &#x2192; connect, verify &#x201C;Connected,&#x201D; run a workflow to test cues.</li><li data-start="3813" data-end="3864">Key Fob &#x2192; connect, map A&#x2013;D, test step control.</li><li data-start="3865" data-end="3936">Proximity &#x2192; connect, start a proximity workflow, adjust threshold.</li><li data-start="3937" data-end="4009">Scanner &#x2192; connect, run scan workflow, check saved file/placeholder.</li><li data-start="4010" data-end="4079">Nayax &#x2192; enable, set COM port, currency, amount, test end-to-end.</li></ol><h2 data-start="4081" data-end="4098" id="troubleshooting">Troubleshooting</h2><ul data-start="4100" data-end="4756"><li data-start="4100" data-end="4217">Printer not listed/wrong size: install driver, Refresh, check paper/template, enable borderless if supported.</li><li data-start="4218" data-end="4299">Microphone missing: check Windows Sound and privacy settings, reopen FMX.</li><li data-start="4300" data-end="4403">LED Ring not detected: use good USB cable, avoid hubs, re-scan; ensure separate COM from Nayax.</li><li data-start="4404" data-end="4495">Key Fob double-triggers: FMX suppresses repeats; if persistent, check wiring/cable.</li><li data-start="4496" data-end="4564">Proximity issues: adjust threshold; test in real conditions.</li><li data-start="4565" data-end="4655">Scanner missing: install WIA drivers, reconnect; FMX will fallback to placeholder.</li><li data-start="4656" data-end="4756">Nayax fails: confirm provider= Nayax, correct COM port, baud=115200, ensure port not shared.</li></ul><h2 data-start="4758" data-end="4773" id="save-reminder">Save reminder</h2><ul data-start="4775" data-end="4920"><li data-start="4775" data-end="4920">Changes are live for testing. Click Save Changes in Global Settings to persist (some critical IDs and event selections may save immediately).</li></ul><h2 data-start="4922" data-end="4939" id="quick-checklist">Quick checklist</h2><ul data-start="4941" data-end="5078"><li data-start="4941" data-end="5078">Printer set &#x2192; Mic selected &#x2192; LED Ring connected &#x2192; Key Fob mapped &#x2192; Proximity tuned &#x2192; Scanner tested &#x2192; Nayax configured &#x2192; Save Changes</li></ul><h2 data-start="5080" data-end="5098" id="dodont-summary">Do/Don&#x2019;t summary</h2><ul data-start="5100" data-end="5347" data-is-last-node data-is-only-node><li data-start="5100" data-end="5159">Do test each device before events with reliable cables.</li><li data-start="5160" data-end="5209">Do use Load Balancing with multiple printers.</li><li data-start="5210" data-end="5285">Don&#x2019;t change paper size or driver settings mid-event without retesting.</li><li data-start="5286" data-end="5347" data-is-last-node>Don&#x2019;t share payment credentials or COM ports across apps.</li></ul>

Devices Tab

The Sharing tab controls how FMX sends content to guests by Email and SMS. You can use Foto Master Cloud (recommended) or your own server (“Custom”). Includes an SMS Country Selector for accurate phone number entry. Changes apply immediately for test

<article tabindex="-1" dir="auto" data-turn-id="request-68cee4f3-f45c-8323-b875-d7208748fbc7-11" data-testid="conversation-turn-14" data-scroll-anchor="true" data-turn="assistant" id="isPasted"><div tabindex="-1"><div data-message-author-role="assistant" data-message-id="88febb76-2b3a-4c12-895a-4937e33db845" dir="auto" data-message-model-slug="gpt-5"><h2 data-start="0" data-end="9" id><img src="https://attachments.gorgias.help/JEmYL2naMXn6oMgQ/hc/bgJ1Q6QrLw2vXKOM/2025092019-224f1680-b561-4b5f-9813-9b6ab3ddf156-sharing_screen.jpg" class="fr-fic fr-dib"></h2><h2 data-start="0" data-end="9" id="summary">Summary</h2><ul data-start="11" data-end="368"><li data-start="11" data-end="89">The Sharing tab controls how FMX sends content to guests by Email and SMS.</li><li data-start="90" data-end="168">You can use Foto Master Cloud (recommended) or your own server (&#x201C;Custom&#x201D;).</li><li data-start="169" data-end="238">Includes an SMS Country Selector for accurate phone number entry.</li><li data-start="239" data-end="368">Changes apply immediately for testing; click Save Changes to keep them for next time. The Save button validates your entries.</li></ul><h2 data-start="370" data-end="391" id="providers-and-modes">Providers and modes</h2><ul data-start="393" data-end="1035"><li data-start="393" data-end="641">Email Provider<ul data-start="418" data-end="641"><li data-start="418" data-end="476">Cloud: FMX uses Foto Master Cloud to deliver emails.</li><li data-start="479" data-end="641">Custom: FMX sends a POST request to your server.<ul data-start="538" data-end="641"><li data-start="538" data-end="581">Custom Server URL: your HTTPS endpoint.</li><li data-start="586" data-end="641">X-API-Key: secret key sent in the X-API-Key header.</li></ul></li></ul></li><li data-start="643" data-end="890">SMS Provider<ul data-start="666" data-end="890"><li data-start="666" data-end="725">Cloud: FMX uses Foto Master Cloud to deliver SMS/MMS.</li><li data-start="728" data-end="890">Custom: FMX sends a POST request to your server.<ul data-start="787" data-end="890"><li data-start="787" data-end="830">Custom Server URL: your HTTPS endpoint.</li><li data-start="835" data-end="890">X-API-Key: secret key sent in the X-API-Key header.</li></ul></li></ul></li><li data-start="892" data-end="1035">Validation on Save<ul data-start="921" data-end="1035"><li data-start="921" data-end="1035">In Custom mode: URL must be valid, X-API-Key must not be empty. Invalid entries block Save with a clear error.</li></ul></li></ul><h2 data-start="1037" data-end="1068" id="what-fmx-sends-in-custom-mode">What FMX sends in Custom mode</h2><ul data-start="1070" data-end="1963"><li data-start="1070" data-end="1232">Transport<ul data-start="1090" data-end="1232"><li data-start="1090" data-end="1106">Method: POST</li><li data-start="1109" data-end="1179">Headers: <code data-start="1120" data-end="1152">Content-Type: application/json</code>, <code data-start="1154" data-end="1177">X-API-Key: &lt;your key&gt;</code></li><li data-start="1182" data-end="1232">URL: exactly what you set in Custom Server URL</li></ul></li><li data-start="1234" data-end="1493">Email request body (JSON)<ul data-start="1270" data-end="1493"><li data-start="1270" data-end="1302"><code data-start="1272" data-end="1284">recipients</code>: list of emails</li><li data-start="1305" data-end="1383"><code data-start="1307" data-end="1314">media</code>: array of items, each with <code data-start="1342" data-end="1347">url</code> or <code data-start="1351" data-end="1359">base64</code> + filename + mimeType</li><li data-start="1386" data-end="1440"><code data-start="1388" data-end="1398">metadata</code>: includes app/version/timestamp/machine</li></ul></li><li data-start="1495" data-end="1706">SMS request body (JSON)<ul data-start="1529" data-end="1706"><li data-start="1529" data-end="1589"><code data-start="1531" data-end="1543">recipients</code>: list of E.164 numbers (e.g., +15551234567)</li><li data-start="1592" data-end="1620"><code data-start="1594" data-end="1603">message</code>: optional text</li><li data-start="1623" data-end="1655"><code data-start="1625" data-end="1632">media</code>: same rules as email</li></ul></li><li data-start="1708" data-end="1835">Media behavior<ul data-start="1733" data-end="1835"><li data-start="1733" data-end="1802">Prefers <code data-start="1743" data-end="1748">url</code> if Cloud sync is available; falls back to <code data-start="1791" data-end="1799">base64</code>.</li><li data-start="1805" data-end="1835">Server should accept both.</li></ul></li><li data-start="1837" data-end="1963">Expected responses<ul data-start="1866" data-end="1963"><li data-start="1866" data-end="1923">Success: HTTP 2xx (optionally per-recipient results).</li><li data-start="1926" data-end="1963">Error: HTTP 4xx/5xx with details.</li></ul></li></ul><h2 data-start="1965" data-end="1987" id="sms-country-selector">SMS Country Selector</h2><ul data-start="1989" data-end="2433"><li data-start="1989" data-end="2053">Enable Country Selector: toggles selector on SMS screen.</li><li data-start="2054" data-end="2119">Default Prefix: the pre-selected country code (e.g., +1).</li><li data-start="2120" data-end="2194">Custom List (optional): comma-separated codes (e.g., +1,+44,+972).</li><li data-start="2195" data-end="2360">Validation rules:<ul data-start="2223" data-end="2360"><li data-start="2223" data-end="2308">If Country Selector ON + Custom List ON &#x2192; list must have at least one valid code.</li><li data-start="2311" data-end="2360">Default Prefix must exist in the active list.</li></ul></li><li data-start="2361" data-end="2433">Tips: keep the list short, always set a sensible Default Prefix.</li></ul><h2 data-start="2435" data-end="2466" id="notes-on-assets-and-templates">Notes on assets and templates</h2><ul data-start="2468" data-end="2642"><li data-start="2468" data-end="2642">Current builds disable Email/SMS asset sections in Theme. If enabled in future, customization will be available there. For now, provider choice is managed in Sharing tab.</li></ul><h2 data-start="2644" data-end="2666" id="recommended-workflow">Recommended workflow</h2><ol data-start="2668" data-end="3099"><li data-start="2668" data-end="2755">Choose provider: start with Cloud; switch to Custom when endpoint + key are ready.</li><li data-start="2756" data-end="2800">For Custom: set Server URL + X-API-Key.</li><li data-start="2801" data-end="2894">(Optional) Configure SMS Country Selector: Default Prefix, and optionally a custom list.</li><li data-start="2895" data-end="2919">Click Save Changes.</li><li data-start="2920" data-end="3004">Run a test:<ul data-start="2940" data-end="3004"><li data-start="2940" data-end="2969">Email &#x2192; send to yourself.</li><li data-start="2973" data-end="3004">SMS &#x2192; send to a test phone.</li></ul></li><li data-start="3005" data-end="3099">If using Cloud QR sharing, scan QR and confirm landing page updates when upload finishes.</li></ol><h2 data-start="3101" data-end="3118" id="troubleshooting">Troubleshooting</h2><ul data-start="3120" data-end="3628"><li data-start="3120" data-end="3184">Save blocked: invalid URL &#x2192; enter full https:// address.</li><li data-start="3185" data-end="3247">Save blocked: missing key &#x2192; enter a non-empty API key.</li><li data-start="3248" data-end="3315">Country selector error &#x2192; fix custom list or Default Prefix.</li><li data-start="3316" data-end="3470">Email/SMS not delivered (Custom) &#x2192; check server response:<ul data-start="3384" data-end="3470"><li data-start="3384" data-end="3410">401/403 = key mismatch</li><li data-start="3413" data-end="3438">400 = schema mismatch</li><li data-start="3441" data-end="3470">413 = size limit exceeded</li></ul></li><li data-start="3471" data-end="3551">Provider rejects MMS/attachments &#x2192; use urls or smaller/transcoded files.</li><li data-start="3552" data-end="3628">Large base64 payloads &#x2192; enable Cloud sync or increase server limits.</li></ul><h2 data-start="3630" data-end="3664" id="privacy-and-reliability-custom">Privacy and reliability (Custom)</h2><ul data-start="3666" data-end="3842"><li data-start="3666" data-end="3687">Always use HTTPS.</li><li data-start="3688" data-end="3733">Keep API key secret; rotate periodically.</li><li data-start="3734" data-end="3770">Validate recipients server-side.</li><li data-start="3771" data-end="3816">Log requestId/sessionId for traceability.</li><li data-start="3817" data-end="3842">Rate-limit if needed.</li></ul><h2 data-start="3844" data-end="3859" id="save-reminder">Save reminder</h2><ul data-start="3861" data-end="3960"><li data-start="3861" data-end="3960">Settings are live for testing, but only persist after clicking Save Changes in Global Settings.</li></ul><h2 data-start="3962" data-end="3979" id="quick-checklist">Quick checklist</h2><ul data-start="3981" data-end="4086"><li data-start="3981" data-end="4086">Pick Provider &#x2192; Enter URL + API Key (Custom) &#x2192; Configure SMS Selector &#x2192; Save Changes &#x2192; Test Email/SMS</li></ul><h2 data-start="4088" data-end="4106" id="dodont-summary">Do/Don&#x2019;t summary</h2><ul data-start="4108" data-end="4342"><li data-start="4108" data-end="4151">Do start with Cloud for quickest setup.</li><li data-start="4152" data-end="4196">Do use HTTPS + secure API key in Custom.</li><li data-start="4197" data-end="4251">Do keep SMS list short and Default Prefix correct.</li><li data-start="4252" data-end="4308">Don&#x2019;t assume Custom works without HTTP 2xx response.</li><li data-start="4309" data-end="4342">Don&#x2019;t forget to Save Changes.</li></ul>References<ul data-start="4358" data-end="4496" data-is-last-node data-is-only-node><li data-start="4358" data-end="4406">Sharing_Custom_Email.md [will be sent upon request]</li><li data-start="4407" data-end="4451">Sharing_Custom_SMS.md&#xA0;[will be sent upon request]</li><li data-start="4452" data-end="4496" data-is-last-node>Cloud &amp; QR links: see Cloud tab guidance</li></ul></div></div></article><div data-edge="true"> </div>

Sharing Tab

The Storage tab controls where FMX saves your event media and whether the app auto-deletes older content and writes system logs. Changes apply immediately for testing; click Save Changes to keep them for next time. Base Folder. Displays the root fold

<img src="https://attachments.gorgias.help/JEmYL2naMXn6oMgQ/hc/bgJ1Q6QrLw2vXKOM/2025092019-eb7c6b3b-82b3-415a-bc0a-a911b8acb95d-storage_screen.jpg" class="fr-fic fr-dib"><h2 data-start="0" data-end="9" id="isPasted">Summary</h2><ul data-start="11" data-end="233"><li data-start="11" data-end="143">The Storage tab controls where FMX saves your event media and whether the app auto-deletes older content and writes system logs.</li><li data-start="144" data-end="233">Changes apply immediately for testing; click Save Changes to keep them for next time.</li></ul><h2 data-start="235" data-end="245" id="controls">Controls</h2><ul data-start="247" data-end="955"><li data-start="247" data-end="427">Base Folder<ul data-start="269" data-end="427"><li data-start="269" data-end="358">Displays the root folder FMX uses for events and media (photos, videos, GIFs, scans).</li><li data-start="361" data-end="427">Change Folder&#x2026; opens a picker to select a new base folder.</li></ul></li><li data-start="429" data-end="568">Auto-Delete Old Content<ul data-start="463" data-end="568"><li data-start="463" data-end="538">ON &#x2192; FMX cleans up older content per the &#x201C;Delete after N days&#x201D; setting.</li><li data-start="541" data-end="568">OFF &#x2192; no auto-deletion.</li></ul></li><li data-start="570" data-end="764">Delete after N days<ul data-start="600" data-end="764"><li data-start="600" data-end="652">Number of days to retain content before cleanup.</li><li data-start="655" data-end="692">Only digits allowed; minimum = 1.</li><li data-start="695" data-end="764">Empty/invalid resets to default (30) when focus leaves the field.</li></ul></li><li data-start="766" data-end="955">System Log<ul data-start="787" data-end="955"><li data-start="787" data-end="862">ON &#x2192; FMX writes detailed logs to <code data-start="822" data-end="835">C:\FMX\Logs</code> with automatic rotation.</li><li data-start="865" data-end="897">OFF &#x2192; disables file logging.</li><li data-start="900" data-end="955">Takes effect immediately; Save persists the choice.</li></ul></li></ul><h2 data-start="957" data-end="988" id="how-to-change-the-base-folder">How to change the Base Folder</h2><ol data-start="990" data-end="1132"><li data-start="990" data-end="1019">Click Change Folder&#x2026;</li><li data-start="1020" data-end="1065">Select the target directory and confirm.</li><li data-start="1066" data-end="1132">Field updates immediately; click Save Changes to persist.</li></ol><h2 data-start="1134" data-end="1158" id="auto-delete-behavior">Auto-delete (behavior)</h2><ul data-start="1160" data-end="1374"><li data-start="1160" data-end="1211">Enable Auto-Delete and set retention days (&#x2265;1).</li><li data-start="1212" data-end="1248">Invalid input resets to 30 days.</li><li data-start="1249" data-end="1305">Applies only to FMX-managed media under Base Folder.</li><li data-start="1306" data-end="1374">Keep OFF during critical events if you&#x2019;re unsure what to retain.</li></ul><h2 data-start="1376" data-end="1388" id="system-log">System Log</h2><ul data-start="1390" data-end="1515"><li data-start="1390" data-end="1446">Enabled &#x2192; logs saved to <code data-start="1416" data-end="1429">C:\FMX\Logs</code> with rotation.</li><li data-start="1447" data-end="1484">Toggle affects runtime instantly.</li><li data-start="1485" data-end="1515">Persisted only after Save.</li></ul><h2 data-start="1517" data-end="1532" id="save-behavior">Save behavior</h2><ul data-start="1534" data-end="1684"><li data-start="1534" data-end="1615">All edits apply immediately but persist only after clicking Save Changes.</li><li data-start="1616" data-end="1684">Covers Base Folder, Auto-Delete, retention days, and System Log.</li></ul><h2 data-start="1686" data-end="1708" id="recommended-workflow">Recommended workflow</h2><ol data-start="1710" data-end="1958"><li data-start="1710" data-end="1792">Choose a fast, reliable local Base Folder (avoid unstable network/USB paths).</li><li data-start="1793" data-end="1875">Enable Auto-Delete with safe retention (e.g., 30 days) if cleanup is desired.</li><li data-start="1876" data-end="1929">Enable System Log if you need saved diagnostics.</li><li data-start="1930" data-end="1958">Click Save Changes.</li></ol><h2 data-start="1960" data-end="1977" id="troubleshooting">Troubleshooting</h2><ul data-start="1979" data-end="2328"><li data-start="1979" data-end="2082">Folder picker blocked &#x2192; retry; check Windows prompts or policies; type path manually if needed.</li><li data-start="2083" data-end="2149">Auto-delete not running &#x2192; runs on schedule, not instantly.</li><li data-start="2150" data-end="2214">Letters in Days field &#x2192; blocked by design (digits only).</li><li data-start="2215" data-end="2328">No logs in <code data-start="2230" data-end="2243">C:\FMX\Logs</code> &#x2192; ensure System Log is ON, folder may appear after first log, check permissions.</li></ul><h2 data-start="2330" data-end="2347" id="quick-checklist">Quick checklist</h2><ul data-start="2349" data-end="2431"><li data-start="2349" data-end="2431">Set Base Folder &#x2192; Decide Auto-Delete + Days &#x2192; Toggle System Log &#x2192; Save Changes</li></ul><h2 data-start="2433" data-end="2451" id="dodont-summary">Do/Don&#x2019;t summary</h2><ul data-start="2453" data-end="2696" data-is-last-node data-is-only-node><li data-start="2453" data-end="2510">Do use a reliable Base Folder with enough free space.</li><li data-start="2511" data-end="2578">Do enable Auto-Delete with safe retention for long-term setups.</li><li data-start="2579" data-end="2632">Do enable System Log for diagnostics when needed but don&apos;t forget to disable it right after.</li><li data-start="2633" data-end="2696" data-is-last-node>Don&#x2019;t forget to click Save Changes to persist settings.</li></ul>

Storage Tab

The Theme tab customizes the look and text of your experience. You can set background and main (accent) colors, choose built-in vs. your own assets for Email/SMS/Print/Signature/Preview, add a branding overlay, and edit translations (UI text). Change

<img src="https://attachments.gorgias.help/JEmYL2naMXn6oMgQ/hc/bgJ1Q6QrLw2vXKOM/2025092019-35e2c715-5af8-49c0-a62e-dfd2cd3a057a-theme_screen.jpg" class="fr-fic fr-dib"><h2 data-start="0" data-end="9" id="isPasted">Summary</h2><ul data-start="11" data-end="338"><li data-start="11" data-end="77">The Theme tab customizes the look and text of your experience.</li><li data-start="78" data-end="262">You can set background and main (accent) colors, choose built-in vs. your own assets for Email/SMS/Print/Signature/Preview, add a branding overlay, and edit translations (UI text).</li><li data-start="263" data-end="338">Changes apply immediately for testing; click Save Changes to keep them.</li></ul><h2 data-start="340" data-end="348" id="colors">Colors</h2><ul data-start="350" data-end="720"><li data-start="350" data-end="528">Workflow Background Color<ul data-start="386" data-end="528"><li data-start="386" data-end="446">Enter HEX (#RGB, #RRGGBB, #AARRGGBB). Stored as #RRGGBB.</li><li data-start="449" data-end="499">Use palette or type HEX; preview updates live.</li><li data-start="502" data-end="528">Applies to background.</li></ul></li><li data-start="530" data-end="720">Main Theme Color (accent)<ul data-start="566" data-end="720"><li data-start="566" data-end="623">Controls accents like primary buttons and selections.</li><li data-start="626" data-end="669">HEX or palette input with live preview.</li><li data-start="672" data-end="720">Status warning/error colors remain standard.</li></ul></li></ul><h2 data-start="722" data-end="754" id="assets-built-in-vs-customize">Assets (Built-in vs Customize)</h2><ul data-start="756" data-end="1537"><li data-start="756" data-end="858">Email Assets<ul data-start="779" data-end="858"><li data-start="779" data-end="811">Built-in: packaged defaults.</li><li data-start="814" data-end="858">Customize: select your own asset folder.</li></ul></li><li data-start="860" data-end="928">SMS Assets<ul data-start="881" data-end="928"><li data-start="881" data-end="928">Built-in or customize with your own folder.</li></ul></li><li data-start="930" data-end="1093">Print Assets<ul data-start="953" data-end="1093"><li data-start="953" data-end="995">Built-in: packaged overlays/templates.</li><li data-start="998" data-end="1093">Customize: pick a folder. Defaults auto-installed to <code data-start="1053" data-end="1079">{BaseFolder}\Theme\Print</code> if missing.</li></ul></li><li data-start="1095" data-end="1253">Signature Stamps<ul data-start="1122" data-end="1253"><li data-start="1122" data-end="1156">Built-in: packaged PNG stamps.</li><li data-start="1159" data-end="1253">Customize: pick a folder. Defaults auto-installed to <code data-start="1214" data-end="1241">{BaseFolder}\Theme\Stamps</code> if empty.</li></ul></li><li data-start="1255" data-end="1414">Preview Assets<ul data-start="1280" data-end="1414"><li data-start="1280" data-end="1314">Built-in: packaged preview UI.</li><li data-start="1317" data-end="1414">Customize: pick a folder. Defaults auto-installed to <code data-start="1372" data-end="1400">{BaseFolder}\Theme\Preview</code> if missing.</li></ul></li><li data-start="1416" data-end="1537">Packaged defaults are copied to your Base Folder only when needed (first-time bootstrap). You can replace them later.</li></ul><h2 data-start="1539" data-end="1557" id="branding-overlay">Branding overlay</h2><ul data-start="1559" data-end="1688"><li data-start="1559" data-end="1688">Foreground PNG<ul data-start="1584" data-end="1688"><li data-start="1584" data-end="1649">Pick a transparent PNG to display over the experience screen.</li><li data-start="1652" data-end="1688">Compact picker allows set/clear.</li></ul></li></ul><h2 data-start="1690" data-end="1714" id="translations-ui-text">Translations (UI text)</h2><ul data-start="1716" data-end="1996"><li data-start="1716" data-end="1769">Edit keys/values for app text (buttons, prompts).</li><li data-start="1770" data-end="1806">Add: create blank Key/Value.</li><li data-start="1807" data-end="1853">Add Common Keys: seed popular entries.</li><li data-start="1854" data-end="1920">Edit: change Key/Value inline; renaming a key replaces it.</li><li data-start="1921" data-end="1953">Remove: deletes the key.</li><li data-start="1954" data-end="1996">Tip: Keep values short and consistent.</li></ul><h2 data-start="1998" data-end="2022" id="main-controls-position">Main controls position</h2><ul data-start="2024" data-end="2090"><li data-start="2024" data-end="2090">Choose where the main buttons appear: Top (default) or Bottom.</li></ul><h2 data-start="2092" data-end="2108" id="folder-pickers">Folder pickers</h2><ul data-start="2110" data-end="2256"><li data-start="2110" data-end="2139">Built-in: no path needed.</li><li data-start="2140" data-end="2256">Customize: choose a folder; FMX creates suggested <code data-start="2192" data-end="2214">{BaseFolder}\Theme\&#x2026;</code> paths and installs defaults if missing.</li></ul><h2 data-start="2258" data-end="2273" id="save-behavior">Save behavior</h2><ul data-start="2275" data-end="2402"><li data-start="2275" data-end="2319">All edits apply immediately for preview.</li><li data-start="2320" data-end="2402">Persist only after clicking Save Changes at the bottom of Global Settings.</li></ul><h2 data-start="2404" data-end="2426" id="recommended-workflow">Recommended workflow</h2><ol data-start="2428" data-end="2763"><li data-start="2428" data-end="2497">Set Workflow Background and Main Theme colors; confirm previews.</li><li data-start="2498" data-end="2584">Decide which assets to customize (start Built-in, switch to Customize as needed).</li><li data-start="2585" data-end="2644">Add Foreground PNG branding (transparent recommended).</li><li data-start="2645" data-end="2702">Use Add Common Keys in Translations and adjust text.</li><li data-start="2703" data-end="2738">Choose Main Controls Position.</li><li data-start="2739" data-end="2763">Click Save Changes.</li></ol><h2 data-start="2765" data-end="2782" id="troubleshooting">Troubleshooting</h2><ul data-start="2784" data-end="3245"><li data-start="2784" data-end="2865">HEX invalid: only #RGB/#RRGGBB/#AARRGGBB allowed; invalid entries revert.</li><li data-start="2866" data-end="2958">Custom assets not visible: confirm Customize is selected and folder has valid files.</li><li data-start="2959" data-end="3088">Defaults didn&#x2019;t install: auto-install runs only if Customize is chosen with no content. Copy defaults manually if needed.</li><li data-start="3089" data-end="3149">Foreground PNG missing: check path and transparency.</li><li data-start="3150" data-end="3245">Translations not updating: ensure correct Key edited and field exited; Save to persist.</li></ul><h2 data-start="3247" data-end="3264" id="quick-checklist">Quick checklist</h2><ul data-start="3266" data-end="3421"><li data-start="3266" data-end="3421">Set colors &#x2192; Pick Built-in/Customize per asset group &#x2192; Select folders &#x2192; Add overlay PNG &#x2192; Update translations &#x2192; Choose controls position &#x2192; Save Changes</li></ul><h2 data-start="3423" data-end="3441" id="dodont-summary">Do/Don&#x2019;t summary</h2><ul data-start="3443" data-end="3639" data-is-last-node data-is-only-node><li data-start="3443" data-end="3494">Do use valid HEX for colors and check previews.</li><li data-start="3495" data-end="3549">Do start Built-in and move to Customize gradually.</li><li data-start="3550" data-end="3583">Do keep translations concise.</li><li data-start="3584" data-end="3639" data-is-last-node>Don&#x2019;t forget to Save Changes to persist your theme.</li></ul>

Global Settings