Central Deck CD

Version 1.0.0

Central Deck turns an Android phone into a small Stream Deck-style dock for a Mac.

The app runs a local Node.js agent on the iMac and serves a phone-friendly web app. Open the URL on an Android phone on the same Wi-Fi, tap an app icon or saved scene, and the Mac brings the right app or display/window layout forward.

Run

npm start

The terminal prints phone URLs like:

http://192.168.1.42:47832/?token=...

Open that full URL on Android Chrome. After the first successful load, Chrome can add it to the home screen as an app-like PWA.

How It Works

• mac-agent/server.js scans macOS application bundles under /Applications and /System/Applications.
• App icons are converted from .icns to PNG with macOS sips.
• The Android-facing web app calls POST /api/activate.
• The Mac agent runs open -b <bundleId> to activate the selected app.
• The Scenes tab saves the visible windows by display and recalls them later.

Notes

• Commands are protected by a locally generated token stored in .central-deck/config.json.
• The MVP lists installed GUI applications rather than only currently open windows. Activating a closed app launches it.
• Scene capture stores visible window coordinates per display because macOS does not expose a public Stage Manager scene ID.
• Window-level scene recall uses macOS Accessibility automation through System Events.