Beta Software

FloSync is currently in beta. Features may change rapidly as we gather feedback.

Documentation Menu

Preferences

The defaults are the best starting point for most installations, and every recommended setup on this page begins from them. Change something when you have a reason: screens that look misaligned, playback that feels jumpy, or a computer that has to come back on its own after a power cut.

Accessing Preferences

macOS:

  • Menu: FloSync > Preferences
  • Keyboard: ⌘,

Windows:

  • Menu: File > Settings
  • Keyboard: Ctrl+,

Sync Tolerance Settings

Sync tolerance controls how much playback drift FloSync allows before it corrects itself. A Mode toggle at the top of this section switches between two ways to set it.

Automatic Mode

Default. Pick an overall aggressiveness level, and FloSync applies matching tolerance settings for you:

Level Description
Strict Tighter sync, may have more corrections
Balanced (default) Good balance of sync and stability
Relaxed Smoother playback, slightly looser sync

Manual Mode

Set tolerance directly, on two sliders labeled Local and Network, each adjustable from 10 to 200 ms.

Local (default 30 ms)

What it controls: Synchronization between multiple screens connected to the same computer (used in Mirrored and Spanned modes during Go Live).

When to adjust:

Scenario Recommendation
Screens are visibly misaligned Tighten tolerance
Playback feels jumpy Relax tolerance
High-performance system You can usually run tighter settings
Older hardware You may get smoother playback with more lenient settings

Network (default 50 ms)

What it controls: Synchronization between computers connected over the network (server/client mode).

When to adjust:

Scenario Recommendation
Screens are visibly drifting Tighten tolerance
Frequent corrections cause stutter Relax tolerance
Stable wired network Defaults are usually ideal
Busy or unstable network More lenient settings can improve smoothness

Note: Network sync settles in quickly after clients connect. In most deployments, the default settings provide smooth, stable results.

Understanding Tolerance Values

What It Means

Tolerance is the maximum acceptable difference between:

  • Local sync: The primary screen and secondary screens
  • Network sync: The server's position and the client's position

If drift persists beyond this window, FloSync applies a correction.

Tighter vs. More Lenient Tolerance

Tighter tolerance:

  • Closer visual alignment
  • More frequent corrections
  • Best for side-by-side screens where differences are easy to spot

More lenient tolerance:

  • Smoother playback with fewer corrections
  • Helpful on older hardware or unstable networks
  • Often fine when viewers are not seeing multiple screens at once

About Defaults

FloSync defaults are tuned for most real-world setups. Use them first, then adjust only if you see visible drift or unnecessary corrections.

Video Wall (Spanned Mode)

Start with defaults. If screens are visibly misaligned, tighten tolerance gradually.

Retail Digital Signage (Mirrored Mode)

Defaults are usually best. Relax tolerance only if you see frequent corrections.

Conference Room (Mirrored Mode)

Defaults typically provide strong results for side-by-side displays.

Large Event Installation (Network Sync)

Use defaults first, then tune based on network quality and observed behavior.

Art Installation (Any Mode)

If visual continuity is critical, tighten local tolerance and validate with a test run.

Startup Settings

FloSync can automatically launch when you log in to your computer and optionally start playing content immediately.

Launch at Login

What it controls: Whether FloSync starts automatically when you log in to your computer.

Default: Off

How to enable:

  1. Open Preferences (⌘, on macOS, Ctrl+, on Windows)
  2. Scroll to the Startup section
  3. Toggle Launch FloSync at login on
  4. Click Save

Platform notes:

  • macOS 13+: Uses the system's Login Items feature (visible in System Settings > General > Login Items)
  • macOS 12 and earlier: Creates a LaunchAgent in ~/Library/LaunchAgents/
  • Windows: Creates a shortcut in the Startup folder (%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\) to start FloSync on login

Auto Go Live

What it controls: Whether FloSync automatically starts playing content when the app launches.

Default: Off

Options:

Mode Description
Off FloSync opens to the composer - no automatic playback
Fullscreen Automatically goes live with fullscreen windows on all displays
Controller Automatically goes live in controller mode (server only - plays in composer preview)

How it works:

  1. When FloSync launches with Auto Go Live enabled, a short countdown dialog appears
  2. You can click Cancel to stop the countdown and stay in the composer
  3. If the countdown completes, FloSync goes live using your configured schedule
  4. For Interval mode: Starts from scene 1 and cycles through scenes
  5. For Time-of-Day mode: Plays the scene for the current time

Controller mode requirements:

  • FloSync must be running as a server for Controller mode to work
  • If you have Controller mode selected but connect as a client, you'll be prompted to change the setting
  • Controller mode is ideal for operating remote video walls from a laptop

Tip: Auto Go Live is perfect for digital signage that needs to start playing immediately after a power outage or system restart.

Video Looping

FloSync offers two looping modes. Choose the one that works best for your setup.

Looping Mode

What it controls: How videos loop during Go Live.

Default: Seamless, for MP4 and MOV files. Other formats use standard looping automatically.

Options:

Mode Description
Standard Videos loop normally. You may notice a brief flicker at the loop point on some videos.
Seamless Eliminates loop gaps for MP4 and MOV files. Other formats will use standard looping automatically.

How to choose:

Scenario Recommendation
Your files are MP4 or MOV and smooth loops matter (signage, video walls, VJ) Seamless (default)
Other file formats, maximum compatibility, or simplest setup Standard

Note: When using Seamless mode, FloSync prepares your MP4 and MOV videos for smooth playback when you Go Live. You'll see an "Optimizing Video" progress indicator while this completes. Other formats loop normally with no preparation step.

MIDI Settings

The MIDI section in Preferences lets you enable MIDI controller support and select your device. When enabled, you can map interval scenes to controller pads for direct scene triggering during live performances.

How to enable: Toggle Enable MIDI Control on, select your device from the dropdown, and click Save.

For complete setup instructions, supported controllers, LED feedback details, and scene mapping, see the MIDI guide.

Danger Zone

Reset All Scenes & Content

To clear all content and start fresh while keeping your preferences:

  1. Go to File > Reset All Scenes & Content
  2. Confirm in the dialog that appears

This clears schedule scenes, content assignments, and Global Canvas Extension settings. Your sync tolerance preferences are preserved.

Full Reset (Including Preferences)

The Preferences screen includes a Danger Zone section where you can perform a complete reset:

  1. Open Preferences
  2. Scroll to the Danger Zone section
  3. Click Reset, the button beside Reset FloSync
  4. In the confirmation dialog, click Reset & Quit

This clears all preferences, schedules, content assignments, Global Canvas Extension settings, and logs. FloSync quits after the reset.