{"id":33315918,"url":"https://github.com/q7df1/xrayfa","last_synced_at":"2026-05-01T16:01:55.163Z","repository":{"id":322776934,"uuid":"1048959687","full_name":"Q7DF1/XrayFA","owner":"Q7DF1","description":"XrayFA is a powerful and user-friendly Android client for Xray-core.","archived":false,"fork":false,"pushed_at":"2026-04-28T15:33:39.000Z","size":12991,"stargazers_count":46,"open_issues_count":6,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-28T17:26:04.227Z","etag":null,"topics":["android-app","hysteria2","shadowsocks","trojan","tun2socks","vless","vmess","vpn-client","xray-core"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Q7DF1.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":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-02T09:27:03.000Z","updated_at":"2026-04-28T15:35:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"8fa5b412-5562-41f0-9c0c-5eebd99dca20","html_url":"https://github.com/Q7DF1/XrayFA","commit_stats":null,"previous_names":["q7df1/xrayfa"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/Q7DF1/XrayFA","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Q7DF1%2FXrayFA","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Q7DF1%2FXrayFA/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Q7DF1%2FXrayFA/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Q7DF1%2FXrayFA/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Q7DF1","download_url":"https://codeload.github.com/Q7DF1/XrayFA/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Q7DF1%2FXrayFA/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32503204,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["android-app","hysteria2","shadowsocks","trojan","tun2socks","vless","vmess","vpn-client","xray-core"],"created_at":"2025-11-19T14:02:03.956Z","updated_at":"2026-05-01T16:01:55.148Z","avatar_url":"https://github.com/Q7DF1.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🚀 XrayFA\n\n**A modern, powerful, and user-friendly Android client for [Xray-core](https://github.com/XTLS/Xray-core).**\n\nXrayFA provides a secure, high-speed proxy experience with a focus on simplicity and performance.\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eEnglish\u003c/b\u003e | \u003ca href=\"README_zh-CN.md\"\u003e简体中文\u003c/a\u003e | \u003ca href=\"README_RU.md\"\u003eРусский\u003c/a\u003e | \u003ca href=\"README_KR.md\"\u003e한글\u003c/a\u003e\n\u003c/p\u003e\n\n[![GitHub release](https://img.shields.io/github/v/release/Q7DF1/XrayFA?style=flat-square\u0026color=blue)](https://github.com/Q7DF1/XrayFA/releases)\n[![GitHub license](https://img.shields.io/github/license/Q7DF1/XrayFA?style=flat-square)](https://github.com/Q7DF1/XrayFA/blob/main/LICENSE)\n[![GitHub top language](https://img.shields.io/github/languages/top/Q7DF1/XrayFA?style=flat-square)](https://github.com/Q7DF1/XrayFA)\n[![GitHub stars](https://img.shields.io/github/stars/Q7DF1/XrayFA?style=flat-square)](https://github.com/Q7DF1/XrayFA/stargazers)\n\n\u003c/div\u003e\n\n---\n\n## 📸 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n    \u003ch3\u003ePhone UI\u003c/h3\u003e\n    \u003cimg src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/1.png\" width=\"30%\" /\u003e\n    \u003cimg src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/2.png\" width=\"30%\" /\u003e\n    \u003cimg src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/3.png\" width=\"30%\" /\u003e\n    \u003cbr\u003e\u003cbr\u003e\n    \u003ch3\u003eTablet / Foldable UI\u003c/h3\u003e\n    \u003cimg src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/4.png\" width=\"85%\" /\u003e\n\u003c/div\u003e\n\n---\n\n## ✨ Features\n\n### 📡 Protocol Support\n| VLESS | VMESS | Shadowsocks | Trojan | Hysteria2 |\n| :---: | :---: | :---: | :---: | :---: |\n| ✅ | ✅ | ✅ | ✅ | ✅ |\n\n### 🛠️ Core Capabilities\n*   **Subscription Management**: Easily import, manage, and batch-update subscription links.\n*   **Intuitive Dashboard**: Clean real-time monitoring of connection status, speed, and traffic.\n*   **Rich Configuration**: Advanced routing rules and DNS settings for power users.\n*   **Smooth UX**: Modern Material Design 3 interface with fluid animations and Dark Mode support.\n*   **Stable Engine**: Built on the latest **Xray-core** for maximum compatibility and security.\n\n---\n\n## 📥 Download\n\nReady to get started? \n\n\u003cdiv style=\"display: flex; gap: 10px; align-items: center;\"\u003e\n    \u003ca href=\"https://github.com/Q7DF1/XrayFA/releases\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/rubenpgrady/get-it-on-github/refs/heads/main/get-it-on-github.png\" alt=\"Get it on GitHub\" height=\"60\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://f-droid.org/en/packages/com.android.xrayfa/\"\u003e\n        \u003cimg src=\"https://f-droid.org/badge/get-it-on.png\" alt=\"Get it on F-Droid\" height=\"60\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n---\n\n## 🔨 Build from Source\n\n### Prerequisites\n* **Android Studio**: Latest stable version.\n* **JDK**: 11 or higher.\n* **Go (Golang)**: 1.21+ (Required for Xray-core compilation).\n* **Git**: For cloning submodules.\n\n### Build Steps\n\n1.  **Clone the repository** (with submodules):\n    `\n    git clone --recursive https://github.com/Q7DF1/XrayFA.git\n    cd XrayFA\n    `\n    *If you missed submodules:* `git submodule update --init --recursive`\n\n2.  **Open in Android Studio**:\n    Select the `XrayFA` folder and wait for Gradle sync.\n\n3.  **Build and Run**:\n    Connect your device and press **Shift + F10**.\n\n\u003e [!CAUTION]\n\u003e 🚨 **IMPORTANT**: For accurate performance testing, ensure the build configuration is set to **RELEASE**. [Learn more about Compose performance](https://medium.com/androiddevelopers/why-should-you-always-test-compose-performance-in-release-4168dd0f2c71).\n\n---\n\n## 📖 Quick Start\n\n1.  **Import Configuration**:\n    *   Click the **+** button to import from Clipboard (`vless://`, `vmess://`, etc.).\n    *   Or scan a **QR Code**.\n2.  **Manage Subscriptions**:\n    *   Navigate to **Subscription Settings** to add provider URLs.\n3.  **Connect**:\n    *   Select a node and tap the **Floating Action Button**.\n    *   Accept the VPN permission request.\n\n---\n\n## 🔗 Credits \u0026 Acknowledgements\n\nSpecial thanks to these projects that make XrayFA possible:\n*   [Xray-core](https://github.com/XTLS/Xray-core) - The core network engine.\n*   [AndroidLibXrayLite](https://github.com/2dust/AndroidLibXrayLite)\n*   [hev-socks5-tunnel](https://github.com/heiher/hev-socks5-tunnel)\n\n## 📄 License\n\nDistributed under the **Apache-2.0 License**. See [LICENSE](LICENSE) for details.\n\n---\n\u003cdiv align=\"center\"\u003e\n\n### 🌟 Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=q7df1/xrayFA\u0026type=Date)](https://star-history.com/q7df1/xrayFA)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fq7df1%2Fxrayfa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fq7df1%2Fxrayfa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fq7df1%2Fxrayfa/lists"}