destroytoday / viso

View drops from CloudApp

Viso

Viso powers all public CloudApp pages. It displays images, renders markdown, syntax highlights code, redirects bookmarks to their URL, and provides a download button for all other file types. It's a thin client that at its heart is a simple Sinatra app which handles drop requests, pings the CloudApp API for its details, and renders or redirects according to the type of drop.

The power of Viso lies in its ability to be fully personalized. Don't like the default CloudApp image viewer? Tired of waiting for an HTML5 video player? No more! Fork the project, hack away, and deploy. That's all there is to it.

Prerequisites

Viso's needs are basic: Ruby 1.9.2, Bundler, and an Event Machine based web server like thin. Using RVM is recommended but not required. Assuming RVM is installed, getting up and running with Ruby 1.9.2 is as simple as:

rvm install 1.9.2

After Ruby has compiled, clone the project and create a stub rvmrc.

git clone [email protected]:cloudapp/viso.git
cd viso
rvm use 1.9.2 --rvmrc

If you're a gemset fan, you probably already know what you're doing, but here's the command just in case:

rvm use 1.9.2@viso --rvmrc --create

Getting Started

Viso uses Bundler to manage its dependencies. Install everything and kick start thin to run Viso locally.

gem install bundler
bundle install
bundle exec thin start

Browse to http://localhost:3000. If you're redirected to http://getcloudapp.com, it's alive! Now grab one of your drops and replace the "cl.ly" domain with "localhost:3000" and watch the magic happen. Or, if you're lazy, just click here.

Working

Crack open the image viewer to start hacking some markup and the stylesheet to get to stylin'. Of course, seeing as how this is your CloudApp, you're free to completely destroy everything and rebuild from the ground up. Have at it.

Parting Words

We'd love to see what you're doing with Viso. Get a hold of us and show it off! Did you find something broken? Have questions getting things running? Open an issue or send over a pull request.

License

Viso is released under the MIT license.