HN 日本語サマリー

← 一覧へ戻る
プログラミング

Moonshine: PCからMoonlight対応デバイスへゲームをストリーミング可能に

Moonshine: Lets you stream games from your PC to any device running Moonlight (github.com)

303 pointsby wertyk123 コメント

要約

Moonshineは、PCからMoonlightクライアントが動作するあらゆるデバイスへゲームをストリーミングできるLinux専用のアプリケーションです。GPUによるハードウェアエンコーディング(H.264, H.265, AV1)、HDRサポート、低遅延のオーディオストリーミングなどの機能を備えています。各ストリームは分離されたセッションで実行されるため、ホストPCはストリーミング中も他の用途に使用でき、モニターなしでも動作します。

全文翻訳

Moonshine 🌙

[画像: CI]

Moonshineは、PCからMoonlightが動作するあらゆるデバイスにゲームをストリーミングできるようにします。キーボード、マウス、コントローラーの入力はホストに送り返されるため、あたかもその場に座っているかのようにリモートでゲームをプレイできます。

特徴

  • 分離されたストリーミングセッション: 各ストリームは独自のコンポジターで実行され、デスクトップ環境とは完全に分離されています。ストリーミング中もホストPCを他の用途に使用できます。
  • モニター不要: ヘッドレスサーバーでも動作します — HDMIダミープラグは不要です。
  • ハードウェアビデオエンコーディング: GPUを使用したH.264、H.265、AV1エンコーディング。
  • HDRサポート: 対応ゲーム向けの真の10ビットHDRストリーミング。
  • 完全な入力サポート: マウス、キーボード、タッチスクリーン、ペン/スタイラス、ゲームパッド(モーション、タッチパッド、ハプティクスを含む)。
  • オーディオストリーミング: 低遅延Opusエンコーディングによるステレオおよびサラウンドサウンド(5.1/7.1)。

要件

  1. Linuxのみ。.deb、.rpm、Nix、AUR、およびSteamOS用のインストールスクリプトとして利用可能です。Arch Linuxでテスト済みですが、他のディストリビューションでも動作すると報告されています。
  2. systemd。アプリケーションプロセスの起動と管理に必要です。ほぼ全てのモダンなLinuxディストリビューションにはデフォルトで含まれています。
  3. Vulkanビデオエンコーディング対応GPU。NVIDIA RTX、AMD RDNA2+、またはIntel Arc。
  4. Moonlight v6.0.0以降。古いバージョンや非公式ポートとの互換性は保証されません。

インストール

Arch

推奨される方法は、AUR経由でインストールすることです。

yay -S moonshine-bin

インストール後、ディストリビューションに依存しない以下のサービスを有効にする手順に従ってください。

Debian / Ubuntu (.deb)

リリースページから最新の.debをダウンロードしてインストールします。

sudo apt install ./moonshine_*.deb

インストール後、以下のサービスを有効にする手順に従ってください。

Fedora / RHEL (.rpm)

リリースページから最新の.rpmをダウンロードしてインストールします。

sudo dnf install ./moonshine-*.rpm

パッケージのインストール後スクリプトは、udevルール、カーネルモジュール、moonshineグループを自動的に設定します。インストール後、以下のサービスを有効にする手順に従ってください。

Nix

このリポジトリはNix flakeでもあり、パッケージとサービスをセットアップするNixOSモジュールを提供します。手順についてはnix/README.mdを参照してください。または、任意のディストリビューションでパッケージのみをインストールするには以下を実行します。

nix profile install github:hgaiser/moonshine

インストール後、以下のサービスを有効にする手順に従ってください(NixOSモジュールを有効にした場合はこれが自動的に処理されます)。

Bazzite / Silverblue / Atomicディストリビューション

Fedora Atomicディストリビューションでは、リリースページから.rpmをダウンロードしてレイヤー化します。

sudo rpm-ostree install ./moonshine-*.rpm
sudo systemctl reboot

