Adds image_processing.facebox.markdown

source/_components/image_processing.facebox.markdown

@@ -0,0 +1,60 @@
+---
+layout: page
+title: "Facebox"
+description: "Detect and recognise faces with Facebox."
+date: 2018-05-03 00:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: machine-box-alpha.png
+ha_category: Image Processing
+featured: false
+ha_release: 0.70
+---
+
+The `facebox` image processing platform allows you to detect and recognise faces in a camera image using [Facebox](https://machinebox.io/docs/facebox). The state of the entity is the number of faces detected, and recognised faces are listed in the `matched_faces` attribute. Facebox runs in a Docker container, and it is recommended that you run this container on a machine with a minimum of 2 GB RAM. On your machine with Docker, run the Facebox container with:
+```
+MB_KEY="INSERT-YOUR-KEY-HERE"
+
+sudo docker run --name=facebox --restart=always 8080:8080 -e "MB_KEY=$MB_KEY"  machinebox/facebox
+```
+
+If you only require face detection (number of faces) you can disable face recognition by adding ```-e "MB_FACEBOX_DISABLE_RECOGNITION=true"``` to the `docker run` command.
+
+To enable this platform in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+image_processing:
+  - platform: facebox
+    ip_address: 192.168.0.1
+    port: 8080
+    source:
+      - entity_id: camera.local_file
+        name: my_custom_name
+```
+
+{% configuration %}
+ip_address:
+  description: The IP address of your machine hosting Facebox.
+  required: true
+  type: string
+port:
+  description: The port which Facebox is exposed on.
+  required: true
+  type: string
+source:
+  description: The list of image sources.
+  required: true
+  type: map
+  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 `image_processing` entity.
+      required: false
+      type: string
+{% endconfiguration %}