XeroxDev / YTMD-StreamDeck

This Stream Deck Plugin allows you to control the YouTube Music Desktop App (https://github.com/ytmdesktop/ytmdesktop)
MIT License
59 stars 17 forks source link
addon app companion-server deck desktop music plugin stream stream-deck streamdeck volume youtube youtube-music-desktop youtube-music-desktop-app ytmd ytmd-app ytmd-streamdeck

Thumbnail

1. Table of content

2. Badges

Forks Stars Watchers Contributors

Issues Issues closed

Issues-pr Issues-pr closed PRs welcome

Release

Awesome Badges

3. What is this Plugin?

This Stream Deck Plugin allows you to control the YouTube Music Desktop App

[!NOTE] we only support version 2.x.x and above, if you are using an older version, please update to the latest version.

4. Support / Feedback

You found a bug? You have a feature request? I would love to hear about it here or click on the "Issues" tab here on the GitHub repositorie!

You can also join my discord here

5. Actions

6. How to use it?

[!NOTE] This is just a simplified version, please visit the official documentation for a more detailed guide.

  1. Install the YouTube Music Desktop App.
  2. Install the Plugin from Releases or from the official Stream Deck Store.
  3. Add Play/Pause action
  4. Insert, if not already correct, the settings to YTMDesktop (eg. Host and Port)
  5. Make sure the YTMDesktop App and the Companion Server is running
    • To start the companion server, click at the top right of YTMDesktop on the settings gear
    • Go on the left side on the "Integrations" tab
    • Enable the "Companion Server"
  6. Turn on "enable companion authorization" under the Companion Server
  7. Press the Authorize button in the Play/Pause action settings
  8. Compare the authorization code displaying by the plugin with the one displaying in the YTMDesktop App
  9. If they match, confirm the authorization in the YTMDesktop App
  10. You are ready to go! (Steps 6-9 are only needed once/when the plugin isn't authorized)

7. How to contribute?

Just fork the repository and create PR's.

[!NOTE] We're using release-please to optimal release the plugin. release-please is following the conventionalcommits specification.