Baipyrus/ProxySwitcher
1
0
Fork 0
mirror of https://github.com/Baipyrus/ProxySwitcher.git synced 2024-12-26 04:31:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updated README in regards to #6 and in general terms

Browse Source
This commit is contained in:
waltem01 2024-11-19 11:01:34 +01:00
parent 5008813e5a
commit 3690f58d15
1 changed files with 84 additions and 66 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

150
README.md
View File

@ -10,35 +10,40 @@ access to settings and toggling proxies.
## Features ## Features
- Switch internet proxy settings for various applications and the system. - Switch internet proxy settings for various applications and the system.
- Manage configurations through a `configs.json` file. - Configuration files stored in `configs/` for better organization and flexibility.
- Command-line interface with commands like `set`, `unset`, and `save`. - CLI commands (`set`, `unset`, `save`, `debug`) for managing proxy settings.
- System tray icon with options to enable and disable proxies, open settings, - System tray icon for fast access to all functionality.
save configurations, or exit the application.
## Installation ## Installation
You should download the [latest release](https://github.com/Baipyrus/ProxySwitcher/releases) This project offers two installation methods: via PowerShell or manually. In the
archive, **extract all contents** to a dedicated directory and then simply execute end, you will always be using the [`.\install.ps1`](./install.ps1) script which will
the [`.\install.ps1`](./install.ps1) script within a Windows Powershell. automatically download the Project if necessary and adds it to `%PATH%`. All contents
will then be installed to `%LOCALAPPDATA%/Programs` for a user installation.
Alternatively, you could simply run the following command in a Windows PowerShell: ### PowerShell Installation
Run the following command in Windows PowerShell:
```powershell ```powershell
# Using 'Invoke-RestMethod' and 'Invoke-Expression'
irm 'https://raw.githubusercontent.com/Baipyrus/ProxySwitcher/main/install.ps1' | iex irm 'https://raw.githubusercontent.com/Baipyrus/ProxySwitcher/main/install.ps1' | iex
``` ```
### Manual Installation
1. Download the [latest release](https://github.com/Baipyrus/ProxySwitcher/releases).
2. Extract the archive to somewhere accessible to your user.
3. Run the [`.\install.ps1`](./install.ps1) script within a Windows Powershell instance.
## Usage ## Usage
Generally, the [Installation](#installation) step will install both the program, First, you will either need to navigate into the program directory (`C:\Users\[Username]\AppData\Local\Programs\ProxySwitcher\`)
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 manually or specify a path to any directory containing configuration files using
the flag `-c, --configs string configurations path (default "configs/")`. 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 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: directly via code.
In case you want to run the code directly:
- Clone the repository: - Clone the repository:
@ -51,83 +56,87 @@ directly via code. This latter option will be explained next:
- **set**: Enable all saved proxies including system proxy. - **set**: Enable all saved proxies including system proxy.
```powersell ```powersell
# .\ProxySwitcher.exe set # ProxySwitcher.exe set
go run . set go run . set
``` ```
- **unset**: Disable all saved proxies including system proxy. - **unset**: Disable all saved proxies including system proxy.
```powersell ```powersell
# .\ProxySwitcher.exe unset # ProxySwitcher.exe unset
go run . unset go run . unset
``` ```
- **save**: Saves a new configuration to set a proxy for. - **save**: Saves a new configuration to set a proxy for.
```powersell ```powersell
# .\ProxySwitcher.exe save # ProxySwitcher.exe save
go run . save go run . save
``` ```
- **debug**: Prints all proxy configurations after generating corresponding commands. - **debug**: Prints all proxy configurations after generating corresponding commands.
```powersell ```powersell
# .\ProxySwitcher.exe debug # ProxySwitcher.exe debug
go run . save go run . save
``` ```
### Configuration ### Configuration
The programs for which the proxy settings should be managed are stored in [`configs/`](https://github.com/Baipyrus/ProxySwitcher/tree/main/configs), Proxy configurations are organized within the [`configs/`](https://github.com/Baipyrus/ProxySwitcher/tree/main/configs),
wherein you can then create a JSON file per command group. These files can easily directory, with each JSON file representing a configuration for a specific command
be modified directly or generated through the `save` command. For examples, group. You can modify or add your own configurations in any JSON file in this directory
please take a look at the [default config](https://github.com/Baipyrus/ProxySwitcher/tree/main/configs) directly, or you could use the `save` command in a CLI to save settings for you.
or at the following block: For examples configurations, please take a look at the [default config](https://github.com/Baipyrus/ProxySwitcher/tree/main/configs).
```js #### Structure
[
{ Any of these JSON files are used to build commands that the program can run to `set`
"name": "test1", // Default CMD Name and `unset` the proxy configuration of other programs. The system proxy will be set
"cmd": "echo 'Hello, World!'", // Optional automatically upon calling the respective commands. The actual proxy address and
"set": [ port will be automatically detected from your system settings, if available.
{
"args": [ Once in one of these JSON files, you will need to create an object (`{}`) with the
"http" following properties:
], // Optionally empty
"type": "text" // Default; Optional ```javascript
"equator": " " // Default; Optional {
}, // Writes "echo 'Hello, World!' http ", followed // Either "name" or "cmd" or both is required:
// by your system proxy, to a powershell process. "name": "npm",
{ // Use a custom '$PRSW_ARG' variable to inject
"args": [ // arguments into "cmd" at given positions:
"https" // "cmd": "npm",
], // Optionally empty
"equator": "=" // Optional "set": [
} // Writes "echo 'Hello, World!' https=", followed {
// by your system proxy, to a powershell process. "args": [
], // Optional "config",
"unset": [] "set",
// "unset" has the contents as "set" above "proxy"
// and it is also optional. ],
}, { // Optionally specify a separator between the
"name": "test2", // Default CMD Name // last argument and the injected proxy string:
"cmd": "echo '$PRSW_ARG $PRSW_ARG'", // Optional "equator": "=", // Default: " "
"set": [ // Optionally specify a surrounding character
{ // for injected proxy string:
"args": [ "surround": "\"",
"https" // Optionally specify the type of command. If
], // Optionally empty // using '$PRSW_ARG' in "cmd", set to "variable".
"type": "variable" // Optional "type": "variable", // Default: "text"
} // Writes "echo 'https <Your System Proxy>'" // Optionally choose to skip injecting the
// to a powershell process. // proxy string for pre-config commands.
] // Optional "discard": "true" // Default: "false"
} }
] ],
// Use the same structure as "set":
"unset" []
}
``` ```
### System Tray Icon ### System Tray Icon
Right-click the system tray icon to: The system tray icon provides a context menu for all commands:
- **Properties**: View and modify system proxy settings. - **Properties**: View and modify system proxy settings.
- **Enable Proxy**: Enable all saved proxies including system proxy. - **Enable Proxy**: Enable all saved proxies including system proxy.
@ -138,8 +147,17 @@ Right-click the system tray icon to:
## Building ## Building
1. Clone the repository as seen above in [Usage](#usage) 1. Clone the repository as seen above in [Usage](#usage)
2. Run the following command: 2. If running on Windows Subsystem for Linux:
- Set environment variables to build for windows:
```bash
GOOS=windows
GOARCH=amd64
```
3. Run the following command:
```powershell ```powershell
GOOS=windows GOARCH=amd64 go build -o build/ -v ./... # Remove-Item -Recurse -Force -ErrorAction SilentlyContinue build/
go build -o build/ -v ./...
``` ```