Project

giphy

0.09
No release in over 3 years
Low commit activity in last 3 years
There's a lot of open issues
A Ruby interface to the Giphy API.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
~> 10.1
~> 2.14
~> 1.0

Runtime

 Project Readme

Giphy

Build Status Code Climate

Because GIFs make life fun! Use Giphy API from your Ruby programs and command line. Check out Giphy Labs for inspiration.

Installation

Add this line to your application's Gemfile:

gem 'giphy'

And then execute:

$ bundle

Or install it yourself as:

$ gem install giphy

Usage

Set the API version and api_key:

Giphy::Configuration.configure do |config|
  config.version = THE_API_VERSION
  config.api_key = YOUR_API_KEY
end

Important: Giphy API is currently in public beta. Unless version and api_key are set to specific values the default values for the beta period will be used. Check Giphy's API for updates.

That's it, you're ready to have fun!

Trending

Giphy.trending(limit: 5)

Translate

Giphy.translate('geek')

Search

Giphy.search('funny cat', {limit: 50, offset: 25})

Favorites

Write

Giphy.favorite('12HoHdqnDxz5NS')

Read

Giphy.favorites('absurdnoise', {limit: 50, offset: 25})

Screensaver

Giphy.screensaver('surprise')

Random

Giphy.random

For getting random gifs with a specific tag:

Giphy.random('american psycho')

GIFs by ID

Giphy.gif_by_id('feqkVgjJpYtjy', '12HoHdqnDxz5NS', '7rzbxdu0ZEXLy')

Command Line Tool

There is a small command line tool that let's you search for GIFs from the command line and opens it on your browser. Just for fun.

$ giphy 'dance'

Supported Ruby Versions

This library aims to support and is tested against the following Ruby implementations:

  • Ruby 1.9
  • Ruby 2.0
  • Ruby 2.1
  • Ruby 2.2

Contributing

  1. Fork it
  2. Create your feature branch: git checkout -b my-new-feature
  3. Run tests: rake
  4. Commit your changes: git commit -am 'Add some feature'
  5. Push to the branch: git push origin my-new-feature
  6. Create new Pull Request

License

See LICENSE for details.