VNC4MAC.xyz
for Mac

Download

VNC4MAC.xyz is free and open source under the MIT License (see LICENSE and terms). The ZIP now ships everything you need to run or install the tool on your Mac—no account, no paywall.

What you’re downloading

Current release bundle is structured for clarity: you always get licensing text, the runnable launcher, and optional helpers.

  • vnc-portal-v3.py — main program (Python 3). Check the version with python3 vnc-portal-v3.py --version (v1.0.0).
  • LICENSE — full MIT license text (copyright Maurii LLC).
  • INSTALL.txt — step-by-step: run from folder, venv, pre-fill host/port, custom ports, Mac .app pointer.
  • install.sh — optional: copies the launcher to ~/.local/bin/vnc4mac so you can type vnc4mac (add that directory to your PATH if needed).
  • requirements.txt — optional pip install -r for websockify; the launcher can still auto-install on first run if you skip this.

Recommended bundle

vnc4mac-xyz.zip

All of the above in one archive—best option for new users.

Download ZIP vnc4mac-xyz.zip

Individual files

vnc-portal-v3.py Main launcher
requirements.txt Optional: pip install -r
INSTALL.txt Quick setup steps
LICENSE MIT (open source)
install.sh Optional: install vnc4mac to ~/.local/bin

Run after download

Fast path

  1. Unzip vnc4mac-xyz.zip (files land in one folder).
  2. In Terminal: cd into that folder.
  3. Run python3 vnc-portal-v3.py — your browser opens the local UI.
  4. Stop with Ctrl+C.

Optional: vnc4mac command

From the same folder (after unzip):

chmod +x install.sh
./install.sh

Then use vnc4mac from a terminal if ~/.local/bin is on your PATH. Details are in INSTALL.txt.

First launch & websockify

The first run may run pip install websockify for you. Prefer an isolated venv? See INSTALL.txt or run python3 -m venv .venv, activate it, then pip install -r requirements.txt.

Mac app (.app) — no Python for end users

Developers can build a double-clickable VNC4MAC.xyz.app from the full source tree using PyInstaller (see the packaging/macos/ folder and root README.md). That gives users who don’t want a Python install a native app bundle (code signing / notarization is separate, for wider distribution).

The download on this page is the Python + ZIP workflow so everyone can read and audit vnc-portal-v3.py. If a pre-built .app or disk image is published here later, we’ll link it from this section.

Requirements

  • macOS — primary target.
  • Python 3 — for the ZIP/script workflow (python3 --version).
  • Reachable VNC server (firewall / SSH tunnel as needed).

Software is licensed under the MIT License (download LICENSE). Use is also subject to our terms & conditions (disclaimer of warranty, limitation of liability, contact info). VNC4MAC.xyz is offered at no charge.