{"id":25092543,"url":"https://github.com/peterbueschel/awsdefault","last_synced_at":"2026-05-09T09:40:38.538Z","repository":{"id":57568358,"uuid":"118642756","full_name":"peterbueschel/awsdefault","owner":"peterbueschel","description":"handle your Amazon AWS profile/account on your host globally","archived":false,"fork":false,"pushed_at":"2019-02-28T18:06:29.000Z","size":387,"stargazers_count":0,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-07T14:19:25.118Z","etag":null,"topics":["aws","aws-profile","cli-utility","golang","gtk3","profile","tool"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/peterbueschel.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}},"created_at":"2018-01-23T17:12:22.000Z","updated_at":"2019-02-28T18:05:55.000Z","dependencies_parsed_at":"2022-08-28T08:20:27.376Z","dependency_job_id":null,"html_url":"https://github.com/peterbueschel/awsdefault","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterbueschel%2Fawsdefault","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterbueschel%2Fawsdefault/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterbueschel%2Fawsdefault/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterbueschel%2Fawsdefault/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/peterbueschel","download_url":"https://codeload.github.com/peterbueschel/awsdefault/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246716717,"owners_count":20822508,"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":["aws","aws-profile","cli-utility","golang","gtk3","profile","tool"],"created_at":"2025-02-07T14:19:24.388Z","updated_at":"2026-05-09T09:40:33.512Z","avatar_url":"https://github.com/peterbueschel.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"awsdefault\n==========\n[![Build Status](https://travis-ci.org/peterbueschel/awsdefault.svg?branch=master)](https://travis-ci.org/peterbueschel/awsdefault)\n[![Go Report Card](https://goreportcard.com/badge/github.com/peterbueschel/awsdefault)](https://goreportcard.com/report/github.com/peterbueschel/awsdefault)\n[![Coverage Status](https://coveralls.io/repos/github/peterbueschel/awsdefault/badge.svg?branch=master)](https://coveralls.io/github/peterbueschel/awsdefault?branch=master)\n\n*Change [Amazon AWS](https://aws.amazon.com) profiles/accounts globally.*\n\nThis tool sets one of your AWS profiles, configured in your $HOME/.aws/credentials file (see  [here](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html)),\n to the default profile.\nMeans:\n- adding parameters like `--profile=my-profile` to the aws cli\n- or changing the environment variable with `export AWS_PROFILE=my-profile` in every new terminal window\n\nare not required anymore.\n\nTable of Contents\n=================\n\n* [Example Usage](#example-usage)\n  * [Cli tool](#use-either-the-cli-tool)\n  * [UI tool](#or-the-ui-tool)\n    * [Linux](#linux)\n    * [Windows](#windows)\n* [Installation](#installation)\n* [How it works](#how-it-works)\n* [License](#license)\n\n# Example Usage\n\n## Use either the cli tool\n\n### Change the default AWS profile to 'personal'\n\n- command:\n\n```bash\n$ awsdefault to personal\n```\n\n### Disable/unset the AWS profile\n\ncommand:\n\n```bash\n$ awsdefault rm\n```\n\n*the complete list of parameters can be found [here](cmd/awsdefault/readme.md#usage)*\n\n\n## Or the UI tool\n\n### Linux\n\n![awsdefault-gkt3-example1](doc/awsdefault-gtk3-example1.gif?raw=true) \n\n*Note* [i3block](https://github.com/vivien/i3blocks) was used as statusbar in this example. You can find the config in the [doc folder](cmd/awsdefault-gtk3/doc/i3block-example.conf).\n\n### Windows\n\nTODO\n\n# Installation\n\n## Option 1 — Download binaries\n\nprecompiled binaries for Linux, (TODO: Windows and MacOS) are available at the [release] page.\n\n\n```bash\ncurl \n```\n\n## Option 2 — Compile it\n\n- for the cli tool, see [here](cmd/awsdefault/readme.md#installation)\n- for the gtk3-UI, see [here](cmd/awsdefault-gtk3/readme.md#installation)\n\n## Configure your environment (only first time)\n\nSet the environment variable `AWS_PROFILE` to `default` ([aws userguide](https://docs.aws.amazon.com/cli/latest/userguide/cli-environment.html)).\n\n### Linux\n\nAdd the following line to your .xinitrc, .zshrc or .bashrc file:\n\n```bash\nexport AWS_PROFILE=default\n```\n\n### Windows\n\nTODO\n\n# How it works\n\n\nThe awsdefault (cli or UI) tool creates, changes or deletes the `[default]` profile section in your [AWS credentials file](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html). This default section contains the same `aws_access_key_id` and `aws_secret_access_key` as stored in one of the other profile sections.\nTogether with the configured environment variable `AWS_PROFILE=default`, this approach enables or disables the credentials of the specific AWS profile. In other words, the default profile points to the required profile or will be deleted if no profile is needed.\n\n- The environment variable\n\n```bash\n$ env | grep AWS_PROFILE\nAWS_PROFILE=default\n```\n\n- The AWS credentials file — _no default was set; default was unset_\n\n```bash\n$ cat ~/.aws/credentials\n[live]\naws_access_key_id     = A\naws_secret_access_key = B\n\n[dev]\naws_access_key_id     = C\naws_secret_access_key = D\n\n[personal]\naws_access_key_id     = E\naws_secret_access_key = F\n```\n\n- The AWS credentials file — _default was set to personal_ (comment was added automatically)\n\n```bash\n$ cat ~/.aws/credentials\n; active_profile=personal\n[default]\naws_access_key_id     = E\naws_secret_access_key = F\n                         \n[live]                   \naws_access_key_id     = A\naws_secret_access_key = B\n                         \n[dev]                    \naws_access_key_id     = C\naws_secret_access_key = D\n                         \n[personal]               \naws_access_key_id     = E\naws_secret_access_key = F\n```\n\n# License\n\nSee [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterbueschel%2Fawsdefault","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeterbueschel%2Fawsdefault","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterbueschel%2Fawsdefault/lists"}