eeliberto/surgerelay-macos

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.