XangleCs documentation

General tab

Presets

• Quick-apply: Event / Studio single camera / Studio bullet-time / Photogrammetry

Main output

• Images checkbox
• Process (resize, assets…) checkbox Not Starter
• Videos checkbox

Top navigation visibility

• Checkboxes for: Player, Share, Library, Display, Calibration, Chromakey, Live view, Assets, UI, Frames, Lights, Email monitoring, Files/folders, Performances, Trigger actions, Media collections
• Each gated by its respective license feature

Trigger actions components

• Checkboxes for: Camera presets, Light presets, Projector presets, GPIO presets, Display devices xangle-server-trigger-actions

Studio Mode tab

• Allow delete checkbox
• App flash checkbox
• App dimmer dropdown — No dimmer / Trigger duration / Preview duration / Complete duration
• Dimmer opacity slider 10–100%
• Dimmer spinner checkbox
• Frames to show text input — Empty for all
• Extract JPG from RAW dropdown — Extract all / Extract selection / Extract none

Publish tab

Output folder

• Output folder text input — This folder is used to store the files generated during a shooting. Its content is also displayed in the library and gallery. Previous digital calibration settings will also be stored there.
• Reset to default button

Publish options

• RAW files (if available) checkbox — Not available for Trial licenses xangle-server-raw
• Originals files checkbox
• Aligned images checkbox
• Preview images checkbox
• Final images checkbox — multi-camera only
• Final format dropdown — JPG / PNG
• Publish server and camera settings checkbox
• Extract thumbnails from RAW checkbox
• Copy EXIF from RAW to JPG dropdown — None / Orientation only / All
• Thumbnail camera number number input

Sharing tab

Email

• Active checkbox Not Starter
• Allow multiple emails checkbox
• Cloud upload checkbox
• Cloud upload attachments: Video, First video frame, All original pictures checkboxes
• Email template dropdown

Email custom fields

• Per field: Name (e.g. "first_name"), Type (Text / Dropdown), Required, Placeholder, Values Values separated by commas (for dropdown type)

Terms & conditions checkboxes

• Per checkbox: Name (e.g. "terms_and_conditions"), Text, HTML file path (optional), Required, Checked (default)

Direct download

• Active checkbox Not Starter

Self hosted

• Active checkbox Not Starter
• Sharing URL prefix text input

Download attachments

• Video, First video frame, All original pictures checkboxes

Collection selector

• Active checkbox Not Starter
• Selected template dropdown
• Webhook URL text input — The webhook will be called when the collection selector is changed, with POST data: timestamp, foldername, path
• External processing dropdown — None / Managed automatic / Managed manual / Delayed

Email templates

• HTML file template dropdown
• Subject text input
• Body textarea / HTML editor — toggle: "html editor" checkbox

SMTP Provider

• Email Service dropdown — None / Simulation / SendGrid / Gmail / Custom
• Warning! With Gmail you have to configure your gmail account to allow 'unsecure' apps. Google may block you after a certain number of mails sent per day.
• Warning! Simulation uses a simulated local mail server. No actual mail will be sent!
• From (sender) email input
• Host, Port, Secure, Check certificate errors — Custom SMTP only
• Username, Password / API key — per provider
• Check SMTP connection button

CDN Provider

• CDN provider dropdown — Bunny CDN / Cloudinary / Cloudflare R2
• API key, API secret password inputs
• Bunny CDN: Storage zone, Region (DE/UK/US/SG/SE/BR/SA), Pull zone URL
• Cloudinary: Cloud name
• Cloudflare R2: Account ID, Bucket name, Public URL

Player tab

• Mute player checkbox — Required for autoplay
• Preview image number input — Will show the image from this camera if available. Leave blank or 0 if you don't need fast preview.

Network tab

• Network interface dropdown — Can only be edited in app, not in a browser
• Refresh / Renew IP addresses buttons (app only)
• Disable server broadcast on network checkbox

Advanced tab

Processing shortcuts

• Skip processing checkbox
• Batch recalibrate button
• Links to: API documentation, Video output settings, Custom trigger sequences

Trigger signal filtering

• Prevent trigger during image transfer checkbox
• Prevent trigger until processing is finished checkbox
• Prevent trigger without cameras checkbox
• Bulb trigger cooldown slider 0–2000 ms — [DSLR with BULB only] Time during which trigger signal will be ignored
• Mirror Lock cooldown slider 0–2000 ms — [DSLR with mirror-lockup only] Time during which trigger signal will be ignored

Trigger timing

• Mirror Lockup delay slider 0–1000 ms — Delay between the "raise mirror" command and the actual capture. Recommended: 300–500 ms
• Half-Press Delay slider 0–1000 ms — [DSLR only] Time the camera stays in half-press when you can't control the standby signal
• Trigger warmup delay slider 0–300 ms — Compensate for software signal processing lag. Slightly improves sync in 'freeze' situations at expense of responsiveness
• Trigger release delay slider 0–500 ms — [DSLR only] How long Xangle 'holds' the trigger signal before releasing
• Mirror lockup half press delay slider 0–500 ms — [DSLR with mirror-lockup] How long to hold half press before raising mirror
• Release half-press after mirror lock checkbox

Processing performance

• Defines the number of parallel tasks. A good rule of thumb is to use a number just below the number of CPU cores.
• CPU cores for calibration slider 1–64
• CPU cores for chromakey slider 1–64
• Parallel instances for ffmpeg slider 1–64 — If using nvenc with limited VRAM, you might need to reduce parallel instances

Image transfer logic

• Picture upload timeout slider 0–30000 ms — Maximum wait before considering transfer failed. 0 = disabled (use at your own risk)
• Ignore extra picture delay slider 0–10000 ms — Extra images transferred within this window will be ignored when shooting multiple times
• Client buffer capacity slider 0–32 — When using Pis with limited RAM (1 GB or less), limit files transiting through memory. 0 = unlimited
• Transfer during capture checkbox — Allow immediate file transfer during long captures (burst, multiple iterations…)

Bandwidth control

• Image transfer rate limit slider 0–1500 MB/s — Control peak bandwidth. A good rule of thumb is 90–95% of available bandwidth. 0 = unlimited Not Starter
• Concurrent downloads slider 0–300 — Max simultaneous file downloads. Higher = more bandwidth, faster transfer. 0 = unlimited

Misc

• Raspberry Pi performance preset dropdown — powersave (600 MHz) / performance (1200+ MHz, requires more power)
• Raspberry Pi log level dropdown — debug / info / error / off