ImageStream Tumblr Like Node.js Image Stream

Description

ImageStream is a dead simple image upload application written in Node.js. You can manually upload images or have a client (iOS, Android, etc.) post images to the application for storage. Files are written to disk and their metadata is stored in MongoDB. The index page is a paginated stream of all the images that have been uploaded to the application. Each entry gets it's own detail page which allows sharing to Twitter and Facebook as well as URL shortening via Bit.ly.

Requirements

Project Setup and Execution

Go the project base directory in Terminal and type npm install.
Copy config.default.js to config.js and edit as necessary, see Configuration).
Start mongo
- Type mongod in a new Terminal window and leave it open.
Execute the application
- Type node app.js in the original Terminal window

Manual Post Submission

Images and 'messages' can be manually submitted via web form at http://localhost:3000/popsquatch/form. Anything posted via this method will show up just the same as an image posted from another application.

Submission Fields

The endpoint to POST data to is http://localhost:3000/

displayImage: The image to be uploaded.
message: The message to be used for the tweet.

Configuration

All configuration is done in the config.js file. If it doesn't exist it should be copied from config.default.js which should have enough configuration to make the application run.

ImageStream

General application configuration resides in this section.

long_url: This is the URL to use as the base URL for Bitly links, the 'base callback' URL, if you will. This URL needs to be publicly accessible and point to the /popsquatch endpoint.
post_limit: The number of posts to display per page.

Debug

This section is for debugging and development parameters.

enabled: If set to true, extra logging and debug behavior will be enabled.
api_usage: If set to false the application will not POST to Twitter and Bit.ly APIs.

Bitly

If you wish to use OAuth configuraiton make sure that username,client_id, secret and access_token are properly filled out.

#####Legacy For using the Legacy API connection, simply fill out the login and api_key values in the bitly.legacy section.

Twitter

Twitter requires OAuth authentication and as such you will need the consumer_key, consumer_secret, access_token and access_token_secret from your custom Twitter application.

mashurex / ImageStream