home-assistant.github.io/source/components/device_tracker.markdown
Carlo Costanzo 33f9c0679b Added note on track_new_devices
Also updated csv to yaml.
2015-09-13 21:14:14 -04:00

41 lines
1.8 KiB
Markdown

---
layout: page
title: "Device tracking"
description: "Instructions how to setup device tracking within Home Assistant."
date: 2015-01-20 22:36
sidebar: false
comments: false
sharing: true
footer: true
---
Home Assistant can get information from your wireless router to track which devices are connected. There are three different types of supported wireless routers:
- [Actiontec](/components/device_tracker.actiontec.html)
- [Aruba](/components/device_tracker.aruba.html)
- [ASUSWRT](/components/device_tracker.asuswrt.html)
- [DD-WRT](/components/device_tracker.ddwrt.html)
- [luci (OpenWRT)](/components/device_tracker.luci.html)
- [netgear](/components/device_tracker.netgear.html)
- [tomato](/components/device_tracker.tomato.html)
- [TP-Link](/components/device_tracker.tplink.html)
- [Thomsom](/components/device_tracker.thomson.html)
You can also decide to directly scan the network for devices by using the [nmap scanner](/components/device_tracker.nmap_scanner.html).
To get started add the following lines to your `configuration.yaml` (example for Netgear):
```yaml
# Example configuration.yaml entry for Netgear device
device_tracker:
platform: netgear
host: 192.168.1.1
username: admin
password: YOUR_PASSWORD
track_new_devices: yes
```
By default, the device tracker will add all found devices into the `known_devices.yaml`. It will default to displaying them in the UI as well. To disable displaying new devices in the UI, change the value of `track_new_devices:` to `no`.
Once tracking, the `device_tracker` component will maintain a file in your config dir called `known_devices.yaml`. Edit this file to adjust which devices have to be tracked. Here you can also setup a url for each device to be used as the entity picture and set whether the device will be show in the UI when in away state..