Temp Mail Bot

A fast and secure Telegram bot written in Crystal that provides temporary email addresses. It automatically fetches emails and intelligently extracts verification codes and links, keeping your chat clean and efficient.

✨ Features

• 🎲 Instant Email Generation: Get a random temporary email address with a single command.
• 🧠 Smart Extraction: Automatically detects and extracts verification codes (OTP) and confirmation links.
• 🧹 Clean Interface: Strips unnecessary HTML, styles, and scripts from emails.
• 🚀 High Performance: Built with Crystal for blazing fast speed and low resource usage.
• 🔄 Auto-Polling: Checks for new emails in the background automatically.

🛠️ Tech Stack

• Language: Crystal 💎
• Framework: Tourmaline (Telegram Bot API)
• HTTP Client: Halite

🚀 Getting Started

Prerequisites

• Crystal (latest version)
• A Telegram Bot Token (from @BotFather)

Installation

1. Clone the repository

   git clone https://github.com/teenagelove/temp-mail-bot.git
   cd temp-mail-bot
   

2. Install dependencies

   shards install
   

3. Set up environment variables Export your Telegram bot token:

   export TELEGRAM_BOT_TOKEN="your_bot_token_here"
   

4. Run the bot

   crystal run src/temp_mail_bot.cr
   

📖 Usage

• /start - Welcome message and instructions.
• /new - Generate a new temporary email address.

The bot will automatically forward any incoming emails to your chat. If an email contains a verification code or link, the bot will highlight it for you!

🧪 Development

Run the test suite to ensure everything is working correctly:

crystal spec

🤝 Contributing

1. Fork it (https://github.com/teenagelove/temp-mail-bot/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

👥 Contributors

• Danil Kazakov - creator and maintainer

📄 License

Distributed under the MIT License. See LICENSE for more information.

Made with ❤️ and 💎 Crystal.