Getting Started with FloSync

This guide will walk you through installing FloSync, loading your first content, and understanding the basic interface.

Installation #

macOS #

1. Download the FloSync DMG file from the download page
2. Open the DMG and drag FloSync to your Applications folder
3. Launch FloSync from Applications

Note: On first launch, macOS may ask you to confirm you want to open an app from an identified developer. Click "Open" to proceed.

Windows #

1. Download the FloSync installer from the download page
2. Run the installer and follow the prompts
3. Launch FloSync from the Start menu or desktop shortcut

First Launch #

When you first open FloSync, you'll see the main control panel interface:

Screenshot: The main FloSync control panel showing the screen arrangement area in the center, mode selector and sync controls at the top, and playback controls at the bottom.

Interface Overview #

The FloSync interface is a unified control panel divided into several areas:

Top Bar

• Mode dropdown - Switch between Independent, Mirrored, and Spanned modes
• LIVE indicator - Shows when presentation mode is active (red badge)
• Schedule icon (agenda/list) - Open/close the schedule panel for time-based and interval content scheduling
• Clear All button (cancel presentation) - Remove all loaded content (only shown when content is loaded)
• Canvas extension icon (grid) - Configure global canvas for multi-computer video walls (Spanned mode only)
• Global preview toggle (zoom) - Show/hide the global canvas preview (Spanned mode only, when extension is configured)
• (divider)
• Server icon (tower) - Start/stop server mode for network sync (green when active)
• Client icon (wifi) - Connect/disconnect as client for network sync (blue when active)

Screen Arrangement Area

• Shows a visual representation of your connected screens
• Each screen appears as a box proportional to its actual size and position
• Drag and drop videos or images directly onto screen boxes
• Right-click for additional options (load web page, load HTML file)
• Click screens to select them
• Click loaded content to edit its settings
• Audio toggle button on each screen (videos only)

Playback Controls Bar

• Timeline slider - Scrub through the video (visible when video content is loaded)
• Time display - Current position and total duration
• Play/Pause button - Control video playback
• Go Live button - Launch fullscreen presentation on all screens

Status Bar

• Canvas size - Total dimensions of all screens combined (e.g., "3840×1080")
• Global canvas size - When canvas extension is configured, shows the full video wall size
• Screen count - Number of connected screens
• Warnings - Any issues with your setup (missing content, duration mismatch, etc.)
• Sync corrections - Number of sync corrections during live mode (only shown when live)
• Network sync status - Shows server/client connection status when active
• Video duration - Length of the longest loaded video

Loading Content #

FloSync supports three content types: videos, images, and web pages. Each type has different loading methods and behaviors.

Loading Videos #

Drag and Drop: Simply drag a video file from Finder (macOS) or Explorer (Windows) and drop it onto any screen box in the FloSync control panel.

Click to Browse:

1. Click on any screen box in the arrangement area
2. A file browser dialog will open
3. Select your video file and click Open

Supported Video Formats:

• MP4 (H.264, H.265/HEVC)
• MOV (including ProRes)
• MKV
• AVI
• WebM

In Mirrored or Spanned mode, loading content on any screen automatically loads it on all screens. In Independent mode, each screen can have different content.

Loading Images #

Drag and Drop: Drag an image file from your file browser and drop it onto any screen box.

Click to Browse:

1. Click on any screen box
2. Select "Load Video/Image" from the file dialog
3. Choose your image file

Supported Image Formats:

• PNG
• JPG / JPEG
• GIF (including animated GIFs - they will loop automatically)
• BMP
• TIFF
• WebP
• SVG

Image Fit Modes: After loading an image, click on it to open the content settings dialog where you can adjust:

• Fit - Scale to fit within screen, maintaining aspect ratio (may show bars)
• Fill - Scale to fill screen, cropping excess (no bars, may crop)
• Stretch - Stretch to fill screen (may distort aspect ratio)

Loading Web Pages #

From URL:

