GitSwitch-Gui
Effortlessly manage multiple GitHub accounts from your desktop
GitSwitch-Gui is a powerful desktop application that simplifies the management of multiple GitHub accounts. Built with Tauri and React with rust, it offers a seamless experience for developers who need to switch between different GitHub identities effortlessly.
π Features
Account Management
- π Add new GitHub accounts with ease
- π Switch between accounts with a single click
- ποΈ Remove individual accounts or clear all accounts
- π View all added accounts in a clean, organized list
SSH Key Handling
- π Automatic SSH key generation for each account
- π Easy copying of SSH keys to clipboard
- π View SSH keys for any account at any time
User Interface
- π¨ Intuitive and responsive design built with Ant Design components
- π Toggle between light and dark themes
- π Clear visual indicators for active accounts
Security
- π Local storage of account information for enhanced privacy
- π‘οΈ No storage of GitHub passwords or tokens
Cross-Platform Support
- π₯οΈ Works on Windows, macOS, and Linux
- π¦ Easy installation process for each platform
Utility Features
- π Automatic refresh of account list after actions
- βΉοΈ Informative messages for successful actions and errors
- β Built-in help and guide section for easy onboarding
π Installation
Download the latest release for your OS from the Releases page.
Quick Start Guide
-
Windows
- Download the
.msi
installer
- Run the installer and follow the on-screen instructions
-
macOS
- Download the
.dmg
file
- Open the
.dmg
file
- Drag the GitSwitch app to your Applications folder
-
Linux
- Download the
.AppImage
file
- Make it executable:
chmod +x GitSwitch.AppImage
- Run it:
./GitSwitch.AppImage
π― Usage
-
Launch the GitSwitch application.
-
Add a new account:
- Navigate to the "Add Account" tab.
- Enter your name and email associated with your GitHub account.
- Click "Add Account".
- Copy the generated SSH key and add it to your GitHub account settings.
-
Switch accounts:
- Go to the "Switch Account" tab.
- Click "Switch" next to the account you want to use.
- The active account will be highlighted.
-
View SSH keys:
- Use the "Show SSH Key" button next to each account to view its SSH key.
- You can easily copy the key to your clipboard.
-
Remove accounts:
- Navigate to the "Remove Account" tab to delete individual accounts.
- Use the "Remove All Accounts" option to clear all accounts (use with caution).
-
Access Help/Guide:
- Click on the "Help/Guide" tab for detailed information on using the app.
π οΈ Building from Source
To build GitSwitch-Gui from source, follow these steps:
-
Ensure you have Node.js (v14 or later) and Rust installed.
-
Clone the repository:
git clone https://github.com/biohacker0/GitSwitch-Gui.git
cd GitSwitch-Gui
-
Install dependencies:
npm install
-
Run the development version:
npm run tauri dev
-
Build for production:
npm run tauri build
π€ Contributing
Contributions are welcome! Here's how you can contribute:
- Fork the repository.
- Create a new branch:
git checkout -b feature-branch-name
- Make your changes and commit them:
git commit -m 'Add some feature'
- Push to the branch:
git push origin feature-branch-name
- Submit a pull request.
Please make sure to update tests as appropriate and adhere to the existing coding style.
π License
This project is licensed under the MIT License. See the LICENSE file for details.
If you find GitSwitch-Gui useful, consider buying me a coffee!
GitSwitch-Gui is a personal project made open-source to benefit the developer community. It's designed as a minimalist, go-to tool for managing multiple GitHub accounts without hassle. Enjoy using GitSwitch!