---

GenyConnect

English | Persian - فارسی | Chinese - 中文 | Japanese - 日本語 | Turkish - Türkçe | Russian - Русский | French - Français | Spanish - Español | Korean - 한국어 | Azerbaijani - Azərbaycanca | Hindi - हिंदी | Portuguese - Português | Arabic - العربية | German - Deutsch

GenyConnect is a modern, cross-platform secure connectivity client for private networks and encrypted communications, built with a strong focus on performance, privacy, and precise traffic management.

It provides a powerful orchestration layer for secure networking and tunneling engines, emphasizing reliability, observability, operational transparency, and user experience, while remaining independent of any specific protocol, technology, or implementation.

GenyConnect is being developed in two directions: a Community Edition for individual users and everyday connectivity needs, and a Commercial & Enterprise Edition designed for organizations that require centralized management, network policies, access control, and secure communications at scale.

---

Overview

GenyConnect enables users to establish and manage secure connections through structured server profiles and shareable configuration links.

Runtime configurations are generated dynamically, connection lifecycles are supervised explicitly, and system state remains fully observable at all times.

The platform is intentionally engine-agnostic, allowing different tunneling backends to be integrated without altering user workflows or expected behavior.

GenyConnect is not limited to a generic tunneling use case. Its long-term direction is an intelligent connectivity layer for managing access to services, private infrastructure, cloud resources, and distributed teams that require stable and reliable communication.

By the 1.4 and 1.5 release range, GenyConnect is expected to mature for broader public use and cover a substantial set of needs for users who require dependable connections. Future releases are planned to add Persian and additional in-app languages.

The second generation of GenyConnect will focus more deeply on commercial and organizational needs, including access management, communication infrastructure customization, network resilience, reduced dependence on external services, and stable connectivity under varying network conditions. Future versions are also planned to support the dedicated gen. format and GenyConnect's own communication architecture for defining and managing private networks and organizational access.

---

Key Capabilities

• Clear operational visibility

  • Live logs
  • Real-time traffic statistics
  • Explicit connection-state reporting

• High-performance execution

  • Lightweight runtime
  • Minimal overhead
  • Responsive under sustained workloads

• Deterministic lifecycle management

  • Predictable startup
  • Clean shutdown
  • Safe reconnection logic

• Advanced traffic routing

  • whitelist-based routing
  • domain-level tunnel/direct/block rules
  • application-based routing where supported
  • process-based routing where supported

• Flexible tunneling modes

  • application-level proxying
  • full system tunneling
  • consistent control surface

• LAN Sharing

  • share GenyConnect-managed traffic with other devices on the local network
  • support devices such as game consoles, smart TVs, phones, tablets, laptops, and desktop computers
  • advanced sharing controls for managed network environments

• Cross-platform architecture

  • shared runtime core
  • desktop and mobile adapters
  • platform-specific integrations

---

Power Mode

GenyConnect includes a platform-aware Power Mode system designed to improve connection stability and runtime consistency during sustained workloads.

Power Mode helps reduce operating-system interference caused by aggressive power-saving behavior, background throttling, idle suspension, and sleep-state transitions.

Depending on the operating system and runtime backend, Power Mode may:

• keep critical networking paths responsive
• reduce unexpected disconnects
• improve throughput consistency
• optimize long-running traffic sessions
• minimize latency spikes during heavy activity
• improve runtime reliability while tunneling

Power Mode behavior is adaptive and may vary depending on platform capabilities and operating-system restrictions.

---

Screenshots

---

Platform Support

GenyConnect currently supports:

• macOS
• Windows
• Linux
• Android

iOS support is under active development.

---

Linux AppImage Notes

The Linux AppImage is intended to run without relying on host Qt libraries. The release packaging pipeline validates the bundled Qt platform plugins and QML imports, including the xcb and Wayland platform plugins, QtQuick modules, QtQuick Controls, QtQuick Dialogs, and QtQuick Effects.

GenyConnect does not require KDE Breeze QML modules at runtime. On KDE desktops where Qt may try to select Breeze automatically from the host environment, the app falls back to the bundled Qt Quick Controls Basic style so startup does not depend on host KDE QML modules.

When troubleshooting AppImage startup, check the first Qt diagnostics printed by the app. They include the selected platform plugin, Qt library paths, QML import paths, QT_PLUGIN_PATH, QML2_IMPORT_PATH, LD_LIBRARY_PATH, QT_QPA_PLATFORM, and QT_QUICK_CONTROLS_STYLE.

RPM packages

Release builds publish native RPM packages for both x86_64 and aarch64. On Fedora or another RPM-based distribution, install the downloaded package with:

sudo dnf install ./genyconnect-*.rpm

The RPM contains GenyConnect, its updater and TUN helper, the matching Xray runtime, the desktop entry, and application icons. Qt 6 runtime dependencies are resolved through the distribution package manager.

Nix and NixOS

