{"id":26408069,"url":"https://github.com/joedemcher/simplelogin-cli","last_synced_at":"2025-10-07T05:35:22.333Z","repository":{"id":281546442,"uuid":"734648243","full_name":"joedemcher/simplelogin-cli","owner":"joedemcher","description":"A command line interface for SimpleLogin","archived":false,"fork":false,"pushed_at":"2025-03-20T19:44:47.000Z","size":112,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-03T09:58:43.791Z","etag":null,"topics":["cli","email","python","simplelogin"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/simplelogin/","language":"Python","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/joedemcher.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"zenodo":null}},"created_at":"2023-12-22T08:28:41.000Z","updated_at":"2025-08-25T02:22:04.000Z","dependencies_parsed_at":"2025-07-04T20:34:42.336Z","dependency_job_id":"3243e8ee-837d-4f44-bb4b-1bd643ab6e89","html_url":"https://github.com/joedemcher/simplelogin-cli","commit_stats":null,"previous_names":["joedemcher/simplelogin-cli"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/joedemcher/simplelogin-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joedemcher%2Fsimplelogin-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joedemcher%2Fsimplelogin-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joedemcher%2Fsimplelogin-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joedemcher%2Fsimplelogin-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joedemcher","download_url":"https://codeload.github.com/joedemcher/simplelogin-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joedemcher%2Fsimplelogin-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278723919,"owners_count":26034691,"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","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cli","email","python","simplelogin"],"created_at":"2025-03-17T18:37:48.519Z","updated_at":"2025-10-07T05:35:22.314Z","avatar_url":"https://github.com/joedemcher.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SimpleLogin CLI\r\n\r\nA command-line interface for managing your [SimpleLogin](https://simplelogin.io/) email aliases and custom domains.\r\n\r\n\u003e Disclaimer: This tool is not officially associated with or endorsed by SimpleLogin. It is an independent, community-developed project that interacts with the SimpleLogin API.\r\n\r\n## Overview\r\n\r\nSimpleLogin CLI provides a convenient way to manage your SimpleLogin email aliases directly from your terminal. With this tool, you can:\r\n\r\n- List, create, toggle, and delete email aliases\r\n- View detailed information about your aliases\r\n- Manage contacts for your aliases\r\n- Manage custom domains \r\n- View mailboxes associated with your account\r\n- Search and filter your aliases\r\n\r\n## Installation\r\n\r\n### Prerequisites\r\n\r\n- Python 3.6 or higher\r\n- A SimpleLogin account with an API key\r\n\r\n### Install via pip\r\n\r\n```bash\r\npip install simplelogin\r\n```\r\n\r\n### Manual Installation\r\n\r\n1. Clone the repository:\r\n   ```bash\r\n   git clone https://github.com/joedemcher/simplelogin-cli.git\r\n   cd simplelogin-cli\r\n   ```\r\n\r\n2. Install dependencies/package:\r\n   ```bash\r\n   pip install .\r\n   ```\r\n\r\n## Configuration\r\n\r\nBefore using SimpleLogin CLI, you need to configure your API key:\r\n\r\n```bash\r\nsimplelogin config set-key YOUR_API_KEY\r\n```\r\n\r\nYou can create your API key in the SimpleLogin dashboard under API Keys.\r\n\r\nAlternatively, you can set the API key as an environment variable:\r\n\r\n```bash\r\nexport SIMPLELOGIN_API_KEY=YOUR_API_KEY\r\n```\r\n\r\nTo view your current configuration:\r\n\r\n```bash\r\nsimplelogin config view\r\n```\r\n\r\n## Usage\r\n\r\n### Managing Aliases\r\n\r\n#### List aliases\r\n\r\n```bash\r\n# List all aliases\r\nsimplelogin aliases list\r\n\r\n# Paginate through aliases\r\nsimplelogin aliases list --page=1\r\n\r\n# Show only enabled aliases\r\nsimplelogin aliases list --enabled\r\n\r\n# Show only disabled aliases\r\nsimplelogin aliases list --disabled\r\n\r\n# Show only pinned aliases\r\nsimplelogin aliases list --pinned\r\n\r\n# Search aliases\r\nsimplelogin aliases list --query=\"github\"\r\n```\r\n\r\n#### Create aliases\r\n\r\n```bash\r\n# Create a custom alias\r\nsimplelogin aliases create custom github\r\n# You'll be prompted to select a suffix and mailbox\r\n\r\n# Create a custom alias with options\r\nsimplelogin aliases create custom github --note=\"For GitHub notifications\" --name=\"GitHub\"\r\n\r\n# Create a random alias\r\nsimplelogin aliases create random\r\n\r\n# Create a random alias with word mode\r\nsimplelogin aliases create random --mode=word\r\n\r\n# Create a random alias with a note\r\nsimplelogin aliases create random --note=\"For newsletter signups\"\r\n```\r\n\r\n#### Manage existing aliases\r\n\r\n```bash\r\n# Toggle an alias (enable/disable)\r\nsimplelogin aliases toggle 123\r\n\r\n# Delete an alias\r\nsimplelogin aliases delete 123\r\n\r\n# View detailed information about an alias\r\nsimplelogin aliases info 123\r\n```\r\n\r\n#### Manage contacts\r\n\r\n```bash\r\n# List contacts for an alias\r\nsimplelogin contacts list 123\r\n\r\n# Create a new contact for an alias\r\nsimplelogin contacts create 123 user@example.com\r\n\r\n# Delete a contact for an alias\r\nsimplelogin contacts delete 123\r\n\r\n# Toggle a contact (block/unblock)\r\nsimplelogin contacts toggle 123\r\n```\r\n\r\n### Managing Custom Domains\r\n\r\n```bash\r\n# List all custom domains\r\nsimplelogin domains list\r\n\r\n# View domain details\r\nsimplelogin domains info 42\r\n\r\n# Update domain settings\r\nsimplelogin domains update 42 --catch-all=true --random-prefix=true\r\n\r\n# View deleted aliases for a domain\r\nsimplelogin domains trash 42\r\n```\r\n\r\n### Managing Mailboxes\r\n\r\n```bash\r\n# List all mailboxes\r\nsimplelogin mailboxes list\r\n```\r\n\r\n## Advanced Usage\r\n\r\n### Specifying Mailboxes\r\n\r\nWhen creating a custom alias, you can specify which mailboxes should receive emails:\r\n\r\n```bash\r\nsimplelogin aliases create custom github --mailboxes=1,2,3\r\n```\r\n\r\nIf you don't specify mailboxes, you'll be prompted to select them interactively.\r\n\r\n### Environment Variables\r\n\r\nThe tool recognizes the following environment variables:\r\n\r\n- `SIMPLELOGIN_API_KEY`: Your SimpleLogin API key\r\n- `SIMPLELOGIN_CONFIG`: Custom path to the configuration file\r\n- `XDG_CONFIG_HOME`: Base directory for user-specific configuration files\r\n\r\n## Troubleshooting\r\n\r\n### Common Issues\r\n\r\n1. **API Key errors**: Ensure your API key is correctly set and that it's valid in the SimpleLogin dashboard.\r\n\r\n2. **Rate limiting**: SimpleLogin may rate-limit API requests. If you encounter errors, try again after a short delay.\r\n\r\n3. **Permissions issues**: Some operations may require a premium SimpleLogin subscription.\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the LICENSE file for details.\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Please feel free to submit a Pull Request.\r\n\r\n## Acknowledgements\r\n\r\n- [SimpleLogin](https://simplelogin.io/) for their email alias service\r\n- [docopt](http://docopt.org/) for command-line interface parsing\r\n- [tabulate](https://github.com/astanin/python-tabulate) for pretty table formatting\r\n- [questionary](https://github.com/tmbo/questionary) for interactive prompts\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoedemcher%2Fsimplelogin-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoedemcher%2Fsimplelogin-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoedemcher%2Fsimplelogin-cli/lists"}