Web app for tracking speedrunning times and personal bests.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
json
pytz
static
templates
xml
.gitignore
LICENSE
README.md
app.yaml
appengine_config.py
asup.py
change_categories.py
cleanup_games.py
cleanup_games_base.py
cleanup_games_now.py
cron.yaml
default_error.html
deleterun.py
edit_table.py
favicon.ico
fixerupper.py
front.py
gamelist.py
gamepage.py
games.py
handler.py
login.py
logout.py
main.py
over_quota.html
presubmit.py
runhandler.py
runnerlist.py
runnerpage.py
runners.py
runs.py
secret_dummy.py
signup.py
submit.py
updatebkt.py
util.py
xmlpage.py

README.md

PB Tracker

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.

Technical Overview

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).

Code Overview

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.

Want to Contribute?

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.

Contact