nyan Real / Spatial Wall ユーザーマニュアル

メガネをかけると、目の前の空間に複数のディスプレイが並びます。 頭を動かすと視点が移動しますが、ディスプレイはその場に留まります。 このマニュアルでは、接続から基本設定、使い方、トラブル対処までを説明します。

個々の設定項目の説明は、アプリ内でその項目にマウスを重ねると出ます。 ここではその手前にある「何のために、どういう順番で使うか」を扱います。

このアプリについて

対応するメガネを USB でつなぐと、PC のディスプレイをウォールとして 空間に並べ、頭の動きに合わせて描き直します。ディスプレイは物理・仮想を 問わず並べられ、音も画面の位置から聞こえるようになります。

主な機能は 2 つです。

インターネット上の外部サーバーとは通信しません。 更新の自動確認や、利用状況・ クラッシュ情報の送信も行いません。ネットワーク通信を使う機能は、次のローカル経路だけです。

サポートも自動化していません。不具合の報告は、「バージョン情報」から情報をコピーして GitHub Issues に貼る、という手動の流れです。

対応メガネ:XREAL(One Pro / One / 1S / Air 2 Pro / Air 2 / Air)、 ROG XREAL R1、xbx a01 / a01+、RayNeo Air、Rokid(Max / Air)、 VITURE(Pro / One / One Lite)、EPSON MOVERIO(BT-40 / BT-30C)、Nreal Light、 MAD Gaze Glow。機種ごとにできることが違うので、詳しくは 対応メガネ一覧 を見てください。

動作環境:Windows のほか、Linux と macOS でも同じアプリが動きます。

OS 動作要件
Windows Windows 10 バージョン 2004(build 19041)以降の 64 ビット版
Linux(GNOME) GNOME 46 以降(Wayland セッション)
Linux(Raspberry Pi) Raspberry Pi OS trixie 以降 + labwc
macOS macOS 14.4 以降(実験的。一部の機能が未対応です)

どの環境でも、映像出力できる USB-C ポートまたは HDMI 変換アダプターと、メガネ本体が 要ります。インターネット接続は必須ではありません。スマホリモコンや Android メガネ ブリッジを使う場合は、スマホと PC が同じ LAN に接続されている必要があります。OS ごとの機能差は 付録の表にまとめてあります。

インストールと最初の起動

Windows

インストーラー(nyan-real-spatial-wall-*-installer.exe)とポータブル ZIP の どちらでも動きます。ポータブル版は展開して spatial-wall.exe を実行するだけで、 インストールは不要です。

署名について:現在の配布物にはコード署名がないため、初回起動時に Windows の SmartScreen が警告を出すことがあります。「詳細情報」→ 「実行」で進めてください。

Linux(GNOME)

.deb パッケージを apt install で導入します。仮想ディスプレイは GNOME の 画面共有機能(Mutter ScreenCast)を使うので、追加のドライバーは要りません。

Linux(Raspberry Pi / labwc)

専用の .deb を導入します。仮想ディスプレイは labwc の機能を使います。 インストール時に udev ルールが入り、メガネへ USB でアクセスできるようになります。

macOS

実験的な対応です。購入時または配布時に案内された最新版を使い、同梱の README で対応アーキテクチャと署名状態を確認してください。

どの環境でも、起動後の使い方はこの先で共通です。

起動すると常駐アイコンが表示されます。Windows 版と Linux 版ではタスクトレイ、 macOS 版ではメニューバーに常駐します。ウィンドウを閉じても終了しません。 常駐アイコンから再表示でき、アイコンのメニューで「終了」を選ぶと終了します。

最初に見えるのは、上部の操作パネルと、左側のカテゴリ一覧です。

Spatial Wall の操作パネルとメガネ設定

メガネをまだつないでいなくても設定をひととおり確認・変更できます。接続したメガネが 検出されて頭の追従が始まると、状態表示が「3DoF 動作中」に変わります。

メガネをつなぐ

