Getting Started

CapyDeploy has two parts: the Hub (on your PC) and an Agent (on your handheld). Both must be on the same Wi-Fi network.

Your PC

Install the Hub. This is where you select games and send them to your device.

Your Handheld

Install the Agent (desktop mode) or the Decky Plugin (gaming mode, Steam Deck only). This receives and installs games.

Download

Pre-built binaries ready to use. No compilation required.

Windows

Hub + Agent bundled in a single ZIP. Extract and run.

Windows ZIP

Linux

AppImages with auto-install support. One for each component.

Hub AppImage Agent AppImage

Decky Plugin (Gaming Mode)

Alternative Agent inside Decky Loader. No Steam restart needed.

Decky Plugin ZIP
Linux tar.gz (Hub + Agent) Checksums (SHA-256)

Browse all releases →

Linux

1. Download the .AppImage file

2. Make it executable: right-click the file → Properties → Permissions → check "Allow executing as program"

3. Double-click to run — it will prompt to install automatically

The app installs itself to your application menu with its own icon.

Terminal users: chmod +x, --install, --uninstall, --help

Windows

1. Download the .zip file

2. Right-click the ZIP → Extract All

3. Double-click capydeploy-hub-tauri.exe (on your PC) or capydeploy-agent-tauri.exe (on your handheld)

WebView2 is pre-installed on Windows 10/11.

Windows SmartScreen may show a warning since the app is not signed. Click "More info" → "Run anyway" to proceed.

Decky Plugin

1. Download CapyDeploy.zip from the card above

2. On your handheld, open Decky Settings

3. Select Install Plugin from ZIP

Agent vs Decky Plugin
ShortcutsInstant (SteamClient API)
ArtworkInstant (no file copy)
Steam restartNot needed

Troubleshooting

The Hub doesn't find my device

Both devices must be on the same Wi-Fi network. Some routers block mDNS between devices — try disabling "AP Isolation" or "Client Isolation" in your router settings. VPNs and guest networks may also prevent discovery.

Windows shows a SmartScreen warning

The app is not code-signed. Click "More info" then "Run anyway". This is safe — you can verify the download with the checksums file.

Linux AppImage won't run

Make sure the file has execute permission: right-click → Properties → Permissions → "Allow executing as program". On some distros you may also need libfuse2 installed.

Pairing code expired

The 6-digit code expires after 60 seconds. Disconnect from the Hub and reconnect to generate a new code.

Where do I get a SteamGridDB API key?

Go to steamgriddb.com, create a free account, then go to Preferences → API to generate your key. Paste it in the Hub's Settings tab.

For contributors

Building from Source

For contributors and developers who want to build from source code.

1

Install Prerequisites

# Install Rust and Bun
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
curl -fsSL https://bun.sh/install | bash
2

Clone and Build

git clone https://github.com/lobinuxsoft/capydeploy
cd capydeploy

# Build everything
./build_all.sh

# Or build individually
cd apps/hub-tauri && ./build.sh
cd apps/agents/agent-tauri && ./build.sh
3

Run and Pair

# On handheld
./capydeploy-agent
# Shows 6-digit pairing code

# On PC
./capydeploy-hub
# Enter the pairing code → Done!

Platform Dependencies (for building from source)

Fedora / Bazzite

rpm-ostree install webkit2gtk4.1-devel gtk3-devel pkg-config

Ubuntu / Debian

apt install libwebkit2gtk-4.1-dev libgtk-3-dev pkg-config build-essential

Arch Linux

pacman -S webkit2gtk-4.1 gtk3 pkgconf base-devel

Windows

WebView2 pre-installed on Win10/11