1. Right-click on a screen box
2. Select "Load Web Page URL"
3. Enter an HTTPS URL (e.g., https://example.com)
4. Click OK

From Local HTML File:

1. Right-click on a screen box
2. Select "Load HTML File"
3. Browse to and select your HTML file
4. Click Open

Note: Only HTTPS URLs are supported for security. Local HTML files can reference relative assets (CSS, images, JS) in the same directory.

Auto-Refresh: After loading a web page, click on it to open settings where you can configure auto-refresh:

• Never (default)
• Every 15 minutes
• Every 30 minutes
• Every 1 hour

Playing Your Content #

Once content is loaded, you have two ways to display it:

Preview Mode (Control Panel) #

Use the playback controls in the control panel to preview your content:

• Play/Pause button - Click the play button in the bottom bar (videos only)
• Timeline scrubbing - Click and drag on the timeline to jump to any position (videos only)
• Audio toggle - Click the speaker icon on each screen to enable/disable audio (videos only)

Note: Images display immediately and stay visible indefinitely. Web pages render live in the preview. Playback controls only affect video content.

Screenshot: A video loaded in the control panel, showing the screen boxes with video previews, timeline progress, and playback controls.

Go Live (Fullscreen Presentation) #

For actual presentation, use the Go Live feature:

1. Click the Go Live button in the playback controls bar
2. FloSync creates fullscreen windows on each connected screen
3. Content displays on each screen according to your configuration:
   • Videos play in perfect sync across all screens
   • Images display immediately
   • Web pages render live
4. If network sync is active (server or client mode), video playback will be synchronized across all connected computers

During Live Mode:

• The mouse cursor is hidden by default on fullscreen windows
• Moving the mouse reveals the cursor temporarily
• The cursor auto-hides again after 15 seconds of inactivity
• Clicking on a fullscreen window shows an "Exit Live?" confirmation dialog

Exiting Live Mode:

• Press ESC on any fullscreen window to exit live mode
• Click anywhere on a fullscreen window and select "Yes" in the dialog
• Or click the Stop Live button in the control panel

Go Live Options: When you have a configured schedule (multiple scenes), the Go Live button shows a dropdown:

• Go Live (Current) — Plays the current composer content, ignoring the schedule. Use this for testing only.
• Go Live (Schedule) or Go Live (Beginning) — Plays scheduled content with automatic transitions. Use this for real deployments.

For details on scheduling modes and the Controller option, see Scheduling.

Working with Multiple Screens #

If you have multiple screens connected to your computer, FloSync automatically detects them and shows them in the screen arrangement area.

Screen Arrangement #

The center of the control panel shows your connected screens arranged as they are configured in your operating system. The layout is proportionally scaled to show relative positions and sizes.

Screenshot: The screen arrangement area showing multiple screen boxes positioned to match the physical monitor arrangement.

Screen Modes #

Use the Mode dropdown in the top bar to choose how content appears across your screens:

• Independent - Each screen can show different content with separate audio
• Mirrored - All screens show the same content in sync (primary screen audio only)
• Spanned - Your content stretches across all screens as one large canvas

For detailed information about each mode, see Screen Modes.

Menu Bar #

FloSync provides full menu bar access on both platforms:

macOS: Native menu bar with standard keyboard shortcuts

• FloSync menu - About, Preferences (⌘,), Hide, Quit
• File menu - Import/Export Configuration (⌘O/⌘S), Reset Everything
• View menu - Schedule Panel, Log Panel, Global Canvas Preview
• Window menu - Minimize, Zoom
• Help menu - Documentation, Website, Reddit

Windows: In-app menu bar at the top of the window

• File menu - Import/Export Configuration (Ctrl+O/Ctrl+S), Reset Everything, Settings (Ctrl+,), Exit (Ctrl+Q)
• View menu - Schedule Panel, Log Panel, Global Canvas Preview
• Help menu - Documentation, Website, Reddit, About

Saving and Loading Configurations #

FloSync can save your complete setup to a .flo file, which you can later import to restore your configuration. This is useful for:

• Backing up your schedule and content assignments
• Deploying the same configuration to multiple computers
• Sharing setups with colleagues

Exporting a Configuration #

1. Go to File > Export Configuration (⌘S on macOS, Ctrl+S on Windows)
2. Choose a location and filename
3. Click Save

What's exported:

• All schedule scenes and their content assignments (both Time-of-Day and Interval schedules)
• Display mode (Independent, Mirrored, or Spanned)
• Global canvas extension settings
• Audio settings (per-display mute states)
• App version and format version (for compatibility checking)

What's NOT exported (machine-specific):

• Sync tolerances (local and network)
• Window position and size
• UI panel visibility

Importing a Configuration #

1. Go to File > Import Configuration (⌘O on macOS, Ctrl+O on Windows)
2. Select a .flo file
3. Click Open

Version Compatibility: If the file was created by a newer version of FloSync, you'll see a warning dialog asking whether to proceed. This helps prevent issues when importing configurations that may use features not available in your version.

Missing Files: If some content files have been moved or renamed since the configuration was exported, FloSync will show a Missing Files dialog. You can:

• Click Search Folder to search a folder for all missing files at once
• Click Locate Files to select specific files manually
• FloSync matches files by filename and verifies them by size and content hash when available

Resetting Everything #

To clear all content and start fresh:

1. Go to File > Reset Everything
2. Confirm in the dialog that appears

This clears:

• All schedule scenes (reverts to a single "All Day" scene)
• Content assignments for each display
• Global canvas extension settings

Your preferences (sync tolerances, etc.) are preserved.

Note: Import and Reset are disabled while in Live mode. Exit Live mode first.

Quick Tips #

• ESC to exit: Press ESC on any fullscreen window to exit live mode
• Drag to replace: If content is already loaded, drag new content onto the screen to replace it
• Loop playback: Videos automatically loop - perfect for digital signage
• Clear all content: Click the X button in the top bar to clear all loaded content
• Persistent sessions: FloSync remembers your last loaded content and restores it on next launch
• Audio per screen: In Independent mode, each screen has its own audio toggle (videos only)
• Content settings: Click on loaded content to adjust fit mode (images/videos) or URL/refresh (web pages)
• Right-click menu: Right-click any screen for options to load videos, images, HTML files, or web URLs
• Animated GIFs: GIF images loop automatically - no configuration needed