Osmo Webcam

SETUP GUIDE

Start with a clear view.

Connect your camera and save the presets you use. Controls prepare automatically.

1. Install the desktop app

Download the DMG from the official releases page. Open Osmo Webcam and choose Install for This User. The app installs in ~/Applications/Osmo Webcam.app. Subsequent updates use About → Update & Restart.

If you have the earlier Pocket Control development app, quit it and move its app bundle to Trash before running the new installer. Keep your private data folders intact. Existing presets and credentials use the same storage.

2. Connect USB and choose a preview

  1. Connect a standard Pocket 4 by USB in webcam mode. This release targets Apple Silicon, macOS 26+ and firmware 01.03.14.04.
  2. Open Settings → Camera and connect the discovered camera. Controls work independently of OBS and preview.
  3. For preview without OBS, select Pocket camera · USB and choose Enable Preview. Allow macOS camera access when requested.
  4. If OBS is capturing the camera, start OBS Virtual Camera and select that source in Osmo Webcam instead. If macOS reports the Pocket as in use, release the other capture or choose OBS Virtual Camera.

Preview is off until enabled. Disconnect stops preview and clears the image; reconnect leaves it off. Preview does not record or upload video.

3. Start with ready controls

Controls become Ready automatically after connection, app restart and camera reconnection. Keep the camera fixed, turn tracking off and leave a clear movement path. There are no setup names or confirmation checkboxes. Preparing controls does not move the camera.

Existing presets, camera limits and motion preferences are retained. Motion profiles are available in Settings → Motion. Experimental profiles retain their documented limits; reported positions do not prove physical clearance, arrival or immediate stop.

4. Save your first preset

Choose the always-first Add Preset card to capture the current framing, then enter a name and transition. Each camera can hold twenty presets. The preset editor offers separate pan/tilt and zoom speeds, or you can inherit the app defaults. Selecting another preset replaces an ongoing recall.

Click a card or list item to show its details. Open Preset tools → Export to save a JSON backup, or Import to review an existing export before applying it. Press Escape in the app to cancel movement scheduling.

Stream Deck

  1. Use Stream Deck 6.6 or later. Open Osmo Webcam → Integrations → Stream Deck and choose Install Stream Deck plugin. The app provisions its dedicated local Control credential before opening the bundled installer.
  2. If you installed the plugin from official downloads separately, choose Connect Stream Deck in the app once. No token entry is needed in Stream Deck.
  3. Add an Osmo Webcam Recall Preset action and choose the actual preset name from its dropdown. The binding follows that preset through renaming and reordering. Deleted presets do not fall back to another view.
  4. Add Pan / Tilt or Zoom actions and choose a direction. Hold to move and release to stop scheduling. These controls can overlap. Recenter uses the guarded USB default; a separate Stop key is optional for cancelling recalls or held controls.

The app manages camera readiness. Revoke access in Settings → Integrations → Client access. After revocation, choose Connect Stream Deck explicitly to pair again. Credentials stay outside shared action/profile settings. Update the plugin separately using its compatible direct installer.

Other local software

Open Integrations → HTTP requests for copy buttons covering request URLs, method, headers, bodies and complete curl examples. The optional local HTTP bridge exposes twenty preset slots and handles the recall lease. It is a separate service; opening the guide does not install or start it.

For direct API v1 access, the guide can create a named client and copy status, preset and Stop examples. Readiness, reference checks and motion leases still apply. Keep credentials private; never put them in a URL or shared profile.

Updates, recovery and quitting

The app can check and download updates automatically. Installing requires Update & Restart. Updates preserve saved state and prepare controls automatically after reopening. If installation is interrupted, reopen the installed app and follow recovery; do not start extra app copies or remove lock files.

Restart and reconnection require no setup confirmation. Preview stays off until you enable it. Interrupted movement is never replayed.

Closing the window leaves the local agent running. Choose Quit Osmo Webcam to stop the agent. Get help with setup or recovery →