Skip to content

Latest commit

 

History

237 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Etonify

English / Русский / Українська / 简体中文 / فارسی

Etonify is an open-source VPN client for Android, built with Flutter and etonify-core, a maintained fork of sing-box. It manages subscriptions, server selection, DNS and traffic routing.

The application does not provide VPN servers. You need your own server or a subscription from a provider.

Download APK · Changelog · Report a problem · Telegram

Etonify interface

Versions and requirements

Component Version or requirement
Client source 0.3.6+26
Bundled core v1.15.0-alpha.3-etonify.1, based on sing-box 1.15.0-alpha.3
Android 8.0 or later (API 26+)
APK architectures arm64-v8a, armeabi-v7a
Interface languages English and Russian

The source version comes from pubspec.yaml; the bundled core version comes from libbox.provenance.json. The source tree may contain changes that are not yet published. Check Releases for available APKs and release notes.

Android is the supported release platform. Other Flutter platform directories do not imply supported desktop or iOS builds.

Getting started

  1. Download an APK for your device from Releases and install it.
  2. Add a subscription or import a server configuration.
  3. Select a server or an automatic selection group.
  4. Start the connection and approve Android's VPN permission request.

In-app updates are available under About > Updates. Use the menu in that section to select Stable or Beta. Beta includes prereleases intended for testing; the version displayed in the app may not contain a “beta” suffix.

Features

  • Connections: Android VPN through TUN, local HTTP/SOCKS proxy, or both.
  • Subscriptions: import from a URL, file, clipboard, QR code or supported deep link; refresh profiles and view provider-supplied traffic and expiry information.
  • Servers: manual selection, automatic selection groups, proxy chains and latency testing through the proxy connection.
  • Routing: per-app routing, local network bypass, traffic rules and local rule sets.
  • DNS: direct and proxied resolvers, encrypted DNS options and AdGuard DNS filtering.
  • Core settings: network strategy, connection timeouts, TCP keepalive and UDP/NAT controls. The section includes explanations, a first-visit notice and its own reset action. See Core settings.
  • Diagnostics: connection logs and runtime information for troubleshooting.

Latency tests measure a request through the proxy, not ICMP ping. A missing result does not by itself establish whether a server works.

Configuration compatibility

Import formats include server links, sing-box JSON, Xray JSON, Clash YAML and SIP008. Supported protocols include VLESS, VMess, Trojan, Shadowsocks, Hysteria/Hysteria2, TUIC, AnyTLS, NaiveProxy, HTTP and SOCKS. Compatibility depends on the protocol, transport and fields used in the configuration.

Importing an Xray or Clash profile does not mean every feature of its original core is supported. Etonify converts supported settings to its own sing-box configuration. See sing-box 1.14 compatibility for migration details.

WireGuard has not been supported since Etonify 0.3.1 because of problems with its operation in the client.

Multiplexing requires compatible server support. It is not automatically negotiated for every server, and sing-box multiplexing is not interchangeable with Xray Mux. Provider-supplied settings and manual overrides are explained in the core settings section.

Privacy and security

  • Send HWID to provider in General settings controls the global device-identification option for subscription requests. Individual subscriptions can also have saved consent. Review these settings before adding a subscription.
  • Untrusted proxy certificates are a separate security setting. Enabling it bypasses certificate verification; it should not be a general fix for connection problems.
  • Logs and screenshots can contain subscription URLs, server addresses, credentials or device identifiers. Check and redact attachments before sharing them, even if the application has already masked some fields.

Report vulnerabilities privately using the security policy, not a public issue.

Building and development

The client CI uses Flutter 3.47.2 and JDK 21. Dart constraints are defined in pubspec.yaml, and Android build tools are pinned in the Gradle files. Rebuilding the core uses a separate toolchain recorded in ETONIFY_BASELINE.

git clone --recurse-submodules https://github.com/yamixdev/Etonify.git
cd Etonify
flutter pub get
flutter gen-l10n
flutter analyze
flutter test
flutter build apk --debug

For release builds, configure your signing key in android/key.properties. Some Happ encrypted-subscription compatibility assets are not public; see private build inputs before expecting a local build to match official builds in that area.

The bundled AAR's source commit, version, toolchain and checksum are recorded in libbox.provenance.json. Do not infer the binary's source revision from the current submodule HEAD. See bundled core documentation for replacement requirements and CONTRIBUTING.md for contribution guidelines.

Support

For bugs and suggestions, use the issue forms. Include the application version, device model, Android version and vendor software version, reproduction steps and relevant redacted logs. If the problem started after an update, mention the last working version.

Project news: @etonify. Questions and private support: Etonify Direct.

License and acknowledgements

Etonify is maintained by MeowTeam: yamixdev and dudosxdev. The project uses sing-box and other open-source components.

Licensed under the GNU GPL v3.0 or later. See NOTICE.md and THIRD_PARTY_NOTICES.md for attribution and third-party notices.

About

Android-first open-source VPN client built around a modified sing-box core.

Resources

Contributing

Security policy

Stars

24 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages