A Flask-based web application for testing SMTP server connections and sending test emails
Project description
SMTP Tester
A Flask-based web application to test SMTP server connections and send test emails. This tool is designed to help developers and system administrators verify SMTP server configurations with a user-friendly interface and AI-powered chat support.
Overview
SMTP Tester provides:
- Testing of SMTP server connectivity with security options (None, SSL, TLS, Auto).
- Sending test emails to verify sender and recipient addresses.
- Real-time chat assistance powered by OpenAI.
- Email address validation before sending.
- Secure form submissions with CSRF protection.
- Configuration of sensitive settings via
.envfile.
This project is open-source under the MIT License and welcomes contributions from the community.
Demo
SMTP Tester features a sleek, dark-themed interface with a form to input SMTP details and a live chat for troubleshooting. Run it locally to see it in action, or check the Issues page for planned UI enhancements!
Installation and Usage
Prerequisites
- Python 3.6 or higher
- pip (Python package manager)
- Git (for cloning the repository)
Installation Steps
- Clone the repository:
git clone https://github.com/Mrv3n0m666/Smtp-Webtester.git cd Smtp-Webtester
- Install dependencies:
pip install -r requirements.txt
- Create a
.envfile in the project root and add your OpenAI API key:OPENAI_API_KEY=sk-proj-your-api-key
- Run the application:
python smtpWEBtester.py
Usage
- Open your browser and navigate to
http://localhost:5000. - Fill in the SMTP server details:
- SMTP Host: e.g.,
smtp.example.com - Port: Common ports are
465(SSL) or587(TLS) - Security: Choose
None,SSL,TLS, orAuto - Username: Your SMTP username (e.g.,
your@email.com) - Password: Your SMTP password or API key
- Mail From: Sender email address
- Mail To: Recipient email address
- SMTP Host: e.g.,
- Click Test SMTP to send a test email.
- Check the result message for success or error details.
- Use the chat feature on the right to ask for assistance or troubleshooting tips.
Notes
- Ensure your SMTP server supports the selected security protocol.
- Email addresses are validated to prevent errors.
- The form is protected against CSRF attacks.
- For production, configure a secure environment and disable debug mode (
debug=True).
Roadmap
We aim to make SMTP Tester more robust and feature-rich. Planned features include:
- Support for multiple recipients in a single test.
- Test history stored in a local database.
- Integration with alternative AI chat providers (e.g., xAI Grok).
- Automated tests with pytest.
- Deployment guides for platforms like Heroku or Docker.
Have an idea? Open an issue to discuss!
Contributing
We love contributions! Whether you're fixing bugs, adding features, or improving docs, your help is welcome. See our CONTRIBUTING.md for detailed guidelines on how to get started. Check the Issues page for tasks labeled good first issue or help wanted.
License
MIT License. See LICENSE for details.
Acknowledgements
- Thanks to the Flask and OpenAI communities for their amazing tools.
- Shoutout to future contributors for helping improve SMTP Tester!
Contact
For questions, suggestions, or bug reports, please open an issue or contact Mrv3n0m666.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file smtp_webtester-0.1.0.tar.gz.
File metadata
- Download URL: smtp_webtester-0.1.0.tar.gz
- Upload date:
- Size: 3.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.9.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
453e53ac7f6ff8eb0c9c27778b75e476f5fe8d82e4e78c861421f523297ed7d5
|
|
| MD5 |
7a34ff5292ccf6cce46d0c95865e4e6c
|
|
| BLAKE2b-256 |
3b15c2549bba58cda17c5cf8eba6cc44743f4af1579006b02b2876c9a5af33aa
|
File details
Details for the file smtp_webtester-0.1.0-py3-none-any.whl.
File metadata
- Download URL: smtp_webtester-0.1.0-py3-none-any.whl
- Upload date:
- Size: 3.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.9.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
36f8f051786cf3a9a8516f2f9d332d013569bc50ae94b37535d9d5cf345f65f8
|
|
| MD5 |
09d6c3538a81e53f0326d4549967df6b
|
|
| BLAKE2b-256 |
700199fd1d46eb3d6f4d0389415254bdde0f390febbf52ddd5e3c0fb21614839
|