Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
S

SubConv

> 编程语言
Open source

Yet Another Subscription Converter for Clash

399 stars0 likes2 views
WebsiteGitHub

About

Yet Another Subscription Converter for Clash

Subscription Converter

English | 中文

This project is a subscription converter aiming to transform subscriptions into mihomo-compatible configs.

We ship two built-in templates in the root template/ directory: zju.yaml and general.yaml. The Web UI defaults to zju, and the API does the same when the template query parameter is omitted. The repository includes config.yaml.example as the default runtime config.

Screenshot

Features

  • Support Clash config and V2ray format base64 links (i.e. the original subscription does not have to be Clash)
  • A Web-UI (thanks to @Musanico)
  • Rules based on ACL
  • Nodes auto update based on proxy-provider
  • Rules auto update based on rule-provider
  • Support proxy rule-provider to prevent failure to get rules from GitHub
  • Support multiple airports
  • Display remaining traffic and total traffic (only useful when you use a single airport, requires your airport and Clash to support it at the same time, Clash for Windows, Clash Verge, Stash, Clash Meta for Android, etc. are known to support it)
  • Implement the api of subscription conversion to proxy-provider (normal people won't use it)
  • Support template files

Docs

docs (both Chinese and English, but machine translated)

Repo Layout

  • subconv/: FastAPI backend and converter logic
  • api.py: thin entrypoint used by the CLI and Vercel
  • config.yaml.example: example runtime config; put user changes in config.yaml
  • template/: runtime YAML templates (zju.yaml is the default, general.yaml is the alternate)
  • mainpage/: Vue/Vite frontend
  • docs/: VitePress documentation site, deployed separately via GitHub Pages

Local commands (requires uv and bun):

  • Backend: uv sync, optionally copy config.yaml.example to config.yaml (recommended; the bundled docker-compose.yml requires it), edit it if needed, then uv run python api.py
  • Frontend: cd mainpage && bun install && bun run dev
  • Docs: cd docs && bun install && bun run dev

P.S

Clash Core from Dreamacro (original Clash core) is no longer supported. It's recommended to use mihomo instead.

Usage

Deploy by yourself according to docs

Contribute

Welcome issue and PR. If you want to contribute, please create a new branch from main and then create a PR to dev, or you can merge main into dev first and then make changes in dev, and finally create a PR to dev branch.

Credits

  • subconverter
  • mihomo
  • Proxy Provider Converter

License

This project is distributed under MPL-2.0 License

Issues· 16 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Python

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言