home-assistant.io/source/components/device_tracker.markdown

layout, title, description, date, sidebar, comments, sharing, footer

layout	title	description	date	sidebar	comments	sharing	footer
page	Device tracking	Instructions how to setup device tracking within Home Assistant.	2015-01-20 22:36	false	false	true	true

Home Assistant can get information from your wireless router to track which devices are connected. There are several brands of supported wireless routers:

• Actiontec
• Aruba
• ASUSWRT
• DD-WRT
• luci (OpenWRT)
• netgear
• Thomson
• tomato
• TP-Link
• Generic SNMP

Alternative trackers:

• MQTT
• nmap scanner to scan the network for devices
• Owntrack
• Geofancy

To get started add the following lines to your configuration.yaml (example for Netgear):

# Example configuration.yaml entry for Netgear device
device_tracker:
  platform: netgear
  host: 192.168.1.1
  username: admin
  password: YOUR_PASSWORD

  # Optional configuration

  # If new discovered devices are tracked by default (default: yes)
  track_new_devices: yes
  # Seconds between each scan for new devices (default: 12)
  interval_seconds: 12
  # Seconds to wait till marking someone as not home after not being seen
  # (default: 180)
  consider_home: 180

Once tracking, a file will be created 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.