> ## Documentation Index
> Fetch the complete documentation index at: https://docs.otter-shell.org/llms.txt
> Use this file to discover all available pages before exploring further.

# otter-emoji

> Search Unicode 17.0 emoji by name. Print matches, show a compact grid, or copy the first hit to clipboard.

otter-emoji searches the full Unicode 17.0 emoji set by name from the terminal or launcher. It prints matching glyph and name rows, or a compact grid. Pass `--copy` to put the first match on the clipboard.

## Usage

Pass a keyword to search. Flags control output format, result count, and clipboard copy.

```bash theme={null}
otter-emoji heart            # search by keyword
otter-emoji --grid weather   # display results as a grid
otter-emoji --limit 8 smile  # limit results count
otter-emoji --copy rocket    # copy first match to clipboard
```

## Configuration

otter-emoji reads `~/.config/otter-shell/otter-emoji.conf`.

```conf theme={null}
grid = false
copy = false
limit = 32
```

* `grid`: `true` for a compact grid by default
* `copy`: `true` to always copy the first match
* `limit`: max number of results returned

<Note>
  Emoji data covers Unicode 17.0.0 `emoji-test.txt` including all
  fully-qualified emoji sequences.
</Note>