hubot-giphy-gifme

Get a random GIF from Giphy! Search by tags! Yeah!

Built with the wonderful Giphy API.

Commands

hubot gif me or hubot giphy returns a random GIF
hubot gif me american psycho or hubot giphy american psycho returns a random GIF tagged with "american" and "psycho"
hubot gif me /search american psycho or hubot giphy /search american psycho returns a random GIF selected from the search results for "american psycho" (using the /search endpoint instead of the default /random)

You can include tags in a number of ways:

These will all result in the same search "american+psycho". See the random endpoint docs for more info.

In your hubot instance, include this script like so:

external-scripts.json

[
  ...
  "hubot-giphy-gifme"
]

package.json

{
  ...
  "dependencies": {
    ...
    "hubot-giphy-gifme": "^1.0.0"
  }
}

You can configure the script with the following environment variables:

HUBOT_GIPHY_API_KEY - Your Giphy API key. Uses Giphy's demo API key as a default. You can request your own here.
HUBOT_GIPHY_RATING - The maximum allowed GIF rating (to prevent NSFW results). Possible values are: y, g, pg, pg-13 or r. Defaults to pg.
HUBOT_GIPHY_FORCE_HTTPS - If true, transform all search results from http to https. Defaults to false.
HUBOT_GIPHY_INLINE_IMAGES - If true, send results as in-line images instead of raw URLs. Defaults to false
HUBOT_GIPHY_DEFAULT_ENDPOINT - The default Giphy API endpoint to use for searches. Defaults to /random.
HUBOT_GIPHY_RESULTS_LIMIT - The number of results to return when getting GIFs from the /search endpoint. Defaults to 25.

Fork/clone this project
Run bootstrap script (installs dependencies, etc): npm start
Make and test your changes
- Test against a local hubot instance (see below)
- Run and update the tests: npm test
Submit a PR and badger bencentra until it is merged and a new version is published

See the hubot docs for info on setting up your own hubot instance.

To run Hubot with your local copy of hubot-giphy-gifme, add it to the scripts/ directory:

mkdir hubot/scripts
cp hubot-giphy-gifme/src/giphy-gifme.coffee hubot/scripts/giphy-gifme.coffee

You can set the additional environment variable DEBUG to enable console output:

DEBUG=* bin/hubot