SpiderDesk Tutorial

A swarm-type multi-remote-control system that monitors and controls up to 300 PCs in real-time from a single Controller PC.

info What is SpiderDesk?

SpiderDesk is a swarm-type multi-remote-control system that allows a single Controller PC to monitor and remotely control up to 300 client PCs in real-time. Think of it as a CCTV surveillance system — but for PC desktops.

To use the service, you need two components:

  • Controller — The management server. Install on the PC you use for administration.
  • Client — The agent on each PC to be controlled.
lightbulbThe installation order does not matter. Install the Client on PCs you want to control, and the Controller on the PC you will manage from. Then log in with the same account on both.

download Installation Guide

personIndividual Install
groupsBatch Deployment

1 Download SpiderClient

Download the SpiderClient installer from the official website.

downloadDownload SpiderClient

2 Install & Run

Run the downloaded file to complete the installation.

  • Installation path: C:\Program Files\SpiderDesk\
  • Administrator privileges are required

3 Login

Two login methods are available:

  • Google Login — Click "Sign in with Google", auto-login after first sign-in.
  • Email Login — Register with email, then sign in.
warningAlways check "Stay signed in" to automatically log in on next startup.

4 Done!

The client auto-connects after login. Now install the Controller on your management PC and log in with the same account.

1 Generate Master Key

From SpiderController: Tools → Generate Master Key. Save the bootstrap.json file.

warningSecurity Warning! The master key contains authentication credentials. Only use in trusted environments.

2 Deploy Client

Deploy the installer alongside the master key.

Deployment folder: +-- SpiderClient.exe +-- bootstrap.json

3 Script Deployment (Optional)

# Example: Install on remote PC $remotePath = "\\PC001\C$\SpiderDesk\" Copy-Item -Path ".\SpiderClient\*" -Destination $remotePath -Recurse

4 Run

The client auto-connects via RefreshToken from the master key.

lightbulbClients deployed with master key are managed centrally from the controller.

hub Network Architecture

The Controller should be positioned at the top of your network hierarchy, directly under the ISP router, not behind secondary routers.

Ideal Setup — Switch Hub (Recommended)

All devices on the same subnet via a switch hub for direct Winsocket communication.

Internet ISP Gateway (192.168.1.1) Switch Hub (24/48 port) LAN Same Network (192.168.1.x) Controller PC 192.168.1.5 PC 1 192.168.1.10 PC 2 192.168.1.11 Winsocket Direct (Bidirectional OK)

Problematic Setup — Controller Behind Sub-Router

When the Controller is behind a sub-router (NAT), it cannot initiate connections back to clients on other subnets.

Internet ISP Router (192.168.1.1) Controller PC 192.168.1.5 Sub-Router (NAT) WAN:1.6 / LAN:2.1 PC 1 PC 2
tips_and_updatesRecommendation: Use only Switch Hubs (no routers/NAT) for direct TCP/UDP with zero obstacles.

swap_horiz LAN / WAN Mode

SpiderDesk supports both LAN Mode and WAN Mode.

LAN Mode (TCP/UDP) — Ultra-Low Latency

In LAN mode, video data is sent raw without encoder bitrate limits — the full bandwidth of your physical network is utilized.

  • Sub-10ms latency, full physical network speed (100Mbps / 1Gbps)
  • No encoder bitrate restriction — raw data as-is
  • Ideal for offices, PC cafes, schools, labs

WAN Mode (WebRTC) — Cross-Network

Uses encoder bitrate presets (Standard/High/Ultra) to control bandwidth via WebRTC with STUN/TURN servers.

  • Encoder quality presets control bandwidth (4~12 Mbps)
  • Reduces Controller CPU/GPU burden
  • Works across the internet

Automatic Fallback Chain

1. LAN (TCP/UDP) → UPnP / Hole Punching → 2. WAN (WebRTC) → 3. Relay

Covers approximately 98% of connection scenarios.

mouseTo switch modes manually: Right-click status bar in Room List → "Switch MODE WAN".

dashboard Service Architecture

