Detect if you are home or away, and trigger automation.
phonehomey is a Python 3 project that will track if you are at home or away, and then run arbitrary scripts as you come and go. It does this by monitoring the presence of your mobile phone's MAC address on your home network. phonehomey will run 'home' and 'away' actions for each phone in the config file as they are determined to be one or the other. It will also run 'all_home' and 'all_away' actions when it's determined that all phones are home or away.
-
Download all Python 3 required libraries and install them into a venv folder. To do this, just
cdinto this directory and type:make -
Open the
config.ymlfile and read the comments at the top for info regarding how to use the config file. You will need your iPhone's wifi MAC address, and a prowlapp API key. Note that you can copyconfig.ymltoconfig_local.ymlif you wish. phonehomey will look forconfig_local.ymlfirst. Note that*_local*is in the.gitignorefile to prevent accidental commits with personal info. -
Use run_action.py as a starting framework to write your Python automation scripts. All scripts must go in the scritps folder. You can use the same script for all actions by parsing variables that are passed in, or have uni 6529 que scripts for each thing. If you don't want an action to run any automation, just use an empty script file.
With the config file complete, run phonehomey.py from its virtual environment (shown with the optional verbose mode):
./venv/bin/python phonehomey.py -v
Verbose mode outputs all debug to standard out (in addition to the log file if DEBUG level is set in the config file).
- Python 3
- Mac OS X or linux
- prowlapp $3 on iOS
- iOS only until code for a push notification api/app is added for android
- Arrival detection is very timely. However, departure detection time will be equal to the push notification timeout (default 15 min), meaning the phone needs to be gone for that timeout before it's determined to be away.
- The host running phonehomey must be on the same naetwork (layer 2) as the phones (wifi, or ethernet plugged into the same wifi router)