git clone <this repo>
cd distractinator
python setup.py install
Note: You may need to sudo python setup.py install as this will attempt to write to /usr/local/bin/
distractd
You will be walked through a few steps to ensure the script can communicate with your receiver. The setup process will also copy an example config file to your home directory.
By default, the log messages will print to stdout. You can specify a logfile location with the --log argument.
distractd --log /path/to/distractd.log
This is especially helpful when running as a background process, or under the supervision of a separate process.
distractd works best when it runs any time your machine is on. Here are two strategies for running it without too much hassle on Ubuntu.
Add an entry to Startup Applications:
/usr/local/bin/distractd --log /path/to/distractd.log
Run it under Supervisord:
pip install supervisor
Example stanza for supervisord.conf:
[program:distractd]
command=/usr/local/bin/distractd
autostart=True
autorestart=unexpected
user=joe ; Replace with your user
exitcodes=0,2
redirect_stderr=True
stdout_logfile=/path/to/distractd.log
You should use one!
This repository comes with an example customevents.py file. Find its path on your system with:
distractd --example_custom_code
- Copy that file to your desired location
- Uncomment the
custom_scriptvariable in your config file - Point it to the absolute path of your customevents.py file
You will need to restart distractd to pick up changes to customevents.py.