Skip to content
Homebridge TestFlight
Protocols and bridges

Camera FFmpeg

@homebridge-plugins/homebridge-camera-ffmpeg · v4.1.0

VerifiedLocalHomebridge 2.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
DeviceStatusWhat they saidSource
Amcrest IP2M-842E PoE cameraWorksTested working on iOS 14.1 and tvOS 14.3; config added
Saved copy
Manufacturer/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-AIWorksWorks with unbridge config and RTSP source
Saved copy
Did 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 cameraWorksWorks with -rtsp_transport tcp added to source
Saved copy
Hello, 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 C1WorksStreaming stopped due to wrong IP in config; fixed
Saved copy
Today 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 cameraWorksTested config added; one-way audio works
Saved copy
Manufacturer/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 doorbellPartly worksVideo works; no motion or doorbell notifications reach HomeKit
Saved 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 worksOnly still frames; live view worked via Synology Surveillance Station
Saved 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/iPadPartly worksApple TV and iPad need 1920x1080 at 802 kbps; copy codec fails there
Saved copy
Hello 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 i114Partly worksvcodec copy streams stuck at 299 kbps; reported failing on iOS 13.5
Saved 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 ModulePartly worksStream works after config change; camera reports ~80% duplicate frames
Saved 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 410Partly worksStream flaky; crashes on immediate reopen, spinner on some phones
Saved copy
Same 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 V2Partly worksLive stream only worked on an older iPad, not newer devices
Saved copy
Did 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 viewingNot workingCameras stopped streaming after tvOS 16 upgrade; iOS 16 still works
Saved copy
After 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 webcamNot working'Video device not found' on macOS despite ffmpeg working
Saved copy
Describe 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 HomebridgeYes
Homebridge versions^1.9.0 || ^2.0.0 || ^2.0.0-beta.26 || ^2.0.0-alpha.37
Homebridge 2.0Yes
Node.js^20 || ^22 || ^24
Settings in Homebridge UIYes
MatterNo
Platform nameCamera-ffmpeg
LicenseISC

Community signals

Downloads a week196
Downloads a month935
GitHub stars1,115
Open issues51
Closed issues950
Discussions55
Last code push2026-02-09
Latest version4.1.0 (2025-09-18)
First published2025-01-19
Releases7
npm dependents2

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