toreamun / victorsmartkill-homeassistant

Home Assistant integration for Victor Smart-Kill WI-FI electronic mouse and rat traps from VictorPest.com.
MIT License
18 stars 4 forks source link
hacs home-assistant homeassistant-integration mouse rat trap victor

Victor Smart-Kill

Home Assistant integration for Victor Smart-Kill WI-FI electronic mouse and rat traps from VictorPest.com. This integration is open source and not made by VictorPest.com.

Victor logo

GitHub Release Language grade: Python License

hacs Project Maintenance BuyMeCoffee

image-m1-mouse-trap image-m2-rat-trap

example

Dowload the integration

HACS download (alternative 1)

The easiest way to add the integration to your Homeassistant installation is using HACS. I you have HACS installed:

  1. Goto HACS -> integrations (http://homeassistant.local:8123/hacs/integrations) and select "explore and download repositories".
  2. Search for Victor Smart-Kill, and select to download the repository.
  3. Restart Home Assistant (http://homeassistant.local:8123/config/server_control and select restart).

Script download (alternative 2)

You need some kind of terminal to use this method. You can use one of the SSH add-ons from the Add-on Store if you run HassOS.

  1. Open terminal. Change directory to your Home Assistant configuration directory (where you find configuration.yaml) if you are not using HassOS.
  2. Run this script
wget -O - https://raw.githubusercontent.com/toreamun/victorsmartkill-homeassistant/master/get | bash -
  1. Restart Home Assistant (http://homeassistant.local:8123/config/server_control and select restart)
  2. Before the integration can show up in the list of integrations, you need to clear your browser cache or perform hard-refresh.

Manual download (alternative 3)

You need some kind of terminal to use this method. You can use one of the SSH add-ons from the Add-on Store if you run HassOS.

  1. Open terminal and change to the directory for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory there, you need to create it.
  3. Change dircetory to custom_components.
  4. Download lastest version
wget https://github.com/toreamun/victorsmartkill-homeassistant/releases/latest/download/victorsmartkill.zip
  1. Unzip victorsmartkill.zip into folder victorsmartkill
unzip victorsmartkill.zip -d victorsmartkill       
  1. Delete victorsmartkill.zip
rm victorsmartkill.zip
  1. Restart Home Assistant (http://homeassistant.local:8123/config/server_control and select restart)
  2. Before the integration can show up in the list of integrations, you need to clear your browser cache or perform hard-refresh.

Install the integration

Once the integration has been downloaded and Home Assistant has been restarted, go to Configuration -> Integrations (http://homeassistant.local:8123/config/integrations) and click the + to select Victor Smart-Kill and add the new integration. You may have to clear your browser cache or perform hard-refresh if the integrations is missing from the list. Check the log if you still have problems.

Trap models and versions

This integration should work with traps that has been provisioned with the VictorPest app. Please create an issue if you have trouble with your trap. Please see the wiki if you are interested in details about the hardware.

It is very helpfull if you can check the list of models and update the list if you have an unlisted trap or version.