flamejam is a generic game jam application that uses the Flask microframework. It was initially created as a voting platforms for the BaconGameJam. However, it is generic and as such it is usable for any other game jam event.
This application is designed to make sure that participants vote on other entries fairly and evenly.
You will need
- Python 2.7
as well as their respective dependencies. All of these except mysql/mysql_config are available on PyPI and as such I recommend using a virtualenv and pip to install all of those. Always get the newest version of any of these. If flamejam should be incompatible with the latest version of one of these packages, it is to be considered a bug and should be fixed.
You are currently expected to run some kind of POSIX system such as Linux. This software has not been tested on Windows and it would be quite a wonder indeed if it worked there.
The installation should generally be rather simple provided you have virtualenv and pip in your PATH. Should that be the case, it would be as simple as running
# make install
True enough, this will install the software directly to your system and set up all the dependencies for you in a virtualenv. Should you want to install to a different root, use something like
# make DESTDIR=/some/else install
Copy the default config from
/etc/flamejam/flamejam.cfgand configure it to your needs. Do not forget to set permissions accordingly as this file contains cleartext passwords.
- Copy the cron file from
/etc/cron.d/flamejam. This cronjob will tick the web app every minute and send out announcements on time if needed.
- Configure your webserver. If you use Apache with mod_wsgi, you may use the provided example
Initialize the database using either test data or an admin account. For this, you can use either of the provided scripts in
/srv/flamejam/scripts/seed-db.py. If you use
init-db.pyon a production system, call it inside the virtualenv as follows:
$ CONFIG_TYPE=production python scripts/init-db.py <username> <password> <email>
For development and testing, firstly set up a virtualenv containing all dependencies. For your
convenience, a Makefile target has been provided. Run
make setup to have it set up for you.
You also need a mysql installation with mysql-config available. On Ubuntu the package is called
make init-db <username> <password> <email> and
make seed-db to
setup a development database.
When this is done, run
python runserver.py inside the virtualenv to fire up the
debug server and navigate to http://localhost:5000. Alternatively you can use
In order to receive help in getting this application to run, it would be best to ask in the official IRC channel: #bacongamejam on irc.freenode.net.
You might as well report bugs on the Github project and we will surely come back to you.
Pull request are rather welcome.
This application, all of its sources and resources are licensed under the zlib license with the following exceptions:
These exceptions are subject to their own copyrights and licenses. This project only makes use of them.
For the full license text, please see the included LICENSE file.