17.1K ·GitHub
What is this?
A utility that converts proxy subscription files between formats: feed it a subscription link for one proxy client and get a ready config for another, like Clash, Surge or V2Ray.
A utility that converts proxy subscription files between formats: feed it a subscription link for one proxy client and get a ready config for another, like Clash, Surge or V2Ray.Which subscription formats can it convert between?Clash, ClashR, Quantumult, Quantumult X, Loon, SS (SIP002), SS Android, SSD, SSR, Surfboard, Surge 2/3/4 and V2Ray, each both as source and target; Telegram-style HTTP/Socks5 links work only as a source.
Clash, ClashR, Quantumult, Quantumult X, Loon, SS (SIP002), SS Android, SSD, SSR, Surfboard, Surge 2/3/4 and V2Ray, each both as source and target; Telegram-style HTTP/Socks5 links work only as a source.How do I convert a subscription once it's running?Call the access interface with a target parameter (the format name, e.g. clash) and a url parameter holding your URLEncoded subscription link; an optional config parameter adds an external configuration file.
Call the access interface with a target parameter (the format name, e.g. clash) and a url parameter holding your URLEncoded subscription link; an optional config parameter adds an external configuration file.How do I get it running on my machine?It is a C++ program: build it from source with the included Makefile, or run the Docker image its CI publishes, then keep the local service up and query it over HTTP.
It is a C++ program: build it from source with the included Makefile, or run the Docker image its CI publishes, then keep the local service up and query it over HTTP.Any format quirks I should watch out for?Shadowrocket users should pick ss, ssr or v2ray as the target, Telegram-style links cannot be a target, and subscription URLs must be URLEncoded before being passed.
Shadowrocket users should pick ss, ssr or v2ray as the target, Telegram-style links cannot be a target, and subscription URLs must be URLEncoded before being passed.Can I merge multiple subscriptions into one config?Yes — join the subscription links with '|' before URLEncoding them, and the converter outputs a single combined config.
Yes — join the subscription links with '|' before URLEncoding them, and the converter outputs a single combined config.Can it keep a converted subscription in sync on GitHub Gist?Yes. Put a Personal Access Token into gistconf.ini in the root directory and add &upload=true to your local subscription link; each access then updates the Gist automatically.
Yes. Put a Personal Access Token into gistconf.ini in the root directory and add &upload=true to your local subscription link; each access then updates the Gist automatically.Can I customize the rules and groups of the generated config?Yes — pass an external configuration file via the config parameter (a URL or file path, URLEncoded); the repository has more examples, and advanced usage is covered in the Chinese docs (中文文档).
Yes — pass an external configuration file via the config parameter (a URL or file path, URLEncoded); the repository has more examples, and advanced usage is covered in the Chinese docs (中文文档).What are similar projects?clash-rules, ddgksf2013, SS-Rule-Snippet, v2rayfree, CFBox, Sub-Store, fancyss, Free-servers
clash-rules, ddgksf2013, SS-Rule-Snippet, v2rayfree, CFBox, Sub-Store, fancyss, Free-serversWhich topics is it in?ss, quantumult, quantumultx, emoji, surge, clash, v2ray, shadowsocks, ssr, proxy, c++, utility
ss, quantumult, quantumultx, emoji, surge, clash, v2ray, shadowsocks, ssr, proxy, c++, utility