Skip to content

heyitsolivia/jifbox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jifbox logo

Pronounced GIF-box

JIFBOX is a web-based animated GIF photobooth. GIFs are generated in the browser using your webcam, then uploaded to various services that you can choose to enable (currently Dropbox and Tumblr).

some people acting weird

ONLY GOOGLE CHROME IS SUPPORTED AT THIS TIME

Want to see some GIFs generated by JIFBOX? Check out Sunlight Foundation's Sunfright Tumblr from our annual Halloween open house.

Deploy

Deploy

Click the button above to deploy on a new Heroku instance. You will be prompted for configuration values.

If you'd rather deploy somewhere else, you'll need to install MongoDB and the required Python packages listed in requirements.txt. You'll also need to set some environment variables. Refer to the Flask Deployment Options documentation for suggestions on running this app in production.

Services

JIFBOX will automatically send the animated GIFs to various services, if you so choose. Support for each service must be enabled individually.

Dropbox

Upload generated GIFs to a Dropbox folder. Requires DROPBOX_KEY and DROPBOX_SECRET to be set and Dropbox to be connected via /settings. You can get these values by registering an app for the Dropbox API.

Tumblr

Post generated GIFs to a Tumblr blog. Requires TUMBLR_KEY, TUMBLR_SECRET, and TUMBLR_HOSTNAME to be set and Tumblr to be connected via /settings. You can get these values by registering an app for the Tumblr API.

In the Tumblr API app settings set the Default callback URL to http://[project_domain_name]/settings/tumblr/callback

Settings

Basic app configuration is done via environment variables. Additional settings for customizing the app are available at http://<your jifbox domain>/settings.

Environment variables

Required

Variable Description
ADMIN_PASSWORD Password used for access to /settings
MONGOLAB_URI Heroku-style URL for MongoDB configuration
SECRET_KEY String used to sign cookies and other security related things

Optional

Variable Description
BASIC_PASSWORD HIGHLY RECOMMENDED If set, password required to use JIFBOX
DROPBOX_KEY App key from the Dropbox App Console
DROPBOX_SECRET App secret from the Dropbox App Console
TUMBLR_KEY Consumer key for the Tumblr API
TUMBLR_SECRET Consumer secret for the Tumblr API
TUMBLR_HOSTNAME Full hostname for your Tumblr blog (ex: this-is-my-blog.tumblr.com)