Skip to content

Commit d9d15cf

Browse files
authored
Merge pull request #235 from mreduar/add-random-emails
Add random-emails package
2 parents f4dda86 + 25c31b5 commit d9d15cf

3 files changed

Lines changed: 1142 additions & 0 deletions

File tree

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# Random Emails
2+
3+
Generate random but realistic-looking fake email addresses with
4+
[espanso](https://espanso.org).
5+
6+
| Trigger | Expands to | Examples |
7+
| -------- | ---------- | -------- |
8+
| `>email` | A random fake address | `abigail.moody3@gmail.com` · `adam@cocacola.com` · `alex.rowe72@mycompany.com` |
9+
10+
Every time you type `>email`, espanso picks a fresh random address, so you get a
11+
different one each time.
12+
13+
## What's inside
14+
15+
The address is **fake, but every part looks real**:
16+
17+
- **~900 real-style usernames** built from real name patterns
18+
(`eduar`, `j.smith`, `maria.garcia`, `mgarcia87`, `jonnydeep`, …).
19+
- **185 real domains**, mixing real email providers (`gmail.com`,
20+
`outlook.com`, `proton.me`), real companies (`cocacola.com`, `nike.com`,
21+
`tesla.com`) and plausible business domains (`mycompany.com`, `myemail.com`).
22+
23+
The username and the domain are combined **independently**, which yields more
24+
than **160,000** possible addresses.
25+
26+
## Usage
27+
28+
Type `>email` anywhere espanso is active and it expands instantly:
29+
30+
```
31+
>email -> kenji.tanaka@spotify.com
32+
>email -> priya88@gmail.com
33+
```
34+
35+
Great for filling forms, seeding test data, or generating placeholder contacts.
36+
37+
> These are randomly generated addresses. Any resemblance to a real, existing
38+
> mailbox is coincidental — they are meant as placeholder/test data.
39+
40+
## Customizing
41+
42+
The usernames and domains live in `package.yml` under the `local` and `domain`
43+
global variables. Add, remove or edit entries in the `choices` lists to fit your
44+
needs.
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
name: "random-emails"
2+
title: "Random Emails"
3+
description: Generate random but realistic-looking fake email addresses. Type >email to get an address like abigail.moody3@gmail.com, adam@cocacola.com or alex.rowe72@mycompany.com.
4+
version: 0.1.0
5+
author: Eduar Bastidas
6+
homepage: "https://github.com/mreduar/random-emails"
7+
tags: ["email", "random", "fake", "placeholder", "test-data"]

0 commit comments

Comments
 (0)