Your Gmail address can be "scrambled". This allows you to have 10k or up to unlimited addresses linked to one inbox. This is done by adding periods or plus signs at the end of the username.
This repository helps you generate a big amount of gmail aliases automatically.
1. How do I run it?
2. Walkthrough
3. How does it work?
4. Examples
5. Troubleshooting
You can run the code via the Replit project. Just go the link and click run at the top of the page.
Alternatively you can clone the code and run it on your own machine.
In the CMD:
git clone https://github.com/brentspine/gmail-alias-generator
Run it:
cd gmail-alias-generator
python main.py
After running the program, it asks you to input a valid gmail address. You can also keep the field empty if you just want to test functionality
When the program is done generating your aliases you are prompted with some options you can choose from
You can generate as many aliases as you want by pressing "1" and pressing enter.
To copy and use your aliases you can either use option 4, which prints all addresses or option 3, which exports them to a file.
If the file you want to export to already exists you can either choose the write or the append mode. The write mode wipes all contents of the file and overwrites them, while the append mode adds the new addresses to the .txt. Important to notice is, that it won't check for duplicates.
Adding dots in between the username
-> When receiving mails, Google removes all dots from your address
-> This is why we can add random dots accross the address to "scramble it"
-> In this case we have the following rules
- Don't add dots at the beginning or end and only before the @ sign
- Don't surpass the threshold of 43 % dots
- Don't have 2 dots in a row (exam..ple@gmail.com)
-> Example: exam.plema.il@gmail.com forwards to example.mail@gmail.com
Alternating between domains
-> @gmail.com and @googlemail.com are basically the same
-> We can still use both addresses on one service
-> Meaning we essentially double our alias amount
-> Example: example.mail@googlemail.com forwards to example.mail@gmail.com
Adding a + at the end of our username
-> Gmail also has a built-in functionality for alias generation
-> We can add a + sign at the end of our username and everything between it and the @ will be ignored
-> Example: example.mail+g34d@gmail.com forwards to example.mail@gmail.com
Examples
-> e.xamp.lemai.l+89dfgascb@googlemail.com forwards to example.mail@gmail.com
-> m.y.c.ooladdres.s+xyz69@gmail.com forwards to my.cool.address@gmail.com
I've given some examples in the how does it work section, but I've also generated some files as example outputs. You can find them here.
If you still have problems you can open an issue or contact me.