ff25926e0f
Introduce Dependabot To Project |
||
---|---|---|
.github | ||
assets | ||
cmd | ||
configs | ||
proxy | ||
util | ||
.gitignore | ||
go.mod | ||
go.sum | ||
install.ps1 | ||
LICENSE | ||
main.go | ||
README.md | ||
run.ps1 |
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
, andsave
. - 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 ./...