再起動後、以下のサービスを有効にする手順に従ってください。

SteamOS

インストーラースクリプトを使用します。

curl -fsSL https://github.com/hgaiser/moonshine/releases/latest/download/moonshine-install.sh | bash

これにより、Moonshineは/opt/moonshine/にデプロイされ、設定ファイルは/etc/に配置されます。インストーラーはこれらのファイルをSteamOSに登録するため、アトミックアップデートを跨いでも永続化されます。

サービスを有効にする

これらの手順は上記の全てのインストール方法に適用されます(サービスはsystemdユニットです)。

  1. ユーザーのリンガリングを有効にする:

    sudo loginctl enable-linger $USER
    

    これにより、ユーザーがログインしていない状態(ヘッドレス実行時)でも、Moonshineがユーザーセッションでアプリケーションを実行できるようになります。

    ストリーミングしたいときに常にユーザーがログインしている場合は、この手順をスキップできます。

  2. 起動時にサービスを開始し、すぐに実行するように有効にする:

    sudo systemctl enable --now moonshine@$USER
    
  3. ヘッドレスでストリーミングする際のゲームパッドサポート(アクティブなデスクトップセッションがない場合): ユーザーをinputグループに追加し、変更を有効にするためにログアウトして再ログイン(または再起動)します。

    sudo usermod -aG input $USER
    

    Moonshineはストリーミングされたコントローラーごとに仮想ゲームパッドを作成し、ストリーミングされたゲームはそれを読み取れる必要があります。デスクトップセッションがアクティブな状態でストリーミングする場合、ユーザーはアクティブシートとして既に入力デバイスへのアクセス権を付与されているため、この手順は不要です。moonshine healthcheckを実行して確認してください。グループが不足している場合はinput groupの警告が表示されます。

ソース

ビルドおよび実行には以下の依存関係が必要です。

# ビルド依存関係
sudo pacman -S --asdeps \
   clang \
   cmake \
   jq \
   libc++ \
   rust

# ランタイム依存関係
sudo pacman -S \
   gcc-libs \
   glibc \
   libevdev \
   libxkbcommon \
   mesa \
   opus \
   wayland \
   xorg-xwayland

その後ビルドします。

cargo build --release --workspace

環境をセットアップします。

# uinput/uhidカーネルモジュールをインストール
sudo install -Dm644 dist/moonshine-modules.conf /usr/lib/modules-load.d/moonshine.conf
sudo modprobe uinput uhid

# 入力デバイスアクセス用のudevルールをインストール
sudo install -Dm644 dist/60-moonshine.rules /usr/lib/udev/rules.d/60-moonshine.rules
sudo udevadm control --reload-rules

# ゲームレンダリング用のferriscopeのVulkan WSIレイヤーをインストール
dist/install-wsi.sh   # あなたとしてビルドし、インストールにはsudoを要求します

その後実行します。

cargo run --release -- /path/to/config.toml

設定

指定したパスに設定ファイルが存在しない場合、自動的に作成されます。AURパッケージを使用する場合、デフォルトは$XDG_CONFIG_HOME/moonshine/config.tomlです。

クライアントとのペアリング

初めてMoonlightで接続する際、PINが表示されます。ホストに通知が表示され、ペアリングページを開くためにクリックできます。または、手動でhttp://localhost:47989/pinにアクセスすることもできます。

コマンドラインからペアリングすることもできます。

curl -X POST "http://localhost:47989/submit-pin" -d "uniqueid=0123456789ABCDEF&pin=<PIN>"
アプリケーションの追加

各アプリケーションは独自の分離されたストリーミングセッションで実行されます。config.tomlに以下のように追加します。

