# OAK Viewer See what your OAK camera sees, live. No code needed. Plug in your camera, pick a pipeline, and watch depth, 3D point clouds, and AI detections in real time. Compare stereo and neural depth on your own scene, tune every setting, recalibrate, and keep your camera up to date, all from one app. It works with every RVC2 (OAK) and RVC4 (OAK4) device, over USB or Ethernet. ## Download #### Linux > **Note** > Debian packages are available for Ubuntu 24.04 / 22.04, supporting x86_64 (AMD64) and ARM64 (AArch64) architectures. OAK Viewer 4.2.8 for Ubuntu 24.04 / 22.04 [Download for Ubuntu (x86_64)](https://oak-viewer-releases.luxonis.com/data/4.2.8/debian_x86_64/viewer.deb)[Download for Ubuntu (ARM64)](https://oak-viewer-releases.luxonis.com/data/4.2.8/debian_arm_64/viewer.deb)> **ARM64 development build** > The Ubuntu ARM64 (AArch64) package is a development build. Reach out to us at [support@luxonis.com](mailto:support@luxonis.com) if you encounter any issues. #### macOS > **Note** > Viewer is available for macOS 12 and later, supporting both ARM (Apple Silicon) and x86_64 (Intel) architectures. OAK Viewer 4.2.8 for macOS 12+ [Download for Apple Silicon (ARM64)](https://oak-viewer-releases.luxonis.com/data/4.2.8/macos_arm_64/Viewer.dmg)[Download for Intel Mac (x86_64)](https://oak-viewer-releases.luxonis.com/data/4.2.8/macos_x86_64/Viewer.dmg) #### Windows > **Note** > Please note that you can get warning from Microsoft Defender. Viewer is available for Windows 10/11, supporting the x86_64 (AMD64) architecture. OAK Viewer 4.2.8 for Windows 10/11 [Download for Windows (x86_64)](https://oak-viewer-releases.luxonis.com/data/4.2.8/windows_x86_64/Viewer.msi) ## Connecting a device When OAK Viewer starts, the Dashboard lists every OAK device it can find over USB and Ethernet. Each device card shows the platform (RVC2 or RVC4), OS version, power state, and connection. Click Connect to open the device. You can also switch devices at any time from the selector in the top bar. If your device isn't listed (for example, it's on a different subnet), open the device selector and choose Add Custom IP. See [Troubleshooting](#Troubleshooting) if the device still doesn't appear. While connecting, the Viewer measures the bandwidth between your computer and the camera. It then opens the best pipeline the device supports and your connection can sustain. For a depth-capable OAK4 that is usually Neural Assisted 3D. ## Pipelines The Pipelines section of the sidebar is the main way to use OAK Viewer. Each pipeline is a ready-made DepthAI pipeline built for one task. The Viewer shows only the pipelines your device supports. Hover over a pipeline to see what it does. | Pipeline | What it's for | Devices | | --- | --- | --- | | Stereo 3D (called Vision 3D in earlier versions) | Depth from classical stereo matching, plus a colored point cloud | Stereo devices | | Neural 3D | Depth from the on-device neural stereo model (LENS), plus a point cloud | Stereo RVC4 devices | | Neural Assisted 3D | Neural depth fused with classical stereo into one dense depth map | Stereo RVC4 devices | | Vision ToF | Depth and point cloud from the Time-of-Flight sensor | ToF devices | | Vision AI | A neural network running on the color camera, with annotations on the video | All devices | | Dynamic Calibration | Check calibration quality and recalibrate the stereo pair | Stereo devices | | Advanced | Every stream, configurable stereo depth, a selectable model, and device sensors | Devices with a color camera | | FFC Calibration | Initialize and refine extrinsics for overlapping camera groups | OAK4 FFC | | Panorama | Compose overlapping camera views, with stitching controls | Devices with overlapping cameras | | High Resolution | Inspect high-resolution camera output | Supported devices | ### Depth pipelines OAK Viewer lets you compare all depth methods side by side on your own scene. Switch between the depth pipelines while pointing the camera at the same view. * Stereo 3D computes depth with the stereo hardware block of the device, using the calibrated left and right cameras. On devices with an IR dot projector, the projector is enabled to add texture to plain surfaces. To tune the stereo algorithm itself, use the Advanced pipeline. * Neural 3D replaces classical matching with [LENS (Luxonis Edge Neural Stereo)](https://docs.luxonis.com/software-v3/depthai/depthai-components/nodes/neural_depth.md), a neural network that runs fully on the device. It handles low-texture surfaces, repetitive patterns, reflections, and difficult lighting much better than classical stereo. In Configure → Models you can choose the model size, which trades resolution for frame rate: * Large: 768x480 (default) * Medium: 576x360 * Small: 480x300 * Nano: 384x240 Under Neural Depth Configuration you can also adjust the Confidence Threshold and Edge Threshold (both from 0 to 1) to filter out uncertain pixels. A higher confidence threshold removes more incorrect points but leaves more holes. Threshold changes apply to the running pipeline, while changing the model rebuilds it, so let the streams restart before comparing results. Neural depth can still produce incorrect geometry, such as filling regions that should have no valid depth, so check both the depth map and point cloud around small objects and distant backgrounds. * Neural Assisted 3D uses [Neural Assisted Stereo](https://docs.luxonis.com/software-v3/depthai/depthai-components/nodes/neural_assisted_stereo.md): a small neural depth model guides the classical stereo block. You get the robustness of neural depth with the full-resolution detail and accuracy of stereo, which makes it a good general-purpose choice, for example for bin picking or object dimensioning. The preset uses the Nano neural model at a target of 30 FPS, and its model and thresholds are fixed. To change them, use Neural 3D. * Vision ToF uses the Time-of-Flight sensor on ToF-equipped devices. In Configure → ToF you can choose the Low Range, Mid Range, or High Range preset. > **Neural depth requires OAK4** > Neural 3D and Neural Assisted 3D run only on RVC4 (OAK4) devices with a calibrated stereo pair, running Luxonis OS 1.45.0 or later. They don't appear in the sidebar for RVC2 devices. To compare the depth methods in more detail, see the [Depth overview](https://docs.luxonis.com/overview/toplevel-features/depth.md). All depth pipelines show a Point Cloud panel, computed in the Viewer from the depth and color streams. Use the Maximum Distance slider in the depth panel to cut off the background. ### Vision AI Vision AI runs a neural network on the main color camera and draws its output on the video. Use Swap Model in the header to choose a different model. You can also adjust its parameters, such as Confidence Threshold, IoU Threshold, Maximum Detections, and which Labels to show. The available models cover object detection (YOLOv6 nano, COCO classes), pose estimation (YOLOv8 nano pose), face detection (YuNet), monocular depth (MiDaS v2), and open-vocabulary detection (YOLO-World, RVC4 only). > **Custom models cannot be uploaded in OAK Viewer** > OAK Viewer supports only a selected subset of Luxonis Models Zoo models. Users cannot upload custom models or run models outside that subset. See the [Use custom models on HubAI](https://docs.luxonis.com/cloud/tutorials/use-custom-models-on-hub-ai.md) tutorial. ### Dynamic Calibration Stereo depth relies on an accurate calibration between the left and right cameras. Mechanical shocks and temperature changes can shift that calibration over time. The Dynamic Calibration pipeline [recalibrates](https://docs.luxonis.com/software-v3/depthai/depthai-components/host_nodes/dynamic_calibration.md) the device using the natural scene in front of it, so no calibration target is needed. 1. Open Dynamic Calibration and click Check Calibration. The Calibration Details panel shows the current calibration quality: Good, Improve, or Recalibrate. 2. If needed, click Recalibrate. Slowly sweep the camera across a scene with texture across the whole field of view and even lighting, until the coverage grid is filled. 3. The new calibration is flashed to the device automatically. You can switch back to the Factory or Previous calibration at any time. All OAK Series 2 stereo devices (excluding FFC) and OAK Series 4 stereo devices are supported. OAK4 FFC is supported through the [FFC Calibration](#FFC%20Calibration) pipeline. [Learn more about Dynamic Calibration.](https://discuss.luxonis.com/blog/6346-dynamic-calibration-keeping-stereo-depth-accurate) ### FFC Calibration On OAK4 FFC devices, the FFC Calibration pipeline lets you initialize and refine the extrinsics of overlapping camera groups. For assembly and calibration steps, see [OAK4 FFC Getting Started](https://docs.luxonis.com/hardware/platform/deploy/oak4-ffc-getting-started.md). ### Advanced The Advanced pipeline combines everything in one place: the camera streams, configurable stereo depth and point cloud, a selectable neural network, and the available device sensors (IMU, thermal, and IR projectors). Use it to explore and fine-tune the full device. In Configure → Advanced you can choose a stereo depth preset (Default, Robotics, Face, High Detail, Fast Density, Fast Accuracy) and adjust individual stereo filters, such as the spatial, speckle, temporal, and median filters, or the left-right check. For what each setting does, see [Configuring Stereo Depth](https://docs.luxonis.com/hardware/platform/depth/configuring-stereo-depth.md). ### Why is a pipeline disabled? Each pipeline needs a minimum bandwidth between your computer and the camera. When the measured bandwidth is too low, the pipeline is shown with a warning icon and can't be selected. Its tooltip shows the measured speed. To measure again, for example after you change the cable, click the refresh button next to the pipeline list. | Pipeline | Approximate bandwidth required | | --- | --- | | Stereo 3D, Neural Assisted 3D | 690 Mbps | | Neural 3D | 580 Mbps | | Dynamic Calibration | 500 Mbps | | Vision ToF, Advanced | 400 Mbps | | Vision AI | 95 Mbps | A USB 2.0 connection is not enough for the depth pipelines. Use a USB 3 cable and port (USB 3.1 with 10 Gbps for the best results), or a gigabit Ethernet connection. ## Working with streams The Streams tab shows the live output of the current pipeline, one stream per panel. The Pipeline tab shows the DepthAI pipeline the Viewer built for it: every node, its parameters, and the connections between nodes. This is a good starting point if you want to recreate the same pipeline in your own DepthAI code. The header above the panels gives you: * Configure: the settings available for the current pipeline. Depending on the pipeline, these are grouped into Sensors (resolution, FPS, maximum distance), Preview, Advanced (stereo depth), Calibration, Models (neural depth), and ToF. * Swap Model: choose and configure the neural network (Vision AI and Advanced). * Streams: show or hide individual streams, including the point cloud. * Performance Metrics: show frame rate and throughput on every panel. ### Stream panel Each panel shows the stream name and resolution. With performance metrics turned on, it also shows: * Target: the frame rate requested by the configuration. * Network: the frame rate received by the browser for this stream. * Decode: the frame rate decoded into renderable data. * Render: the frame rate drawn by the panel. * Throughput: the network data received for this stream. This doesn't include traffic between DepthAI and the device. From the panel menu you can toggle annotations, move the panel, switch to fullscreen, or close the stream. ## Device management Use the device card on the Dashboard, or the sidebar while connected, to manage the device: * OS updates (RVC4): when the device runs an older Luxonis OS than the Viewer requires, the Viewer offers to update it. You can also check for an update from the device card. * Bootloader updates (RVC2): the Viewer prompts you to update an outdated bootloader on Ethernet devices. * Luxonis Hub (RVC4): Set Up, Add To Hub, or Change Hub Team to manage the device remotely. See [Connect OAK to Hub](https://docs.luxonis.com/cloud/hub/connect-oak.md). * App Store (RVC4): browse and install OAK Apps on the device. * Power status (RVC4): the device card shows Full Power (PoE+ or USB-C Power Delivery) or Limited Power (15 W budget). Heavier pipelines can make a device on limited power disconnect. * Motion Stats: live IMU data, available in Stereo 3D and Advanced. * Logs: view and download the Viewer logs. Attach them when you report an issue on [Discuss](https://discuss.luxonis.com/) or to support. You can switch between light, dark, and system theme, and between metric and imperial units, from the menu in the top-right corner. ## Desktop app and OAK4 default app > **Note** > All Viewer features work only in Chrome. The desktop app includes a bundled Chrome browser. The web version can be opened in any browser, but with some limitations. All browsers support RAW streams. Encoded streams, and the features based on them, work only in Chrome, because they need the full [WebCodecs API](https://developer.mozilla.org/en-US/docs/Web/API/VideoDecoder). You can run OAK Viewer as a desktop app on your computer, or as the default app installed on an OAK4 device during setup. Both provide the same pipelines. The default app works only with the device it runs on. The desktop app can connect to any OAK camera it can reach over Ethernet or USB, and adds device management features such as OS updates, Hub setup, and the App Store. The desktop app streams from its local backend over WebSocket, so it is limited only by the speed of your connection to the camera. The OAK4 default app can be opened in two ways: * Directly on the device, usually at `https://:9000`. If another app is already using that port, `9001` is used instead. Check the application logs for the exact URL. A self-signed certificate is needed for the encoded streams to work. * Through remote access, over WebRTC. The theoretical throughput is around 400 Mbps on a local network, and lower over the internet, depending on your connection. The URL looks like `https://viewer.luxonis.app/1.2.1/?t=xxxx`. You can find it in the application logs, or open the Viewer remotely from Luxonis Hub. > **Note** > The remote access URL is valid for only 15 minutes and is then regenerated. An open Viewer refreshes automatically, but you can't bookmark the URL. ## Troubleshooting ### Device is not listed > **Device visible in oakctl, missing in OAK Viewer** > `oakctl list` and OAK Viewer can disagree on some networks. `oakctl` discovery uses mDNS, while DepthAI discovery used by OAK Viewer depends on local network broadcast behavior. 1. Update to the latest versions: * Run `oakctl self-update` on the host. * Run `oakctl device update` for the camera. 2. Verify the host and camera are on the same subnet and that broadcast traffic is not blocked on your network. If they are on different subnets, connect with Add Custom IP. 3. Check firewall rules on the host (on Ubuntu, `ufw` blocks discovery by default): * Allow `11491/udp` for discovery. * Allow `11490/tcp` for XLink connection. 4. On OAK4 devices, make sure DepthAI Peripheral Mode is enabled (see [device setup options](https://docs.luxonis.com/cloud/hub/connect-oak.md)). Without it, `oakctl` can see the device, but DepthAI and OAK Viewer can't connect to it. 5. Disable VPN temporarily and test again. 6. If the host has multiple interfaces (for example Wi-Fi and Ethernet), set routing so the camera subnet is reached through the correct interface. For USB devices, open the device selector and choose USB Device Troubleshooting. ### Connection is too slow If the Viewer reports Insufficient USB speed or Bad Connection, the link to the camera is too slow for the pipeline. Connect the camera to a USB 3 port with a USB 3 cable (avoid hubs and long passive extensions), or use gigabit Ethernet. See [Why is a pipeline disabled?](#Why%20is%20a%20pipeline%20disabled%3F) ### Not enough power If the Viewer reports Not enough power or Limited power, the device can't sustain the selected pipeline: * RVC4: use USB-C Power Delivery (15 W minimum, 30 W recommended) or PoE+ (802.3at, 30 W). * RVC2: use a USB Y-adapter to provide additional power. ### Application already running Only one application can use a device at a time. If the Viewer reports Application already running, close the other application, including other open Viewer windows. On OAK4, the desktop app can stop the running OAK App for you when you choose Continue to Viewer. ## Release Notes ### Version 4.2.8 (October 27, 2026) * Added FFC support with a camera extrinsics editor, stereo pair selection, and Dynamic Calibration for overlapping camera groups. * Added Panorama and High Resolution pipelines. Panorama includes seam finders, view controls, and stitching settings. * Improved device startup and added device health checks. RVC4 devices now require Luxonis OS 1.45.0 or later. * Fixed RVC2 stereo settings and Neural Depth thresholds to apply without pipeline restarts, and preserved Neural Depth settings across pipeline rebuilds. * Fixed camera view refresh and depth distance readouts. ### Version 4.1.6 (September 24, 2026) * Default Neural Depth FPS increased for all models ### Version 4.1.5 (September 18, 2026) * Performance improvements across the board * Significant stability improvements * Overhauled OS update flow (RVC4) * Power status handling (RVC4) * macOS releases now use DMG installers * UI/UX improvements ### Version 3.9.8 (September 1, 2026) * Added support for bootloader updates on RVC2 devices * Added support for updating Luxonis OS on multiple RVC4 devices * Added support for Ubuntu on ARM platform * * UI/UX improvements ### Version 3.8.2 (August 12, 2026) * RVC4 ToF support * Includes oakctl 0.27.1 to support newest devices and features * Dark mode * UI/UX improvements ### Version 3.7.0 (July 20, 2026) * Point Cloud Alignment fixed * OAK D SR fixed * Updated legacy frontend dependencies * Rendering performance & responsiveness optimization ### Version 3.2.1 (June 8, 2026) * Backported DepthAI version due to Windows and Mac issues. * Reverted Point Cloud Alignment fix due to Windows and MacOS issues. ### Version 3.2.0 (June 8, 2026) * Fixed Windows and MacOS start device issues. ### Version 3.0.2 (June 5, 2026) * Improved performance across the board. * Improved point cloud precision & responsiveness. * Improved error state handling, including cases where the app is already running or the device is offline. * Fixed device disconnect handling. * Added detection of insufficient device power. * Several bug fixes and UI/UX improvements. ### Version 2.5.2 (June 2, 2026) * Improvements to stability and bugfixing. ### Version 2.5.1 (May 27, 2026) * Fix crashes when running with hardware acceleration enabled on macOS and Windows. * Fix `oakctl` dependencies on Windows. * Improve error handling during OS update. * Improve error handling for cameras without a color sensor. ### Version 2.4.11 (May 25, 2026) * RVC4 USB support * Initial TOF support (RVC2 only) * Expanded device support * Stability improvements * Neural Assisted Stereo (RVC4 only) ### Version 1.6.3 (December 18, 2025) * Includes oakctl 0.17.0, with more robust handling of device setup and adoption to Hub. * Includes DAI 3.2.1 and DAI Nodes 0.3.6. * Improvements to OTA update flows. * Improved stream and annotation rendering performance. * Error toasts are now properly displayed when configuration changes fail. * Moved the distance slider to the top-right corner. * Added a link to USB camera troubleshooting documentation. ### Version 1.5.53 (December 8, 2025) * Full support for OAK 4 device setup and adoption to Luxonis Hub, including migration to a different team when the device is already in Hub. * Fixed video encoder issues on Windows, resolving green stripe artifacts. * Fixed issues with loading information about connected devices. * Fixed connection issues when multiple devices are present. * Improved UI responsiveness across different resolutions and corrected the positioning of info toasts. * Corrected Flood Light and Dot Projector badges for OAK 4 D. * Improved Neural Depth configuration. * Includes Visualizer 2.68.8 (Improved responsiveness, Better NV12 decoding, Ability to change the point cloud camera). * Fixed the toast shown when another application is already running on OAK 4.