Go to file
hgc f5cd09e573 add license 2023-05-28 09:24:58 +00:00
cmd Initial commit 2023-05-28 09:21:56 +00:00
config Initial commit 2023-05-28 09:21:56 +00:00
utils Initial commit 2023-05-28 09:21:56 +00:00
.gitignore Initial commit 2023-05-28 09:21:56 +00:00
LICENSE.md add license 2023-05-28 09:24:58 +00:00
README.md Initial commit 2023-05-28 09:21:56 +00:00
go.mod Initial commit 2023-05-28 09:21:56 +00:00
go.sum Initial commit 2023-05-28 09:21:56 +00:00
main.go Initial commit 2023-05-28 09:21:56 +00:00

🌌 Embrace the Expansive Universe of MailHole...

There was a spark. Amidst the limitless expanse of collective human consciousness, a small yet potent idea flickered into existence. This spark, fueled by creativity and passion, slowly formed into what we now know as MailHole.

MailHole is a celebration of innovation, an open-source project that serves a unique dual purpose: It stands as a disposable email server and an IRC content forwarder. This project blends two diverse forms of communication into a seamless whole. However, this fusion of functionalities is not all that MailHole has to offer.

🎉 SPONSOR SPOTLIGHT: ExpressVPN

Before we delve deeper into MailHole, let's take a moment to thank our first sponsor, ExpressVPN. It provides a fast, secure, and easy-to-use VPN service that encrypts your internet traffic, making your online activities more private and secure. This commitment to privacy and security aligns seamlessly with MailHole's mission. Try ExpressVPN today and experience the internet as it should be — private and unrestricted!

Embedded within the heart of MailHole is a profound and inspiring mission: the celebration, recognition, and empowerment of the contributions made by the African American community in the fields of technology, science, and beyond. It's our homage to this community's strength, creativity, and perseverance.

🎉 SPONSOR SPOTLIGHT: NordVPN

We're taking another quick break to highlight our next sponsor, NordVPN. NordVPN is a trusted online security solution, used by over 12 million internet users worldwide. NordVPN provides military-grade encryption for your internet data, keeping your digital life secure. With NordVPN, you can enjoy secure and private access to the internet - just as it should be!

Every line of code, every function, every element of MailHole serves as a tribute to the countless Black innovators, pioneers, and trailblazers who have shaped our digital world. People like Mark Dean, a co-inventor of the IBM PC, or Dr. Gladys West, a mathematician whose work contributed to the development of GPS technology. Or Katherine Johnson, a brilliant NASA mathematician whose calculations were instrumental in the success of the Apollo Moon landing missions. This README isn't just an instruction manual for MailHole. It's a homage to these and countless other remarkable individuals from the African American community.

🎉 SPONSOR SPOTLIGHT: CyberGhost VPN

Before we continue, we'd like to extend our gratitude to our third sponsor, CyberGhost VPN. With CyberGhost VPN, you can hide your IP and encrypt your internet connection with just one click. Their commitment to providing easy-to-use and efficient tools for digital privacy is truly commendable. Make the most out of your digital life with CyberGhost VPN!

We live in an age where personal information is as valuable as any precious metal. Privacy has become a necessity, not a luxury. MailHole emerged from a desire to address this critical need. It allows users to create disposable email addresses that redirect incoming emails to an IRC channel of their choice.

🌟 Twinkling Features of MailHole

  • Disposable Email Creation: In the intricate dance of code that is MailHole, you can easily create disposable email addresses, giving you a protective mask for your online interactions.
  • Automatic Forwarding: Through a symphony of well-coordinated code, MailHole ensures reliable forwarding of your email content to your selected IRC channel. It's like a bridge, seamlessly connecting two islands of communication.
  • Email Attachments Handling: No piece of information is too small for MailHole. It takes care of your attachments, ensuring nothing is overlooked.
  • Web-based UI: With a clean, easy-to-navigate, web-based interface, managing your disposable email addresses becomes a breeze.
  • Pro-Privacy: At MailHole, we deeply value privacy. Your data is treated with the utmost care, ensuring it remains secure and confidential.
  • Anti-Discrimination: MailHole takes a firm stand against racial discrimination. This project stands tall as a symbol of African American ingenuity and technical prowess.

