@scrypted/arlo 0.11.39 → 0.11.40

package/README.md

@@ -16,28 +16,29 @@ If you experience any trouble logging in, clear the username and password boxes,
 
 ## General Setup Notes
 
-- **2FA Requirement:** Ensure that your Arlo account's default 2FA option is set to **either SMS or email**. Without this, you will not be able to log in and use the plugin. The plugin will require you to enter a 2FA code once your credentials are entered. This code is sent to you via your selected method, and you will need to input it into the plugin settings.
+- **2FA Requirement:** Ensure that your Arlo account's default 2FA option is set to either SMS or email. Without this, you will not be able to log in and use the plugin. The plugin will require you to enter a 2FA code once your credentials are entered. This code is sent to you via your selected method, and you will need to input it into the plugin settings.
   
-- **Motion Event Notifications:** Motion event notifications must be enabled in the Arlo app. This is important because when motion is detected, the plugin will receive these events and trigger actions. If you are receiving push notifications directly from Arlo, you can disable these notifications in your phone's settings after enabling them in the Arlo app. This avoids receiving duplicate alerts from both the Arlo app and the Scrypted system.
+- **Motion Event Notifications:** Motion event notifications must be enabled in the Arlo app. This is important because when motion is detected, the plugin will receive these events and trigger actions. If you are receiving push notifications directly from Arlo, you can disable these notifications in your phone's settings after enabling them in the Arlo app. This avoids receiving duplicate alerts from both the Arlo app and Scrypted or any other downstream options.
 
-- **Smart Detection & Recording Settings:** Disable **smart detection** and any cloud or local recording options in the Arlo app. Arlo Cloud limits to a single active RTSP or DASH stream per camera. If recording is enabled, it may conflict with the plugin’s ability to stream video, particularly when motion events trigger. Disabling these features ensures that you can get uninterrupted access to the live feed for downstream services (like Homekit) to access the video stream properly.
+- **Smart Detection & Recording Settings:** Disable smart detection and any cloud or local recording options in the Arlo app. Arlo limits to a single active stream per camera. If smart detection or any recording is enabled, it may conflict with the plugin’s ability to stream video, particularly when motion events trigger. Disabling these features ensures that you can get uninterrupted access to the live feed for downstream services (like HomeKit) to access the video stream properly.
 
-- **Rebroadcast Plugin:** It is highly recommended to enable the **Rebroadcast plugin** in Scrypted. This will allow multiple downstream integrations (such as Homekit) to access the video feed from a single camera simultaneously. Without the rebroadcast plugin, only one device or platform can access the video feed at a time.
+- **Rebroadcast Plugin:** It is highly recommended to enable the Rebroadcast Plugin in Scrypted. This will allow multiple downstream integrations (such as HomeKit) to access the video feed from a single camera simultaneously. Without the rebroadcast plugin, only one device or platform can access the video feed at a time.
 
 - **Stream Types:** The plugin supports three types of video streams pulled from Arlo Cloud:
-  - **WebRTC**: Recommended for streaming, providing a real-time video feed with minimal latency.
-  - **RTSP**: Recommended for recording due to its higher reliability for persistent video storage.
-  - **DASH**: Less reliable and may require additional configurations like `-vcodec h264` when used with FFmpeg.
+  - **WebRTC**: This stream option is the standard connection type for most cameras and doorbells through the Arlo app. The connection process does take a little longer, but does seem to be reliable. Downstream services (like HomeKit) may automatically transcode WebRTC streams for recording because of the audio requirements for HomeKit Secure Video.
+  - **Cloud RTSP**: This stream is usually faster in connecting and recording. Downstream services (like HomeKit) may automatically transcode Cloud RTSP streams for live streaming because of the audio requirements for HomeKit Live Streaming.
+  - **Cloud DASH**: This stream is the least reliable and may require additional configurations like `-vcodec h264` when used with FFmpeg.
+  - **Synthetic Stream**: Entering a name for a Synthetic stream creates a new stream option that feeds one of the streams above into a synthetically transcode the stream on-demand with the ffmpeg arguments provided. You can only feed one stream in at a time here.
 
-  Note that Arlo’s single-stream limitation means you can only use one of these stream types at a time. If you try to access a camera while the stream is already open, it may prevent recording. Therefore, it is recommended to use the same stream for all streams in Scrypted and the Rebroadcast plugin will handle sending the same stream to multiple places, i.e. streaming while recording.
+  Note that Arlo’s single-stream limitation means you can only use one of these stream types at a time. If downstream service (like HomeKit) tries to access a camera while the stream is already open, it may prevent recording. Therefore, it is recommended to use the same stream for all streams in Scrypted and the Rebroadcast plugin will handle sending the same stream to multiple places, i.e. streaming while recording.
 
