home-assistant.io/source/_components/openalpr_local.markdown
Franck Nijhof 1833c32a2c Cleans up front matter (#9835)
* Sets front matter defaults

* Removes default front matter from section templates/pages

* Removes default front matter from addon pages

* Removes default front matter from integration pages

* Removes default front matter from posts

* Removes default front matter from docs pages

* Removes default front matter from other pages

* Fixes blog category pages
2019-07-11 14:35:08 -07:00

2.4 KiB

title, description, logo, ha_category, ha_release, redirect_from
title description logo ha_category ha_release redirect_from
OpenALPR Local Instructions on how to integrate licences plates with OpenALPR local into Home Assistant. openalpr.png
Image Processing
0.36
/components/openalpr/
/components/image_processing.openalpr_local/

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 the result inside an automation rule, take a look at the component page.

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 -

Configuration

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

{% configuration %} region: description: Country or region. List of supported values. required: true type: string alpr_bin: description: The command line tool alpr from OpenALPR software for local processing. required: false type: string default: alpr confidence: description: The minimum of confidence in percent to process with Home Assistant. required: false type: integer default: 80 source: description: List of image sources. required: true type: list keys: entity_id: description: A camera entity id to get picture from. required: true type: string name: description: This parameter allows you to override the name of your OpenALPR entity. required: false type: string {% endconfiguration %}