Link Search Menu Expand Document

First time install

Table of contents

  1. Preparing files
  2. Setting up the database
    1. No existing nests table
    2. Existing nests table
  3. Configure the tool
  4. Running

Preparing files

Clone the repo, install pip requirements and copy the config.

git clone https://github.com/M4d40/nestwatcher.git && cd nestwatcher
pip3 install -r requirements.txt
cp -r config_example config

Setting up the database

Steps to prepare your database will look different depending whether or not you have RocketMAD or PMSF running. If flly set up, both should already have created a nests table in your mad db (rocketmad) or manualdb (pmsf). If that’s the case, you just have to update that table.

No existing nests table

mysql -u {USER} -p {PASS} {DBNAME} < sql/nests.sql

If you’re running RocketMAD, you’ll have to replace {DBNAME} with your MAD DB name, else it’s up to you what database to use

Existing nests table

mysql -u {USER} -p {PASS} {DBNAME} < sql/update.sql

Configure the tool

Now cd config and fill out the files. For your first run, it’s enough to focus on the DB credentials in config.ini and geofences in areas.json. You can do the rest later. For help with filling them out, refer to the Config files page.

Running

To start Nest Watcher, just do python3 nests.py. Since it’s getting OSM data on its first run, you will have to wait a while for it to finish. (10+ minutes until it’s fully done)

It should now be finding nests and write them to your database. Now, it’s all working fine, but you might want Discord notifications or refine your results. For that, visit Additional steps