NearField

Docs And How-Tos

Build a reliable NearField path before showtime.

Start here for setup, network planning, browser clients, NDI input, licensing, and the checks that make remote monitoring feel boring in the best possible way.

Quick Start How-To Library Troubleshooting

First Run

Quick Start

Use this flow for a first local test or a clean production prep pass.

1

Install and open NearField

Download the latest release, open the DMG, move NearField to Applications, and complete macOS permission prompts for camera, microphone, local network, and speech recognition if you use transcript tools.

2

Start a server

Choose Server mode, select program audio, comms input, tie-line output, and video input, then start the session. The server publishes native and WebRTC paths based on the selected options.

3

Connect a client

Choose Client mode on another machine, enter the server endpoint, select output and talkback devices, then connect. Keep server and client versions matched whenever possible.

4

Validate before relying on it

Confirm program audio, comms, talkback return, video, LUFS, latency, and recording behavior in the actual network environment you plan to use.

Access

Licensing And Demo Mode

NearField can be evaluated before purchase, then activated when you are ready to use licensed features.

Internet is required to activate a license. NearField needs to reach the licensing service for first activation, device deactivation, and periodic validation refreshes. If the licensing service or your internet connection is temporarily unavailable after a successful validation, NearField uses the last valid license and enters Offline Grace for up to three days so production work is not interrupted by a service outage.

Demo Mode

Use Demo Mode to test routing, devices, permissions, and network behavior before subscribing. Demo Mode may limit server session duration or licensed features.

License Delivery

After purchase, the license key is sent to the checkout email from no-reply@nearfield.ch. Use that same email for the Licensing Portal.

Offline Grace

When Offline Grace is active, the app warns you and shows the remaining grace time. Reconnect to the internet before the grace window expires so NearField can refresh validation.

Device Seats

Each subscription includes two native macOS activations unless checkout or a written agreement says otherwise. Browser clients do not consume native activations.

Revoked Access

Offline Grace is for licensing-service outages or temporary connectivity problems. If a license is revoked or a device is deactivated from the portal, new sessions require a valid activation.

Venue Side

Server Setup

The server is the machine connected to production audio, comms, and video sources.

Inputs To Confirm

  • Program left/right audio source.
  • Comms input source.
  • Tie-line output for client talkback return.
  • Camera, capture card, NDI source, or audio-only mode.
  • Sample rate and device buffer size on the audio interface.

Useful Server Options

  • Use hot encode when clients need to switch video feeds or profiles quickly.
  • Use fixed encode when you want one efficient video profile and lower server load.
  • Enable WebRTC publish when browser clients or WebRTC native preview are needed.
  • Select audio-only when no video path should be published.

Remote Side

Native Client Setup

The native client is the main workflow for mix-critical monitoring, control-room tools, and diagnostics.

Audio Monitoring

Select the monitor output before connecting. Program and comms use independent receive paths so the client can adapt to jitter without tying every stream to the same buffer behavior.

Talkback

Select a talkback input and use Hold, Latch, or Auto mode. Keybinds work across NearField windows when a NearField window is focused.

Multiview

Open Multiview when you need additional feeds, LUFS radar, meters, stats, or transcript tiles. The main monitor pauses while Multiview is active to save bandwidth.

WebRTC

Browser Client

Browser clients are useful when installing the native app is not the right move.

Browser clients do not consume native app activations. They still need a reachable server path and browser permissions for audio output selection and talkback input when those features are used.

When To Use It

  • Quick review from a trusted browser.
  • Low-friction monitoring for additional listeners.
  • WebRTC multiview without installing the native client.

What To Check

  • Use HTTPS for non-localhost browser access.
  • Confirm browser audio output and talkback input selection.
  • Watch WebRTC audio/video stats if a path feels unstable.

Network Path

Networking And VPN Notes

NearField keeps media point-to-point. You provide the route between server and client.

Supported VPN Visibility

NearField can detect and surface useful endpoint information for Tailscale, ZeroTier, NetBird, and other local interfaces when their tools are available.

Production Checklist

  • Confirm server and client can ping or otherwise reach each other.
  • Copy the correct VPN or interface IP from the NearField UI.
  • Test over the same Wi-Fi, wired, VPN, or cellular path expected during the show.
  • Prefer wired network paths for the venue/server machine when possible.

Video Input

NDI Input

NearField can use NDI sources as server-side video inputs when the app-local runtime is available.

NDI® is a registered trademark of Vizrt NDI AB. Learn more at ndi.video. Source discovery depends on the network interface, local firewall behavior, and NDI source availability.

Setup Notes

  • Choose the correct NDI network interface on the server side.
  • Confirm the source appears in discovery before starting a session.
  • If discovery looks stale, refresh sources or restart the NDI sender.

When Preview Looks Wrong

If a source resolution or frame rate looks misleading, switch away and back, refresh discovery, then validate the published client view before show use.

Video Slots

How-To Library

These are structured placeholders for the walkthrough videos we can add as you record them.

Video Coming Soon

Run a local two-app test

Validate program audio, video, comms, talkback, and latency on one Mac before testing over a network.

Video Coming Soon

Connect over Tailscale, ZeroTier, or NetBird

Pick the right endpoint IP and validate reachability before you start troubleshooting media.

Video Coming Soon

Set up browser monitoring

Enable WebRTC publish, open the browser client, choose audio devices, and verify the stats drawer.

Video Coming Soon

Use Multiview and LUFS radar

Build a custom multiview with feeds, meters, transport stats, transcript tiles, and loudness views.

Video Coming Soon

Record a client session

Save a session, record program and comms, and find the resulting files in the session folder.

Video Coming Soon

Troubleshoot no audio or no video

Use health cards, stats, device selection, permissions, and route checks to isolate the issue quickly.

Debug Faster

Troubleshooting Checklists

Start with the boring checks. They save the most time.

No Connection

  • Confirm both machines are on the expected VPN or network.
  • Check the endpoint IP and port shown in the server top bar.
  • Make sure macOS local network permission has been granted.
  • Keep server and client versions matched.

No Audio

  • Confirm the selected audio device still exists.
  • Check program and comms meters on the server first.
  • Check client output device and mute states.
  • Use stats to separate packet gaps from device underruns.

No Video

  • Confirm the server preview sees the selected source.
  • Check whether video is disabled or paused for Multiview.
  • Try WebRTC and native preview paths separately.
  • For NDI, confirm the source is still discoverable.