ocular.ink
Launch App

Output & mapping

Output is where the mix hits real glass.

  1. Detect screens uses the Window Management permission (Chrome/Edge). If unsupported you'll see Screen detection needs Chrome/Edge — add screens manually; use the mapper toolbar TV icon to add a virtual screen (name + resolution presets from VGA to 8K). Size is editable on virtual screens and on detected displays that report an unknown resolution; add/unknown defaults to the session render size.
  2. Pick a display that is not badged App — App is the screen the UI is on. Card badges: Detected, App, Primary, Live (window open), Virtual (manual), Offline (was bound to a display that's gone). Virtual/offline screens can be bound to a detected display, which copies its resolution. Click any card to select it for surface mapping.
  3. Launch all: available on the far right of the mapper toolbar whenever external displays are detected. It opens output windows directly on their target physical displays, pre-sized to fill each monitor's workspace. Next to it, the Display Manager / Auto-Fullscreen status pill indicates window placement and zero-gesture fullscreen state. A red X next to it closes all open output windows at once. In standard browsers, click an output window once to engage hardware fullscreen. When Automatic Fullscreen is configured (see below), output windows go fullscreen instantly with zero clicks.
  4. The mapper toolbar far right also has output Canvas | Stream: Canvas copies the mix directly (lower latency); Stream uses a video capture of the mix (smoother on some Linux GPUs), followed by the Native | 1080 | 720 warp resolution cap.
  5. The mapper toolbar switches between 2D Map and 3D Stage:
    • 2D Map: Locked orthogonal view for polygon editing. Tools include Select (drag vertices and Bézier handles) and Add Polygon (click points to draw; click first point to close). The fullscreen-surface icon drops a full-frame quad. Undo/redo: ⌘Z / ⇧⌘Z.
    • 3D Stage: Arrange screens in 3D (Pos X/Y/Z and Rot Y/X). The camera frames all surfaces when you enter 3D; Center camera re-frames at any time. Drag to rotate, pan, and zoom.
  6. Master Aspect & Sliding: Each surface can independently choose its aspect ratio fit (Match Height, Match Width, or Stretch) and slide the master crop horizontally or vertically across the surface using the slider or Left, Center, and Right shortcuts. In the sidebar inspector, Master Aspect and Screen 3D controls are unified in a single collapsible card (with 3D controls automatically hidden while in 2D Map mode).
  7. Preview modes: No overlay, UV grid, or live TDM output (the mix on each surface, including Bus O when it targets that surface). In 3D Stage, view as full Quad or clipped On surface, and Reset UV to start over. Mapping and Launch are free.

Inside an output window: the cursor hides itself after a couple of seconds, and the U key toggles a UV-grid calibration pattern in place of the mix — handy while focusing the projector.

Surfaces save with the session (red floppy). Guests can map and launch output windows. The mix is watermarked until you subscribe.

Automatic Fullscreen (Zero-Click PWA Kiosk Output)

By default, browser security models require a user gesture (clicking the output window) to engage hardware fullscreen. To allow output windows to enter fullscreen automatically upon launching with zero manual clicks, enable Chromium's Automatic Fullscreen policy for https://ocular.ink:

macOS

# Google Chrome
defaults write com.google.Chrome AutomaticFullscreenAllowedForUrls -array "https://ocular.ink"

# Brave Browser
defaults write com.brave.Browser AutomaticFullscreenAllowedForUrls -array "https://ocular.ink"

# Microsoft Edge
defaults write com.microsoft.Edge AutomaticFullscreenAllowedForUrls -array "https://ocular.ink"

Linux

# Google Chrome
sudo mkdir -p /etc/opt/chrome/policies/managed
echo '{"AutomaticFullscreenAllowedForUrls": ["https://ocular.ink"]}' | sudo tee /etc/opt/chrome/policies/managed/automatic_fullscreen.json

# Chromium
sudo mkdir -p /etc/chromium/policies/managed
echo '{"AutomaticFullscreenAllowedForUrls": ["https://ocular.ink"]}' | sudo tee /etc/chromium/policies/managed/automatic_fullscreen.json

# Brave Browser
sudo mkdir -p /etc/brave/policies/managed
echo '{"AutomaticFullscreenAllowedForUrls": ["https://ocular.ink"]}' | sudo tee /etc/brave/policies/managed/automatic_fullscreen.json

# Microsoft Edge
sudo mkdir -p /etc/opt/edge/policies/managed
echo '{"AutomaticFullscreenAllowedForUrls": ["https://ocular.ink"]}' | sudo tee /etc/opt/edge/policies/managed/automatic_fullscreen.json

Windows (Command Prompt / PowerShell as Administrator)

# Google Chrome
reg add "HKCU\Software\Policies\Google\Chrome\AutomaticFullscreenAllowedForUrls" /v 1 /t REG_SZ /d "https://ocular.ink" /f

# Microsoft Edge
reg add "HKCU\Software\Policies\Microsoft\Edge\AutomaticFullscreenAllowedForUrls" /v 1 /t REG_SZ /d "https://ocular.ink" /f

# Brave Browser
reg add "HKCU\Software\Policies\BraveSoftware\Brave\AutomaticFullscreenAllowedForUrls" /v 1 /t REG_SZ /d "https://ocular.ink" /f

After running the command for your OS, restart your browser and open chrome://policy (or edge://policy / brave://policy) → click Reload policies to confirm AutomaticFullscreenAllowedForUrls is active with status OK.

Surface Control layers

Add Surface Control from the clip's layer icon (free). Gate or dim surfaces, chase/strobe/alternate across screens, color overlay and invert. Edge looks: Flames, Pulse Lines, Moving Lines, Neon Glow, Laser Trace — width, color, speed, frequency, and blend (Normal / Add / Screen / Multiply). Keyframable.

Surface Control shows on Screen previews, 3D Stage previews (orbit and cinematic), mapper TDM output, and launched output windows. The flat Master mix does not dim or edge individual surfaces — switch the preview target to Screen or 3D Stage to see it.

Bus O on a surface

Set a channel to bus O, then in the inspector Output Routing pick a mapped surface (and a blend). That channel draws only on that surface. Choose On top of all channels to put it over the whole mix instead. Turn on mapper TDM output to preview; output windows and 3D Stage match.

Master / Screen / 3D Stage preview

The Editor master preview, Monitor center tile, and Auto VJ composite each remember their own preview target: Master (flat mix), a Screen, or 3D Stage (drag to orbit). Screen and 3D Stage include Surface Control and Bus O surface overlays.