err-catto/README.md

# Catto

This is a plugin for [Errbot](http://errbot.io/) that fetches random cat images from the [The Cat API](http://thecatapi.com/)

Users can optionally specify whether to fetch a `gif` (animated) or a `still` (jpg/png) image:

## Usage:

- `!catto` Fetches a random cat image, animated (gif) or still (jpg/png)
- `!catto gif` Fetches a random cat animated gif image
- `!catto still` Fetches a random cat still jpg/png image
- `!catto jpg` Fetches a random cat jpg image
- `!catto png` Fetches a random cat png image

## Configuration:

It's possible to use your own Cat API key. Configure with:

```
!plugin config Catto {'CATAPI_KEY': 'your-api-key-here'}
```