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.
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
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.
To enable emoji support when rendering markdown, you must first run
bundle exec rake emoji to copy the emoji images to public/image/emoji path.
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.
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.
Viso is released under the MIT license.