Skip to content

README.md

Latest commit

 

History

History
155 lines (101 loc) · 3.93 KB

README.md

File metadata and controls

155 lines (101 loc) · 3.93 KB
Raw

Stream Deck Utility

A command-line utility for managing Stream Deck profiles across multiple devices. This tool addresses a limitation in Elgato's Stream Deck software, which only allows copying individual profiles one at a time.

Features

  • List all Stream Deck devices and their profiles
  • Copy individual profiles between devices
  • Copy all profiles from one device to another in a single operation
  • Automatically remap profile references (for "Switch Profile" buttons)
  • Regenerate page UUIDs to prevent conflicts between source and copied profiles
  • Delete profiles with confirmation prompts

Installation

npm install

Usage

Run commands using the wrapper script:

./cli.sh <command> [options]

Or directly with Node:

node src/cli.js <command> [options]

Device Commands

List all devices

./cli.sh devices list

Shows all connected Stream Deck devices with their names, models, UUIDs, and profile counts.

Show device details

./cli.sh devices info <uuid>

Displays detailed information about a specific device, including all profiles assigned to it.

Profile Commands

List all profiles

./cli.sh profiles list
./cli.sh profiles list --device <uuid>

Lists all profiles, optionally filtered by device UUID.

Show profile details

./cli.sh profiles info <profileId>

Displays detailed information about a specific profile, including pages and action counts.

Copy a single profile

./cli.sh profiles copy <profileId> --to-device <uuid>

Copies a profile to another device.

Copy all profiles between devices

./cli.sh profiles copy-all --from-device <uuid> --to-device <uuid>

Copies all profiles from one device to another. This command:

  • Copies all profile directories with new UUIDs
  • Regenerates page UUIDs to prevent conflicts with source profiles
  • Remaps internal profile references (so "Switch Profile" buttons work correctly)

Options:

  • -r, --replace - Delete existing profiles on target device before copying
  • -y, --yes - Skip confirmation prompts

Examples:

# Copy all profiles, keeping existing ones on target
./cli.sh profiles copy-all -f '@(1)[4057/143/SOURCE]' -t '@(1)[4057/143/TARGET]'

# Replace all profiles on target device
./cli.sh profiles copy-all -f '@(1)[4057/143/SOURCE]' -t '@(1)[4057/143/TARGET]' --replace

# Replace without confirmation prompts
./cli.sh profiles copy-all -f '@(1)[4057/143/SOURCE]' -t '@(1)[4057/143/TARGET]' --replace --yes

Delete a profile

./cli.sh profiles delete <profileId>
./cli.sh profiles delete <profileId> --yes

Deletes a single profile. Use --yes or -y to skip the confirmation prompt.

How It Works

Stream Deck profiles are stored in:

~/Library/Application Support/com.elgato.StreamDeck/ProfilesV3/

Each profile is a .sdProfile directory containing:

  • manifest.json - Profile metadata and device binding
  • Profiles/ - Subdirectory containing page definitions

When copying profiles, this utility:

  1. Copies the profile directory with a new UUID
  2. Regenerates all page UUIDs within the profile (prevents Stream Deck from confusing source and copied profiles)
  3. Updates the device binding in the manifest
  4. Remaps page references in the profile manifest
  5. Remaps any "Switch Profile" action references to point to the new profile UUIDs

Note: Device preferences (default profile, sort order) are stored in ~/Library/Preferences/com.elgato.StreamDeck.plist but are not modified by this tool. You may need to set the default profile manually in the Stream Deck app after copying.

Notes

  • After making changes, restart the Stream Deck app to see updates
  • Profile UUIDs are case-insensitive but stored in uppercase
  • The tool reads device names from the Elgato preferences plist

Requirements

  • Node.js 18+
  • macOS (uses PlistBuddy for reading device names)
  • Stream Deck software installed

License

MIT