macOS desktop pet and app-specific Stream Deck built with Electron and React.
npm install
npm startnpm start runs CharacterDeck in the foreground, so closing the terminal also closes the app.
To keep it running after the terminal closes:
npm run launchOpen directly into settings:
npm run open-settingsStop a background instance:
npm run stopSaved settings and deck commands are created outside this Git repository, next to the project folder:
settings.jsonshortcuts.jsonstatus.json
The committed app starts with an empty deck: Global: [].
Character frames are bundled in assets/frames. If a sibling ../frames folder exists, CharacterDeck uses that first so local custom frames can stay outside the repository.