Mollusc is a browser for your Oyster pay as you go history. You can run it on your server or localhost.
You’ll get a bar chart and table breakdown of how your balance changed each month. Top ups are highlighted in green, fares above £3 in red. The £10 auto top-up threshold is shown as a red line.
Oyster only make 8 weeks data available at a time, but Mollusc will keep old data forever once you start importing it.
- Linux/Mac OS X
- Apache (2 probably?) with the rewrite module enabled
- MySQL (5 probably?)
- PHP 5.3
- Copy this directory somewhere on your machine where Apache can reach it.
Some people use
/var/www
or something like that - Edit
app/conf/local.conf.php
with your details. - Rename it to the result of running
hostname
on your machine followed by.conf.php
. e.g. if your system hostname isrhubarb
the file needs to be calledrhubarb.conf.php
. - Edit
apache-vhost.conf
, changing all occurrences of/path/to/install
to the path where you copied this directory. Set yourServerName
. Make it password protected if you like. - Run
script/initdb.php
and answer the questions as prompted to setup the database. - Run
script/fetch.php
to import your journey history. You’ll probably want to put this in cron to run once a day or something. - Put
Include /path/to/install/apache-vhost.conf
somewhere appropriate to your OS Apache config and restart Apache. - Point your DNS at your webserver (or
/etc/hosts
file if you’re running it locally). - Enjoy!
To change the red fare warning threshold, edit the FARE_WARNING
constant in app/conf/conf.php
. It’s in pence.