USB でつなぐと自動で検出されます。メガネのカテゴリに、検出した機種・ IMU の経路・メガネのディスプレイが表示されます。

通常のメガネ表示は、独立した拡張ディスプレイである必要があります。 複製表示や「セカンドスクリーンのみ」だと、ウォールが取り込むはずの画面が 隠れてしまうためです。既定では自動で拡張ディスプレイに切り替え、デスクトップの 隅へ寄せます。この隅は他のディスプレイと 1 点だけで接するので、カーソルや ドラッグ中のウィンドウがメガネ側へはみ出しません。複製中はメガネと相手画面が同じ 表示元を共有するため、独立した拡張画面への切り替えが完了するまでウォール出力を開始しません。 Windows では無効化された対応メガネも再有効化します。

条件付き機能として、実機 EDID に Microsoft HMD VSDB を持つ表示モードでは、Windows がメガネを HeadMounted と分類してデスクトップから外します。Spatial Wall はこの状態を自動検出し、 メガネを排他取得して直接表示します。一般のメガネを HMD 化する機能ではありません。 HMD モード中は、拡張画面の設定、隅寄せ、メガネ側のカーソルフェンス、 フルスクリーン排他は使用しません。対応条件と実機確認済みの構成は、付録の 「検証済み構成と既知の制限」を参照してください。

つないだら次を確認してください。

  1. 表示モード — 2D か 3D SBS か、リフレッシュレートを選びます。 72 Hz / 90 Hz 系のモードは OLED のデューティ比も下がるため、見回したときの 残像が減ります。「保存した表示モードを接続時に復元」は既定でオフです。 オフでも手動選択は記憶され、通常モードの復元にも使えます。最後に記憶したのが HMD 対応モードの場合は、その切り替えが安定する PC でだけオンにしてください。
  2. SBS 出力 — 「自動」のままで、たいていのモードは正しく判別されます。 ハーフ SBS のモードだけは解像度から判別できないので、手動でオンにします。
  3. 明るさ / 音量 — メガネ側で調整できる機種なら、ここから操作できます。 メガネ内蔵アンプの音量と PC 側の音量は掛け算になるので、PC 側が 100% でも 小さいときはメガネ側を上げてください。

タップ操作(対応機種のみ)

メガネのツルを 2 回 / 3 回叩くと、再生・一時停止や 音量、センターに移動などを実行できます。反応が悪いときは「タップ操作」の カテゴリから較正してください。メガネに指示が表示されます。

居眠り対策

しばらく動かないとスリープに入り、画面を消します。 動かせば戻ります。時間と感度は「省電力」で変えられます。

ウォールを組む

Display Wall のカテゴリで、どのディスプレイを並べるかと、どう並べるかを 決めます。

並べるディスプレイを選ぶ

図には OS 側の現在のディスプレイ配置が表示されます。タイルをクリックすると、 そのディスプレイをウォールに含めるかどうかが切り替わります。除外したタイルは 薄く表示され、ウォールを空にしないよう最後の 1 枚は除外できません。メイン ディスプレイもほかのディスプレイと同じ方法で切り替えられます。メガネ自身の ディスプレイはウォールには含まれません。

並べ方を決める

Spatial Wall にはレイアウト方式の選択はなく、OS のディスプレイ配置がそのまま ウォールになります。図のタイルをドラッグすると配置を編集できます。表示された 適用を押すと OS 側のディスプレイ配置も変更され、キャンセルを押すと編集前の 配置に戻ります。OS のディスプレイ設定で配置を変えた場合も、ウォールに反映されます。

「ディスプレイの枠を表示」をオンにすると、隣り合うディスプレイの間に細い黒線が 入ります。ディスプレイ間の隙間や外側の余白を数値で設定する項目はありません。

見る位置を決める

ウィジェット

「ウィジェットを追加」から、時計などの小さなパネルをウォールの縁に 貼り付けられます。タイルのクリックで表示 / 非表示、ドラッグで移動、右下の角を ドラッグしてリサイズ、右クリックで設定を開きます。

