home-assistant.io/source/_components/image_processing.openalpr_local.markdown
Alok Saboo 1aca7b08cf Misc fixes: e.g. -> e.g., and proper case for Home Assistant (#4942)
* e.g. to e.g., and proper case for Home Assistant

* Instructions how to -> Instructions on how to
2018-03-17 20:20:37 +01:00

2.3 KiB

layout title description date sidebar comments sharing footer logo ha_category featured ha_release redirect_from
page OpenALPR Local Instructions on how to integrate licences plates with OpenALPR local into Home Assistant. 2017-01-09 00:00 true false true true openalpr.png Image Processing false 0.36 /components/openalpr/

OpenALPR integration for Home Assistant allows you to process licences plates from a camera. You can use them to open a garage door or trigger any other automation.

For using inside automation look on component page.

{% linkable_title Local installation %}

If you want process all data locally, you need version 2.3.1 or higher of the alpr commandline tool.

If you don't find binaries for your distribution you can compile from source. Documentation of how to build OpenALPR is found here.

On a Debian system you can use this cmake command to build only the command line tool:

$ cmake -DWITH_TEST=FALSE -DWITH_BINDING_JAVA=FALSE --DWITH_BINDING_PYTHON=FALSE \
  --DWITH_BINDING_GO=FALSE -DWITH_DAEMON=FALSE -DCMAKE_INSTALL_PREFIX:PATH=/usr ..

For other operating system please refer to the OpenALPR wiki.

Verify your alpr installation with:

$ wget -O- -q http://plates.openalpr.com/h786poj.jpg | alpr -

{% linkable_title Configuration Home Assistant %}

# Example configuration.yaml entry
image_processing:
 - platform: openalpr_local
   region: eu
   source:
    - entity_id: camera.garage

Configuration variables:

  • region (Required): Country or region. List of supported values.
  • alpr_bin (Optional): The command line tool alpr from OpenALPR software for local processing. Defaults to alpr.
  • confidence (Optional): The minimum of confidence in percent to process with Home Assistant. Defaults to 80.
  • source array (Required): List of image sources.
    • entities (Required): A list of devices to add in Home Assistant.
    • name (Optional): This parameter allows you to override the name of your OpenALPR entity.