Deck

Stream Deck for your tablet. Configure buttons that execute actions on your PC.

How it works

Tablet/Phone  ──ws──▶  Server (:4000)  ──ws──▶  Desktop Agent (your PC)
   (browser)            serves UI +              executes: open apps,
   tap buttons          relays commands          copy text, run commands
                        + notifications          + captures PC notifications

Quick Start

git clone https://github.com/florextech/deck.git
cd deck
pnpm install
pnpm dev

Scan the QR code shown in terminal with your tablet.

Tutorial

1. First run

After pnpm dev, you'll see a QR code in your terminal. Scan it with your tablet's camera to open Deck.

2. Add your first action (from PC)

1. Open http://localhost:4000 on your PC
2. Tap Config at the bottom
3. Tap + Add action
4. Choose a type:
   • Open a link → paste any URL
   • Copy text → text that gets copied to your PC clipboard
   • Run command → any terminal command
   • Open app → pick from detected apps
5. Give it a name → Add to deck

3. Use from tablet

Switch to the Deck tab and tap your buttons. They execute on your PC instantly.

4. Customize

In Config → Settings you can:

• Change theme (8 options)
• Toggle notification sound
• Switch language (English/Español)
• Add more PCs (workspaces)

5. Install as app (PWA)

On your tablet in Chrome: menu ⋮ → "Add to Home screen". Opens fullscreen without browser bars.

Features

• Action grid — configurable buttons that execute on your PC
• Notifications — real-time PC notifications on your tablet (macOS, Windows, Linux)
• Multi-workspace — connect one tablet to multiple PCs, switch between them
• Themes — 8 themes (Midnight, Ocean, Ember, Forest, Rose, Ice, Gold, Crimson)
• i18n — English and Spanish
• Sound — notification sound with toggle
• App detection — auto-detects installed apps on your PC
• Network scan — auto-discover other PCs running Deck
• Roles — PC can configure, tablet can only execute
• PWA — install as fullscreen app on tablet
• Installer — generate .dmg/.exe with Electron

Configure

From the PC: Open http://localhost:4000 → Config → Actions → Add

From a file: Edit deck.config.json:

{
  "actions": [
    { "id": "1", "label": "GitHub", "type": "url", "payload": { "type": "url", "url": "https://github.com" } },
    { "id": "2", "label": "Copy Key", "type": "copy", "payload": { "type": "copy", "text": "my-key" } },
    { "id": "3", "label": "Deploy", "type": "command", "payload": { "type": "command", "command": "cd ~/app && pnpm deploy" } }
  ]
}

Send notifications

curl -X POST http://localhost:4000/notify \
  -H "Content-Type: application/json" \
  -d '{"title": "Deploy done", "level": "success"}'

Or use the helper: ./scripts/deck-notify "message" level

Build installer (no Docker needed)

pnpm build:installer       # Mac (.dmg)
pnpm build:installer:win   # Windows (.exe)

macOS: "Deck.app is damaged and can't be opened"

This happens because the app is not signed with an Apple Developer certificate. Run this after installing:

xattr -cr /Applications/Deck.app

Then open the app normally.

Structure

deck.config.json    ← your buttons
apps/
  server/           ← serves UI + WebSocket relay
  agent/            ← runs on PC, executes commands + captures notifications
electron/           ← Electron wrapper for installer

Scripts

pnpm dev              # server + agent (shows QR)
pnpm test             # tests
pnpm lint             # eslint
pnpm typecheck        # typescript
pnpm build:installer  # .dmg/.exe

License

MIT