cosmtrek/subconverter — explained in plain English
Analysis updated 2026-08-08 · repo last pushed 2025-11-07
Convert a Clash subscription link into Surge format so you can use it in a different proxy app.
Merge subscriptions from two different proxy providers into a single combined config link.
Automatically push a converted subscription to GitHub Gist so the hosted link stays updated.
Switch from Surge on Mac to Quantumult X on iOS by reformatting an existing subscription.
| cosmtrek/subconverter | 000madz000/rfid-attendance | 00kaku/gallery-slider-block | |
|---|---|---|---|
| Language | — | TypeScript | JavaScript |
| Last pushed | 2025-11-07 | 2024-07-22 | 2021-05-19 |
| Maintenance | Quiet | Dormant | Dormant |
| Setup difficulty | moderate | easy | easy |
| Complexity | 3/5 | 2/5 | 2/5 |
| Audience | developer | developer | general |
Figures from each repo's GitHub metadata at analysis time.
Requires running a local web service or Docker container, and advanced documentation is primarily in Chinese.
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.
A local web service that converts proxy subscription links between formats like Clash, Surge, Quantumult, and V2Ray, and can merge multiple subscriptions into one.
Quiet — no commits in 6-12 months (last push 2025-11-07).
The license is not explicitly stated in the explanation, so permission details are unknown.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.