⚠️ Deprecated. Use AtomicEmails/AtomicEmails instead.
Ymail is a user-friendly telegram bot that lets you create temporary email addresses and receive emails on your smartphone for free. It's open source design allows you to receive emails from any website or service requiring email verification, as well as from friends and family. The bot helps safeguard your privacy and keep your email address secure by preventing spamming and hacking attempts.
YmailBot is a free, open source, and user-friendly temporary email service that allows you to receive emails on your smartphone. It is a great alternative to other temporary email services that require you to sign up for an account and provide your personal information. Ymail is a great way to protect your privacy and keep your email address secure. There is also an ability to connect your own domain to the bot to prevent service from being blocked by some websites.
You can create a temporary email address by sending the command /new to the
bot. The bot will then generate a random email address for you and forward all
incoming emails to your chat.
One persistent email address is created for each chat. You can use this email address to receive emails from friends and family instead of using your main email address. The bot will forward all incoming emails to your chat.
You can connect your own domain to the bot to prevent service from being blocked by some websites. To do that, you need to install bot on your own machine and follow the instructions in the Installation section.
- Deno runtime or Docker Compose
- Custom domain
- SurrealDB Instance or Docker Compose
- Mailgun account
Using Docker Compose:
- Clone the repository and navigate to the project directory.
$ git clone https://github.com/voxelin/Ymail.git
$ cd Ymail- Rename
.env.exampleto.envand fill in the required fields.
$ mv .env.example .env
$ nano .env- Run the bot using Docker Compose.
$ docker-compose up -d- Next steps from Network Setup section.
Using Deno:
- Clone the repository and navigate to the project directory.
$ git clone https://github.com/voxelin/Ymail.git
$ cd Ymail- Rename
.env.exampleto.envand fill in the required fields.
$ mv .env.example .env
$ nano .env- Start the database server.
$ curl -sSf https://install.surrealdb.com | sh
$ surreal start --user <username-from-env> --pass <password-from-env> <DB-Path-from-env>- Run the bot using Deno.
$ deno task edge- Set up a webhook integration in your bot's settings. You can use ngrok to expose your local server to the internet.
$ ngrok http 7000- Set up a webhook integration in your bot's settings. Use the URL provided by ngrok as the webhook URL.
// Navigate to https://api.telegram.org/bot<your-bot-token>/setWebhook?url=<your-webhook-url>/bot/<your-bot-token>. You should receive a response like this:
{ "ok": true, "result": true, "description": "Webhook was set" }- Login to your mailgun account and add your custom domain. Follow the instructions on the mailgun website to verify your domain.
- Open Receiving tab and create a new route. Set these settings:
+ Expression type: Catch All
+ Forward: <your-webhook-url>/receive?secret=SECRET_KEY_FROM_ENV
+ Priority: 0You are all set! Now you can use the bot to create temporary email addresses and receive emails on your smartphone. 🎊📬
/start- Start the bot./help- Show help message./new- Create a new temporary email address./list- List all temporary email addresses./delete- Delete your temporary email address./deleteall- Delete all temporary email addresses.
Contributions are welcome! Please read the contribution guidelines first.
This project is licensed under the GNU General Public License - see the LICENSE file for details.
- voxelin 🇺🇦 - The creator of this project.
- SurrealDB - A simple, fast, and secure database that I personally love.
- Mailgun - A simple service for sending and receiving emails.
- Deno - A secure runtime for JavaScript and TypeScript.
- Docker - A great tool for containerizing applications.
- ngrok - An easy way for exposing local servers to the internet.