home-assistant.io/source/_integrations/android_ip_webcam.markdown

title	description	ha_category	ha_release	ha_iot_class	ha_domain	ha_platforms	ha_integration_type
Android IP Webcam	Connect Android devices as an IP webcam to Home Assistant	Binary Sensor Camera Hub Sensor Switch	0.40	Local Polling	android_ip_webcam	binary_sensor camera sensor switch	integration

The android_ip_webcam integration connects with Android IP Webcam to turn any Android phone or tablet into a network camera with multiple viewing options.

The integration is setup as an MJPEG camera with all settings as switches inside Home Assistant. You can also integrate the sensors exposed by the app. If you have multiple phones, you can use all options inside a list.

There is currently support for the following device types within Home Assistant:

• Binary Sensor
• Camera
• Sensor
• Switch

Setup

Download Android IP Webcam app and launch the app. When you press 'Start Server', it will start streaming video from your phone and the IP address of the device will be shown on screen.

Configuration

To set up the component, add the following information to your configuration.yaml file:

# Example configuration.yaml entry
android_ip_webcam:
  - host: 192.168.1.10

{% configuration %} host: description: The IP address of the phone on the network. required: true type: string port: description: The port the IP Webcam listens on. required: false default: 8080 type: integer name: description: Override the name of the phone. required: false default: IP Webcam type: string username: description: The username to access the phone. If username is specified then password must be also. required: inclusive type: string password: description: The password to access the phone. If password is specified then username must be also. required: inclusive type: string scan_interval: description: The update interval to use (in seconds). required: false default: 10 type: integer sensors: description: List of sensor entities to be created by this component (if supported by the phone and app). required: false type: list keys: audio_connections: description: The audio connections battery_level: description: The battery level battery_temp: description: The battery temperature battery_voltage: description: The battery voltage light: description: The light level motion: description: Analog (not binary) amount of motion detected pressure: description: The current pressure proximity: description: The proximity sound: description: The sound level video_connections: description: The video connections switches: description: List of switch entities to be created by this component. required: false type: list keys: exposure_lock: description: Control the exposure lock ffc: description: Control the front-facing camera focus: description: Control the focus gps_active: description: Control the GPS motion_detect: description: Control the motion detector night_vision: description: Control the night vision overlay: description: Control the overlay torch: description: Control the torch whitebalance_lock: description: Control the white balance lock video_recording: description: Control the video recording motion_sensor: description: Create a binary_sensor._motion_active entity. Note that auto_discovery may also create this sensor. required: false type: boolean default: false {% endconfiguration %}

You need to enable logging in the Android app (Data logging > Enable data logging) if you wish to see the sensor states in Home Assistant. The sensor states stay as unknown, until this is enabled.

Full example

# Example configuration.yaml entry
android_ip_webcam:
  - host: 192.168.1.202
    port: 8000
    sensors:
      - audio_connections
      - battery_level
      - battery_temp
      - battery_voltage
      - light
      - motion
      - pressure
      - proximity
      - sound
      - video_connections
    switches:
      - exposure_lock
      - ffc
      - focus
      - gps_active
      - motion_detect
      - night_vision
      - overlay
      - torch
      - whitebalance_lock
      - video_recording
  - host: 192.168.1.203
    port: 8000
    sensors:
      - light
    switches:
      - torch

Alternate Configuration Method

The configuration described above will cause the android_ip_webcam binary sensor platform to automatically create and configure the devices. Alternatively you can omit the android_ip_webcam component from your configuration.yaml file and add individual devices instead.

Binary Sensor

You can setup the binary motion sensor with the following in your configuration.yaml file:

{% raw %}

# Example configuration.yaml entry
binary_sensor:
  - platform: rest
    name: Kitchen Motion
    device_class: motion
    resource: http://IP_ADDRESS:PORT/sensors.json?sense=motion_active
    value_template: "{{ value_json.motion_active.data[0][1][0] | round(0) }}"

{% endraw %}

Camera

To enable only the camera in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
camera:
  - platform: mjpeg
    mjpeg_url: http://IP_ADDRESS:PORT/video

Other Sensors

You can setup your own sensors by examining the JSON file from the webcam server: http://IP:8080/sensors.json