decky loader

デッキローダー

について

Decky Loader は、Steam Deck 用の自作プラグイン ランチャーです。メニューのスタイル設定、システムサウンドの変更、画面の彩度の調整、追加のシステム設定の変更などに使用できます。

Decky Loader、ドキュメント、開発ツールの詳細については、Wiki を参照してください。

特徴

複数のプラグインのクリーンな挿入とロード。
システムのアップデートと再起動の間、インストールされたままになります。
プラグインとローダー間の双方向通信を可能にします。
TypeScript React から実行される Python 関数をサポートします。
プラグインが CORS を完全にバイパスするフェッチ呼び出しを実行できるようにします。

よくある問題

• Syncthing は Steam Deck でポート 8080 を使用する場合がありますが、Decky Loader が機能するためにはこれが必要です。 Syncthing をサービスとして使用している場合は、そのポートを別のポートに変更してください。

• 8384 は Syncthing に推奨されるポートです。

• ポート 1337 または 8080 を使用するソフトウェアを使用している場合は、ポートを別のポートに変更するか、アンインストールしてください。

• SteamOS のアップデートで Decky が消えることがあります。この問題は、インストーラーを再実行し、安定したブランチを再度インストールするだけで簡単に修正できます。これが機能しない場合は、代わりにプレリリースをインストールしてみてください。それでも問題が解決しない場合は、既存の問題を確認し、存在しない場合は新しい問題を提出します。

インストール

• このインストールは、admin/sudo パスワードを設定しなくても実行できます。

1. 可能であればマウスとキーボードをご用意ください。

• キーボードとマウスは、USB-C または Bluetooth 経由で Steam Deck に接続できます。

• 多くの Bluetooth キーボードおよびマウス アプリが iOS および Android で利用できます。 (KDE Con​​nectはスチームデッキにプリインストールされています)

• Steam リンク アプリは、Windows、macOS、Linux で利用できます。リモートデスクトップの代替としてうまく機能します。

• 他にオプションがない場合は、右のトラックパッドをマウスとして使用し、必要に応じて押してオンスクリーン キーボードを開きます。

2. ボタンを押して、電源メニューを開きます。

3. 「デスクトップに切り替える」を選択します。

4. 選択したブラウザでこの Github ページに移動します。

5. インストーラーファイルをダウンロードします。 (Firefox を使用している場合は、 decky_installer.desktop.downloadという名前になります。実行する前に、名前をdecky_installer.desktopに変更します)

6. ファイルをデスクトップにドラッグし、ダブルクリックして実行します。

7. 管理者パスワードを入力するか、Decky が管理者パスワードを一時的にDecky! (このパスワードはインストーラーの完了後に削除されます)

8. インストールする Decky Loader のバージョンを選択します。

• 最新リリース
  ほとんどのユーザーを対象としています。これは Decky Loader の最新の安定バージョンです。

• 最新のプレリリース
  プラグイン開発者を対象としています。プレリリースは完全に安定しているとは言えませんが、最新の変更が含まれています。プラグイン開発の詳細については、wiki ページを参照してください。

9. デスクトップで「ゲーム モードに戻る」ショートカットを開きます。

• Konsole を使用できる人向けの高速インストールもあります。実行しますcurl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/install_release.sh | sh選択し、プロンプトが表示されたらパスワードを入力します。

アンインストール

残念です。問題が発生したためにアンインストールを検討している場合は、問題をオープンするか、Discord に参加して、あなたや他のユーザーをサポートできるようにすることを検討してください。

1. ボタンを押して、電源メニューを開きます。

2. 「デスクトップに切り替える」を選択します。

3. インストーラー ファイルを再度実行し、 uninstall decky loaderを選択します。

• Konsole を使用できる人向けの高速アンインストールもあります。実行しますcurl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/uninstall.sh | sh選択し、プロンプトが表示されたらパスワードを入力します。

はじめる

Decky Loader がインストールされたので、プラグインの使用を開始できます。各プラグインは異なる開発者によって保守されており、独自の用途がありますが、ほとんどは以下に概説する一般的な構造に従っています。

?プラグイン

1. ボタンを押してアイコンに移動します。これは、プラグインおよびローダー自体と対話するために使用される Decky メニューです。

2. アイコンを選択してプラグイン ブラウザを開きます。ここでプラグインを見つけてインストールできます。

• [設定]メニューのURLからインストールすることもできます。信頼できないソースからプラグインをインストールすることはお勧めしません。

3. プラグインをインストールするには、目的のプラグインの「インストール」ボタンを選択します。ドロップダウン メニューからバージョンを選択することもできますが、これはお勧めしません。

4. プラグインを更新、アンインストール、再ロードするには、Decky メニューに移動してアイコンを選択します。

• プラグインをアンインストールすると、そのプラグイン ファイルのみが削除され、プラグインによって作成された他のファイルは削除されないことに注意してください。

プラグイン開発

完全なプラグイン開発ドキュメントはまだありません。ただし、プラグイン テンプレート リポジトリから始めるのが良いでしょう。ご質問がある場合は、Discord への参加を検討してください。

貢献する

Decky Loader の開発バージョンのインストールの詳細については、開発に関する wiki ページを参照してください。この YouTube ガイドに従って、Steam Deck UI を Windows または Linux コンピューターにインストールしてテストすることもできます。

1. PR を開始する前に、メインへの最新のコミットを使用してリポジトリのクローンを作成します。

2. リポジトリのクローンで、次のコマンドを実行します。

    CDフロントエンド
   pnpm私
   pnpm ビルドを実行する

3. UI を変更している場合は、変更を Steam デッキにデプロイする前にこれらのコマンドを実行する必要があります。

4. VS Code タスクまたはdeck.shスクリプトを使用して、変更を Steam デッキにデプロイしてテストします。

5. Python スクリプト バージョンを使用して変更をテストします。毎回ビルド、デプロイ、リロードする必要があります。

️ライブラリが古いためにビルド エラーが発生する場合は、リポジトリ内でこのコマンドを実行する必要があります。

 pnpm update Decky-frontend-lib --latest

ソース管理とプラグインのデプロイは、依存関係を最新の状態に保つために、複製されたリポジトリのそれぞれの共同作成者に任されます。

クレジット

プラグイン ローダーのコンセプトの元のアイデアは、marios8543 の Steam Deck UI Inject プロジェクトの成果に基づいています。