https://github.com/michaelenger/gifff

Small CLI tool for getting gifs URLs based on a search query
https://github.com/michaelenger/gifff

gifs rust

Last synced: 24 days ago
JSON representation

Small CLI tool for getting gifs URLs based on a search query

• Host: GitHub
• URL: https://github.com/michaelenger/gifff
• Owner: michaelenger
• License: mit
• Created: 2019-10-25T21:31:00.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-05-14T18:49:57.000Z (6 months ago)
• Last Synced: 2024-05-15T15:14:09.013Z (6 months ago)
• Topics: gifs, rust
• Language: Rust
• Homepage:
• Size: 104 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gifff

Get the URL for a random gif from based on a search term:

```shell

gifff "betty white dab"

gifff "sadness"

gifff "🦑"

```

## Usage

You will need an API key from [Giphy](https://developers.giphy.com/) which you store in an environment variable called `GIPHY_API_KEY`:

```shell

export GIPHY_API_KEY="YOUR API KEY"

```

Pass in your search query to get a URL to a random appropriate gif:

```shell

gifff "something funny"

```

Alternatively you can be basic and just get a random trending gif:

```shell

gifff

```

**PROTIP**: Pipe that 🔥 straight to `pbcopy` and paste into your favourite ~colleague harassment~ intra-office communication tool:

```shell

gifff "why the hell would you commit that??" | pbcopy

```

The utility keeps track of which gifs have already been seen in a file in the home directory called `.gifff_history` so that you won't face the embarassment of pasting the same reaction twice.

### Options

* `--ignore-history` Do not filter out previously seen gifs

* `--clear-history` Clear the existing history of gifs

* `--help` Show help text

* `--markdown` Wrap the URL in some markdown - useful for saying 👍 to pull requests

* `--version` Prints version information

### Requirements

* Rust 1.38