whatisgithub

What is oixcloud-external-proxy-program?

pickrui/oixcloud-external-proxy-program — explained in plain English

Analysis updated 2026-05-18

72ShellAudience · generalComplexity · 2/5Setup · moderate

In one sentence

A macOS menu bar app that logs into an oixCloud proxy subscription, connects it to the Surge proxy client, and lets you switch nodes without touching configuration files.

Mindmap

mindmap
  root((oixCloud helper))
    What it does
      Menu bar app
      Connects to Surge
      Manages proxy nodes
    Tech stack
      Shell
      macOS
      Surge
    Use cases
      Auto pick fastest node
      Test node latency
      Merge custom Surge rules
    Audience
      oixCloud subscribers
      Surge users
    Setup
      One command install
      macOS only

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Log into an oixCloud proxy account and connect it to Surge without manual configuration.

USE CASE 2

Automatically pick the fastest proxy node or test latency across all available nodes.

USE CASE 3

Keep your existing Surge rules and proxy groups while only swapping in oixCloud's node list.

USE CASE 4

Share the local proxy with other devices on the same network.

What is it built with?

ShellmacOSSurge

How does it compare?

pickrui/oixcloud-external-proxy-programedengilbertus/terminalphonewallach-game/bashumerate
Stars727171
LanguageShellShellShell
Setup difficultymoderatemoderateeasy
Complexity2/53/52/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

macOS only, requires Surge already installed and an existing oixCloud proxy subscription.

So what is it?

This project is a macOS menu bar app that connects an oixCloud proxy subscription to Surge, a well known proxy client for Mac. Instead of manually copying node lists or editing configuration files, everything except logging into your oixCloud account is handled automatically from a small cloud icon in the menu bar. Installation is a single terminal command that detects your Mac's chip type and macOS version and downloads the matching binary, verifying it is properly signed before installing it to a system folder. Once installed, you run it with a tray flag to start it temporarily, or set it up as a background service so it starts automatically every time you log in. After that, everything happens through the cloud icon menu: logging in with an access token or email and password, connecting to Surge for the first time, and afterward switching between proxy nodes without needing to reconnect. The menu is organized into four groups. The account group shows your current plan, expiration date, data usage, and balance, and lets you log in or out. The nodes group can automatically pick the fastest available node, test latency across all nodes with a color coded result, or let you pick manually. The connection settings group controls local port numbers, whether the app starts at login, whether other devices on the same network can share the proxy, and whether it operates in a multi port mode, where each node gets its own local port, or a single port mode where nodes are switched from the menu. A tools group offers a one click diagnostic check and handles checking for and installing updates. The app also supports keeping your existing Surge configuration untouched by only swapping out the node list URL, and it lets you merge your own custom Surge rules and proxy groups into the generated configuration file without them being overwritten on refresh. Credentials are stored locally in a permissions restricted configuration file, and passwords themselves are never saved once an access token has been obtained. The README does not state a license for this project.

Copy-paste prompts

Prompt 1
Walk me through installing the oixCloud helper on my Mac and connecting it to Surge for the first time.
Prompt 2
Explain the difference between the multi port mapping mode and single port mode in this app.
Prompt 3
Help me write a custom.conf file to add my own Surge rules without them being overwritten.
Prompt 4
Show me how to run this app's diagnostic tool to check why Surge is not connecting.

Frequently asked questions

What is oixcloud-external-proxy-program?

A macOS menu bar app that logs into an oixCloud proxy subscription, connects it to the Surge proxy client, and lets you switch nodes without touching configuration files.

What language is oixcloud-external-proxy-program written in?

Mainly Shell. The stack also includes Shell, macOS, Surge.

How hard is oixcloud-external-proxy-program to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is oixcloud-external-proxy-program for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.