Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Wow, such great example API app
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
bin
config
db
lib
log
public
test
vendor/assets
.gitignore
Gemfile
Gemfile.lock
Procfile
README.md Updates to the README for installation
Rakefile
config.ru

README.md

Pummeldoge

An example Rails app that uses the LayerVault API.

What does it do? It makes sweet GIFs and MOVs of your work, like so:

ShibeVault

The above GIF was created from this LayerVault public project.

Installation

pummeldoge is a Rails 4 application. You will need gifsicle, ffmpeg, and imagemagick installed.

To install those in one swift go with Homebrew:

brew install ffmpeg
brew install gifsicle
brew install imagemagick

You will also need to register a LayerVault application. You can do that from your LayerVault Development page. (Account required. Accounts are free.)

Next, define your API keys in your shell:

export LAYERVAULT_CLIENT_ID=MY_LAYERVAULT_CLIENT_ID_FROM_THE_SITE
export LAYERVAULT_CLIENT_SECRET=MY_LAYERVAULT_SECRET_FROM_THE_SITE

Then:

git clone git@github.com:layervault/pummeldoge.git
cd pummeldoge
bundle
bundle exec foreman start
open http://localhost:3000

Hot doge!

Notes

This app uses Sidekiq and postgres. That might seem a little heavy for a demo app. This is done to cut down on processing time, most folks likely have multi-core processors these days. If we're doing a lot of work at the same time, the Rails-default SQLite3 has terrible write performance. To fix that, we use postgres by default.

You will need to change your username in config/database.yml to take advantage of postgres.

API Notes

This example application is a good demonstration of top-to-bottom use of the LayerVault API.

To authenticate users, we use the omniauth-layervault gem. You can see how we create a User object from the response in app/controllers/auth_controller.rb and app/models/user.rb.

To actually get data out of LayerVault, we use the layervault gem. You can see that in action in the PreviewGatheringService.

Once we have URLs to all of the previews we need, it's just a matter of pulling them down and mushing them into GIFs and MOVs.

Something went wrong with that request. Please try again.