Support & FAQ
Getting started with Camera Bridge OS
You need a small PC (see computers that run it), a USB stick, and for HomeKit Secure Video recording a home hub (Apple TV or HomePod) and an iCloud+ plan.
- Download Camera Bridge OS from the Download page and write it to a USB stick with a tool such as balenaEtcher. Everything on the stick is erased.
- Plug the PC into your router (or see Wi-Fi below), insert the stick and start the PC from it using its boot menu. If it won't start from the stick, turn Secure Boot off in the PC's firmware settings.
- On any phone, tablet or computer on the same network, open http://camera-bridge.local and choose an administrator password right away.
- In System, install Camera Bridge OS to the PC's own disk. When it is done, remove the stick and start the PC again. After that it needs no keyboard or screen.
- Add your cameras: the box finds ONVIF cameras on your network, or add one by address. Use Test before saving.
- Show a camera's pairing code on its page and scan it with the Home app on your iPhone, then turn on recording in the camera's settings in Home.
Setting up Wi-Fi
With a network cable the box needs no setup. Without one:
- The setup network. With no network it knows, the box opens its own Wi-Fi, named CameraBridge-XXXX. Join it with a phone and a page asks which Wi-Fi to use.
- A file on the USB stick. Before the first start, add a text file named
camera-bridge-wifi.txtto the stick with the linesnetwork=andpassword=. - Later, in System › Wi-Fi on the web page.
The earlier Camera Bridge for Mac
If you installed the earlier Camera Bridge for Mac, it keeps working. It gets no new versions for now, and a new Mac version is coming. Need a hand with it? Email us.
Moving from the earlier Camera Bridge for Mac
- In Camera Bridge for Mac, open Settings › Backup › Export and save the file.
- On the box's web page, open Settings › Move from Camera Bridge for Mac, choose the file and type the cameras' passwords. Cameras keep their settings, and importing the same file again adds nothing twice.
- When the cameras run on the box, let the Mac app hand over with Move to Camera Bridge OS (or quit it), add the box in the Home app and remove the Mac's bridge from Home.
Updates
Camera Bridge OS installs signed updates from the System page, or by itself if you turn on automatic updates. If a new version doesn't start properly, the box goes back to the previous one by itself.
Creating an ONVIF user
Many cameras keep ONVIF users separate from the web admin account, so the password you use on the camera's web page may not work for ONVIF.
- Open the camera's web page and sign in.
- Find the ONVIF settings. The menu name varies: look under Network → Advanced Settings, Integration Protocol, Platform Access or Server Settings.
- Make sure ONVIF is enabled, then add a user (Administrator or Operator).
- Use that user in Camera Bridge.
Some cameras are set up from a phone app instead. Look in the app's advanced settings for a Camera Account or Device Account, create a user name and password there, and use those (not your cloud account) in Camera Bridge.
Many cameras lock out logins after several wrong passwords. If that happens, Camera Bridge pauses ONVIF logins to that camera for up to 30 minutes and shows when it will try again.
Why isn't recording working?
- HomeKit Secure Video needs a home hub (Apple TV or HomePod) and an iCloud+ plan.
- Check the camera's recording options in the Home app.
- Check the camera's keyframe interval: a long one is the most common cause of missing clips. About 4 seconds or less is best (see camera compatibility).
Is Camera Bridge free?
Yes, for personal and noncommercial use. Businesses and installers need a commercial license; see License.
Does any video go to Corey Silvia?
No. Camera Bridge OS keeps its recordings on the box, and nothing goes to a cloud of ours. See the Privacy Policy.
Still stuck?
Email me@coreysilvia.com with your camera's make and model and what the checklist shows. Please don't send passwords.