@fnando/streamdeck

A lean framework for developing Elgato Stream Deck plugins.

streamdeck.mp4

Installation

To create a new plugin, use the following command:

npx @fnando/streamdeck create /path/to/your/plugin \
--name 'Your Plugin Name' \
--description 'Your plugin description' \
--id 'com.sample.streamdeck-your-plugin' \
--github your-github-user

If you prefer Gitlab, use --gitlab instead. There are other options you may use, so if you want to check them out, the following command instead:

$ npx @fnando/streamdeck create --helpstreamdeck create [path]Create a new Stream Deck extensionPositionals: path The extension path. [string]Options: --version Show version number [boolean] --help Show help [boolean] --name The human-readable name of the extension. [string] [required] --id A reversed-DNS format that identifies the extension. [string] [required] --author The author name. [default: ""] --email The author email. [default: ""] --url The extension url. [default: ""] --description The extension description. [default: "Your new Stream Deck plugin"] --github Your Github user. When present, an origin pointing to Github will be added. [default: ""] --gitlab Your Gitlab user. When present, an origin pointing to Gitlab will be added. [default: ""] --install Install dependencies using npm. [default: true]

Usage

$ streamdeck -hUsage: streamdeck <command> [options]Commands: streamdeck bundle Build files under `build` directory. While developing, use `--dev` to generate the files that can be linked to Stream Deck's plugins directory. It'll generate the `.streamDeckPlugin` otherwise. streamdeck release Release a new version of the plugin. This command will export a new bundle, make a new commit, tag it with the provided version, alter CHANGELOG.md, and push to your Git's repo origin source. streamdeck create [path] Create a new Stream Deck extension streamdeck images Create file with embedded images streamdeck link Link the dist directory to Stream Deck's plugin directory. streamdeck unlink Remove the Stream Deck directory's link. streamdeck docs Open Elgato's docs. streamdeck styleguide Show Elgato's style guide streamdeck debug [action] Manage debugging mode.Options: --version Show version number [boolean] --help Show help [boolean]

Plugin structure

$ tree -I node_modules
.
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── LICENSE.md
├── README.md
├── build
│ └── com.fnando.hello.sdPlugin
│ ├── css
│ │ ├── custom.css
│ │ └── sdpi.css
│ ├── images
│ │ ├── actions
│ │ │ ├── Hello
│ │ │ │ ├── Key.png
│ │ │ │ └── Key@2x.png
│ │ │ ├── Hello.png
│ │ │ └── Hello@2x.png
│ │ ├── category.png
│ │ ├── category@2x.png
│ │ ├── plugin.png
│ │ └── plugin@2x.png
│ ├── inspector.html
│ ├── inspector.js
│ ├── inspectors
│ ├── manifest.json
│ ├── plugin.html
│ └── plugin.js
├── icons.sketch
├── package-lock.json
├── package.json
├── release
│ └── com.fnando.hello.streamDeckPlugin
├── src
│ ├── actions
│ │ └── Hello.ts
│ ├── css
│ │ ├── custom.css
│ │ └── sdpi.css
│ ├── images
│ │ ├── actions
│ │ │ ├── Hello
│ │ │ │ ├── Key.png
│ │ │ │ └── Key@2x.png
│ │ │ ├── Hello.png
│ │ │ └── Hello@2x.png
│ │ ├── category.png
│ │ ├── category@2x.png
│ │ ├── embed
│ │ ├── multiActions
│ │ ├── plugin.png
│ │ └── plugin@2x.png
│ ├── images.json
│ ├── inspector.html
│ ├── inspector.ts
│ ├── inspectors
│ ├── locales
│ ├── plugin.ts
│ └── streamdeck.json
└── tsconfig.json
18 directories, 40 files

Workflow

Development

1. First, you need to enable the debugging mode. This can be done by running streamdeck debug enable.
2. Symlink the plugin directory into Stream Deck's plugins directory by running streamdeck link.
3. To open the debugger page, you'll need a Chrome-based browser (Google Chrome, Brave, Microsoft Edge, Opera, etc). Use streamdeck debug to open http://127.0.0.1:23654/ on your browser automatically.
4. It's recommended that you use watchman to automatically export files while developing your plugin. Make sure it's installed and then run watchman-make -p 'src/**/*' '*.json' --run 'streamdeck bundle --dev' to watch for changes and create the bundle automatically. Notice that some changes will also require that you restart the Stream Deck app.

Releasing a new version

Once your plugin is done, run streamdeck release --version [version]. This command will update CHANGELOG.md, change src/streamdeck.json, generate the releases/*.streamDeckPlugin, make a Git commit, tag this commit, and push to your preferred Git hosting service (Github or Gitlab).

Maintainer

• Nando Vieira

Contributors

• https://github.com/fnando/streamdeck/contributors

Contributing

For more details about how to contribute, please read https://github.com/fnando/streamdeck/blob/main/CONTRIBUTING.md.

License

The gem is available as open source under the terms of the MIT License. A copy of the license can be found at https://github.com/fnando/streamdeck/blob/main/LICENSE.md.

Code of Conduct

Everyone interacting in the @fnando/streamdeck project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.