Cardboard Camera Toolkit

A webapp for splitting/joining photos from Cardboard Camera to/from a stereo pair and audio file.

Available here: http://cctoolkit.vectorcult.com/

Installation and setup

The server will run on Linux, OS X and probably other Unix-like systems.

git clone https://bitbucket.org/pansapiens/cardboardcam.git
cd cardboardcam

Running under docker-compose

docker-compose build
docker-compose up -d

# Check the logs
# docker-compose logs -f

# open http://localhost:8000

Configuring

The environment variables:

• ENV (prod, dev or test)
• SECRET_KEY
• GOOGLE_ANALYTICS_TRACKING_ID
• UPLOAD_FOLDER

can be set via editing the docker-compose.yml file, or a .env file.

Running the server outside of docker-compose

Running the server this way isn't really recommended, however, if you've installed the dependencies required as per the Dockerfile, you can run the server in development mode accessible only from localhost using:

python3 manage.py runserver

Or, in development mode accessible from any host (not recommended if this port is publicly accessible):

python3 manage.py runserver -h 0.0.0.0

Or, to run the server in production mode (usually proxied behind nginx):

ENV=prod python3 wsgi.py

You can connect to the running server at: http://127.0.0.1:8000/

Development notes

Most of the main business logic is in cardboardcam/controllers/main.py and cardboardcam/static/js/main.js.

When running in production, Javascript and CSS is bundled and minified upon startup, as defined in cardboardcam/assets.py. If you modifiy the Javascript or CSS in production the server must be restarted to re-bundle.

Acknowledgements

Initial Flask app template from: https://jackstouffer.github.io/Flask-Foundation/

"Man with Axe with Cardboard" image modified by /u/Zombieist, based on a Public Domain image.

License

BSD. See LICENSE.md