-- **Newer Camera Models (e.g., Arlo Essential Gen 2):** If you are using newer models such as the **Essential Gen 2**, and you are integrating with downstream plugins like Homekit, you may need to transcode the RTSP/DASH streams for use. Enable transcoding in the `Extensions` section and configure it per camera for RTSP or DASH streams. This is not necessary for WebRTC streaming, but it is required for recording RTSP/DASH streams.
+- **Newer Camera Models (e.g., Arlo Essential Gen 2):** If you are using newer models such as the Essential Gen 2, and you are integrating with downstream services (like HomeKit), you may need to transcode the Cloud RTSP/DASH streams for use. This will require using the FFmpeg (TCP) Parser or setting up a Synthetic stream and using the Synthetic stream. This is not necessary for WebRTC streaming, but it is required for recording RTSP/DASH streams.
 
-- **Downstream Plugin RTP Sender:** The recommended RTP Sender in Homekit or similar plugins is `default`. If you have any issues with recording or streaming, try setting the RTP Sender to `FFmpeg`. The default configuration helps ensure compatibility between Scrypted and downstream services.
+- **Downstream Plugin RTP Sender:** The recommended RTP Sender in HomeKit or similar plugins is `default`. If you have any issues with recording or streaming, try setting the RTP Sender to `FFmpeg`. The default configuration helps ensure compatibility between Scrypted and downstream services.
 
-- **Prebuffering:** Enable **prebuffering** only if the camera is connected to a constant power source (e.g., wall outlet). Solar panels often do not provide sufficient power for prebuffering to function correctly. This feature is most useful for wired cameras with a steady power supply, and will only work when the camera is plugged into an external power source or does not have a battery.
+- **Prebuffering:** Enable prebuffering only if the camera is connected to a constant power source (e.g., wall outlet). Solar panels often do not provide sufficient power for prebuffering to function correctly. This feature is most useful for wired cameras with a steady power supply, and will only work when the camera is plugged into an external power source or does not have a battery.
 
-> **Bandwidth Usage:** Keep in mind that streaming video uses extra bandwidth, as video and audio streams must travel from your camera to Arlo Cloud, and then from Arlo Cloud to your network, before finally reaching Scrypted. This additional round-trip may affect your network speed and performance.
+> **Bandwidth Usage:** Keep in mind that streaming and recording video uses extra bandwidth, as video and audio streams must travel from your camera to Arlo Cloud, and then from Arlo Cloud to your network, before finally reaching Scrypted. This additional round-trip may affect your network speed and performance.
 
 ---
 
@@ -55,9 +56,9 @@ The plugin looks for 2FA codes sent from `do_not_reply@arlo.com`. If you use an
 
 ## Virtual Security System for Arlo Sirens
 
-Sirens in Homekit appear as simple on/off switches, which are easy to accidentally trigger. This plugin creates a **virtual security system device** for each siren to prevent accidental activation.
+Sirens in HomeKit appear as simple on/off switches, which are easy to accidentally trigger. This plugin creates a virtual security system device for each siren to prevent accidental activation.
 
-- The virtual system is synced to Homekit as a separate accessory.
+- The virtual system is synced to HomeKit as a separate accessory.
 - This is **not tied to actual Arlo Security Modes**—it only protects the siren from accidental activation.
 - See the in-plugin README for details on the virtual security system.
 
@@ -65,7 +66,7 @@ Sirens in Homekit appear as simple on/off switches, which are easy to accidental
 
 ## Security System for Arlo Security Modes
 
-The plugin exposes Arlo App Security Modes (Away, Home, Standby) as a security system in Scrypted and Homekit. This lets you automate camera notification behavior based on mode.
+The plugin exposes Arlo App Security Modes (Away, Home, Standby) as a security system in Scrypted and HomeKit. This lets you automate camera notification behavior based on mode.
 
 ### Example Automation Flow
 
@@ -77,9 +78,9 @@ The plugin exposes Arlo App Security Modes (Away, Home, Standby) as a security s
    - Configure **Standby mode** to disable all notifications.
 3. Use automations in the Home app to switch the Arlo security mode by controlling the virtual system in Scrypted.
 
-> Scrypted only receives events from Arlo when notifications are enabled for a camera in the selected security mode. HKSV recordings depend on receiving these notifications.
+> Scrypted only receives events from Arlo when notifications are enabled for a camera in the selected security mode. HomeKit Secure Video recordings depend on receiving these notifications.
 
-Multiple virtual security systems may be created—one per **location** (user or shared). Each system is labeled according to its location name in the Arlo app.
+Multiple virtual security systems may be created—one per location (user or shared). Each system is labeled according to its location name in the Arlo app.
 
 > Note: The plugin does **not** modify your Arlo mode settings—only switches between existing ones.
 
@@ -89,5 +90,5 @@ Multiple virtual security systems may be created—one per **location** (user or
 
 The plugin will display video clips from Arlo Cloud for cameras with cloud recording enabled.
 
-- Clips are **streamed on-demand**, not downloaded to your Scrypted server.
+- Clips are streamed on-demand, not downloaded to your Scrypted server.
 - To delete clips, use the Arlo mobile app or web dashboard.

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "@scrypted/arlo",
-   "version": "0.11.39",
+   "version": "0.11.40",
    "description": "Arlo Plugin for Scrypted",
    "license": "Apache",
    "repository": {