Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Oyster pay as you go history browser.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 app
Octocat-spinner-32 core
Octocat-spinner-32 public
Octocat-spinner-32 script
Octocat-spinner-32 .gitignore
Octocat-spinner-32 README.md
Octocat-spinner-32 apache-vhost.conf
Octocat-spinner-32 init.php
Octocat-spinner-32 screenshot.png
Octocat-spinner-32 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.