Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
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
core Prompt to backup first and log commands
public Changes auto-topup redline from £8 to £10 following TfL change of 2Jan13
script
.gitignore Ignore local conf
README.md Update readme to reflect £10 auto-topup threshold
apache-vhost.conf Apache conf update
init.php Revert "Ignore my confs" and "Switch to using ['SERVER_NAME'] instead…
screenshot.png Screenshot
util.php Initial commit

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.