https://github.com/eznix86/inboxed
Native Mac OS Mail Server/Client For Development alternative to Mailpit/Maildev
https://github.com/eznix86/inboxed
macos mailer swift
Last synced: 13 days ago
JSON representation
Native Mac OS Mail Server/Client For Development alternative to Mailpit/Maildev
- Host: GitHub
- URL: https://github.com/eznix86/inboxed
- Owner: eznix86
- Created: 2026-05-13T10:21:22.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-13T11:09:46.000Z (about 2 months ago)
- Last Synced: 2026-05-13T13:14:15.936Z (about 2 months ago)
- Topics: macos, mailer, swift
- Language: Swift
- Homepage:
- Size: 872 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Inboxed
Inboxed is a native macOS Mail catcher for local development. It runs a local SMTP server, captures outbound emails from your apps, and previews plain text, HTML, raw MIME content, and SMTP logs without forwarding anything outside your machine.
## Features
| Feature | Details |
|---|---|
| Local SMTP server | Listens on `localhost:1025` by default |
| Native | Only use Swift and Swift UI |
| Notifications | Shows a macOS notification when an email is captured |
| Logs | Includes a live SMTP traffic/log view |
## Requirements
- macOS 14+
- Xcode 26+ or the matching command line tools
- Swift Package Manager
## Run Locally
From the project directory:
```bash
swift build
swift run Inboxed
```
`swift run Inboxed` is useful for development. macOS notifications are only enabled when Inboxed is launched from an `.app` bundle.
For an app-bundle style local run:
```bash
sh build.sh
```
The app starts the SMTP server automatically. The current status and port are shown in the sidebar footer.
## SMTP Configuration
Configure your app's mailer with:
| Setting | Value |
|---|---|
| Host | `localhost` |
| Port | `1025` by default |
| TLS | Off |
| Auth | None |
To change the port, open **Inboxed > Settings** or press `Cmd + ,`. If the server is running, saving a new port restarts the listener automatically.
## Send a Test Email
Plain text:
```bash
python3 - <<'PYEOF'
import smtplib
from email.mime.text import MIMEText
msg = MIMEText('Hello from Inboxed!', 'plain')
msg['Subject'] = 'Test Email'
msg['From'] = 'dev@local.test'
msg['To'] = 'you@local.test'
with smtplib.SMTP('localhost', 1025) as smtp:
smtp.send_message(msg)
print('Sent!')
PYEOF
```
HTML + plain text multipart:
```bash
python3 - <<'PYEOF'
import smtplib
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
msg = MIMEMultipart('alternative')
msg['Subject'] = 'HTML Test Email'
msg['From'] = 'dev@local.test'
msg['To'] = 'you@local.test'
msg.attach(MIMEText('This is the plain text fallback.', 'plain'))
msg.attach(MIMEText('''
''', 'html'))
with smtplib.SMTP('localhost', 1025) as smtp:
smtp.send_message(msg)
print('Sent!')
PYEOF
```
## Release Builds
Release builds are currently unsigned. After downloading and unzipping a release, you can ad-hoc sign it locally:
```bash
codesign --force --deep --sign - "Inboxed.app"
```
If macOS still blocks the app because it was downloaded from the internet, remove the quarantine attribute and sign again:
```bash
xattr -dr com.apple.quarantine "Inboxed.app"
codesign --force --deep --sign - "Inboxed.app"
open "Inboxed.app"
```
## Notes
- Inboxed is meant for local development only.
- Emails are kept in memory for the current app session.
- Inboxed never forwards or delivers email to real recipients.
## Credits
- App icon by [akid3v](https://macosicons.com/u/akid3v) via [macOSicons](https://macosicons.com/).