仮想ディスプレイ

物理的なディスプレイが足りなくても、仮想ディスプレイを追加すればウォールを 広げられます。「詳細」→「仮想ディスプレイ」から追加します。

Windows では専用のドライバーが要ります(nyan Real / Virtual Display Driver を推奨、ParsecVDisplay も使えます)。ドライバーは同梱していないので、 別途インストールしてください。Linux / macOS では OS 組み込みの機能を使うため、 導入するものはありません。

追加した仮想ディスプレイは、このアプリが動いている間だけ存在します。次回 起動時には前回の構成が復元されます。

待機と再開

仮想ディスプレイはメガネ越しでしか見えないので、メガネを外している間は そこに置いたウィンドウが行方不明になります。待機を押すと、仮想ディスプレイを 一時的に取り外します。OS は、そこに表示されていたウィンドウを残ったディスプレイへ 移動します。再開を押すと、前回の仮想ディスプレイ構成が復元されます。 メガネをかけてマスタースイッチをオンにすると自動で再開します。

macOS では、Mac 本体がスリープすると仮想ディスプレイも自動で待機し、復帰後に 物理ディスプレイが安定するまで少し待ってから再開します。

マスタースイッチをオフにしたときやメガネを取り外したときに自動では待機しません。 どの OS でも、見えない画面はウォールマップから操作できます。

ウォールマップ

ウォール全体を小さな平面図として表示するウィンドウです。仮想ディスプレイもそのまま マウスで操作できるので、メガネを外したままでも作業を続けられます。ホイールで 拡大縮小、ドラッグで移動、ダブルクリックで全体表示です。

ウォールマップを閉じても、このウィンドウが閉じるだけです。仮想ディスプレイは切断されません。 仮想ディスプレイの切断と復帰には 待機 / 再開を使います。

カーソルが迷子にならないように

Windows 版 / macOS 版では、メガネ画面と仮想ディスプレイにそれぞれ「カーソルを入れない」設定があります。 オンにすると、カーソルはその画面を通り抜けて反対側のディスプレイへ移動します。 メガネが HMD としてデスクトップから外れている間は、メガネ側の設定は不要なので表示されません。 macOS では初回に「入力監視」の許可が必要です。GNOME 版と Raspberry Pi 版では OS の入力制御が 異なるため、この設定は表示されません。

ヒント:カーソルが時々隣のディスプレイの端へ飛ぶときは、Windows の [設定]→[システム]→[ディスプレイ]→[複数のディスプレイ]→ 「ディスプレイ間でカーソルを簡単に移動できるようにする」をオフにしてください。 Windows 側の斜め移動補正と干渉しています。

出力先

上部の「音声の出力先」で、PC の音声出力先を選びます。 「メガネに自動」にすると、メガネの USB オーディオを検出したときに 1 回だけ 切り替えます。特定のデバイスを選んだ場合は、そのデバイスが未接続の間も選択を 覚えていて、見つかり次第戻ります。

Audio Wall

「Audio Wall」のカテゴリで空間音響をオンにすると、音を鳴らして いるアプリを自動で見つけ、そのウィンドウがある方向から聞こえるように混ぜます。 アプリごとの設定は要りません。混ぜたくないアプリは除外リストに実行ファイル名を 入力します(例:discord.exe)。

音はアプリ単位で方向が決まります。1 つのアプリが複数の画面にまたがっている 場合は、1 方向にまとまります。

ブラウザのタブ

Chrome / Edge 116 以降に拡張機能「nyan Real Audio Wall connector」を入れると、タブごとの音も空間に配置できます。Windows と Linux に対応し、 macOS の Chrome タブ取り込みは未対応です。DRM メディアと CORS 許可のない 別オリジンのメディアは、通常どおり ブラウザから再生され、空間化されません。Web Audio で直接生成された音声も 取り込めない場合があります。

操作する

