【Steam Frame】aux ボタンを押し方ごとのショートカットにする「frame-aux-shortcuts」
- Digital0 JPY
Steam Frame の aux ボタン（電源ボタンの上の小さなボタン）を、押し方ごとのショートカットにするアプリです。 1〜5 回押しと長押しの 6 つの押し方に、それぞれアクションを割り当てられます。 押すと短い音と視界の小さなお知らせで、何をしたかが分かります。 PC なしで、Frame の中だけでインストールできます（1 行コマンドか、この zip から）。
特徴
- 6 つの押し方：1〜5 回押しと長押しに、それぞれ別のアクション - すぐ分かる：押すたびに短い音と、視界の下に 2 秒ほどのお知らせ。マイクがミュートの間は、視界の上に「マイク ミュート中」がずっと出ます - 被ったまま設定：SteamVR のダッシュボードの「aux ショートカット」のタブから、割り当て・明るさの段・押し方の時間などを変えられます - 自分のコマンドも：コマンドを登録して割り当てられます。PC の VRChat のミュートを切り替えるプリセットもあります - sudo なし：すべてホームフォルダに入ります。アプリを止めると aux は元の動きに戻ります - 英語にも対応：パネルは Steam の言語に合わせて日本語か英語で表示され、アプリのタブで切り替えられます。インストーラーも Steam の言語が日本語以外なら英語で表示され、zip には英語の説明書（README-en）も入っています
割り当てられるアクション
- マイクのミュート（既定は 1 回押し） - 明るさ：2〜4 段を順に切り替え（既定は 2 回押し、100 → 60 → 40%） - パススルーのオン・オフ（既定は 3 回押し） - スクリーンショット：見ている画面を保存し、Steam のスクリーンショットにも入れます（既定は 4 回押し） - パフォーマンス表示：frame-perf-overlay を出したり消したり（既定は 5 回押し。frame-perf-overlay が入っているとき） - ダッシュボードを開く（既定は長押し） - 自分で登録したコマンド、またはなし アプリが動いている間は、aux を押しても SteamVR の元の動き（1 回押しでダッシュボード、2 回押しでパススルー）にはならず、割り当てたものがその代わりになります。音量ボタンには影響しません。
使い方
Frame の中だけでインストールできます。方法は 2 つで、入るアプリは同じです（違うのは版で、方法 1 はその時点の最新版、方法 2 は zip に入っている版）。 はじめに：開発者モードをオンにして、Konsole を開く Konsole は開発者モードのときだけ出ます。先に Frame の 設定 → システム → 開発者モード をオンにしてください。 そのあと、画面下のバーの「＋」→「プログラムを起動」→「Konsole」を開きます。下のコマンドはコピーして、Konsole 右上の「Paste」ボタンで貼り付けられます（手で打っても大丈夫です）。 方法 1：1 行コマンドで（かんたん・いつもその時点の最新版） 1. Konsole に次の 1 行を貼り付けて Enter curl -fsSL https://frame.sasaken1102s.net | sh 2. メニューで frame-aux-shortcuts の番号を入力して Enter（このメニューでは 5）。SteamVR と一緒に起動するかを聞かれます 方法 2：この zip から 1. Frame のブラウザで、この商品ページから zip をダウンロードします（ホームの Downloads フォルダ ＝ ~/Downloads に入ります） 2. Konsole に次の 1 行を貼り付けて Enter cd ~/Downloads && unzip -o frame-aux-shortcuts_booth.zip && sh frame-apps/install.sh 3. メニューで frame-aux-shortcuts の番号を入力して Enter（この zip だけなら 1）。SteamVR と一緒に起動するかを聞かれます 「SteamVR と一緒に起動する？」に はい（Enter だけでも はい）と答えたときは、SteamVR が動いていればその場で、動いていなければ次に SteamVR を起動したときから aux が使えます。いいえと答えたときは、SteamVR のダッシュボードの「＋」（プログラムを起動）から Frame Aux Shortcuts を起動します。アンインストール（削除）も上のどちらかの 1 行で、メニューの u から選べます。くわしくは zip の中の「はじめにお読みください_frame-aux-shortcuts.txt」へ。
必要なもの
- 開発者モードを有効にした Steam Frame（設定 → システム → 開発者モードを有効化）と SteamVR - パフォーマンス表示のアクションを使うときは frame-perf-overlay（同じインストーラーから入れられます）
同梱の版について
zip には、zip を作った時点の最新版が入っています。インストールしたあとは、パネルのアプリのタブの「更新する」で新しい版にできます。すでに新しい版が入っているときに、zip の古い版で勝手に上書きすることはありません。
ご利用前に必ずお読みください
- 非公式のツールです。Valve Corporation と提携・承認・後援関係にはありません。Steam、Steam Frame、SteamVR は、米国および／またはその他の国における Valve Corporation の商標および／または登録商標です。VRChat は VRChat Inc. の商標で、本ツールは VRChat とは関係ありません - 自己責任でご利用ください。無保証です。このソフトウェアの使用によって生じたいかなる損害（本体やアカウントに関するものを含む）についても、作者は一切の責任を負いません - パススルーの切り替えは SteamVR の非公開の仕組みに頼っているので、SteamVR の更新で使えなくなることがあります（そのときは失敗の音とお知らせが出ます） - aux の割り当ては本体のメモリの中だけで変え、アプリが終わるとき（落ちたときも）元に戻します。再起動すれば必ず元に戻ります。Steam や SteamVR のファイルには書き込みません - 登録したコマンドは、あなたのユーザーができることを何でもできます。信頼できるコマンドだけを登録してください - テレメトリはありません。外部との通信は、GitHub への新しい版の確認と作者のアプリの一覧の取得、VRChat のミュートのプリセットを使ったときに PC へ送る OSC だけです - 作者が AI（Claude）を使って作り、作者の Steam Frame で動作を確かめています。あなたの環境で同じように動くとは限りません
ライセンス
MIT ライセンスです。同梱の openvr.h は BSD-3-Clause、一部のアイコンの形は Feather（MIT）と Lucide（ISC）にならっています。zip の中の tar.gz に LICENSE と THIRD_PARTY_LICENSES が入っています。
お問い合わせ
不具合や要望は X（@sasaken_1102s）または GitHub の Issues へどうぞ。
公式サイト
https://github.com/sasaken1102r/frame-aux-shortcuts
English
Shortcuts on the Steam Frame's aux button (the small button above the power button). - Give each of six ways of pressing it (1 to 5 presses and a long press) its own action: mic mute, brightness levels, passthrough on/off, screenshot, frame-perf-overlay, the dashboard, or a command of your own - A short sound and a small notice in your view tell you what happened - Set everything up from a tab in the SteamVR dashboard. No sudo - The panel and the installer show English when Steam is set to a language other than Japanese. The zip includes README-en How to install (on the headset, in Konsole): Turn on Developer Mode first. Konsole only shows up in Developer Mode. - Latest version: curl -fsSL https://frame.sasaken1102s.net | sh - From this zip: cd ~/Downloads && unzip -o frame-aux-shortcuts_booth.zip && sh frame-apps/install.sh Then pick it from the menu. Unofficial, not affiliated with Valve or VRChat. Passthrough relies on a private SteamVR interface and may break with a SteamVR update. Use at your own risk. MIT licensed.