{"id":16162664,"url":"https://github.com/slashtechno/generate-ddg","last_synced_at":"2025-10-10T01:02:07.135Z","repository":{"id":255060941,"uuid":"848390092","full_name":"slashtechno/generate-ddg","owner":"slashtechno","description":"Generate DuckDuckGo Emails (Duck Addresses) from the command line!","archived":false,"fork":false,"pushed_at":"2024-09-22T20:43:01.000Z","size":103,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-13T08:29:43.497Z","etag":null,"topics":["aliases","duckduckgo","email-forwarding"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/slashtechno.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-27T17:10:46.000Z","updated_at":"2024-09-22T20:42:47.000Z","dependencies_parsed_at":"2024-12-23T17:32:41.654Z","dependency_job_id":null,"html_url":"https://github.com/slashtechno/generate-ddg","commit_stats":{"total_commits":16,"total_committers":1,"mean_commits":16.0,"dds":0.0,"last_synced_commit":"566887b0c20f5f0abe1858520f9e114307126904"},"previous_names":["slashtechno/generate-ddg"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slashtechno%2Fgenerate-ddg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slashtechno%2Fgenerate-ddg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slashtechno%2Fgenerate-ddg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slashtechno%2Fgenerate-ddg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slashtechno","download_url":"https://codeload.github.com/slashtechno/generate-ddg/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247589835,"owners_count":20963022,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aliases","duckduckgo","email-forwarding"],"created_at":"2024-10-10T02:32:12.772Z","updated_at":"2025-10-10T01:02:02.099Z","avatar_url":"https://github.com/slashtechno.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Generate DDG\n[![GitHub Actions Build Workflow Status](https://img.shields.io/github/actions/workflow/status/slashtechno/generate-ddg/go-build.yml?style=for-the-badge\u0026label=Build\u0026labelColor=%2344cc11\u0026color=%23555555)](https://github.com/slashtechno/generate-ddg/actions/workflows/go-build.yml) ![Static Badge](https://img.shields.io/badge/open-source-_?style=for-the-badge\u0026labelColor=%23ef4041\u0026color=%23c13a3a)\n\nGo program that allows you to generate DuckDuckGo email aliases from the command line.\n![Demo](demo.gif)\n\n### Setup and Usage\n1. Create a [Duck Address](https://duckduckgo.com/email/) if you don't already have one  \n2. Run `generate-ddg config` to complete the initial setup.\n    - Config key names can also be set as environment variables (capitalized and `-` replaced with `_`)\n    - `.env` is loaded\n3. Run `generate-ddg`  \n    - 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 \"\u003cphrase\u003e\"`.  \n    - The config files will be stored in `\u003cXDG_CONFIG_HOME\u003e/generate-ddg/`. The directory is dependent on your OS:\n        - Linux: `~/.config/generate-ddg.\n        - Windows: `%APPDATA%\\generate-ddg`\n        - MacOS: `~/Library/Application Support/generate-ddg`\n        - For more information, see [adrg/xdg](https://github.com/adrg/xdg?tab=readme-ov-file#xdg-base-directory)\n4. The program will generate a new email alias and print it to the console.  \n\n### Installation  \n\n#### Binary  \nDownload the latest release from the [releases page](https://github.com/slashtechno/generate-ddg/releases), ensuring you download the correct binary for your system.  \nExecute the binary from the command line! Optionally, you can move it to a directory in your PATH.  \nFor example, on Linux, if you've downloaded `generate-ddg_linux_amd64` to your Downloads directory:  \n```sh\nmv ~/Downloads/generate-ddg_linux_amd64 /usr/local/bin/generate-ddg\nchmod +x /usr/local/bin/generate-ddg\ngenerate-ddg # Run it!\n```\n\n#### Building from source  \nEnsure you have Go installed on your system.  \n```sh\ngit clone https://github.com/slashtechno/generate-ddg.git\ncd generate-ddg\ngo install\n```\n\n\n### Contributing  \nPull Requests are welcome!  \n\n### Acknowledgements  \n* [whatk233/ddg-email-panel](https://github.com/whatk233/ddg-email-panel)  \n    * Ended up looking through the source code to get a better understanding of how DuckDuckGo's authentication works.\n* [DuckDuckGo](https://duckduckgo.com/email/)\n    * I've not run into any issues (at the time of writing) with their service and it's worked quite well for me.\n* [Bitwarden](https://bitwarden.com/)\n    * They have a [feature](https://bitwarden.com/help/generator/#tab-duckduckgo-3Uj911RtQsJD9OAhUuoKrz) wherein you can input the API token for DuckDuckGo (retrieved from DevTools' Network tab) allowing you to generate aliases from within the Bitwarden.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslashtechno%2Fgenerate-ddg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslashtechno%2Fgenerate-ddg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslashtechno%2Fgenerate-ddg/lists"}