

Go program that allows you to generate DuckDuckGo email aliases from the command line.
- Create a Duck Address if you don’t already have one
- Run
generate-ddg config
to complete the initial setup.- Config key names can also be set as environment variables (capitalized and
-
replaced with_
) .env
is loaded
- Config key names can also be set as environment variables (capitalized and
- Run
generate-ddg
- In some cases, this may error if DuckDuckGo suspects you are a bot. If this happens, try to login normally (through DuckDuckGo) and when the magic link/phrase is sent to your email, run the program again with
--otp "<phrase>"
. - The config files will be stored in
<XDG_CONFIG_HOME>/generate-ddg/
. The directory is dependent on your OS:- Linux: `~/.config/generate-ddg.
- Windows:
%APPDATA%\generate-ddg
- MacOS:
~/Library/Application Support/generate-ddg
- For more information, see adrg/xdg
- In some cases, this may error if DuckDuckGo suspects you are a bot. If this happens, try to login normally (through DuckDuckGo) and when the magic link/phrase is sent to your email, run the program again with
- The program will generate a new email alias and print it to the console.
Download the latest release from the releases page, ensuring you download the correct binary for your system.
Execute the binary from the command line! Optionally, you can move it to a directory in your PATH.
For example, on Linux, if you’ve downloaded generate-ddg_linux_amd64
to your Downloads directory:
mv ~/Downloads/generate-ddg_linux_amd64 /usr/local/bin/generate-ddg
chmod +x /usr/local/bin/generate-ddg
generate-ddg # Run it!
Ensure you have Go installed on your system.
git clone https://github.com/slashtechno/generate-ddg.git
cd generate-ddg
go install
Pull Requests are welcome!
- whatk233/ddg-email-panel
- Ended up looking through the source code to get a better understanding of how DuckDuckGo’s authentication works.
- DuckDuckGo
- I’ve not run into any issues (at the time of writing) with their service and it’s worked quite well for me.
- Bitwarden
- They have a feature wherein you can input the API token for DuckDuckGo (retrieved from DevTools’ Network tab) allowing you to generate aliases from within the Bitwarden.

Leave a Reply