{"id":36454849,"url":"https://github.com/goxray/desktop","last_synced_at":"2026-01-11T23:02:03.017Z","repository":{"id":271268427,"uuid":"908605166","full_name":"goxray/desktop","owner":"goxray","description":"🎨 Desktop Xray VPN client for macOS and Linux","archived":false,"fork":false,"pushed_at":"2025-11-07T14:13:41.000Z","size":2697,"stargazers_count":100,"open_issues_count":2,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-11-07T16:07:33.987Z","etag":null,"topics":["go","golang","socks5","trojan","tun","tun2socks","vless","vmess","vpn","vpn-client","xray-core"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/goxray.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":"2024-12-26T13:37:55.000Z","updated_at":"2025-11-07T14:02:01.000Z","dependencies_parsed_at":"2025-06-01T12:39:20.284Z","dependency_job_id":"056301d6-bf8c-417c-8fee-0f9dcf8ad2ce","html_url":"https://github.com/goxray/desktop","commit_stats":null,"previous_names":["goxray/desktop"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/goxray/desktop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goxray%2Fdesktop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goxray%2Fdesktop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goxray%2Fdesktop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goxray%2Fdesktop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/goxray","download_url":"https://codeload.github.com/goxray/desktop/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goxray%2Fdesktop/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28326166,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-11T22:11:01.104Z","status":"ssl_error","status_checked_at":"2026-01-11T22:10:58.990Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["go","golang","socks5","trojan","tun","tun2socks","vless","vmess","vpn","vpn-client","xray-core"],"created_at":"2026-01-11T23:02:02.930Z","updated_at":"2026-01-11T23:02:02.989Z","avatar_url":"https://github.com/goxray.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg width=\"25px\" src=\"icon/assets/app.png\" alt=\"app logo\"\u003e GoXRay: Desktop VPN client for XRay [![Static Badge](https://img.shields.io/badge/featured_on_apps.fyne.io-00ADD8?style=flat\u0026logo=graphite\u0026logoColor=lightblue\u0026color=blue\u0026link=https%3A%2F%2Fapps.fyne.io%2Fapps%2Fcom.github.goxray.client.app.html)](https://apps.fyne.io/apps/com.github.goxray.client.app.html)\n![Static Badge](https://img.shields.io/badge/OS-macOS%20%7C%20Linux-blue?style=flat\u0026logo=linux\u0026logoColor=white\u0026logoSize=auto\u0026color=blue)\n![Static Badge](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat\u0026logo=go\u0026logoColor=white)\n[![Go Report Card](https://goreportcard.com/badge/github.com/goxray/desktop)](https://goreportcard.com/report/github.com/goxray/desktop)\n![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/goxray/desktop/total?color=blue)\n\n\n\nThis project brings fully functional [XRay](https://github.com/XTLS/Xray-core) desktop client for macOS and Linux, powered by [fyne](https://github.com/fyne-io/fyne) and written in Go.\n\n\u003e [!NOTE]\n\u003e The program will not damage your routing rules, default route is intact and only additional rules are added for the lifetime of application's TUN device. There are also additional complementary clean up procedures in place.\n\n\u003e For CLI version see https://github.com/goxray/tun.\n\n| macOS (15.1) Light  | Linux (Ubuntu) Dark |\n| ------------- | ------------- |\n| \u003cimg alt=\"\" src=\".github/images/overview_screenshot.png\"\u003e | \u003cimg alt=\"\" src=\".github/images/overview_screenshot_linux.jpg\"\u003e  |\n\n#### What is XRay?\nPlease visit https://xtls.github.io/en for more info.\n\n#### Tested and supported on:\n- macOS (tested on Sequoia 15.1.1 M3)\n- Linux:\n    - Ubuntu 24.10 ARM\n    - Mint 22 amd64\n\n## ✨ Features\n- Stupidly easy to use\n- Adding and editing XRay URL configurations\n- Supports all [Xray-core](https://github.com/XTLS/Xray-core) protocols (vless, vmess e.t.c.) using link notation (`vless://` e.t.c.)\n- Real-time network statistics for each configuration\n- Responsive, lightweight and dynamic UI, focusing on tray menu for quick and easy interactions\n- Only soft routing rules are applied, no changes made to default routes\n\n## ⚡️ Installation\n\n### 🌐 VPN Client\n\n#### macOS\n\n\u003e [!TIP]\n\u003e You can easily set the application to start at login.\n\u003e Go to `System Settings` \u003e `General` \u003e `Login Items \u0026 Extensions` \u003e `Open at Login`, then press `+` and browse for GoXRay.app\n\nGet the latest release app bundle from [Releases](https://github.com/goxray/desktop/releases) and... just run it. If you get \"damaged\" error then run this command `xattr -c \"GoXRay.app\"`, apple marks externaly downloaded files, this command removes this mark.\nYou will be prompted for admin password, and your GoXRay VPN is ready.\nDon't forget to add the app to your `Applications` and `Open at Login` items!\n\n#### Linux\n\nGet the latest release from [Releases](https://github.com/goxray/desktop/releases).\nAfter unpacking the archive - you can install the app using `make user-install` or run the binary in `usr/local/bin` folder.\n\n\u003e [!IMPORTANT]\n\u003e After installing the application, don't forget to set networking privileges to the installed binary (see `scripts` directory for more info):\n\u003e ```bash\n\u003e sudo setcap cap_net_raw,cap_net_admin,cap_net_bind_service+eip goxray_binary_path\n\u003e ```\n\n##### 📦 Using [twdragon](https://github.com/twdragon) debian package\n\nThe client is available from the PPA repository `ppa:twdragon/xray`, maintained by [twdragon](https://github.com/twdragon). The package is in sync with this repo releases. You can check the pipeline at the [dedicated repository](https://github.com/twdragon/xray-debian-pkg). To install use:\n\n```bash\nsudo add-apt-repository ppa:twdragon/xray\nsudo apt update\nsudo apt install goxray-gui\n```\n\nAfter the installation, the package might be updated automatically as it is done in Ubuntu. Packages are signed by [twdragon](https://github.com/twdragon) and published on [Launchpad](https://launchpad.net/~twdragon/+archive/ubuntu/xray). Experimental builds are also available in [pipeline repository](https://github.com/twdragon/xray-debian-pkg/actions).\n\n### 🛠️ Building from source\n\n\u003e [!IMPORTANT]\n\u003e - `sudo` is required, the application will prompt you for privileged access when you run it.\n\u003e - CGO_ENABLED=1 is required.\n\u003e - Visit https://docs.fyne.io/started/ to get required dependencies for your platform.\n\nIf you have all the required dependencies in place for building the project. You can simply run:\n```bash\nCGO_ENABLED=1 go build . -o goxray\n```\n\nFor Linux, you should also set additional privileges to run the binary, see [#Linux](#linux) info above.\n\nIf you want to get the macOS application bundle (.app structured file), you can run:\n```bash\n# go install fyne.io/fyne/v2/cmd/fyne@latest\nfyne package -os darwin # Check out the newly created GoXRay.app file\n```\n\n\u003e [!TIP]\n\u003e For headache-free cross-compilation please see https://github.com/fyne-io/fyne-cross.\n\n### 📋 Credits\n\n- https://github.com/xtls/xray-core\n- https://github.com/fyne-io/fyne\n- https://github.com/lilendian0x00/xray-knife\n- https://github.com/jackpal/gateway\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoxray%2Fdesktop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoxray%2Fdesktop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoxray%2Fdesktop/lists"}