Integrated animated GIF search for Slack.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Gifbot is a lightweight Sinatra app that provides Slack with embedded keyword search for animated GIFs, using the Giphy API, and Slack's webhooks integration. Once setup, you can type #puppies in your Slack channel, and Gifbot will post a random animated GIF of adorable puppies to the channel.





What better way to celebrate a teammate's bon mot, or to herald a successful code deployment, or announce your imminent departure for lunch?


  • Download Gifbot and run bundle install --path .gems in the gifbot directory. You may need to sudo gem install bundler first.

  • Set up an outgoing webhook migration in Slack using http://host:port/gif as the URL, substituting the host and port that you'll be running the server on. (Unless you tell it otherwise, Sinatra runs on port 4567 by default.) You may opt to configure # as the default trigger word for the webhook.

  • Slack will give you an application token for this integration; note it.

  • Edit gifbot.rb and set your SLACK_TOKEN. You must do this or Gifbot will ignore all attempts to communicate.

  • Optionally, set GIPHY_KEY to your Giphy key, if you have one. The provided key is Giphy's public beta token and works out of the box, but they like you to contact them and ask for a real key if you're using Giphy for serious. You can also change the trigger word and the image style.

  • Run ./ on a public webserver, in a screen(1) session or something.

  • Type #kittens into your Slack chat and voilà.

Are you kidding?

This software took me 20 minutes to write and is released into the public domain. If it breaks, you get to keep all the pieces. Patches welcome, and hugs for everyone.