What is subconverter?

If you use a proxy or VPN service, you might have run into the annoyance of incompatible subscription formats. Maybe your provider gives you a Clash config link, but the app you want to use only understands Surge or V2Ray formats. subconverter solves exactly this problem. It takes a proxy subscription link in one format and translates it into another, so you can use whatever app you prefer without manually rewriting server configurations. At a high level, the tool runs as a small local web service. You send it a web address containing a few pieces of information: the format you want to convert to, the subscription link you already have, and optionally a custom configuration file. It fetches your original subscription, translates the server details into the target format, and hands you back a new link you can paste directly into your proxy app. It supports a wide range of formats including Clash, Surge, Quantumult, V2Ray, and Shadowsocks variants, and can even merge multiple subscriptions into a single combined link. The people who would find this most useful are those who juggle multiple proxy services or switch between different proxy apps across devices. For example, if you maintain subscriptions from two different providers and want to combine them into one Clash list, or if you are switching from Surge on Mac to Quantumult X on iOS and need your existing subscription reformatted, this tool automates what would otherwise be a tedious manual process. One notable convenience feature is automatic upload to GitHub Gist. By adding a personal access token to a configuration file, you can have the converted subscription pushed to a Gist automatically each time you generate it. This means you can create a hosted link once and have it stay updated without running the conversion locally every time. The project also offers a Docker setup for deployment, and its detailed advanced documentation is currently available primarily in Chinese.