[[application]]
title = "Steam"
boxart = "/path/to/steam.png"  # オプション
command = ["/usr/bin/steam", "steam://open/bigpicture"]
steam_integration = true
  • title: Moonlightに表示される名前。
  • boxart(オプション): カバー画像のパス。
  • command: 実行するコマンド。最初の項目が実行ファイル、残りは引数です。
  • pre_command(オプション): アプリケーション起動前に実行するコマンド。各項目は独立したコマンドで、順番に実行されます。同期的に実行され、セッションは全て完了するまで待機します。
  • steam_integration(オプション): Steam統合。gamescopeの-eと同様。デフォルトはオフ。Steam(Big Picture)のオーバーレイやフォーカスを正しく機能させるためにオンにします。オンの場合、SteamおよびSteamゲームウィンドウのみがフォーカスを取得できるため、直接起動する他のものにはオフのままにします。Steamアプリケーションスキャナーからのゲームはオンになっています。
  • post_command(オプション): ストリーミングセッション終了後に実行するコマンド。各項目は独立したコマンドで、順番に実行されます。同期的に実行され、サーバーは全て完了するまで待機します。

例:

[[application]]
title = "Steam"
command = ["/usr/bin/steam", "steam://open/bigpicture"]
steam_integration = true
pre_command = [
    ["/usr/bin/systemctl", "stop", "conflicting.service"],
]
post_command = [
    ["/usr/bin/systemctl", "start", "conflicting.service"],
]
アプリケーションスキャナー

スキャナーはインストールされているアプリケーションを自動的に検出するため、手動で追加する必要はありません。

Steamスキャナー — インストールされている全てのSteamゲームを検出します。

[[application_scanner]]
type = "steam"
library = "$HOME/.local/share/Steam"
command = ["/usr/bin/steam", "-bigpicture", "steam://rungameid/{game_id}"]

Desktopスキャナー — .desktopファイルからアプリケーションを検出します。

[[application_scanner]]
type = "desktop"
directories = [
  "$HOME/.local/share/applications",
  "/usr/share/applications",
]
include_terminal = false
resolve_icons = true

Lutrisスキャナー — インストールされている全てのLutrisゲームを検出します。

[[application_scanner]]
type = "lutris"
command = ["/usr/bin/lutris", "lutris:rungame/{slug}"]

ゲームはLutrisのスラッグでマッチングされます。ボックスアートは利用可能な場合、Lutrisのcoverart/ディレクトリから自動的にロードされます。デフォルトのデータベースパスは~/.local/share/lutris/pga.dbです。pga_dbオプションを使用してカスタムデータベースの場所を指定することで上書きできます。

Heroicスキャナー — インストールされている全てのHeroic Games Launcherゲーム(Epic、GOG、Amazon、および手動で追加されたゲーム)を検出します。

[[application_scanner]]
type = "heroic"
command = ["heroic", "--no-gui", "heroic://launch?appName={app_name}&runner={runner}"]

HeroicをFlathubからインストールした場合、代わりにFlatpak経由で起動します。

[[application_scanner]]
type = "heroic"
command = [
  "dbus-run-session", "--",
  "flatpak", "run", "com.heroicgameslauncher.hgl",
  "--no-gui", "heroic://launch?appName={app_name}&runner={runner}",
]

dbus-run-sessionプレフィックスは、ゲームがデスクトップではなくMoonshineのコンポジター内で実行されるようにします。Flatpakがこれを必要とする理由については、TIPS.mdを参照してください。

{app_name}はHeroicの内部ゲームIDであり、{runner}はストア(Epicの場合はlegendary、GOGの場合はgog、Amazonの場合はnile、手動で追加されたゲームの場合はsideload)です。コマンドはMoonshine自身のPATHに対して解決されます。パッケージ化されたsystemdサービスの下では、これはログインシェルのPATHではなくsystemdのデフォルトのPATHです。したがって、/usr/binにインストールされたパッケージではベアなheroicが機能しますが、AppImageや~/.local/binの下にあるものには機能しません。それらの場合は絶対パスを使用してください。ボックスアートは、Heroicが既にダウンロードしたアートについては、Heroicのimages-cache/ディレクトリから自動的にロードされます。

