A Golang-based Windows application to switch proxy settings
Go to file
2024-09-02 16:43:26 +02:00
.github/workflows test: specifying multiple files for release 2024-09-01 16:46:52 +02:00
assets moved icons to assets 2024-08-30 18:11:21 +02:00
cmd intruduce debug command to output parsed config as commands 2024-09-02 11:21:10 +02:00
proxy intruduce debug command to output parsed config as commands 2024-09-02 11:21:10 +02:00
util prompting for command variants in config 2024-08-31 21:13:46 +02:00
.gitignore Initial commit 2024-08-29 22:54:40 +02:00
configs.json bugfix: non-string value in powershell command 2024-08-31 17:47:52 +02:00
go.mod explicitly require golang sys package for registry 2024-09-01 12:48:31 +02:00
go.sum reading and setting system proxy 2024-08-31 18:26:24 +02:00
install.ps1 bugfix: create local programs directory 2024-09-02 16:43:26 +02:00
LICENSE Initial commit 2024-08-29 22:54:40 +02:00
main.go initialize cobra-cli 2024-08-29 23:06:10 +02:00
README.md initialize easy install script for application 2024-09-01 23:36:20 +02:00
run.ps1 bugfix: using executable instead of go runtime 2024-09-02 09:43:27 +02:00

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

  • 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. You could go into the program directory (C:\Users\[Username]\AppData\Local\Programs\ProxySwitcher\) manually and run the program from your CLI in there, but it is recommended to simply 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.

    go run . set
    
  • unset: Disable all saved proxies including system proxy.

    go run . unset
    
  • save: Saves a new configuration to set a proxy for.

    go run . save
    

Building

  1. Clone the repository as seen above in Usage

  2. Run the following command:

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

Configuration

The programs for which the proxy settings should be managed are stored in a configs.json file, which can be modified directly or 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.