システム
Macro Deck に同梱デッキからコンピューターを操作します。アプリ、音量、コマンド、通知、スリープ、シャットダウンに対応。
スイッチがオンで設定項目がないシステム連携のページ
- アプリケーション、ファイル、フォルダー、Web サイトの起動、前面表示、終了
- 既定のオーディオデバイス、または任意のデバイスの音量とミュート
- コマンドを実行し、その出力を変数に保存
- ロック、スリープ、休止状態、再起動、シャットダウン
- CPU、RAM、GPU、ディスク、時刻、フォーカス中のアプリを変数に
システム連携は、Macro Deck が動いているコンピューターを操作します。Macro Deck に同梱されていて最初から有効で、Windows、macOS、Linux のどれでもセットアップは不要です。
できること
- アプリ、ファイル、Web サイト: アプリケーションを起動 はアプリを起動します。モード で、実行中のアプリを前面に表示したり (起動または前面に表示)、もう一度押したときに閉じたり (起動 / 停止の切り替え) することもできます。ファイルを開く、フォルダーを開く、Web サイトを開く は、既定のアプリで開きます。アプリケーションを強制終了 は、名前を指定してプロセスを終了します。
- 音声: 音量を上げる、音量を下げる、音量を設定、ミュート / ミュート解除 は、既定の出力、既定の入力、または特定の 1 つのデバイスに対して動作します。ミュート / ミュート解除 を設定したボタンには、デバイスがミュートされているかどうかが表示されます。
- コマンド: コマンドを実行 は、既定のシェル、PowerShell、Bash でコマンドラインを実行し、出力を変数に保存できます。
- 通知: 通知を送信 はオペレーティングシステムの通知を表示します。Macro Deck の通知を表示 は、接続しているすべての画面で Macro Deck 内にメッセージを表示します。
- 電源: コンピューターをロック、スリープ、休止状態、再起動、シャットダウン。
変数
この連携は、コンピューターの状態を変数として報告します。CPU、RAM、GPU の使用率、各ディスクの容量、空き容量、アクティビティ、すべてのスピーカーとマイクの音量とミュート状態、日付と時刻、コンピューター名とオペレーティングシステム、画面がロックされているかどうか、前面にあるアプリケーションです。ラベルに表示したり、履歴グラフ や ゲージ ウィジェットでグラフにしたり、オートメーションで反応したりできます。
設定例
- ヘッドセットのマイクに ミュート / ミュート解除 を設定し、ミュート中かどうかを表示するマイクボタン。
system_volume_percentにバインドし、スピーカーの音量を設定するスライダー。system_cpu_usage_percent、system_ram_usage_percent、system_gpu_0_usage_percentを表示する ゲージ ウィジェット。- 音楽プレーヤーを 起動または前面に表示 で アプリケーションを起動 するボタン。
- コンピューターをロック を実行する、または 待機 の後に シャットダウン する「おやすみ」ボタン。
- スクリプトを コマンドを実行 で実行し、結果をボタンに表示する変数に書き込むフロー。
新しいオーディオデバイスやディスクを接続すると、数秒以内にその変数が作られます。
必要なもの
- Windows、macOS、Linux 上の Macro Deck 3
- Linux では、音量に pactl または amixer、通知に notify-send、電源のアクションに systemd
- Linux で GPU の使用率を取得するには、amdgpu ドライバーまたは nvidia-smi
- macOS では、再起動とシャットダウンのために Macro Deck が System Events を制御する権限
セットアップ
ステップ 1: 連携が有効になっていることを確認する
Macro Deck のサイドバーで 連携 をクリックし、システム をクリックします。右上のスイッチは既定でオンになっています。オフの場合はオンにします。設定するものはなく、概要 タブには この連携には設定項目がありません。 と表示されます。Linux の音量バックエンドなど、コンピューターに足りないものがある場合は、ページに問題として表示されます。
ステップ 2: ボタンにシステムのアクションを追加する
デッキ ページでボタンをクリックします。デッキのロックが解除されている必要があります。右上に ロック ボタンが表示されていれば解除されています。エディターが開き、短押し が選択されています。+ アクションを追加 をクリックし、アクションを追加 ダイアログの左側で システム を選択して、ミュート / ミュート解除 や アプリケーションを起動 などのアクションを選びます。
ステップ 3: アクションの内容を入力する
各アクションは必要なものだけを尋ねます。
- アプリケーションを起動: アプリケーション、任意の 引数 と 作業フォルダー、モード。
- 音量のアクション: 音声デバイス と、量 (%) または 音量 (%)。
- コマンドを実行: シェル と コマンド、必要に応じて 出力を変数に保存。
ステップ 4: ボタンに値を表示する
値を表示するには、ボタンのラベルに変数を入力します (例:
CPU {{ vars.system_cpu_usage_percent }} %)。システムのページの 変数 タブには、システムのすべての変数が現在の値とともに表示されます。ステップ 5: ボタンを押す
保存してボタンを押すか、エディターで 実行 をクリックしてアクションをすぐに試します。
アクション17
ボタンに設定したり、フローから実行したりできます。
- アプリケーションを起動
- アプリケーションを起動するか、実行中のインスタンスを切り替えたり前面に表示したりします。
- Web サイトを開く
- 既定のブラウザで Web サイトを開きます。
- ファイルを開く
- 既定のアプリケーションでファイルを開きます。
- フォルダーを開く
- ネイティブのファイルマネージャーでフォルダーを開きます。
- アプリケーションを強制終了
- 実行中のプロセスを名前で終了します。先にウィンドウを閉じるよう求めることもできます。
- 音量を上げる
- 選んだオーディオデバイスの音量を上げます。
- 音量を下げる
- 選んだオーディオデバイスの音量を下げます。
- ミュート / ミュート解除
- 選んだオーディオデバイスのミュート状態を切り替え、ボタンに表示します。
- 音量を設定
- 選んだオーディオデバイスの音量を特定のレベルに設定します。
- 通知を送信
- オペレーティングシステムのネイティブの通知を表示します。
- Macro Deck の通知を表示
- 接続しているデバイスとアプリの Macro Deck に、短いメッセージまたはダイアログとしてメッセージを表示します。
- コマンドを実行
- 選んだシェルでコマンドラインを実行し、その出力を変数に保存できます。
- コンピューターをロック
- 画面をロックします。戻るにはパスワードまたは PIN が必要になります。
- スリープ
- コンピューターをスリープさせます。
- 休止状態
- セッションをディスクに保存し、電源を完全に切ります (Windows と Linux)。
- 再起動
- コンピューターを再起動します。強制 で、再起動を妨げるアプリを無視します。
- シャットダウン
- コンピューターをシャットダウンします。強制 で、シャットダウンを妨げるアプリを無視します。
変数12
これらの値をボタンやウィジェットに表示したり、条件に使ったりできます。
system_volume_percent,system_muted- 既定の出力デバイスの音量 (パーセント) とミュート状態です。
system_input_volume_percent,system_input_muted- 既定の入力デバイスの音量 (パーセント) とミュート状態です。
system_audio_output_<device>_*,system_audio_input_<device>_*- すべてのスピーカーとマイクの音量 (パーセント、
_volume_percent) とミュート状態 (_muted) です (例:system_audio_input_usb_mic_muted)。 system_cpu_usage_percent,system_cpu_name- プロセッサーの負荷 (パーセント) とプロセッサーのモデルです。
system_ram_usage_percent,system_ram_used_gb,system_ram_total_gb- 使用中のメモリの割合 (パーセント)、使用中のメモリ量、メモリの総容量 (GB) です。
system_gpu_<n>_usage_percent,system_gpu_<n>_name- 各グラフィックカードの負荷 (パーセント) と名前です。
0から番号が振られ、最大 8 枚です。 system_disk_<n>_*- 各ディスクの名前、マウントポイント、ファイルシステム、容量、使用容量と空き容量、使用率、読み取りと書き込みの速度とアクティビティです。
0から番号が振られ、最大 8 台です。 system_date,system_time,system_datetime- 現在の日付、時刻、日時のテキストです。
system_timestamp_unix,system_day_of_week,system_hour,system_minute- 現在時刻の各部分です。Unix タイムスタンプ、曜日、時、分です。
system_pc_name,system_os- コンピューター名とオペレーティングシステムです。
system_locked- コンピューターがロックされているかどうかです (Windows と macOS)。
system_focused_app,system_focused_app_path,system_focused_app_bundle_id- 前面にあるアプリケーションと、そのパスとバンドル ID です。
よくある質問
特定の 1 つのデバイスの音量を操作できますか?
はい。すべての音量のアクションに 音声デバイス 欄があり、既定の出力、既定の入力、Macro Deck が検出したすべてのデバイスから選べます。取り外したデバイスも一覧に残り、戻るまでその変数は利用不可になります。
スライダーで音量を設定できますか?
はい。system_volume_percent などの音量の変数にスライダーをバインドします。変数の設定 で音量やミュートの変数を設定することもできます。1 つのボタンでミュートをオンとオフに切り替えるには、ミュート / ミュート解除 を使います。
macOS で再起動やシャットダウンが失敗するのはなぜですか?
macOS は先に許可を求めます。システム設定 > プライバシーとセキュリティ > オートメーション > System Events で Macro Deck を許可してください。macOS では 強制 は効果がなく、休止状態 もありません。
Linux で音量、通知、電源のアクションがないのはなぜですか?
これらには、ディストリビューションによってはインストールされていないツールが必要です。音量には pactl (PulseAudio または PipeWire) か amixer、通知には notify-send、電源のアクションには systemctl か loginctl が必要です。連携 の システム ページに、足りないものが表示されます。
「コマンドを実行」はどのくらい待ちますか?
タイムアウト(秒) まで待ちます (既定は 30)。0 にするとコマンドが終了するまで待ちます。出力を変数に保存しない限り、時間が過ぎても動いているコマンドはそのまま実行を続けます。
Macro Deck 2 の Windows Utils のボタンは引き継がれますか?
ほとんどが引き継がれます。Macro Deck 2 から移行すると、アプリケーションの起動、ファイルやフォルダーを開く、コマンドライン、音量などのアクションはシステムのアクションになり、ホットキーとテキスト入力は キーボード のアクションになります。
お使いのコンピューターのその他の連携
キーボード
Macro Deck に同梱ボタンから、コンピューターでショートカットを押したり、テキストを入力したり、キー操作シーケンスを実行したりできます。
マウス
Macro Deck に同梱ボタンから、コンピューターでクリック、ポインターの移動、ドラッグ、スクロールができます。
ADB / Android Debug Bridge
Macro Deck に同梱USB または Wi-Fi で Android のスマートフォンやタブレットを操作します。画面のスリープ解除、アプリの起動、タップ、文字入力、スクリーンショットの撮影ができます。
Steam
Macro Deck に同梱Steam のゲームを起動、終了し、プレイ中のゲーム、フレンド、ライブラリをデッキに表示します。