Repo brief: tindy2013/subconverter

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T12:00:19.911Z · commit 5b8d3af0d7b6

Verdict

Mixed — Mixed signals — read the receipts

• Last commit 2mo ago
• 19 active contributors
• GPL-3.0 licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

subconverter is a C++ utility that converts proxy subscription formats between incompatible proxy clients (Clash, Quantumult, Surge, V2Ray, Shadowsocks, etc.). It runs as an HTTP service (listening on port 25500) that accepts a source subscription URL and target format, applies rule definitions from /base/config/, and outputs configuration in the client's native format. The core value is enabling a single subscription source to work across all major proxy clients without manual reconfiguration. Monolithic C++ binary with /base/ directory storing static templates: /base/base/ holds client-specific base configs (clash_provider_test.yml, surge.conf, loon.conf, etc.), and /base/config/ holds…

Start here

Open these first:

• CMakeLists.txt — Build configuration for the entire C++ project; defines compilation targets, dependencies, and output artifacts for all…
• base/generate.ini — Primary configuration file that controls subscription format conversion behavior and template selection for output formats.
• base/pref.example.ini — Example preferences configuration showing all customizable conversion parameters and proxy filtering options.
• base/base/all_base.tpl — Core template file used as the foundation for all subscription format conversions; defines the conversion logic structure.
• base/profiles/example_profile.ini — Example profile demonstrating how to define custom conversion rules and output format specifications.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/tindy2013/subconverter.git && cd subconverter && mkdir build && cd build && cmake .. && make. Run with ./subconverter (listens on 127.0.0.1:25500). Test with curl 'http://127.0.0.1:25500/sub…

Daily commands:

Build: cd subconverter && mkdir build && cd build && cmake .. && make. Run: ./subconverter (default port 25500). Docker: docker build -t subconverter . && docker run -p 25500:25500 subconverter (Dockerfile exists).

…shortened for this brief.

Key cautions & unknowns

• Concentrated ownership — top contributor handles 79% of recent commits
• GPL-3.0 is copyleft — check downstream compatibility
• The /base/ directory is critical—if base templates are missing, conversions will fail silently or produce incomplete configs. CMake must find the base/ directory at runtime (likely hardcoded or via CONF_PATH env var,…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.