ProxySwitcher

ProxySwitcher is a Golang-based Windows application that allows you to easily switch internet proxy settings for various programs including the system settings. The application provides a command-line interface (CLI) through the usage of a library called cobra. This CLI then provides commands to set, unset, and save proxy configurations, as well as a system tray icon for quick access to settings and toggling proxies.

Features

Switch internet proxy settings for various applications and the system.
Manage configurations through a configs.json file.
Command-line interface with commands like set, unset, and save.
System tray icon with options to enable and disable proxies, open settings, save configurations, or exit the application.

Installation

You should download the latest release archive, extract all contents to a dedicated directory and then simply execute the .\install.ps1 script within a Windows Powershell.

Alternatively, you could simply run the following command in a Windows PowerShell:

# Using 'Invoke-RestMethod' and 'Invoke-Expression'
irm 'https://raw.githubusercontent.com/Baipyrus/ProxySwitcher/main/install.ps1' | iex

Usage

Generally, the Installation step will install both the program, its assets, and a shortcut for the Windows Startmenu for your current userprofile. Additionally, the program will also be added to the user's %PATH% Variable and will this be executable from within the command-line. However, you will either need to navigate into the program directory (C:\Users\[Username]\AppData\Local\Programs\ProxySwitcher\) manually or specify a path to any directory containing configuration files using the flag -c, --configs string configurations path (default "configs/"). To keep it simple, it is still recommended to use the program in system tray or directly via code. This latter option will be explained next:

Clone the repository:

git clone https://github.com/Baipyrus/ProxySwitcher.git

CLI Commands

set: Enable all saved proxies including system proxy.
```
# .\ProxySwitcher.exe set
go run . set
```
unset: Disable all saved proxies including system proxy.
```
# .\ProxySwitcher.exe unset
go run . unset
```
save: Saves a new configuration to set a proxy for.
```
# .\ProxySwitcher.exe save
go run . save
```
debug: Prints all proxy configurations after generating corresponding commands.
```
# .\ProxySwitcher.exe debug
go run . save
```

Configuration

The programs for which the proxy settings should be managed are stored in configs/, wherein you can then create a JSON file per command group. These files can easily be modified directly or generated through the save command. For examples, please take a look at the default config or at the following block:

[
    {
        "name": "test1", // Default CMD Name
        "cmd": "echo 'Hello, World!'", // Optional
        "set": [
            {
                "args": [
                    "http"
                ], // Optionally empty
                "type": "text" // Default; Optional
                "equator": " " // Default; Optional
            }, // Writes "echo 'Hello, World!' http ", followed
               // by your system proxy, to a powershell process.
            {
                "args": [
                    "https"
                ], // Optionally empty
                "equator": "=" // Optional
            }  // Writes "echo 'Hello, World!' https=", followed
               // by your system proxy, to a powershell process.
        ], // Optional
        "unset": []
        // "unset" has the contents as "set" above
        // and it is also optional.
    }, {
        "name": "test2", // Default CMD Name
        "cmd": "echo '$PRSW_ARG $PRSW_ARG'", // Optional
        "set": [
            {
                "args": [
                    "https"
                ], // Optionally empty
                "type": "variable" // Optional
            }  // Writes "echo 'https <Your System Proxy>'"
               // to a powershell process.
        ] // Optional
    }
]

System Tray Icon

Right-click the system tray icon to:

Properties: View and modify system proxy settings.
Enable Proxy: Enable all saved proxies including system proxy.
Disable Proxy: Disable all saved proxies including system proxy.
Save New Config: Open a prompt to save a new proxy configuration.
Exit: Close the application.

Building

Clone the repository as seen above in Usage

Run the following command:

GOOS=windows GOARCH=amd64 go build -o build/ -v ./...

4.9 KiB Raw Blame History