Amirhossein Hosseinpouramirhp
CV
Active macOS app · Open source

Slipnet for macOS

The command line client worked. Nothing told you whether it was working.

A native Mac app around SlipNet, a VPN tool that tunnels over DNS. Save connection profiles, paste a slipnet:// link and connect, scan for resolvers that actually get through, and switch the Mac's system proxy on and off with the connection.

Download for Mac Source on GitHub

A client only: the tunnel itself is SlipNet by anonvector, credited in the repository. The README states the MIT licence; GitHub does not detect a licence file. Figures from the GitHub API, 30 September 2026.

On GitHub2026 to today

What it does

Everything the SlipNet binary can do, behind a Mac window that shows what is happening.

Profiles

Create, edit, duplicate and import connection profiles, each with its own resolver, local port, TLS fingerprint and query size.

Resolver scanner

Scan a list of DNS resolvers, a quick single-address scan, or an end-to-end test, and test one resolver with nslookup before you use it.

System proxy switch

One button routes the whole Mac through the local SOCKS5 proxy, and disconnecting turns it off again.

Live output

The binary's output streams into a terminal panel, and a Stop button ends the process.

Why a GUI

Most of the work with a DNS tunnel is finding a resolver that gets through, and then knowing whether the connection is still up.

On the command line that means lists of addresses, one scan at a time, a terminal left open, and a system proxy switched on by hand in System Settings and forgotten when the tunnel drops. The app keeps profiles, scans and the proxy switch together, and turns the proxy off when you disconnect, so the Mac is never pointed at a tunnel that is no longer there.

It is the most downloaded thing I have released on GitHub this year: 453 installer downloads across three releases, 431 of them for 1.6.0.

How it works

No network extension. The app runs the SlipNet binary as a child process and uses the tools macOS already ships.

SwiftUI views over one observable app state, in an MVVM shape. Connections are Foundation Process instances, with their output piped into the terminal panel as it arrives. Profiles are JSON in UserDefaults. The system proxy is set with networksetup on the interface you choose, Wi-Fi by default.

The SlipNet binary is bundled, found on the system, or set by hand, and the app can download the latest one from SlipNet's GitHub releases.

# what the proxy button does, for the chosen interface
networksetup -setsocksfirewallproxy "Wi-Fi" 127.0.0.1 <port>
networksetup -setsocksfirewallproxystate "Wi-Fi" on

# and on disconnect
networksetup -setsocksfirewallproxystate "Wi-Fi" off
The standard macOS commands for a SOCKS proxy; the app runs the equivalent.

Getting started

macOS 14 Sonoma or later, and a SlipNet connection link from whoever runs your server.

  1. Install

    Download Slipnet-macOS-Installer.pkg from the latest release and run it. The app goes into Applications.

  2. Add a profile

    Add (⌘N), paste your slipnet:// link, then Save and Connect.

  3. Route the Mac through it

    Press System Proxy in the toolbar. Change the interface in Settings, Connection, if you are not on Wi-Fi.

  4. If it will not connect

    Open DNS Scanner, give it a list of resolvers, and put one that passes into the profile.

Releases

Three releases in five days in March 2026, each with an installer attached.

VersionReleasedWhat changedDownloads
1.6.026 Mar 2026Renamed from BlackSwan to Slipnet-macOS throughout; persistent terminal, Stop, streaming output.431
1.5.022 Mar 2026Commands run one after another in a persistent terminal, with live output.14
1.4.022 Mar 2026The SlipNet binary bundled inside the app; a Stop button; new icon.8

// open-source/

More open source

The other projects with a page of their own. The rest, 56 in all, are in the explorer, each with its status and where the numbers come from.

Every public project The release record
branch main 6 active projects ↑ 113 releases open-source/slipnet.md Sari --:-- UTC+3:30 its@amirhp.com