Skip to content

index.md

Latest commit

 

History

History
111 lines (98 loc) · 5.49 KB

index.md

File metadata and controls

111 lines (98 loc) · 5.49 KB
Raw

Mintray

Mintray is a proxy client for macOS and Linux. For your privacy and freedom.

No dependencies, TUI only. Project is open-source and Issues tab & email are there for any bugs.

Supported protocols

  • Vless (includes full support for all transports, encryption). Provided by Xray package (bin/xray)
  • Socks5
  • Trojan. Provided by Xray package (bin/xray)
  • Shadowsocks
  • Hysteria2. Provided by Hysteria2 package (bin/hysteria2)

Showcase

Linux (CachyOS, Console as terminal) Linux Showcase

macOS (Tahoe, Warp as terminal) macOS Showcase

Why Mintray

  • No dependencies (Works without ANY dependencies on bare Linux & macOS machine in full capabilities with binary)
  • Works the same way on macOS and Linux (no separate app to learn per platform)
  • TUN Mode (routes all traffic except local trough proxy)
  • Lightweight (just a Python3, any machine can run without any issues)
  • Simple design (a clean, simple terminal design that works for everyone)
  • Open source (most clients are closed-source, we are 100% transparent on everything here)

Get Mintray (released binaries & repo)

How to use

Mintray supports connections (servers) by subsciption provider/s

  • How to add subsciption to Mintray: 
    mintray --add-sub [https URL]
    (after that Mintray will work)

Note! Please use --help for more information on arguments, some of the, may resolve your request/issue

Some other info

  1. UDP may not work properly on Vless - Xray core thing (we cannot fix or do anything about this, so something that uses UDP may just not work, ex. Whatsapp calls or just WebRTC in general)
  2. Windows isn't supported. (1. No build-in stdlib - no curses (that's the main interface, required). 2. Too strict (like no actual root implementation) 3. Network compatbility issues - it's gotta be a another implementation of entire network stack (macOS & Linux are basically compatible with each other in a safe way))
  3. It may not run on Linux - everything has been tested enough and noted that it works in full capabilities on Linux and macOS, but Linux has too many distros families and we cannot optimize app for each one. Here's the list of confirmed working OS:
  • macOS (100% compatbility for Ventura and higher, updates never touch things that may break)
  • CachyOS & Arch (Linux distro. Arch Linux based distros will work, Debian and others may not work)_

Building from source

git clone https://yzyworks.com/git/Mintray/.git
cd Mintray

Grab last release of binaries in following repos

XTLS/Xray-core

xjasonlyu/tun2socks

apernet/hysteria

pip install pyinstaller
mkdir bin && cp /path/to/xray /path/to/tun2socks bin/
pyinstaller Mintray.spec

Building from source (step-by-step)

(all of this requires Python3 to be installed in your $PATH, download installer from python.org)

  1. Clone the repo && cd after: (cd changes the directory your terminal is currently in)
git clone https://yzyworks.com/git/Mintray/.git && cd Mintray
  1. Collect binaries for your current device: (specifications like device arch (x84_64, aarch64/arm) and OS (darwin for macOS or just linux))
  1. Install PyInstaller module for Python: (requires pip to be installer & work properly)
pip install pyinstaller

or

python3 -m pip install pyinstaller

(also, if installation fail because of error externally managed, add this argument to command: --break-system-packages)

  1. Create bin/ directory & put binaries in it: (requires slight command changing to work by editing path)
mkdir bin && cp /path/to/xray /path/to/tun2socks bin/
  1. Build binary:
pyinstaller Mintray.spec

or

python3 -m PyInstaller Mintray.spec

After all of that it, fully working executable binary should be build in dist/Mintray

Notice for users

We, at YZYWORKS, think that privacy is a human right and everyone deserves it.

We are pro-privacy, and we never log that you do trough this client.

Get free Vless proxy for YOUR privacy. (no log policy, full privacy policy is available by here) We provide free plan with 512GB of traffic for month with unlimited speeds, if you want - you can order paid plan that provides same things, just unlimited traffic.

This is not an ad, this is a recommendation of our service, which is free for everyone (we do not discriminate or care where you are or what nation you in - for everyone)