ショートカットキー(「リモコン操作」→「ショートカットキー」)

センターに移動、集中の切り替え(次 / 前 / 解除)、3DoF とマスタースイッチのオン・オフを Windows、Raspberry Pi(labwc)、macOS ではグローバルホットキーに割り当てられ、 他のアプリを使っている間でも効きます。macOS のマスタースイッチ用ショートカットは既定で Control + Shift + Esc です。GNOME 版はグローバルショートカットの登録に未対応のため、 この設定行は表示されません。

スマホリモコン(「リモコン操作」)

同じネットワーク上のスマホを、タッチパッド付きのリモコンにできます。有線 LAN の PC と Wi-Fi のスマホのように、接続経路が違っても同じネットワーク上で利用できます。 表示される QR コードをスマホのカメラで読み取るだけで、アプリのインストールは 要りません。マウス操作、センターに移動、ジャイロの再較正、スクリーン距離の変更が できます。

QR コードを読み取れない状況(メガネが唯一のディスプレイのときなど)では、コードで ペアリングを使ってください。スマホのブラウザで URL を開き、表示された 6 桁のコードを入力します。

初回に有効化したとき Windows のファイアウォールが確認を出したら、 「アクセスを許可する」を選んでください。同じ LAN 上の端末から利用してください。 URL に含まれるトークンを知らない端末からの操作は拒否されます。

スマホリモコン、Android アプリのダウンロード、メガネブリッジは LAN 内で 暗号化されていない HTTP / WebSocket を使用します。共有 Wi-Fi や公衆 Wi-Fi ではなく、 信頼できる私設ネットワークでのみお使いください。

Android メガネブリッジ(「リモコン操作」)

メガネを PC ではなく Android スマホへ接続して使う方法です。スマホ側のアプリが メガネとの USB 接続を担当し、映像と頭の向きを PC のウォールへ中継します。PC の USB ポートを 占有したくない場合や、PC から離れて使いたい場合に向いています。メガネを Android の 外部ディスプレイ(Presentation)として扱い、映像と音声を送る機能は Windows と macOS に 対応しています。macOS では画面収録と音声収録の許可が必要です。検証済みの構成と 既知の制限は付録にまとめています。 高画質モードと外部 Video Input は Windows 専用です。

スマホのアプリが接続すると、「リモコン操作」に接続状態が表示されます。 メガネの明るさ・表示モード・外部ディスプレイの状態や、IMU と映像チャンネルが つながっているかを、PC 側から確認できます。ブリッジ経由でも、機種ごとの設定は PC に直接つないだときと同じように扱われます。

Stream Deck(「詳細」→「Stream Deck」)

「この PC からの操作を受け付ける」をオンにすると、ループバック専用 (127.0.0.1)の制御ポートが開き、Stream Deck 用のプラグインからホットキーと 同じ操作ができます。他の PC からは届かないので、トークンはありません。

ログイン時に起動(「詳細」)

Windows 版、パッケージ導入した Linux 版、macOS の .app では、ログイン時に自動起動できます。 macOS では承認のため「システム設定」→「一般」→「ログイン項目」が開くことがあります。 ログイン起動時はコントロールウィンドウを開かず、常駐アイコンだけを表示します。

見え方と負荷の調整

滑らかさ(「省電力」)

画質(「映像エフェクト」)

残像とちらつき(メガネ)

外観(「外観」)

表示言語は「自動(OSに合わせる)」が既定です。日本語または英語を明示的に 選ぶこともできます。変更時に案内が出るので、Spatial Wall を再起動すると 新しい言語が反映されます。

テーマは「自動(OSに合わせる)」「ライト」「ダーク」から選べます。

外観設定の表示言語とテーマ

困ったとき

メガネが検出されない

メガネに何も映らない / デスクトップが消えた

カクつく・コマ落ちする

音が出ない / 音の向きがおかしい

カーソルが行方不明になる