The repository is a Nix flake supporting x86_64-linux and aarch64-linux. Run GenyConnect directly from a checkout with:

nix run .

Install it into the current user profile with:

nix profile install .#genyconnect

The Nix package builds GenyConnect from source and uses the packaged xray runtime from nixpkgs.

---

Proxy Groups, Sorting, and Selection

Profiles can be organized into user-defined groups. Imported subscriptions keep their source group when available, and ungrouped profiles remain available under the default group.

Supported group operations include:

• manual ordering with persisted order
• sorting by name
• sorting by measured ping
• sorting by last successful connection
• choosing the best profile in the current group
• group modes: Manual, Best Latency, and Fallback

Manual mode keeps the selected profile behavior unchanged. Best Latency selects the lowest-latency healthy profile known for the group before connecting. Fallback keeps the current selection when it is healthy and only chooses an alternative when the selected profile has no recent successful health signal.

Ping and selection data are stored with the profile list so ordering and recent reliability signals survive restart.

---

Windows Network Recovery

Before installing or opening an update on Windows, GenyConnect runs a safe network shutdown path. It stops the runtime, stops managed TUN state, removes tracked runtime state, disables system proxy changes made by the app, and writes logs for each cleanup step.

If Windows networking remains broken after a crash, failed update, forced quit, or stale TUN session, run the emergency reset command from a Command Prompt or PowerShell window:

GenyConnect.exe --safe-network-reset

The command is idempotent. Running it more than once is safe. If administrative approval is needed for TUN cleanup, Windows may ask for permission.

---

Connection Diagnostics

Connection startup and runtime supervision now report more detail in the system log. Relevant fields include local proxy readiness, TUN readiness, runtime process state, stats API reachability, selected profile, bytes transferred before failure, and safe cleanup results.

In TUN mode, GenyConnect validates TUN/runtime readiness separately and does not fail the session only because the local mixed proxy port is not meant to be used directly by desktop apps. In proxy/system-proxy modes, the local mixed proxy readiness check remains active and reports port conflicts or startup races clearly.

---

Technology Stack

• C++23
• Qt 6 / QML
• Cross-platform native runtime architecture
• Multi-platform deployment pipelines
• Engine-agnostic tunneling backend integration

---

Licensing

GenyConnect Community Edition is licensed under the GNU General Public License version 3 or later (GPL-3.0-or-later).

Commercial licensing is available separately from Genyleap Labs for:

• proprietary deployments
• closed-source redistribution
• enterprise integrations
• white-label products
• App Store distribution
• commercial editions
• Pro or Enterprise features

Unless explicitly stated otherwise, the following are NOT covered by the GPL license and remain All Rights Reserved:

• GenyConnect name
• logos
• icons
• screenshots
• visual design
• branding assets
• promotional graphics
• UI artwork
• visual identity materials
• marketing assets

Forks and redistributions may not imply endorsement by or affiliation with Genyleap Labs without explicit written permission.

See the LICENSE and NOTICE files for full licensing details.

License Summary

Community Edition source code:

• GPL-3.0-or-later

Commercial licensing:

• Separate proprietary commercial license

Branding and non-code assets:

• All Rights Reserved

---

❤️ Support GenyConnect

GenyConnect is an independently developed project by Genyleap Labs.

If GenyConnect helps you, you can support its continued development by donating with $GENY or USDC on the Base Network.

Your support helps fund:

• continued development
• security improvements
• desktop and mobile platform support
• infrastructure and testing
• future open-source releases
• long-term ecosystem growth

---

🌐 Support with $GENY

By donating with $GENY, you are supporting both GenyConnect development and the broader Geny ecosystem.

Base Mainnet

GENY Token Contract:

0x2a3d6f8c1fc4AcDcf3A75d19b445bae02F03676B

Developer Donation Wallet:

0x9b9E187C1B10A88C04F21A5F9DE0Ff1CA46AA589

Buy or Swap $GENY for Genyleap ecosystem

https://app.uniswap.org/swap?chain=base&outputCurrency=0x2a3d6f8c1fc4AcDcf3A75d19b445bae02F03676B

---

💵 Support with USDC

USDC is a stable and simple way to support development directly.

Base Mainnet

Developer Donation Wallet:

0x9b9E187C1B10A88C04F21A5F9DE0Ff1CA46AA589

---

Donation Notice

Donations are voluntary contributions to support GenyConnect development.

They do not represent:

• investment
• equity
• ownership
• revenue sharing
• securities
• financial products
• promises of financial return

📢 Follow development updates, announcements, and future releases on Telegram and Farcaster:

• Telegram: https://t.me/compezeth • Telegram: https://t.me/genyleap • X/Twitter: https://x.com/genyleap • Farcaster: https://farcaster.xyz/compez.eth • Farcaster: https://farcaster.xyz/genyleap

Your feedback and support help shape the future of GenyConnect and the broader Genyleap ecosystem. 🚀