ShardX Launcher

Installing ShardX Launcher, setting up proxies, and launching your first profile

ShardX Launcher is distributed under the MIT license as a free tool for personal use. The software is provided "as is". We regularly release updates, but we don't offer live chat support — for serious issues, please file a bug report on GitHub.

System Requirements

Windows

Component	Minimum	Recommended
OS	Windows 10 22H2 or Windows 11, 64-bit	Windows 11 64-bit
Architecture	x64 / x86_64	x64
CPU	Dual-core 64-bit with SSE3 support	Quad-core or better
RAM	4 GB	8 GB (16 GB for heavy multi-profile use)
Disk space	1 GB	5 GB+
Runtime	Microsoft Edge WebView2	—

macOS

Component	Minimum	Recommended
OS	macOS 11 Big Sur or newer	Latest stable release
CPU	Apple Silicon M1 or newer	Apple M2 or newer
RAM	4 GB	8 GB or more
Disk space	1 GB	5 GB+

The current build targets aarch64-apple-darwin. Intel Macs are not supported.

---

Installing on Windows

Download the latest release:

Release ShardX Launcher v0.1.2 · ProxyShard/ShardBrowserGitHub

Under Assets, pick the .exe or .msi file.

Choose .exe or .msi under Assets

Run the downloaded file. Windows SmartScreen may show a warning — click More info, then Run anyway.

SmartScreen — click «Run anyway»

The installer will finish in a few seconds.

Installation complete

---

Installing on macOS

Download the latest release:

Release ShardX Launcher v0.1.2 · ProxyShard/ShardBrowserGitHub

Under Assets, pick the aarch64.dmg file.

Choose aarch64.dmg under Assets

Open the downloaded .dmg and drag ShardX Launcher into the Applications folder.

Drag the icon into Applications

Bypassing Gatekeeper

This step is mandatory. macOS blocks all unsigned apps — without it the application will not open.

Open Terminal using one of two methods:

• Spotlight: press ⌘ + Space, type terminal, select the app

Finding Terminal via Spotlight

• Finder: Applications -> Utilities -> Terminal

Paste the command and press Enter:

xattr -dr com.apple.quarantine "/Applications/ShardX Launcher.app"

The command runs silently — that's normal

After that, open the app via Spotlight (⌘ + Space → shardx) or from the Applications folder.

Launching ShardX via Spotlight

---

First Launch

On first launch ShardX downloads the browser engine from CDN (about 198 MB, one time only). Wait for the download to finish.

Downloading the engine on first launch

Once done, the main Browsers screen will open.

ShardX Launcher main screen

---

Adding a Proxy

Go to the Proxies section and click + New proxy.

Proxies section

In the Bulk import proxies window, paste your proxies one per line. Supported formats:

host:port
host:port:user:pass
scheme://host:port
scheme://user:pass@host:port

Paste proxies one per line

Click Test all to check the proxies before importing.

Click «Test all» to verify, then «Import»

After testing, each proxy gets a status. Proxies with the UDP label support SOCKS5 UDP, which means WebRTC too — very useful when working with serious antifraud systems. If there is no UDP label, the browser profile automatically switches to TCP-only mode: your IP won't leak, but traffic may look suspicious to advanced antifraud systems. We strongly recommend using proxies with UDP support.

Click Import — the proxy will appear in the list with status Active.

Proxy added

---

Creating Your First Profile

Go to the Browsers section and click + New profile.

Browsers section

No need to change the default settings — ShardX will generate a unique fingerprint automatically. Make sure to select a proxy in the Proxy field at the bottom of the form.

Select a proxy and click «Create profile»

Click Create profile.

Profile created

---

Launching a Profile

Click Start — the browser will open with an isolated fingerprint and proxy.

Profile launched

---

Troubleshooting

Windows: the app won't start

Most likely Microsoft Edge WebView2 Runtime is not installed. Download and install it:

Microsoft Edge WebView2 | Microsoft Edge Developerdeveloper.microsoft.com

Original Windows 10/11 images already include WebView2. On stripped-down builds it may have been removed.

macOS: "ShardX Launcher is damaged and can't be opened"

This is a standard Gatekeeper block. Follow the steps in Bypassing Gatekeeper — both ways to open Terminal and the command to remove the quarantine flag are described there.

---

What's Next?

• Automation: manage profiles via the local HTTP API on 127.0.0.1:40325

• MCP server: download it from settings (Settings -> MCP server) to control profiles via an AI agent