YouTube Music Desktop App
Macro Deck に同梱デッキから YouTube Music Desktop App の再生、音量、評価を操作し、再生中の内容を表示します。
ヘッダーに YouTube Music Desktop App の名前とロゴを表示し、曲を再生している「全面カバー」スタイルと「小さいジャケット」スタイルのミュージックプレーヤーウィジェット
- 再生、一時停止、スキップ、シーク、シャッフル、リピート、音量
- 現在の曲を高評価、低評価、または評価を解除
- リンクや ID から動画やプレイリストを再生
- アプリの Companion Server によるライブ更新
- ミュージックプレーヤーウィジェットと、曲、アーティスト、進行状況の変数
YouTube Music Desktop App 連携は、YouTube Music のデスクトップアプリである YouTube Music Desktop App (YTMDesktop) に Macro Deck を接続します。バージョン 2.0.6 以降に内蔵されている、アプリの Companion Server を使います。アプリで一度 Macro Deck を許可すれば、以後はアプリが起動するたびに自動で接続します。
できること
- 再生、一時停止、スキップ、シーク、シャッフルのオンとオフ、リピートモードの設定、音量の変更。
- アプリのミュートとミュート解除。
- 現在の曲を高評価または低評価にする、評価を解除する、高評価や低評価をオンとオフに切り替える。
- 現在のキューや自分のプレイリストから曲を再生する、またはボタンを押したときに選ぶ。
- YouTube Music のリンク、youtu.be のリンク、動画 ID、プレイリスト ID から、特定の動画やプレイリストを再生する。
- ミュージックプレーヤー ウィジェットに、カバー、進行状況、再生とスキップのボタンとともに再生中の内容を表示する。
- 曲が高評価、低評価された、または評価が解除されたときに、フローで反応する。
設定例:
- 音楽が再生中か一時停止中かを表示する Toggle Play/Pause ボタン。
- トラックの評価 を 高評価の切り替え モードにし、ラベルを
ytmdesktop_like_statusにバインドした高評価ボタン。 - 動画または URL の再生 で、集中用のプレイリストを YouTube Music のリンクから再生するボタン。
ytmdesktop_volumeにバインドしたスライダー。アプリの音量に追従し、ドラッグすると音量が変わります。
動作のしくみ
Macro Deck は Companion Server とのライブ接続を維持するので、アプリでの変更はすぐにデッキに反映されます。アプリが終了すると、Macro Deck は 5 秒後に再試行し、失敗するたびに待ち時間を延ばして最大 1 分まで待ちます。ytmdesktop_is_connected 変数で、アプリに接続できるかどうかがわかります。アプリでアクセスが取り消されると、連携のページに YouTube Music Desktop App が認可を拒否しました という問題が表示され、セットアップのやり直しを求められます。既定では、Macro Deck は同じコンピューター上のアプリを探します。セットアップの 詳細な設定 で、別のコンピューターのアドレスを入力することもできます。セットアップできる YouTube Music Desktop App は 1 つです。
必要なもの
- YouTube Music Desktop App 2.0.6 以降。バージョン 1 には Companion Server がありません。
- アプリの Settings > Integrations でオンにした Companion Server。
- Macro Deck のセットアップ中にオンにした Companion Authorization。
セットアップ
ステップ 1: YouTube Music Desktop App をインストールする
YouTube Music Desktop App 2.0.6 以降をインストールして起動します。Macro Deck のセットアップのダイアログに、アプリのリリースページへのリンクがあります。
ステップ 2: Companion Server を有効にする
YouTube Music Desktop App で Settings > Integrations に移動します。Companion Server と Companion Authorization をオンにします。Macro Deck を許可すると、アプリは認可を自動でオフに戻します。
ステップ 3: Macro Deck でセットアップを開始する
Macro Deck のサイドバーで 連携 をクリックし、YouTube Music Desktop App をクリックします。概要 タブの 設定 セクションで セットアップ をクリックします。右上のスイッチをオンにしても同じダイアログが開き、セットアップが完了すると連携が有効になります。コンパニオンサーバーを有効にする ダイアログには入力欄がありません。アプリが別のコンピューターで動いている場合は、詳細な設定 をオンにして アドレス を入力します。ポート は
9863のままにします。続行 をクリックします。ステップ 4: アプリで Macro Deck を許可する
ダイアログに Macro Deck を許可 と 認可コード が表示されます。続行 をクリックすると、YouTube Music Desktop App に Macro Deck とコードを示す承認ウィンドウが開きます。コードが一致することを確認し、30 秒以内に Allow をクリックします。Macro Deck のダイアログに セットアップが完了しました。 と表示されたら、完了 をクリックします。
ステップ 5: ボタンにアクションを追加する
デッキ ページで、使いたいボタンをクリックします。デッキのロックが解除されている必要があります。右上のボタンに ロック と表示されていれば解除されています。エディターが開き、短押し が選択されています。+ アクションを追加 をクリックし、アクションを追加 ダイアログの左側で YouTube Music Desktop App を選択して、Toggle Play/Pause や トラックの評価 などのアクションを選びます。次に 保存 をクリックします。
ステップ 6: ボタンを押す
YouTube Music Desktop App で曲を再生し、デッキのボタンを押します。再生が一時停止または再開されます。
アクション17
ボタンに設定したり、フローから実行したりできます。
- Play
- 再生を再開します。
- Pause
- 再生を一時停止します。
- Toggle Play/Pause
- 再生と一時停止を切り替え、再生状態をボタンに表示します。
- Next Track
- 次の曲にスキップします。
- Previous Track
- 前の曲にスキップします。
- Refresh State
- 現在の再生状態をすぐに読み取ります。
- Set Volume
- アプリの音量を 0 から 100% の範囲で設定します。
- Volume Up
- 音量を 10% 上げます。
- Volume Down
- 音量を 10% 下げます。
- Seek
- 現在の曲の指定した位置 (秒) にジャンプします。
- Toggle Shuffle
- シャッフルをオン、オフ、または切り替え、オンかどうかを表示します。
- Set Repeat Mode
- リピートを Off、Repeat Track、Repeat Album/Playlist のいずれかに設定します。
- Play Track
- 現在のキューから曲を再生します。アクションの実行時に選ぶよう求めることもできます。
- Play Playlist
- 自分のプレイリストを再生します。アクションの実行時に選ぶよう求めることもできます。
- トラックの評価
- 現在の曲を高評価、低評価、または評価を解除するか、高評価や低評価をオンとオフに切り替えます。
- ミュート
- アプリをミュート、ミュート解除、またはミュートを切り替えます。
- 動画または URL の再生
- YouTube Music のリンク、youtu.be のリンク、動画 ID、プレイリスト ID から、動画やプレイリストを再生します。
トリガー8
ボタンやフローがこれらのイベントに反応できます。
- 評価の変更
- 現在の曲が高評価、低評価された、または評価が解除されました。特定の評価だけに限定することもできます。
- トラック変更
- 別の曲の再生が始まりました。タイトル、アーティスト、アルバムが含まれます (ミュージックプレーヤー カテゴリにあります)。
- 再生開始
- 再生が始まったか、再開しました (ミュージックプレーヤー カテゴリにあります)。
- 再生の一時停止
- 再生が一時停止されました (ミュージックプレーヤー カテゴリにあります)。
- 再生停止
- 再生が停止しました (ミュージックプレーヤー カテゴリにあります)。
- 音量変更
- 音量が変わりました。新しい値と以前の値が含まれます (ミュージックプレーヤー カテゴリにあります)。
- プレーヤー接続
- アプリに接続できるようになりました (ミュージックプレーヤー カテゴリにあります)。
- プレーヤー切断
- アプリに接続できなくなりました (ミュージックプレーヤー カテゴリにあります)。
変数21
これらの値をボタンやウィジェットに表示したり、条件に使ったりできます。
ytmdesktop_is_connected- Macro Deck がアプリに接続しているかどうかです。
ytmdesktop_current_track_name- 現在の曲のタイトルです。
ytmdesktop_current_artist- 現在の曲のアーティストです。
ytmdesktop_current_album- 現在の曲のアルバムです。
ytmdesktop_album_art_url- Macro Deck での現在のカバーのアドレスです。
ytmdesktop_playback_state- 再生状態です。
playing、paused、stoppedのいずれかです。 ytmdesktop_is_playing- 今音楽を再生しているかどうかです。
ytmdesktop_current_position- 曲を再生済みの位置 (秒) です。設定するとシークできます。
ytmdesktop_track_duration- 現在の曲の長さ (秒) です。
ytmdesktop_progress_percentage- 曲を再生済みの割合 (パーセント) です。
ytmdesktop_volume- アプリの音量 (パーセント) です。スライダーなどで設定することもできます。
ytmdesktop_is_muted- アプリがミュートされているかどうかです。
ytmdesktop_like_status- 現在の曲の評価です。
like、dislike、indifferentのいずれかです。 ytmdesktop_is_liked- 現在の曲が高評価されているかどうかです。
ytmdesktop_shuffle_enabled- シャッフルがオンかどうかです。
ytmdesktop_repeat_mode- リピートモードです。
off、track、contextのいずれかです。 ytmdesktop_is_live- 現在の項目がライブ配信かどうかです。
ytmdesktop_media_type- 現在の項目の種類です。
audio、video、uploaded、podcastのいずれかです。 ytmdesktop_ad_playing- 今広告が再生されているかどうかです。
ytmdesktop_video_id- 現在の曲の YouTube ID です。
ytmdesktop_device_name- 再生元として表示される名前です。
ウィジェット1
ウィジェットの選択画面からデッキに追加できます。
- ミュージックプレーヤー
- YouTube Music Desktop App が再生している曲、アーティスト、カバーを、進行状況と再生、一時停止、スキップのボタンとともに表示します。
よくある質問
ブラウザの YouTube Music でも使えますか？
いいえ。この連携は YouTube Music Desktop App とだけ通信します。ブラウザのタブで YouTube Music を使う場合は、ブラウザ拡張機能と組み合わせて WebNowPlaying 連携を使ってください。
Macro Deck から別のコンピューターのアプリを操作できますか？
はい。セットアップ時に 詳細な設定 をオンにして、YouTube Music Desktop App を実行しているコンピューターの アドレス を入力します。
セットアップでアプリに接続できないと表示されます。どうすればよいですか？
YouTube Music Desktop App が起動していること、バージョンが 2.0.6 以降であること、Settings > Integrations で Companion Server がオンになっていることを確認してください。その後、もう一度 続行 を押します。
セットアップで Companion Authorization をもう一度オンにするよう求められるのはなぜですか？
アプリは、Companion Authorization がオンの間しか新しい認可リクエストを受け付けず、アプリを許可した後は自動でオフにします。オンにしてから 続行 を押し、30 秒以内に Allow をクリックしてください。
アプリを閉じるとどうなりますか？
ytmdesktop_is_connected 変数が false になり、ミュージックプレーヤーウィジェットに YouTube Music が起動していないと表示され、アクションはアプリが接続されていないというメッセージで失敗します。アプリを再び起動すると、Macro Deck は 1 分以内に自動で再接続します。
音楽とオーディオのその他の連携
Spotify
Macro Deck に同梱Spotify の再生の操作、曲のお気に入り登録、プレイリストの管理を行い、再生中の内容をデッキに表示します。
WebNowPlaying
Macro Deck に同梱WebNowPlaying 拡張機能を通じて、ブラウザで再生中の音楽や動画を操作し、再生中の内容を表示します。
Jellyfin
Macro Deck に同梱デッキから Jellyfin のアプリやテレビを操作し、再生中の内容を表示して、再生の開始や停止に反応します。
SoundPad
Macro Deck に同梱SoundPad のリストからサウンドを再生し、録音を操作して、再生中のサウンドをデッキに表示します。
Voicemeeter
Macro Deck に同梱デッキから Voicemeeter、Banana、Potato のゲイン、ミュート、ルーティング、マクロボタンを操作します。