This is an asset reference browser for the game of Riven. The purpose of this application is to easily browse the images and movies from the outstanding game of Riven.
Note: This repository does not, and never will, contain actual Riven assets. To run this browser one must first buy the DVD or CD, and extract the game assets.
Web app prerequisites
For hosting the reference browser, you will need both Python 2 and Python 3 dependencies. This is because the program to make the database (makedb.py) is written in Python3, but the web application is written in Python2.
# python 2 dependencies: pip install flask pip install flask-sqlalchemy pip install flask-login pip install flask-wtf # python 3 dependencies: pip3 install Pillow pip3 install graphviz
For creating the database:
- Install sqlite3.
- Install ffmpeg.
- Install ImageMagick.
- Install graphviz.
Creating the database.
- Put the extracted game data in the browser/protected/DVD folder.
make. If you don't have make installed then
This takes a while (> 10 minutes on most systems), mostly because the movie transcoding process is CPU intensive. When finished the database ("riven.sqlite") will exist as well as many new images in the protected folder. To delete these newly created images just:
Running the Web Application.
Step 1: App configuration
The reference browser first reads it's configuration data from
configuration is then overridden by
is not under version control, it should be the one that you update.
The following keys must be specified:
SQLALCHEMY_DATABASE_URI(path should follow the form
sqlite:////absolute/path/to/riven.sqlite. Note the four  slashes in the scheme specifier.)
SECRET_KEY(may be any string, but a cryptographically random value is recommended for deployment)
For more information see Flask Configuration.
One password is used for authentication, and it is read from
Note: This application does not currently support multiple users, and the one hard-coded user "admin" has a hard-coded test password specified above.
Step 2: Running Flask for development
For development purposes, the app can be run as so:
If you don't have make installed then:
Deploying to the server.
make deploy ssh <server> sudo apachectl restart