ProxyShardUsage instructionsShardX Launcher

ShardX Launcher

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

ShardX Launcher logo

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

ComponentMinimumRecommended
OSWindows 10 22H2 or Windows 11, 64-bitWindows 11 64-bit
Architecturex64 / x86_64x64
CPUDual-core 64-bit with SSE3 supportQuad-core or better
RAM4 GB8 GB (16 GB for heavy multi-profile use)
Disk space1 GB5 GB+
RuntimeMicrosoft Edge WebView2-

macOS

ComponentMinimumRecommended
OSmacOS 11 Big Sur or newerLatest stable release
CPUApple Silicon M1 or newerApple M2 or newer
RAM4 GB8 GB or more
Disk space1 GB5 GB+

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


Installing on Windows

Download the latest release:

github.comhttps://github.com/ProxyShard/ShardBrowser/releases/latest

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:

github.comhttps://github.com/ProxyShard/ShardBrowser/releases/latest

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:

developer.microsoft.comhttps://developer.microsoft.com/en-us/microsoft-edge/webview2/consumer

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

Last updated on

On this page