Like a CCTV system: many small camera feeds + a few large active monitors.

  • Live List — Low-bandwidth thumbnail streams of all devices
  • Remote Control Window — Full-quality interactive session for one device
warningToo many simultaneous Remote Control windows can overwhelm the Controller with network traffic and GPU load.
list_alt

Room List

Tabular view with PC name, CPU, GPU, RAM, encoder details. Sortable and drag-reorderable columns.

live_tv

Live List

CCTV-style 1:N visual monitoring with live thumbnails at 10~30 fps.

folder_shared

Group List

Custom device groups (Lab A, Office 2F). Each group as a separate tab.

share

Shared List

View devices shared by team members for cross-team collaboration.

grid_view Thumbnail Presets

PC CountPresetBitrateFPS
1 ~ 10High1,500 Kbps30 fps
11 ~ 50Mid800 Kbps24 fps
50+Low500 Kbps15 fps
100+Ultra Low400 Kbps10 fps
tuneChange the preset from the secondary toolbar when the Live List or Group tab is active.

tune Encoder Quality & Control Windows

In WAN Mode, choose from three encoder presets. (In LAN mode, video is streamed at full quality without bitrate limits.)

QualityBitrateFPSBest For
Standard4 Mbps30 fpsMultiple simultaneous windows
High8 Mbps60 fpsGeneral precision control
Ultra12 Mbps60 fpsGaming / video editing

memory Multi GPU NVENC Rendering

Assign the integrated Intel/AMD GPU for SpiderDesk decoding, freeing the dedicated NVIDIA GPU for your workload.

How It Works

  • Primary GPU (NVIDIA) — Your heavy workload: gaming, rendering, AI
  • Secondary GPU (Intel/AMD) — SpiderDesk H.264 decoding via D3D11 shared device pipeline

GPU hot-swap — switch without disconnecting active sessions.

devices Multi Device Remote

desktop_windows

Windows Controller

Full remote control with 1:N CCTV monitoring, file transfer, clipboard sync, batch ops.

language

Web User Console

Browser-based monitoring and basic control via WebRTC from anywhere.

phone_android

Mobile App (Android)

Direct WebRTC access on the go for quick checks and emergency access.

Team Collaboration

Invite team members to share device access. Multiple controllers can operate simultaneously on the same fleet.

star Key Features

folder_open

File Manager NEW

Dual-pane remote file manager with drag-and-drop transfer across LAN and WAN.

content_paste

Clipboard Sync

Text, images, and file references synced between Controller and Client.

power_settings_new

Wake-on-LAN NEW

Power on offline PCs by sending a magic packet to their MAC address.

notifications_active

Motion Alerts

Monitor unattended devices for screen activity during quiet hours.

chat

Team Chat

Real-time messaging between controllers and devices with timestamps.

upload_file

Drag & Drop Transfer

Drag files/folders into Remote Control window for seamless transfer.

system_update

Auto Update

Automatic updates via Firebase Storage with release notes support.

monitor

Multi-Monitor

Switch between or view multiple monitors from Remote Control window.

keyboard

Custom Shortcuts

Configure keyboard shortcuts for remote control, screenshot, fullscreen, etc.

help_outline Frequently Asked Questions

What if the master key is leaked?
Generating a new master key invalidates the previous one. Redeploy clients with the new key.
Individual install vs batch deployment?
1-10 PCs: Individual install. 10+ PCs: Batch deployment with master key.
What happens when the token expires?
RefreshToken is automatically renewed. Re-authentication is required only if you revoke app access from your Google account.
Controller and Clients cannot connect?
SpiderDesk tries LAN → UPnP → WAN automatically. Check that both use the same account and the Controller is not behind a restrictive NAT.
Can I switch between LAN and WAN mode?
Yes. Right-click the device status bar in Room List and select "Switch MODE WAN" or "Switch MODE LAN".
How many PCs can I control simultaneously?
Up to 300 registered clients. Full Remote Control windows depend on your GPU and network capacity.
Will my settings be lost if I reinstall?
No. Device list, order, and settings are stored in Firebase Storage and restored on login.