Setup once you have the Prowlbox

Once you have purchased the Prowlbox, it's plug and play, connect it to your access point and start collecting data, but how do you access this data? There's two ways of going about doing this. We will explain both.

GUI slowing you down? Well the first way is doing it is by Terminal, so if you're kind of tech savy, this is the "the guts" of the data, we also have a GUI for our not so tech savy customers.

To access the data through the terminal that's been logging throughout the day, make sure PostgreSQL is running, anyway, run these commands:

cd /usr/local/etc/prowl
cp python3 prowl.py && postgres -D /usr/local/pgsql/data

This will start the Prowl wrapper, and start logging data into Postgres, the wrapper comes preinstalled on all Prowlboxes. Now let's just say, you only want it running for a brief period of time, that's fine too, all you have to do is run:

python3 prowl.py

Most of the output will be in JSON, so make sure you have a implementation of a JSON Schema for Python, like "simplejson" or "jsonschema", these can easily be installed using pip, run:

pip install simplejson

Or:
pip install jsonschema

If you want to pull the full source of jsonschema, just use Git to clone the repo:

git clone https://github.com/Julian/jsonschema

The JSON output should look something similar to this:

nowPlaying" : {
    "artist" : "Coldplay",
    "title" : "Sparks",
    "duration" : 227.1608163265306,
    "album" : "Parachutes",
    "path" : "\/Users\/montana\/Dropbox\/Music\/Coldplay\/Parachutes\/04 Sparks.m4a",
    "percentElpased" : 0,
    "secondsElpased" : 0
  }
}

$ music seek 50%
{
  "status" : "ok",
  "state" : "playing",
  "options" : {
    "shuffle" : true,
    "repeat" : true
  },
  "nowPlaying" : {
    "artist" : "Coldplay",
    "title" : "Sparks",
    "duration" : 227.1608163265306,
    "album" : "Parachutes",
    "path" : "\/Users\/montana\/Dropbox\/Music\/Coldplay\/Parachutes\/04 Sparks.m4a",
    "percentElpased" : 49.7444945952162,
    "secondsElpased" : 113
  }
}

$ music seek -- -10s
{
  "status" : "ok",
  "state" : "playing",
  "options" : {
    "shuffle" : true,
    "repeat" : true
  },
  "nowPlaying" : {
    "artist" : "Coldplay",
    "title" : "Sparks",
    "duration" : 227.1608163265306,
    "album" : "Parachutes",
    "path" : "\/Users\/montana\/Dropbox\/Music\/Coldplay\/Parachutes\/04 Sparks.m4a",
    "percentElpased" : 95.52703829346825,
    "secondsElpased" : 217
  }
}

Once you have ran python3 prowl.py, this will run Prowl for as long as YOU want, unless other wise specified, and if you are tech savy, you can actually set Prowl as a Cron, so it comes on at certain times, for example, if you know your busiest time of day is at 5PM, then you can set a Cron to start Prowl at 5PM everyday.

Here's an example of how you would set a Cron for Prowl, so you want to put a shell script in the file you'll be storing your data, (if you're on Linux or Mac OSX):

cat /etc/cron.daily

Close out of that, open another terminal and run:

crontab -e

Now it's time to set the Cron time, in this example we are going to set the Cron to run a 5:30PM every Monday:

30 17 * * 1 /scripts/cron/prowl

You will be prompted once you cd into the Prowl directory and run Prowl via the "python3 prowl.py" command, if you want it to run in the background, you need to specify that, it will ask you and you can input Y/N, and also specify how long you want it to capture data for, once you're done, it's simple, just type:

exit

If you don't want to click on the Prowl icon, you can simply open the Prowl graphical user interface by running:

prowl .

The Prowl application will be the Fox logo, click on it, and it's a whole GUI with various different options, set your Cron jobs, and doing everything graphically, we like to cater to everyone.

Graphs? Yes, there's lots of information and data organized for you. We use GraphQL, and a plugin called "Sangria", to get the best possible data orginization possible.

Since there's not that many Prowlboxes in stores yet, (there are some), we haven't had any issue to date, we do have troubleshooting techniques, but until we know what the full extent of the problems are, those won't be required for this setup page. For the Prowl API usage, please look on the main page for information, or visit this page for more information.