Skip to content
This component tracks devices using the arp-scan liinux command, it's very fast, and reasonably accurate.
Branch: master
Clone or download
Latest commit 5dc7733 Dec 25, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
custom_components/arpscan_tracker Added code files Dec 17, 2019
.gitignore Update .gitignore Dec 17, 2019
LICENSE Initial commit Dec 17, 2019 Update Dec 25, 2019
hacs.json Create hacs.json Dec 17, 2019 Update Dec 25, 2019

hacs_badge made-with-python Donate

Arpscan Device Tracker Component

This is a Custom Component for Home-Assistant ( that tracks devices using the arp-scan linux command, it's very fast, and reasonably accurate.


HACS - Recommended

  • Have HACS installed, this will allow you to easily manage and track updates.
  • Search for 'Arpscan'.
  • Click Install below the found integration.
  • Configure using the configuration instructions below.
  • Restart Home-Assistant.


  • Copy directory custom_components/arpscan_tracker to your <config dir>/custom_components directory.

  • Install the arp-scan command and set it's sticky bit, so it can be run as root.

    NOTE: This step is not needed on, it contains the arp-scan command already.

$ sudo apt-get install arp-scan
$ sudo chmod +s /usr/bin/arp-scan
  • Configure with config below.
  • Restart Home-Assistant.


To use this component in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry

  - platform: arpscan_tracker
    interval_seconds: 15
    consider_home: 60
    track_new_devices: true

Configuration variables:

  • interval_seconds (Optional) Seconds between each scan for new devices. (default = 12)
  • consider_home (Optional): Seconds to marking device as 'not home' after not being seen (default = 180)
  • track_new_device (Optional): If new discovered devices are tracked by default. (default = True)
  • exclude (Optional): List of IP addresses to skip tracking for.
  • scan_options (Optional): Configurable scan options for arp-scan. (default is -l -g -t1 -q)

Network adapter

Sometimes your host has more than one network adapter (on for example), and you need to figure out which one to use for the scans, you can specify the correct one using scan_options.


scan_options: " --interface=enp2s0 -g"



You can’t perform that action at this time.