PPPP Camera Component for Home Assistant

Overview

The pppp camera component allows Home Assistant to connect and integrate cheap Wi-Fi cameras such as A9, X5, and similar models using the aiopppp library. These cameras typically use the Peer-to-Peer protocol for communication, and this component enables live-streaming and snapshot capture within Home Assistant.

Features

• Supports A9, X5, and similar PPPP protocol cameras (Only JSON protocol is supported for now)
• Live streaming via aiopppp
• Snapshot support
• PTZ control through actions/services
• White lights and IR lights control
• Support for webrtc custom component
• Automatic device discovery
• (TBD) Sound streaming

Tested camera prefixes

Prefix	Protocol	Video	Audio*	PTZ	White Light	IR Light	Reboot
DGOK	📜 JSON	✅	✖️	✅	✅	✅	✅
PTZA	🔢 Binary	✅	✖️	✅	✅	🚫	✅
FTYC	🔢 Binary	❌*	✖️	🚫	🚫	✅	✅
BATE*	🔢 Binary	❔	✖️	❔	❔	❔	❔
DGB*	📜 JSON	⚠️	✖️	❔	❔	❔	❔
ACCQ*	❔ Unknown	✖️	✖️	✖️	✖️	✖️	✖️

Legend:

•  ✅  Working: Feature is fully functional.
•  ⚠️ Partially working: Feature works with limitations or issues.
•  ❌  Not working: Feature is implemented but does not function.
•  ✖️  Not implemented: Feature is not implemented in the system.
•  🚫  Not supported: Feature is not supported by the device.
•  ❔   Not tested: Feature has not been tested on the device.

Installation

Prerequisites

• Home Assistant installed and running. Tested on version 2025.2

Installation

1. HACS > Integrations > Custom Repositories
2. Add devbis/pppp_camera URL.
3. Select Integration as the category.

Or manually copy pppp_camera folder to custom_components folder in your config folder.

Configuration

Basic Configuration

Add cameras through Home Assistant's Devices & Services interface by camera IP address. If username and passwords are blank, it will use default values for authentication: admin:6666.

Advanced YAML Configuration (Optional)

For advanced configuration options, you can add the following to your configuration.yaml file:

pppp_camera:
  defaults:
    username: admin
    password: 6666
  platform:
    lamp: switch    # one of [switch, light, button]
  discovery:
    enabled: true
    duration: 10    # seconds to listen for devices during each discovery
    interval: 600   # seconds between discovery attempts
    ip:             # list of IPs to limit discovery to
      - 192.168.1.1
      - 192.168.1.2
      - 192.168.1.3
    # or single IP can also be specified (usually broadcast address)
    ip: 192.168.1.255
    # if 'ip' is not specified, discovery will listen on all interfaces

Configuration Parameters

defaults (optional)

Default credentials used for all cameras when not specified during UI setup.

• username (string, default: admin): Default username for camera authentication
• password (string, default: 6666): Default password for camera authentication

platform (optional)

Configure how certain entities are represented in Home Assistant.

• lamp (string, default: switch): Platform type for lamp entities
  • switch: Lamps appear as switch entities
  • light: Lamps appear as light entities
  • button: Lamps appear as button entities

discovery (optional)

Configure automatic device discovery on your network.

• enabled (boolean, default: true): Enable or disable automatic discovery
• duration (integer, default: 10): Time in seconds to listen for devices during each discovery cycle
• interval (integer, default: 600): Time in seconds between discovery attempts (600 = 10 minutes)
• ip (string or list, optional): Limit discovery to specific IP addresses
  • Can be a single IP address (e.g., 192.168.1.255 for broadcast)
  • Can be a list of specific IP addresses
  • If not specified, discovery listens on all available network interfaces

Usage

• Once configured, the camera feed should be visible in Home Assistant under Devices & Services.
• You can view the stream in Lovelace UI by adding a picture entity or a camera card.
• Automations can trigger recordings or snapshots.

PTZ control is available through services e.g.:

action: pppp_camera.ptz
data:
  pan: LEFT
target:
  entity_id: camera.dgok_123456_xxxxx

WebRTC component configuration example:

Component project page: https://github.com/AlexxIT/WebRTC

type: custom:webrtc-camera
entity: camera.dgok_123456_xxxxx
media: video
ptz:
  service: pppp_camera.ptz
  data_left:
    pan: LEFT
    entity_id: camera.dgok_123456_xxxxx
  data_right:
    pan: RIGHT
    entity_id: camera.dgok_123456_xxxxx
  data_up:
    tilt: UP
    entity_id: camera.dgok_123456_xxxxx
  data_down:
    tilt: DOWN
    entity_id: camera.dgok_123456_xxxxx

shortcuts:
  - name: White Light
    icon: mdi:lightbulb-on
    service: switch.toggle
    service_data:
      entity_id: switch.dgok_123456_xxxxx_white_lamp
  - name: IR lamp
    icon: mdi:weather-night
    service: switch.toggle
    service_data:
      entity_id: switch.dgok_123456_xxxxx_ir_lamp

Troubleshooting

• Camera not connecting? Ensure IP is correct and phone application is not connected. Only one client can connect.
• No video stream? Sometimes camera doesn't start streaming. Reboot it.

Contributing

Contributions are welcome! Feel free to submit issues or pull requests to improve the integration.

License

This project is licensed under the MIT License.