gravatar-url

# Generate Gravatar URL

Generate a Gravatar avatar URL from an email address.

## Usage

```bash
npx tsx scripts/url.ts <email> [options]
```

### Arguments

| Argument | Required | Description |
|----------|----------|-------------|
| `email` | Yes | Email address |

### Options

| Option | Description |
|--------|-------------|
| `--size=N` | Image size in pixels (default: 80, max: 2048) |
| `--default=TYPE` | Default image type: mp, identicon, monsterid, wavatar, retro, robohash, blank (default: mp) |
| `--rating=LEVEL` | Rating level: g, pg, r, x (default: g) |
| `--force-default` | Force the default image even if user has a Gravatar |

### Output

```
Email: user@example.com
Hash: b48bf4373d7b7374351c0544f36f7fc3
URL: https://www.gravatar.com/avatar/b48bf4373d7b7374351c0544f36f7fc3?s=80&d=mp&r=g
```

## Script Execution (Preferred)

```bash
npx tsx scripts/url.ts <email> [options]
```

Options:
- `--size=N` - Image size in pixels (default: 80, max: 2048)
- `--default=TYPE` - Default image type: mp, identicon, monsterid, wavatar, retro, robohash, blank (default: mp)
- `--rating=LEVEL` - Rating level: g, pg, r, x (default: g)
- `--force-default` - Force the default image even if user has a Gravatar

Run from the gravatar plugin directory: `~/.claude/plugins/cache/gravatar/`

## Gravatar URL Format

```
https://www.gravatar.com/avatar/{hash}?{parameters}
```

The hash is an MD5 hash of the lowercase, trimmed email address.

### URL Parameters

| Parameter | Description | Default | Options |
|-----------|-------------|---------|---------|
| `size` | Image size in pixels | 80 | 1-2048 |
| `default` | Default image when no Gravatar exists | mp | mp, identicon, monsterid, wavatar, retro, robohash, blank |
| `rating` | Content rating level | g | g, pg, r, x |
| `f` | Force default image | y (forced) | y |

### Default Image Types

| Type | Description |
|------|-------------|
| `mp` | Mystery Person (simple, cartoon-style silhouette) |
| `identicon` | Geometric patter