PB Tracker is a web app for tracking speedrunning times and personal bests (PBs). Users can browse individual runners and games, and view runs submitted for each runner and game respectively. In addition, users may signup for their own account, submit their own runs and view / maintain their own individual runner page.
PB Tracker is written mainly in Python under the webapp2 framework and is deployed on Google App Engine (GAE). HTML templating is done with Jinja2, while style and layout is achieved through Twitter Bootstrap, Font Awesome and Bootswatch. To run your own development copy of PB Tracker, first download and install the GAE SDK for Python. Next, clone the repository and rename 'secret_dummy.py' to 'secret.py'. Then run dev_appserver.py /path/to/pb-tracker-directory/
or on Mac and Windows, load the project in GAE's development GUI and run. Finally, open up a browser to http://localhost:8080
(or replace 8080
with a different port if you specified one).
The main launching point for the app is main.py
. For explanations of each of the Python classes, see the comments at the top of each Python file.
Check out the issues and let me know if you want to work on any of them. I'm happy to take pull requests from anyone willing to put in the time to come up with a workable solution. If you have a feature that you want to work on for PB Tracker and it is not listed on the issues page, drop me a line to make sure that it is a suitable feature for PB Tracker.