Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Oyster pay as you go history browser.
PHP Other
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app Missing CSV isn't an error, just means you haven't been traveling
core
public
script
.gitignore
README.md
apache-vhost.conf
init.php Revert "Ignore my confs" and "Switch to using ['SERVER_NAME'] instead…
screenshot.png
util.php

README.md

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.

Screenshot

Required

  • Linux/Mac OS X
  • Apache (2 probably?) with the rewrite module enabled
  • MySQL (5 probably?)
  • PHP 5.3

Installation

  1. Copy this directory somewhere on your machine where Apache can reach it. Some people use /var/www or something like that
  2. Edit app/conf/local.conf.php with your details.
  3. Rename it to the result of running hostname on your machine followed by .conf.php. e.g. if your system hostname is rhubarb the file needs to be called rhubarb.conf.php.
  4. Edit apache-vhost.conf, changing all occurrences of /path/to/install to the path where you copied this directory. Set your ServerName. Make it password protected if you like.
  5. Run script/initdb.php and answer the questions as prompted to setup the database.
  6. 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.
  7. Put Include /path/to/install/apache-vhost.conf somewhere appropriate to your OS Apache config and restart Apache.
  8. Point your DNS at your webserver (or /etc/hosts file if you’re running it locally).
  9. Enjoy!

Configuration

To change the red fare warning threshold, edit the FARE_WARNING constant in app/conf/conf.php. It’s in pence.

Something went wrong with that request. Please try again.