trip

README

[!IMPORTANT] Development has moved to Linux-Society/trip.

🚉 trip

sydney public transport, in your terminal
made in collaboration with linux society @ unsw

🛠 Setup

Requirements

• A recent version of sqlite3 (tested with ≥ 3.50.2)
• GTFS data: TFNSW Timetables Complete GTFS
• A TFNSW_KEY environment variable set to your TFNSW Open Data Hub API key

Build the database

./makedatabase.sh /path/to/unzipped/gtfs

This creates app.sqlite with GTFS data.

Run the app locally

go build -o trip -tags 'fts5' main.go
./trip

SSH Server Mode

trip can be run in SSH mode to allow users to connect via ssh:

Edit defaultSSHAddr in main.go to change the port if needed. Then build with permissions to bind to privileged ports and run in ssh mode:

go build -o trip -tags 'fts5' main.go
sudo setcap CAP_NET_BIND_SERVICE=+eip trip
./trip --ssh
# then connect from another terminal
ssh user@your.domain.here -p your_port

Acknowledgements

thank you everyone who helped trip come to life in such a short period of time ❤️