Generate Gravatar URL

Generate a Gravatar avatar URL from an email address.

Usage

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)

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 pattern based on email hash | | monsterid | Unique monster generated from email hash | | wavatar | Unique face generated from email hash | | retro | 8-bit arcade-style face | | robohash | Unique robot generated from email hash | | blank | Transparent PNG |

Rating Levels

| Rating | Description | |--------|-------------| | g | Suitable for all audiences | | pg | May contain rude gestures or mild violence | | r | May contain harsh language, violence, or partial nudity | | x | May contain explicit content |

Examples

Basic Gravatar URL:

npx tsx scripts/url.ts user@example.com

Custom size (200px):

npx tsx scripts/url.ts user@example.com --size=200

Use identicon for default:

npx tsx scripts/url.ts user@example.com --default=identicon

Force default image (ignore user's Gravatar):

npx tsx scripts/url.ts user@example.com --force-default --default=robohash

MD5 Hashing

Gravatar uses MD5 hash of the email address:

Convert email to lowercase
Trim whitespace
Compute MD5 hash
Use hex-encoded hash in URL

Example:

Email:   User@Example.COM
Step 1:  user@example.com
Step 2:  b48bf4373d7b7374351c0544f36f7fc3 (MD5)
URL:     https://www.gravatar.com/avatar/b48bf4373d7b7374351c0544f36f7fc3

Profile URLs

Gravatar also provides profile pages:

https://www.gravatar.com/{hash}

Replace /avatar/ with just the hash to get the profile page, which may contain additional information about the user.

Use gravatar-check skill to verify if a Gravatar exists for an email
Use gravatar-download skill to download Gravatar images to local files
Use Gravatar profile URLs to get additional user information
Combine with npm or GitHub author emails to display author avatars
Use default images to provide consistent fallbacks

Use Cases

Developer Profiles

Generate avatar URLs for package maintainers:

npx tsx scripts/url.ts maintainer@npmjs.com

Team Pages

Create consistent avatars for team members:

npx tsx scripts/url.ts dev1@company.com --default=identicon --size=200
npx tsx scripts/url.ts dev2@company.com --default=identicon --size=200

User Comments

Display avatars for user comments:

npx tsx scripts/url.ts commenter@example.com --rating=pg

Notes

Gravatar images are served over HTTPS
Images are cached by browsers and CDNs
URL generation requires no API calls - it's deterministic
Users must register on gravatar.com to set their avatar
Unregistered emails will show the default image

gravatar-url