Skip to content

About

🎛️ Stream Deck plugin for NoteDeck (Misskey client)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

NoteDeck for Stream Deck

Post, run capabilities and jump around NoteDeck (a Misskey client, "Misskey Pro") from Stream Deck keys. The plugin talks to NoteDeck's built-in HTTP API on 127.0.0.1:19820 and to notedeck:// links, so NoteDeck has to be installed on the same machine (running for the API actions).

Actions

Action What it does Needs
Post Note Post a preset text (account / CW / visibility). NoteDeck shows its usual confirmation before sending. token + notes.write
Open Post Form Open NoteDeck's post form, optionally with preset text (notedeck://compose). nothing
Run Capability Run any NoteDeck capability by id with JSON parameters (everything the command palette, plugins and AI can do). token + whatever the capability needs
Focus Column Focus a deck column (notedeck://column/<id>). nothing
Switch Deck Profile Switch the deck profile by name (notedeck://profile/<name>). nothing
Hide NoteDeck / Show NoteDeck Boss Key: hide the window, or bring it back (app.hide / app.show, NoteDeck 1.80+). token (no permission)

Actions marked "nothing" use deep links: no token, no permission, no confirmation dialog, because you are the one pressing the key. The key shows ✓ on success and ⚠ on failure; the reason is in the plugin log (com.notedeck.streamdeck.sdPlugin/logs).

Setup

  1. In NoteDeck open Settings → Permissions → API tokens and issue a token.
  2. Drop a NoteDeck action on a key. In its settings, fill NoteDeck API URL (leave the default) and API token once; they are shared by every NoteDeck key.
  3. External tools get a read-only permission set by default. In the same Permissions window, under External, allow what you want: notes.write for Post Note, and whatever a Run Capability key needs.
  4. Writes (post / memo) are always confirmed inside the NoteDeck window.

IDs you may need: account ids from the account.list capability, column ids from column.list or GET /api/deck/columns. The quickest way to look them up is the Run Capability command of the Raycast extension, or NoteDeck's API docs column.

Development

npm install
npm run build        # bundle to com.notedeck.streamdeck.sdPlugin/bin
npm run typecheck
npm run validate     # streamdeck validate
npm run pack         # .streamDeckPlugin for distribution

On a machine with the Stream Deck app: npx streamdeck link com.notedeck.streamdeck.sdPlugin installs the folder as a development plugin, and npm run watch rebuilds and restarts it on change. validate and pack also run on Linux.

License

MIT. NoteDeck itself is AGPL-3.0; this plugin is a separate client of its public API.

About

🎛️ Stream Deck plugin for NoteDeck (Misskey client)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages