Skip to content

v3.6.7

Choose a tag to compare

@github-actions github-actions released this 15 Jul 22:37
· 121 commits to main since this release

gomailtesttool Suite - Email Infrastructure Testing Tools

Portable CLI tools for comprehensive email infrastructure testing - covering cloud services (Exchange Online via Microsoft Graph), SMTP, IMAP, POP3, and JMAP protocols.

What's Included

Each ZIP archive contains a single unified binary:

  • gomailtest - Unified CLI for all protocols (smtp, imap, pop3, jmap, msgraph subcommands)

Plus documentation:

  • README.md - Main documentation
  • TOOLS.md - Protocol-specific tool guides
  • LICENSE - MIT License

Installation

Windows (amd64):

  1. Download gomailtesttool-windows-amd64-v3.6.7.zip
  2. Extract the ZIP file
  3. Run: gomailtest.exe --help

Linux (amd64):

  1. Download gomailtesttool-linux-amd64-v3.6.7.zip
  2. Extract: unzip gomailtesttool-linux-amd64-v3.6.7.zip
  3. Make executable: chmod +x gomailtest
  4. Run: ./gomailtest --help

macOS (Apple Silicon/arm64):

  1. Download gomailtesttool-macos-arm64-v3.6.7.zip
  2. Extract: unzip gomailtesttool-macos-arm64-v3.6.7.zip
  3. Make executable: chmod +x gomailtest
  4. Run: ./gomailtest --help

Note for macOS: If you see "cannot be opened because the developer cannot be verified":

  • Right-click the binary and select "Open", or
  • Run: xattr -d com.apple.quarantine gomailtest

Quick Start Examples

SMTP Testing:

# Test connectivity
./gomailtest smtp testconnect --host smtp.example.com --port 25

# TLS diagnostics
./gomailtest smtp teststarttls --host smtp.example.com --port 587

IMAP Testing:

# Test connection
./gomailtest imap testconnect --host imap.gmail.com --imaps

# List folders with OAuth2
./gomailtest imap listfolders --host imap.gmail.com --imaps \
  --username user@gmail.com --accesstoken "ya29..."

POP3 Testing:

# Test connection
./gomailtest pop3 testconnect --host pop.gmail.com --pop3s

# List mail
./gomailtest pop3 listmail --host pop.gmail.com --pop3s \
  --username user@gmail.com --password "app-password"

JMAP Testing:

# Discover session
./gomailtest jmap testconnect --host jmap.fastmail.com

# Get mailboxes
./gomailtest jmap getmailboxes --host jmap.fastmail.com \
  --username user@fastmail.com --accesstoken "token"

Microsoft Graph:

./gomailtest msgraph getinbox --tenantid "..." --clientid "..." --secret "..." \
  --mailbox "user@example.com"

Documentation