mirror of
https://github.com/DeNNiiInc/Advanced-Smtp-Tester.git
synced 2026-04-23 19:55:59 +00:00
Docs: Overhaul README with new screenshots and deployment info
This commit is contained in:
197
README.md
197
README.md
@@ -1,124 +1,131 @@
|
|||||||
# Advanced SMTP Tester
|
# 📧 Advanced SMTP Tester
|
||||||
|
|
||||||
A powerful desktop application for testing SMTP configurations with support for multiple providers, dark mode, test history, and enhanced error messages..
|

|
||||||
|
|
||||||
## Features
|
> **A premium, powerful SMTP testing utility for developers and sysadmins.**
|
||||||
|
> Test configurations, debug connection issues, and visualize results with a modern, beautiful interface.
|
||||||
|
|
||||||
### 🎨 User Interface
|
<div align="center">
|
||||||
- **Dark/Light Mode** - Toggle between themes with persistence
|
|
||||||
- **Configuration Presets** - Quick-load for Office 365, Gmail, SendGrid, Mailgun, Amazon SES
|
|
||||||
- **Test History** - Last 50 tests with click-to-load
|
|
||||||
- **Enhanced Errors** - Helpful troubleshooting tips for common issues
|
|
||||||
|
|
||||||
### 🖥️ Desktop Application
|
[](https://advanced-smtp-tester.beyondcloud.technology/)
|
||||||
- **Native Windows App** - Runs in its own window (no browser needed)
|
[](https://github.com/DeNNiiInc/Advanced-Smtp-Tester)
|
||||||
- **System Tray** - Minimize to tray, quick access
|
[](LICENSE)
|
||||||
- **Menu Bar** - Full application menu
|
|
||||||
- **Auto-Start Server** - Express server starts automatically
|
|
||||||
|
|
||||||
### 📧 SMTP Testing
|
</div>
|
||||||
- **Multiple Encryption** - STARTTLS, SSL/TLS, Unencrypted
|
|
||||||
- **Auto-Discovery** - Test multiple port/encryption combinations
|
|
||||||
- **Beautiful Emails** - Professional HTML test emails
|
|
||||||
- **Detailed Results** - Full response logs and error messages
|
|
||||||
|
|
||||||
## Installation
|
---
|
||||||
|
|
||||||
### Desktop App (Windows)
|
## ✨ Features
|
||||||
1. Download the latest release from [Releases](https://github.com/DeNNiiInc/Advanced-Smtp-Tester/releases)
|
|
||||||
2. Extract the ZIP file
|
### 🎨 Modern User Interface
|
||||||
3. Run `Advanced-SMTP-Tester.exe`
|
- **Premium Design** - Glassmorphism effects, smooth animations, and a polished UI.
|
||||||
|
- **Dark/Light Mode** - Toggle between themes with automatic persistence.
|
||||||
|
- **Responsive** - Works perfectly on desktop and mobile devices.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
### 🚀 Powerful Testing Tools
|
||||||
|
- **Auto-Discovery** - Automatically test multiple port (25, 465, 587, 2525) and encryption (SSL/TLS, STARTTLS) combinations in one click.
|
||||||
|
- **Quick Presets** - Pre-configured settings for **Office 365, Gmail, SendGrid, Mailgun, and Amazon SES**.
|
||||||
|
- **Enhanced Error Handling** - Intelligent error analysis that provides actionable troubleshooting tips.
|
||||||
|
|
||||||
|
### 📊 History & Insights
|
||||||
|
- **Local Test History** - Automatically saves your recent tests (locally) for quick re-testing.
|
||||||
|
- **Detailed Logs** - View full SMTP transaction logs and server responses.
|
||||||
|
- **Git Version Badge** - Always know which version is deployed with the live Git commit badge.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🌐 Live Demo
|
||||||
|
|
||||||
|
Try the application instantly on our production server:
|
||||||
|
**[https://advanced-smtp-tester.beyondcloud.technology/](https://advanced-smtp-tester.beyondcloud.technology/)**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🛠️ Installation & Usage
|
||||||
|
|
||||||
|
### Option 1: Run Locally (Node.js)
|
||||||
|
|
||||||
|
1. **Clone the repository**
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/DeNNiiInc/Advanced-Smtp-Tester.git
|
||||||
|
cd Advanced-Smtp-Tester
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Install dependencies**
|
||||||
|
```bash
|
||||||
|
npm install
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Start the server**
|
||||||
|
```bash
|
||||||
|
npm start
|
||||||
|
```
|
||||||
|
Access the app at `http://localhost:3000`
|
||||||
|
|
||||||
|
### Option 2: Desktop App (Electron)
|
||||||
|
|
||||||
|
You can run the application as a standalone desktop app.
|
||||||
|
|
||||||
### Web Version
|
|
||||||
```bash
|
```bash
|
||||||
npm install
|
# Run in development mode
|
||||||
npm start
|
|
||||||
```
|
|
||||||
Open `http://localhost:3000` in your browser.
|
|
||||||
|
|
||||||
### Electron Development
|
|
||||||
```bash
|
|
||||||
npm install
|
|
||||||
npm run electron
|
npm run electron
|
||||||
```
|
|
||||||
|
|
||||||
## Building from Source
|
# Build Windows Installer
|
||||||
|
|
||||||
### Web Version
|
|
||||||
```bash
|
|
||||||
npm install
|
|
||||||
npm start
|
|
||||||
```
|
|
||||||
|
|
||||||
### Desktop App
|
|
||||||
```bash
|
|
||||||
npm install
|
|
||||||
npm run build
|
npm run build
|
||||||
```
|
```
|
||||||
|
|
||||||
Or use electron-packager:
|
### Option 3: Proxmox Deployment (Automated)
|
||||||
```bash
|
|
||||||
npx electron-packager . "Advanced-SMTP-Tester" --platform=win32 --arch=x64 --out=dist --overwrite
|
|
||||||
```
|
|
||||||
|
|
||||||
## Usage
|
We provide a fully automated deployment script for **TurnKey Linux Node.js** containers on Proxmox.
|
||||||
|
|
||||||
### Quick Start
|
1. **Setup Secrets**: Create `deploy-secrets.json` (see `PROXMOX_DEPLOY_TEMPLATE.md`).
|
||||||
1. Select a preset (e.g., "Microsoft Office 365")
|
2. **Run Deploy Script**:
|
||||||
2. Enter your credentials
|
```powershell
|
||||||
3. Enter recipient email
|
./deploy-to-proxmox.ps1
|
||||||
4. Click "Test Configuration & Send Email"
|
```
|
||||||
|
This script handles:
|
||||||
|
- Installing system dependencies (Git, Nginx, PM2, Cloudflared).
|
||||||
|
- Configuring Nginx reverse proxy.
|
||||||
|
- Setting up a cron job for **auto-updates every 5 minutes**.
|
||||||
|
|
||||||
### Configuration Presets
|
👉 **[Read the Full Deployment Guide](PROXMOX_DEPLOY_TEMPLATE.md)**
|
||||||
- **Office 365**: `smtp.office365.com:587` (STARTTLS)
|
|
||||||
- **Gmail**: `smtp.gmail.com:587` (STARTTLS)
|
|
||||||
- **SendGrid**: `smtp.sendgrid.net:587` (STARTTLS)
|
|
||||||
- **Mailgun**: `smtp.mailgun.org:587` (STARTTLS)
|
|
||||||
- **Amazon SES**: `email-smtp.us-east-1.amazonaws.com:587` (STARTTLS)
|
|
||||||
|
|
||||||
### Auto-Discovery
|
---
|
||||||
Click "Auto Discovery Test" to automatically test multiple port/encryption combinations.
|
|
||||||
|
|
||||||
## Development
|
## 🔒 Security Note
|
||||||
|
|
||||||
### Project Structure
|
This application is designed for testing purposes.
|
||||||
```
|
- **Passwords are processed in memory only** on the server side to attempt the SMTP connection.
|
||||||
Advanced-Smtp-Tester/
|
- **No credentials are stored** on the server.
|
||||||
├── electron-main.js # Electron entry point
|
- **Test History** is stored **locally in your browser** (IndexedDB). clearing your browser cache will clear your history.
|
||||||
├── server.js # Express server
|
- The "Unencrypted" option is provided for legacy server testing but should be used with caution.
|
||||||
├── index.html # Main UI
|
|
||||||
├── public/
|
|
||||||
│ ├── db.js # IndexedDB wrapper
|
|
||||||
│ ├── script.js # Frontend logic
|
|
||||||
│ ├── styles.css # Styling
|
|
||||||
│ └── Logo.png # App icon
|
|
||||||
└── .github/
|
|
||||||
└── workflows/
|
|
||||||
└── build-desktop.yml # Automated builds
|
|
||||||
```
|
|
||||||
|
|
||||||
### Scripts
|
---
|
||||||
- `npm start` - Start web server
|
|
||||||
- `npm run electron` - Run desktop app
|
|
||||||
- `npm run build` - Build Windows installer
|
|
||||||
- `npm run build:dir` - Build unpacked directory
|
|
||||||
|
|
||||||
## Technologies
|
## 🤝 Contributing
|
||||||
|
|
||||||
- **Backend**: Node.js, Express, Nodemailer
|
Contributions are welcome! Please feel free to submit a Pull Request.
|
||||||
- **Frontend**: Vanilla JavaScript, IndexedDB
|
|
||||||
- **Desktop**: Electron
|
|
||||||
- **Build**: electron-builder, electron-packager
|
|
||||||
|
|
||||||
## License
|
1. Fork the project
|
||||||
|
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
|
||||||
|
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
|
||||||
|
4. Push to the branch (`git push origin feature/AmazingFeature`)
|
||||||
|
5. Open a Pull Request
|
||||||
|
|
||||||
ISC
|
---
|
||||||
|
|
||||||
## Author
|
## 📄 License
|
||||||
|
|
||||||
Beyond Cloud Technology
|
This project is licensed under the ISC License.
|
||||||
|
|
||||||
## Links
|
---
|
||||||
|
|
||||||
- [GitHub Repository](https://github.com/DeNNiiInc/Advanced-Smtp-Tester)
|
<div align="center">
|
||||||
- [YouTube Channel](https://www.youtube.com/@beyondcloudtechnology)
|
<p>Built with ❤️ by <strong>Beyond Cloud Technology</strong></p>
|
||||||
|
<a href="https://www.youtube.com/@beyondcloudtechnology">YouTube Channel</a> •
|
||||||
|
<a href="https://beyondcloud.technology">Website</a>
|
||||||
|
</div>
|
||||||
|
|||||||
BIN
docs/feature_git_badge.png
Normal file
BIN
docs/feature_git_badge.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.8 KiB |
BIN
docs/feature_main_interface.png
Normal file
BIN
docs/feature_main_interface.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 146 KiB |
Reference in New Issue
Block a user