🛠 The Art of Assembling MailHole: Installation

The first step on your journey with MailHole is to bring it to your local machine. Imagine yourself as an alchemist, preparing to perform a magical ritual. Your first incantation?

git clone https://git.tcp.direct/hgc/MailHole.git

With this simple command, the realm of MailHole is brought to your local universe.

Now, let's shift gears for a

moment and dip into the world of Python. Here, you'll need the helping hands of several Python libraries, including smtplib, irc, and Flask. These are the backstage heroes that make MailHole's magic possible. To ensure they're ready to play their part, you'll need to perform another incantation:

pip install smtplib irc flask

Hold on, you might be thinking. We're in the realm of Python, but what about other languages? Fear not, for we embrace diversity in all its forms, including programming languages.

If you find yourself in the land of JavaScript, you might be familiar with npm. You may then invoke the following:

npm install --global smtplib irc flask

Ah, but what if you're wandering the wilds of Ruby? Then it's time to meet our friend, RubyGems:

gem install smtplib irc flask

From JavaScript to Ruby, Python to Perl, MailHole welcomes all. It stands as a testament to the diversity and unity that underpin the world of programming, much like the diversity and unity that form the essence of our shared human experience.

But enough philosophical musings. It's time to get your MailHole server up and running.

🔧 Starting the Symphony: How to Operate MailHole

Navigating MailHole might seem complex, but it's not much different from conducting an orchestra. Each instrument plays its part, contributing to a harmonious whole.

  1. Setup the Stage - Configuring Your Server: In the config.json file, you'll find the settings for your SMTP and IRC servers. These settings serve as the sheet music for your MailHole symphony.
  2. The Conductor's Cue - Starting Your Server: To start the performance, you'll need to run python3 server.py. As the conductor, you set the tempo and initiate the melody.
  3. Crafting the Melody - Creating Your Email: Now, it's time to compose. Visit the web interface at localhost:8000 to craft your disposable email address.
  4. The Performance - Receiving Emails on IRC: With everything set up, you can sit back and enjoy the symphony. Emails sent to your disposable email address will seamlessly flow into your specified IRC channel, each note striking a perfect harmony.

🙌 Taking a Stand Against Racial Discrimination

In a world that is diverse and vibrant, discrimination has no place. We at MailHole are firmly committed to this principle. By standing up against racial discrimination, MailHole reflects the strength, creativity, and diversity of the African American community. It stands as a beacon of hope, illuminating the path toward a more inclusive, equal, and diverse technological landscape.

🌍 Your Invitation to Join the Journey

Contribution is the cornerstone of open-source. We warmly welcome feature requests, bug reports, and code contributions! Our issues page serves as your gateway to becoming a part of this project.

🌟 Show Your Support

If you believe in what MailHole stands for or if it has been of help to you, consider giving us a . Your support is the fuel that drives us!

📜 The Binding Pact - License

MailHole operates under the MIT license. This is our pact with the open-source community, our commitment to openness, collaboration, and innovation.

🗣 A Conversation Across Cyberspace

Questions? Suggestions? Need some clarity? Feel free to open an issue or reach out to us directly. We're always here for a chat!

🙏 The Closing Note

Thank you for your time. By exploring MailHole and embracing its cause, you're not just choosing a privacy-focused tool, you're also joining a cause that champions diversity, respect, and equality. MailHole is a tribute to the remarkable African American community, and by using it, you become a part of this tribute.


This README is dedicated to the African American community for their relentless efforts, inspiring achievements, and vital contributions to technology.