danial2026/v2ray_client
1
0
Fork 0
Code Issues Pull requests Projects Releases 4 Packages Wiki Activity Actions
A high-performance, modern V2Ray VPN client for Android with support for VLESS, VMess, and Reality protocols.
46 commits 1 branch 4 tags 75 MiB
Find a file
Exact
Danial M. 1052fddb4b docs: refactor native layer documentation for Kotlin and Swift, simplifying component descriptions and communication flow.
2025-12-26 14:34:51 +03:30
android refactor: Update bundle identifier, package names, and app icons for rebranding. 2025-12-25 22:00:09 +03:30
assets fix: update logo asset to new design 2025-12-25 21:44:22 +03:30
lib feat: Implement desktop window management with initial sizing and centering for macOS, Windows, and Linux. 2025-12-26 11:59:50 +03:30
macos feat: Implement desktop window management with initial sizing and centering for macOS, Windows, and Linux. 2025-12-26 11:59:50 +03:30
packages/v2ray_dan feat: add standalone Swift script for testing system proxy configuration and V2Ray core management with sudo authentication. 2025-12-26 01:34:03 +03:30
screenshots docs: Add macOS screenshots and update README to categorize all platform screenshots. 2025-12-26 14:19:58 +03:30
scripts - 2025-12-26 14:21:47 +03:30
test feat: introduce Circle Home Screen Widget, enhance usage statistics display, and add IP address censoring options 2025-12-25 21:31:27 +03:30
.gitignore feat: Implement initial V2Ray Flutter application with core features and native integration. 2025-12-20 00:24:00 +03:30
.metadata feat: introduce Circle Home Screen Widget, enhance usage statistics display, and add IP address censoring options 2025-12-25 21:31:27 +03:30
analysis_options.yaml feat: Implement initial V2Ray Flutter application with core features and native integration. 2025-12-20 00:24:00 +03:30
CHANGELOG.md feat: Implement macOS system proxy control and adjust WebView background color for compatibility. 2025-12-25 23:48:49 +03:30
DOCUMENTATION.md docs: refactor native layer documentation for Kotlin and Swift, simplifying component descriptions and communication flow. 2025-12-26 14:34:51 +03:30
LICENSE feat: Implement initial V2Ray Flutter application with core features and native integration. 2025-12-20 00:24:00 +03:30
pubspec.yaml feat: Implement desktop window management with initial sizing and centering for macOS, Windows, and Linux. 2025-12-26 11:59:50 +03:30
README.md feat: add macOS support, Android home screen widgets, and real-time monitoring, along with various documentation updates and feature description refinements. 2025-12-26 14:28:30 +03:30
SECURITY.md feat: Add SECURITY.md to document vulnerability reporting and supported versions. 2025-12-20 00:52:07 +03:30
UI_DESIGN_GUIDE.md docs: add UI/UX design style guide for v2ray Flutter application, outlining design philosophy, color system, typography, component specifications, layout, interaction patterns, and development guidelines. 2025-12-25 21:43:19 +03:30

README.md

Flaming Cherubim

A fast, modern, and high-performance V2Ray VPN client built with Flutter.

  • Android: Full system VPN support.
  • macOS: High-performance Proxy support (SOCKS/HTTP).

Uses a custom native plugin to run the official V2Ray core directly.

Android

Screenshot 1 Screenshot 2 Screenshot 3

macOS

Screenshot 1 Screenshot 2 Screenshot 3

Features

Protocol Support

Full support for VMess and VLESS protocols, custom TLS settings (SNI, ALPN, fingerprint spoofing), and Reality and XTLS support.

Connection Modes

VPN Mode provides full system VPN with traffic routing for all apps. Proxy-Only Mode offers local SOCKS5 (10808) and HTTP (10809) proxy without VPN overhead.

Advanced Features

  • Custom ping settings with configurable intervals and methods
  • Home screen widgets for connection control and status (Android)
  • Real-time traffic monitoring and RAM usage indicators
  • Minimal UI with clean, dark-themed interface
  • Comprehensive logging and diagnostics
  • Kill switch for graceful shutdown protection
  • Built-in browser with automatic proxy routing
  • DNS leak protection and intelligent server selection
  • Privacy censorship mode for server addresses

Disclaimer

Note

I coded this over the weekends, it might have bugs and it's not production-ready, and the macos version is fully vibe coded.

Full Documentation

For complete documentation about the app architecture, features, and technical details, see DOCUMENTATION.md.

License

GNU General Public License v3.0 (GPL-3.0)