デフォルトの設定ディレクトリは~/.config/heroicですが、Flatpak版のみがインストールされている場合は~/.var/app/com.heroicgameslauncher.hgl/config/heroicにフォールバックします。config_dirオプションでこれを上書きできます。

Bottlesスキャナー — BottlesのLibraryタブにあるゲームとアプリケーションを検出します。

[[application_scanner]]
type = "bottles"
command = ["bottles-cli", "run", "-b", "{bottle}", "--program-id", "{program_id}"]
umu_command = ["bottles-cli", "umu", "run", "--game", "{umu_game}"]

Bottlesのライブラリに追加したエントリ(プログラムの「ライブラリに追加」)のみが表示されます — Bottlesが検出した全てのプログラムが表示されるわけではありません。UMUエントリはBottlesが準備完了を報告すると表示され、ライブラリ内のSteamショートカットはスキップされます。umu_commandはオプションです。指定しない場合、UMUエントリはスキップされます。

制限事項: Bottlesはボトル外(例: 別個のゲームドライブ)にある実行ファイルをwine start経由で起動します。これはすぐに終了するため、Moonshineは起動後まもなくセッションを終了します。ボトルプレフィックス内にインストールされたゲームは影響を受けません。

{bottle}はボトルの名前、{program_id}はプログラムの内部ID、{name}はエントリの表示名、{umu_game}はBottlesのUMU統合で管理されているゲームのIDです。コマンドはMoonshine自身のPATHに対して解決されるため、ベアなbottles-cliはネイティブにインストールされたBottlesでのみ機能します。Flatpak版Bottlesについては、TIPS.mdを参照してください。

デフォルトのデータディレクトリは、library.ymlを含む~/.local/share/bottlesと~/.var/app/com.usebottles.bottles/data/bottlesのうち最初に見つかったものです — アンインストールされたネイティブBottlesの残存データはFlatpakインストールをシャドウしません。data_dirオプションでこれを上書きできます。

ボックスアートは、利用可能な場合はBottlesのグリッド画像から自動的にロードされ、プログラムのアイコンにフォールバックします。

ヒントとコツ

実用的なレシピや回避策については、TIPS.mdを参照してください。

FAQ

  1. Sunshineと比較してどうですか?

    • Sunshineはより多くのプラットフォームをサポートし、全体的に機能が多いです。MoonshineはLinux専用です。
    • Moonshineは各ストリーミングセッションをデスクトップから分離された独自の環境で実行します。これは、ストリーミング中にホストPCを使用可能であり、アクティブなデスクトップセッションなしでも動作することを意味します。
  2. Moonshineを使用して同時に2つのクライアントにストリーミングできますか?

    これは現在サポートされている機能ではなく、Moonshineの焦点ではありません。これに対するサポートの追加に興味がある場合は、Discordでissueを開くか、議論してください。

  3. ヘルスチェックを実行するにはどうすればよいですか?

    moonshine healthcheckを実行して、GPU機能、コーデックサポート、ポートの可用性を確認します。設定されたポートとGPU設定も確認するには、--config <path>を渡します。

セキュリティ

Moonshineはパブリックネットワークでの使用を想定していません。基盤となるGameStreamプロトコルには、アプリケーションレベルでトラフィックが完全に暗号化されないという制限があります。

インターネット経由でストリーミングする必要がある場合は、Tailscale、WireGuard、またはZeroTierのようなVPNを使用してください。

Moonshineのポートをインターネットに直接公開しないでください。

謝辞

以下のプロジェクトの背後にいる人々の素晴らしい貢献なしには、これは不可能でした。

  1. Moonlight、これがなければMoonshineのクライアントは存在しませんでした。
  2. Sunshine、APIのホスト部分の多くの基盤を築きました。
  3. Inputtino、入力デバイスの徹底的な実装を提供しました。
  4. magic-mirror、VulkanとWaylandコンポジターを使用してヘッドレスストリーミングを行うためのインスピレーションとなりました。