Skip to content

Gozargah/Marz

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Marz - An Xray-based VPN client

Marz is an Xray client that aims for a clean and intuitive interface. The repo distributes APKs for now. iOS and macOS ports are planned once the Android release stabilizes.

Key Features

  • Automatic fastest-server selection with instant failover
  • Import and parse v2ray/Xray subscription links with usage tracking
  • Upload, download, and remaining data at a glance
  • Alerts when your subscription is close to expiring or hitting its data cap
  • Shows your current IP and location through the active proxy
  • Quick Settings tile for fast toggling
  • Lightweight background operation that stays out of your way
  • Multiple subscription profiles with quick switching

Who Marz Is For

Marz is designed for non-technical users who need a simple, reliable way to connect using Xray-based subscription links. The application intentionally omits advanced technical options to keep the interface approachable for everyday users. Users seeking custom protocol settings, routing rules, or detailed debugging capabilities should consider established tools like V2rayNG. Marz starts Xray based on the provided subscription link and manages the connection without exposing complex settings.

Most Xray clients aim to give users full control over their connections with a comprehensive interface. Marz just parses the subscription link and prepares it for a smooth connection.

Platform Availability

Build Download
Android [apk-arm64-v8a] [apk-armeabi-v7a]

iOS and macOS builds are planned after the Android release reaches a stable milestone.

Deep Linking Guide

One-tap subscription import from provider websites:

URL Scheme

marz://import?url=https%3A%2F%2Fexample.com%2Fsub%2Fid&name=ProviderName

Parameters

Parameter Description
url URI-encoded subscription URL
name URI-encoded provider name

Integration Tips

  • Add country flag emojis to config remarks (e.g. 🇺🇸 US-1, 🇬🇧 London) for automatic geographic grouping.
  • Configs without a recognizable flag will be ignored.

Getting Help

To report bugs or request assistance, open an issue: https://github.com/gozargah/marz/issues

When reporting issues, include:

  • App version (from the About screen)
  • Android version and device model
  • Steps to reproduce the problem
  • Screenshots or sanitized logs

Privacy & Legal

Use of the app constitutes acceptance of the terms and privacy policy (see NOTICE.md). For legal or compliance inquiries, open an issue and the maintainers will respond with the appropriate channels.

Acknowledgements

See NOTICE.md and LICENSE for open-source notices and licensing details.

About

A VPN client built on Xray core with a focus on clean and intuitive interface

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors