Files
onepilot/tools/webcam
github-actions[bot] 54e6124925 sunnypilot v2026.05.07-4485
version: sunnypilot v2026.001.000 (dev)
date: 2026-05-07T23:07:19
master commit: c28eb958740187620f2282023b8f1997cf90f583
2026-05-07 23:07:19 +00:00
..
2026-05-07 23:07:19 +00:00
2026-05-07 23:07:19 +00:00
2026-05-07 23:07:19 +00:00

Run openpilot with webcam on PC

What's needed:

  • Ubuntu 24.04 (WSL2 is not supported) or macOS
  • GPU (recommended)
  • One USB webcam, at least 720p and 78 degrees FOV (e.g. Logitech C920/C615, NexiGo N60)
  • Car harness
  • panda
  • USB-A to USB-A cable to connect panda to your computer

Setup openpilot

  • Follow this readme to install and build the requirements

Connect the hardware

  • Connect the camera first
  • Connect your computer to panda

GO

USE_WEBCAM=1 system/manager/manager.py
  • Start the car, then the UI should show the road webcam's view
  • Adjust and secure the webcam
  • Finish calibration and engage!

Specify Cameras

Use the ROAD_CAM (default 0) and optional DRIVER_CAM, WIDE_CAM environment variables to specify which camera is which (ie. ROAD_CAM=1 uses /dev/video1, on Ubuntu, for the road camera):

USE_WEBCAM=1 ROAD_CAM=1 system/manager/manager.py