{"id":28273643,"url":"https://github.com/v2rayroot/v2root","last_synced_at":"2025-06-15T19:31:14.467Z","repository":{"id":286023743,"uuid":"959944563","full_name":"V2RayRoot/V2Root","owner":"V2RayRoot","description":"A Python package to manage v2ray with native extensions","archived":false,"fork":false,"pushed_at":"2025-05-13T22:21:29.000Z","size":19541,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-21T00:19:28.191Z","etag":null,"topics":["v2ray","v2ray-client","vpn","vpn-client","vpn-manager","vpn-service"],"latest_commit_sha":null,"homepage":"https://v2root.readthedocs.io/en/latest/index.html","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/V2RayRoot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"docs/supported_options.rst","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-03T15:52:28.000Z","updated_at":"2025-05-13T22:08:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"e3c777a8-46e6-44f0-9896-368e87ce1dcc","html_url":"https://github.com/V2RayRoot/V2Root","commit_stats":null,"previous_names":["v2rayroot/v2root"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/V2RayRoot/V2Root","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/V2RayRoot%2FV2Root","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/V2RayRoot%2FV2Root/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/V2RayRoot%2FV2Root/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/V2RayRoot%2FV2Root/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/V2RayRoot","download_url":"https://codeload.github.com/V2RayRoot/V2Root/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/V2RayRoot%2FV2Root/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260039512,"owners_count":22949634,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["v2ray","v2ray-client","vpn","vpn-client","vpn-manager","vpn-service"],"created_at":"2025-05-21T00:19:04.244Z","updated_at":"2025-06-15T19:31:14.453Z","avatar_url":"https://github.com/V2RayRoot.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# V2Root\r\n\r\nA Python package to manage V2Ray proxy configurations with native extensions.\r\n\r\nV2Root provides a Python interface to interact with the V2Ray proxy software using a custom C library (`libv2root.dll` on Windows, `libv2root.so` on Linux). It allows users to load configurations, start/stop V2Ray, test connections, and parse VLESS, VMess, and Shadowsocks strings into V2Ray-compatible config files.\r\n\r\n## Features\r\n\r\n- Load and validate V2Ray configuration files\r\n- Start and stop V2Ray processes\r\n- Test server connections with ping and protocol-specific tests\r\n- Parse VLESS, VMess, and Shadowsocks strings into V2Ray-compatible JSON configs\r\n- Cross-platform support for Windows and Linux\r\n- Comprehensive documentation with examples and troubleshooting\r\n\r\n## Installation\r\n\r\nInstall via pip:\r\n\r\n```bash\r\npip install v2root\r\n```\r\n\r\n## Usage\r\nBasic example to start V2Ray with a VLESS configuration:\r\n\r\n```python\r\nfrom v2root import V2ROOT\r\n\r\n# Initialize V2ROOT\r\nv2 = V2ROOT()\r\n\r\n# Set a VLESS string\r\nvless_str = \"vless://your-uuid@your-server:443?security=tls\u0026type=tcp\"\r\nv2.set_config_string(vless_str)\r\n\r\n# Start V2Ray\r\nv2.start()\r\n\r\n# Stop V2Ray when done\r\nv2.stop()\r\n```\r\n\r\n## Requirements\r\n- Python 3.6 or higher\r\n- V2Ray executable (v2ray.exe on Windows, v2ray on Linux)\r\n- Windows or Linux OS\r\n- Standard libraries: ctypes, colorama\r\n\r\n## Documentation\r\nDetailed documentation, including installation instructions, usage examples, and supported configuration options, is available at:\r\n\u003ca href=\"https://v2root.readthedocs.io/en/latest/\"\u003eRead the Docs\u003c/a\u003e\r\n\r\n## License\r\nThis project is licensed under the MIT License - see the file for details.\r\n\r\n## Contributing\r\nContributions are welcome! Please fork the repository and submit a pull request with your changes. See the \u003ca href=\"https://v2root.readthedocs.io/en/latest/contributing.html\"\u003e Contributing Guide\u003c/a\u003e for more details.\r\n\r\n## What's New\r\n- Fixed Shadowsocks parser\r\n- Resolved service execution issues with the latest V2Ray version on Linux\r\n- Updated Explain Error section for better error handling and user friendly troubleshooting\r\n\r\n## Support\r\nIf you encounter any issues or have questions, feel free to open an issue on the \u003ca href=\"https://github.com/V2RayRoot/V2Root/issues\"\u003e GitHub repository\u003c/a\u003e or join our \u003ca href=\"https://t.me/DevSepehr\"\u003eSupport Channel\u003c/a\u003e.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv2rayroot%2Fv2root","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fv2rayroot%2Fv2root","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv2rayroot%2Fv2root/lists"}