gitwtfhub

wtf is surgerelay-macos?

eeliberto/surgerelay-macos — explained in plain English

Analysis updated 2026-05-18

150SwiftAudience · generalComplexity · 3/5Setup · moderate

TL;DR

A macOS app that centralizes converting, editing, and publishing Surge proxy configuration modules so all your devices can subscribe to one stable link.

Mindmap

mindmap
  root((Surge Relay))
    What it does
      Converts proxy modules
      Publishes stable links
      Edits Surge rules
    Tech stack
      Swift
      Script Hub
      Cloudflare Workers
    Use cases
      Multi device sync
      Module editing
      Remote management
    Audience
      Surge power users
      Multi device owners

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

Why would anyone build with this?

REASON 1

Convert modules from Loon or Quantumult X into Surge's own module format on one Mac.

REASON 2

Publish Surge modules to a stable link so all your devices stay in sync automatically.

REASON 3

Edit and disable specific rules in a module using a visual editor instead of raw text.

REASON 4

Manage Surge Relay remotely from another device through its web interface.

What's in the stack?

SwiftScript HubCloudflare Workers

How it stacks up

eeliberto/surgerelay-macosjcranokc/app-monitorkunkka19xx/look
Stars150151136
LanguageSwiftSwiftSwift
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencegeneralgeneralgeneral

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Downloaded builds are quarantined by macOS and need one terminal command to open, publishing to the web needs an optional GitHub and Cloudflare setup.

The README does not state a license for the app itself.

Wtf does this do

Surge Relay is a macOS app for managing, converting, and publishing configuration files, called modules, used by Surge, a network proxy tool for Mac and iOS devices. It builds on an existing open source tool called Script Hub to do the local conversion of module formats. The app is aimed at people who maintain many Surge modules across several devices, especially those who convert modules from other proxy tools like Loon or Quantumult X into Surge's own module format. Instead of repeating that conversion process on every device, Surge Relay centralizes the work on one Mac. Once you set the source addresses and any custom editing rules inside Surge Relay, it produces the final Surge modules and publishes them to a stable web address. Every device, including iPhone, iPad, Apple TV, and Mac, can then just subscribe to that fixed address using Surge, instead of dealing with the original source. If an upstream module address changes, the fix is made once inside Surge Relay rather than reinstalling on every device. Published modules can go to a private GitHub repository paired with a Cloudflare Worker for a stable link, or simply be saved to a local iCloud Drive folder, which the README says is the easier and recommended option. The README notes that public repositories are not allowed as a publishing target, to avoid abuse. Since publishing happens ahead of time, the modules keep working on other devices even if the Mac is turned off or offline. Surge Relay also includes a graphical editor for reviewing and adjusting modules: removing ones you no longer want, blocking specific MITM hostnames, disabling certain scripts or rewrite rules, and tweaking parameters, instead of hand editing configuration files. There is also a web based remote management view, paired with a feature called Surge Ponte, so the app's status can be checked and edited from another device without sitting at the Mac. If macOS blocks the app as damaged after download, the README explains this is Apple's quarantine flag on apps that were not notarized, and gives a terminal command to remove it. The project includes a disclaimer that any example modules shown belong to their original authors, and Surge Relay only provides the local tooling, not endorsement of any specific module's content or safety.

Yoink these prompts

Prompt 1
Help me set up a private GitHub repo and Cloudflare Worker for Surge Relay following its guide.
Prompt 2
Explain what Surge Relay does compared to editing .sgmodule files by hand.
Prompt 3
Show me how to fix the app is damaged warning when opening Surge Relay on macOS.

Frequently asked questions

wtf is surgerelay-macos?

A macOS app that centralizes converting, editing, and publishing Surge proxy configuration modules so all your devices can subscribe to one stable link.

What language is surgerelay-macos written in?

Mainly Swift. The stack also includes Swift, Script Hub, Cloudflare Workers.

What license does surgerelay-macos use?

The README does not state a license for the app itself.

How hard is surgerelay-macos to set up?

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

Who is surgerelay-macos for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.