Camera FFmpeg
@homebridge-plugins/homebridge-camera-ffmpeg · v4.1.0
Adds generic IP/RTSP cameras to HomeKit using FFmpeg, with motion, doorbell and HomeKit Secure Video.
What it says it supports
Devices it names
- IP cameras
- RTSP cameras
- doorbell cameras
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Works with most RTSP IP cameras given tuned ffmpeg config; Apple TV/iPad are picky and Pi cameras and Reolink are flaky.
- Works5
- Partly works7
- Not working2
| Device | Status | What they said | Source |
|---|---|---|---|
| Amcrest IP2M-842E PoE camera | Works | Tested working on iOS 14.1 and tvOS 14.3; config addedSaved copyManufacturer/Model: Amcrest IP2M-842E POE outdoor bullet camera Homebridge Config: [code] Additional Information: Based on the Amcrest IP4M-1026 configuration, slightly modified for this specific camera. The streaming appears to be working on iOS 14.1 and tvOS 14.3. Works on a headless Ubuntu server with those specs, but may want to dial the values down to make it work on a Raspberry Pi e.g.: [code] Excerpt saved from GitHub on 2026-10-22. | Issue #919 · 2020-12 |
| Amcrest IP5M-T1277EW-AI | Works | Works with unbridge config and RTSP sourceSaved copyDid anyone got the Amcrest IP5M-T1277EW-AI to work with camera-ffmpeg . I am trying this config, but it will not popup in HOME, [code] I also dont see any errors: Excerpt saved from GitHub on 2026-10-22. | Discussion #1442 · 2024-04 |
| Eufy 2K camera | Works | Works with -rtsp_transport tcp added to sourceSaved copyHello, I have a problem with some EUFY cameras, I have followed every possible way to solve the problem, but I do not understand where I am wrong. Basically I have these errors all the time: [3/20/2021, 5:06:41 PM] [Camera FFmpeg] [Soggiorno CAM] [Snapshot] [rtsp @ 0x7ff63c888700] method SETUP failed: 461 Unsupported transport [3/20/2021, 5:06:41 PM] [Camera FFmpeg] [Garage CAM] [Snapshot] [rtsp @ 0x7fefbbb5e700] method SETUP failed: 461 Unsupported transport [3/20/2021, 5:07:12 PM] [Camera FFmpeg] [Garage CAM] [Snapshot] [rtsp @ 0x7f5650fba700] method SETUP failed: 461 Unsupported transport … Excerpt saved from GitHub on 2026-10-22. | Issue #1083 · 2021-03 |
| Foscam C1 | Works | Streaming stopped due to wrong IP in config; fixedSaved copyToday I noticed my snapshots stopped working and had to remove and add the cameras again to get them working. When I click one of my cameras I get the following error and streaming does not start: [code] I am using the latest official homebridge docker container: ffmpeg version integrated: [code] Any idea what is causing it to fail? Excerpt saved from GitHub on 2026-10-22. | Issue #1246 · 2022-01 |
| Techage 2MP PoE camera | Works | Tested config added; one-way audio worksSaved copyManufacturer/Model: Techage 2MP PoE NVR kit. Cheap and very reliable across multiple installs with Homebridge running on Raspberry Pi 3B and 4. Purchased from official Techage store on AliExpress. Link I have only tested the 2MP H264 (older) and H265 (newer) PoE cameras (grey cylindrical body). I haven’t tested wifi cameras or the 5MP cameras. One way audio works. Homebridge Config: Partial config showing camera info: [code] Additional Information: These cameras can upload snapshots on motion detect directly to a FTP server. I’ve used vsftp as the FTP server on the Pi. To set up, log into the … Excerpt saved from GitHub on 2026-10-22. | Issue #857 · 2020-10 |
| Amcrest AD410 doorbell | Partly works | Video works; no motion or doorbell notifications reach HomeKitSaved copy… this model. The config below was copied from a AD110, the camera feed works, but no notifications. Even in debug mode, I see no activity for motion or doorbell in Homebridge. And get no notifications in Homekit. If I trigger these via the Homebridge UI, I see the notifications, so it seems that Homebridge is not seeing these activities from the doorbell. Any tips? { "name": "Front Door", "manufacturer": "Amcrest", "model": "AD410", "serialNumber": "XXXXXXXXXXXXX", "motion": true, "doorbell": true, "switches": true, "motionDoorbell": true, "unbridge": true, "videoConfig": { "source": "-i … Excerpt saved from GitHub on 2026-10-22. | Issue #1317 · 2022-07 |
| Dahua-style RTSP camera (Synology) | Partly works | Only still frames; live view worked via Synology Surveillance StationSaved copy… same effect: only stills and no streaming log: ---------------- [11/4/2019, 7:15:15 PM] Homebridge is running on port 51826. [11/4/2019, 7:15:36 PM] [Camera-ffmpeg] Snapshot from Voordeur at 480x270 ffmpeg -re -i rtsp://syno:[email protected]:554/Sms=23.unicast -t 1 -s 480x270 -f image2 - [11/4/2019, 7:15:42 PM] [Camera-ffmpeg] Start streaming video from Voordeur with 1280x720@299kBit ffmpeg -re -i rtsp://syno:[email protected]:554/Sms=23.unicast -map 0:0 -vcodec libx264 -pix_fmt yuv420p -r 30 -f rawvideo -loglevel verbose -b:v 299k -bufsize 299k -maxrate 299k -payload_type 99 -ssrc 15512771 -f rtp … Excerpt saved from GitHub on 2026-10-22. | Issue #384 · 2019-11 |
| Hikvision camera on Apple TV/iPad | Partly works | Apple TV and iPad need 1920x1080 at 802 kbps; copy codec fails thereSaved copyHello Everyone, First, thanks for this plugin ! I have camera from HIK Vision and it works great. In my home, I have 2 AppleTV and iPhone. To avoid encoding issue, I used the option vcodec: copy The image was very good. Then, when I tried on my AppleTV, it was not working... After searching on internet, I found that the apple tv is more picky with the homekits standards. The Apple TV needs 802 kbps with 1920x1080. If it's not these values, it doesn't work... So, in order to get it work with AppleTV, I need to set the setting value empty to let the plugin encode the video with the right value. … Excerpt saved from GitHub on 2026-10-22. | Issue #1106 · 2021-04 |
| Hikvision HiWatch i114 | Partly works | vcodec copy streams stuck at 299 kbps; reported failing on iOS 13.5Saved copy… camera parameters. In the camera settings, the bitrate is set to 2048 and the homebridge log shows 299 kbit / sec. "name": "HikCam", "manufacturer": "Hikvision", "model": "HiWatch i114", "serialNumber": "192.168.0.15", "firmwareRevision": "1.0", "videoConfig": { "source": "-y -i rtsp://admin:*@192.168.0.15:554/unicast", "stillImageSource": "-y -i rtsp://admin:*@192.168.0.15:554/unicast", "maxFPS": 25, "audio": true, "debug": true Excerpt saved from GitHub on 2026-10-22. | Issue #549 · 2020-06 |
| Raspberry Pi Camera Module | Partly works | Stream works after config change; camera reports ~80% duplicate framesSaved copy… The Problem: Tested configuration no longer works after release 2.5.0. Homekit shows a "Live" feed but the image is static. To Reproduce: Configure a raspberry Pi camera module with the configuration below. Logs: [code] Homebridge Config: [code] Screenshots: N/A Environment: Node.js Version: v12.18.3 NPM Version: v6.14.6 Homebridge Version: 1.1.2 Homebridge Camera FFmpeg Version: v3.0.1 Homebridge Config UI X Plugin Version: v4.27.0 Operating System: Raspbian Excerpt saved from GitHub on 2026-10-22. | Issue #751 · 2020-08 |
| Reolink 410 | Partly works | Stream flaky; crashes on immediate reopen, spinner on some phonesSaved copySame issue here: RTSP Stream to Reolink 410 works fine on VLC Camera live view on iPhone (HomeApp) doesn't work; sometimes with a lot of luck it works without changing any settings, but next time it's failing again I've tested a lot of different configurations, encoders, bitrates, ... but nothing worked properly my WIFI performance is not the problem >500MBit/s & stable Env: -Docker Container based on Alpine Linux (3.12.7) (on Ubuntu 18.04 host) -Node.js Version v14.17.0 -Npm Version v6.14.13 -Homebridge Version v1.3.4 -homebridge-camera-ffmpeg v3.1.2 -CPU: Intel(R) Celeron(R) CPU J3455 @ … Excerpt saved from GitHub on 2026-10-22. | Issue #1134 · 2021-05 |
| Wyze Cam V2 | Partly works | Live stream only worked on an older iPad, not newer devicesSaved copyDid you follow this? https://github.com/homebridge-plugins/homebridge-camera-ffmpeg/wiki/Tested-Configurations#wyzecam-v2-with-raspberry-pi-4-model-b On Jun 1, 2020, at 9:15 PM, Larry Novak wrote: I have just recently installed a couple of Wyze V2 cameras and the video stream only works on my older iPad. My iPhone, wives iPad and another newer iPad does not show the live stream. Does not throw any error messages., You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub , or unsubscribe . Excerpt saved from GitHub on 2026-10-22. | Issue #517 · 2020-05 |
| Apple TV (tvOS 16) camera viewing | Not working | Cameras stopped streaming after tvOS 16 upgrade; iOS 16 still worksSaved copyAfter upgrading my AppleTV's to tvOS16, the camera's no long work. They do work on my phone with ios16, but I can't get them to work on tvOS16. To test this, I upgraded 2 of my tv's, the camera's stopped working. On the TV that still worked, it was running tvOS15.6 and the camera's worked fine. After upgrading that tv to tvOS16, the cameras stop working and report "15minutes" as the last time it was connected (at the time of my testing) Not sure where I can start debugging but if there's anything I can do to get more info, will be glad to start grabbing/debugging. Excerpt saved from GitHub on 2026-10-22. | Issue #1340 · 2022-09 |
| Logitech C922 Pro webcam | Not working | 'Video device not found' on macOS despite ffmpeg workingSaved copyDescribe The Problem: I'm trying to make my "Logitech C922 Pro Stream Webcam" work with this plugin. I'm able to use the camera via ffmpeg and also kinda with the command printed by the debug logs of the plugin but there's an error that I don't know where it comes from: [code] To Reproduce: 1) Check that webcam is using with the following command: [code] This works and saves the streamed video. 2) Install the plugin in homebridge (`homebridge-camera-ffmpeg v3.0.3`) 3) Set up config like this: [code] 4) See error in logs, 5) Test printed stream command (without the filter / codec commands) … Excerpt saved from GitHub on 2026-10-22. | Issue #812 · 2020-09 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
FFmpeg reading camera streams on the LAN
You’ll need
- ffmpeg
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.9.0 || ^2.0.0 || ^2.0.0-beta.26 || ^2.0.0-alpha.37 |
| Homebridge 2.0 | Yes |
| Node.js | ^20 || ^22 || ^24 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | Camera-ffmpeg |
| License | ISC |
Community signals
| Downloads a week | 196 |
|---|---|
| Downloads a month | 935 |
| GitHub stars | 1,115 |
| Open issues | 51 |
| Closed issues | 950 |
| Discussions | 55 |
| Last code push | 2026-02-09 |
| Latest version | 4.1.0 (2025-09-18) |
| First published | 2025-01-19 |
| Releases | 7 |
| npm dependents | 2 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- README minimal
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- CameraRecordingManagement
- Doorbell
- MotionSensor
- StatelessProgrammableSwitch
- Switch