Email Alias Manager

Email Alias Manager is a local web app for generating and tracking plus-address email aliases such as [email protected]. Your aliases are stored in your browser; no account or hosted service is required.

Run it

You need Node.js 18 or newer.

1. Install the latest version

Always install (or reinstall) @latest so you get the newest fixes:

npm install -g email-alias-manager@latest

2. Start the app (background)

eam run

Open http://localhost:4173. Your terminal is free again.

3. Stop when you are done

eam stop

Other useful commands

Start on another port:

eam run 3000

Check if it is running:

eam status

Start in the foreground (keeps the terminal busy):

eam serve

Show help:

eam help

eam, alias-manager, and email-alias-manager are the same CLI.

Update to the latest version

npm install -g email-alias-manager@latest

Use @latest every time you install or update so you never stay on an old release.

Try without installing

Start:

npx email-alias-manager@latest run

Stop:

npx email-alias-manager@latest stop

Desktop

Mobile

What you can do

• Generate aliases from a base address and a starting number.
• Copy an alias, mark it as used, and automatically generate the next number.
• Create YOPmail inboxes and their alt.* base address.
• Check the newest YOPmail message and copy a detected confirmation code.
• Search, filter, sort, and manage multiple accounts.
• Bulk copy or mark aliases, and export/import your data as JSON.
• Switch between light and dark themes.

The YOPmail actions require an internet connection and are subject to YOPmail availability and rate limits. Regular aliases continue to work locally.

Use as a React component

Install the package in your React application:

npm install email-alias-manager@latest

Import the component:

import { AliasManager } from "email-alias-manager";

Import the stylesheet:

import "email-alias-manager/style.css";

Render it:

export default function Page() {
  return <AliasManager />;
}

React 18 or 19 is supported. The embedded component manages local aliases in the browser. YOPmail creation and inbox checks need a server-side API; run eam run (after a global install) for the simplest local API.

Data and privacy

Alias data is persisted in your browser's localStorage under the app's own storage key. Export a JSON backup before clearing browser data or changing profiles. The app does not provide a cloud sync service.

Troubleshooting

The page does not open

Confirm that Node.js is 18+ and that the server is running:

eam status

Try another port:

eam run 3000

Logs are written to ~/.email-alias-manager/server.log.

Command not found: eam

Install the latest build globally:

npm install -g email-alias-manager@latest

If you already installed it, open a new terminal or check that npm's global bin directory is on your PATH.

YOPmail actions fail

YOPmail features need network access and the local API. Restart:

eam stop

eam run

Then retry after a short wait if the upstream service is rate-limiting requests.

My aliases disappeared

They are stored per browser profile. Restore them with the JSON import or switch back to the browser profile where they were created.

License

MIT