Windows 版と macOS 版では「カーソルを入れない」設定をオンにしてください。macOS では初回に 「入力監視」の許可が必要です。GNOME 版、Raspberry Pi 版、またはカーソルがすでに 見えない画面へ移動した場合は、ウォールマップから操作できます。

macOS で Control + Shift + Esc を押すとマスタースイッチがオフになり、 メガネ上の Spatial Wall の表示が消えます。Spatial Wall が管理する仮想ディスプレイが メインディスプレイになっている場合は、表示を消す前に、メインディスプレイを 表示を確認できる物理ディスプレイへ戻します。

それでも解決しないとき

「バージョン情報」の「問い合わせ用情報をコピー」を押すと、製品名・バージョン・ ビルド時刻・OS 名とバージョン・接続中のメガネがクリップボードに入ります。 問い合わせフォームの 「問い合わせ用情報」欄へ内容を変えずに貼り付け、OS を選択し、対応メガネの機種名を 入力したうえで、「症状」と 「再現手順」をそれぞれの欄へ記入してください。ログや画像を添付するときは、 個人情報や秘密情報が含まれていないことを確認してください。

付録

OS による機能差

✅:対応 🟡:条件付き対応 —:非対応

機能 Windows GNOME Raspberry Pi macOS
Display Wall / Audio Wall
仮想ディスプレイ ✅ 専用ドライバーが必要 ✅ OS 組み込み ✅ OS 組み込み ✅ OS 組み込み
ウォールマップ ✅ マスタースイッチがオフのときや、メガネ未接続時も使用可能
カーソルフェンス ✅ 「入力監視」の許可が必要
タップ操作 ✅ 「アクセシビリティ」の許可が必要
スマホリモコン ✅ 「アクセシビリティ」の許可が必要
グローバルホットキー
Android メガネブリッジ出力 🟡 Intel Mac で映像・3DoF・音声を確認済み(Apple Silicon は未確認)

macOS は全体が実験的な扱いです。未対応の機能は、その項目自体が画面に出ません。

検証済み構成と既知の制限

以下は Spatial Wall 0.9.0 系、2026 年 8 月時点の確認結果です。

経路 検証済み構成 既知の制限
Windows HMD 直接出力 Windows 11 Pro(ビルド 26200)/ RTX 3060 / HMD VSDB を書き込んだ xbx a01+。2D 90 Hz と 3D SBS 72 Hz の取得・表示を確認済み Microsoft HMD VSDB を持つ表示モードだけが対象です。Radeon 780M(ドライバー 32.0.31035.1003)では HMD Target が生成されませんでした。Intel UHD(ドライバー 32.0.101.7088)では分類が安定せず、取得・表示は未確認です。
macOS Android メガネブリッジ Intel Mac / macOS 15.7 / SC-52D / XREAL Air。物理ディスプレイ 1 枚と仮想ディスプレイ 2 枚の映像、3DoF、音声、Spatial Wall の再起動後の自動再接続を確認済み Apple Silicon は未確認です。高画質モードと外部 Video Input は Windows 専用です。

設定の保存場所

設定とログは %APPDATA%\nyan-real\(Linux / macOS では各 OS のユーザー設定 ディレクトリ)の下に保存されます。ログの保存先フォルダーはアプリ内から開けます。

設定を初期化する

「詳細」の「設定を既定値に戻す」で、すべての設定が初期状態に戻ります。 元には戻せません。

バージョンの確認

「バージョン情報」にバージョンとビルド時刻が出ます。spatial-wall.exe を右クリックして [プロパティ]→[詳細]でも確認できます。

ライセンス

「バージョン情報」の「使用許諾契約書を表示」で、このアプリの使用条件を読めます。 インストーラーが最初に表示するものと同じ文書で、アプリと同じ場所に EULA.ja.txt / EULA.en.txt としても置いてあります。正文は日本語版です。

同梱物のライセンスは「サードパーティ ライセンスを表示」から読めます。全文を 添付する必要があるものについては、アプリと同じ場所の licenses/ に入っています。