ConsoleMini

ConsoleMiniとは？

ConsoleMiniは、macOS用のElectron + Reactランチャーです。Mac miniを複数のエミュレーターシステムのゲームプレイ向けリビングコンソール体験に変えるために設計されています。コントローラー優先のナビゲーションを基盤とし、「Mac mini → TV → コントローラー」のループを想定。システムを選択し、大型TV対応UIでゲームを起動します。

独自のセーブステート形式を作成せず、対応エミュレーターを起動し、ディスク上のエミュレーターのネイティブセーブ場所をインデックス化してダッシュボード風のセーブステートビューを提供します。

主な機能

• HTML5 Gamepad APIによるコントローラー優先ナビゲーション: ブラウザ/ゲームパッドAPI経由で公開されるコントローラーがメニュー操作に使用可能（Dパッド/左スティックで移動、A/×で決定、B/○で戻る）。
• Mac mini向け専用「キオスク」モード: ログイン時自動起動、Dock非表示、スリープ無効化のセットアップスクリプト付き（キオスクスクリプトの説明通り）、TV対応体験をサポート。
• Apple Siliconネイティブアプリおよび署名済みリリース: リポジトリでApple Siliconネイティブ動作を記述、署名・公証済みDMGでリリース配布。
• 複数エミュレーターシステム向けワンランチャー: 設定タブでエミュレーターインストールノートとワンクリックインストール（スクリプト経由）を提供。
• ROM/BIOSバンドルなし: プロジェクトで「zero ROMs, zero BIOS」を明記、ユーザーが自身でコンテンツを用意。
• セーブステートダッシュボード（読み取り専用）: ConsoleMiniはセーブステートを再実装せず、各エミュレーターのネイティブセーブステート「保管庫」を表示、Finderでセーブフォルダを開放可能。

ConsoleMiniの使い方

1. macOSにインストール 以下のいずれかの方法で：
   • Homebrew（推奨）: tapを追加してcaskをインストール。caskがGitHubリリースから署名・公証済みDMGを取得、SHA-256検証後/ApplicationsにConsoleMini.appを配置。
   • リリースから: 最新署名DMGをダウンロード、ConsoleMini.appを/Applicationsに移動して起動。
2. キオスクモード設定（オプション）: キオスクセットアップスクリプトを実行し、ログイン時自動起動、Dock非表示、スリープ防止を設定。
3. コントローラー接続: Bluetoothでペアリング。ConsoleMiniはHTML5 Gamepad APIでメニューナビゲーション、エミュレーター入力は各エミュレーターが処理。
4. アプリ経由でエミュレーターインストール/確認: アプリのSettingsタブを開き、インストール状況をリアルタイム確認、利用可能なワンクリックインストールを使用。
5. セーブステートパネル使用: Settings → Save statesを開き、利用可能セーブステート保管庫、ファイル数、最終更新日時を表示、RevealでFinderで保管庫を開く。

ユースケース

• Mac miniのリビングコンソールセットアップ: キオスクモードとコントローラー優先UIで、TVからマウス/キーボード不要でシステム閲覧・ゲーム起動。
• macOSでのPlayStation中心エミュレーション: Mac mini → コントローラーワークフローに特化したメニュー体験を求める場合に使用、PS1–PS4/PSP対応エミュレーターと連携。
• マルチエミュレーターライブラリ管理: PS1、PS2、PSP、N64、SNES/NES、GBA、Dreamcastなど複数システムを単一ランチャーで管理、エミュUI切り替え不要。
• ツール重複なしのセーブステート確認: 読み取り専用ダッシュボードで各エミュレーターのセーブステート保管庫存在確認、ディスクフォルダを開く。
• インストーラー駆動エミュレーター提供: 設定タブからインストール状況確認、プロジェクト記載のHomebrewフォーミュラ使用スクリプトでエミュレーターインストール。

FAQ

• ConsoleMiniはROMやBIOSファイルを提供しますか？ いいえ。プロジェクトで「zero ROMs, zero BIOS」と明記、自身で（合法的に）用意してください。

• ConsoleMiniはセーブステートをどう扱いますか？ ConsoleMini自体はセーブステートを実装せず、各エミュレーターのネイティブセーブステートシステムに委譲、セーブ保管庫をインデックス化して表示とFinder「Reveal」を提供。

• 対応コントローラーは？ HTML5 Gamepad API経由で公開されるコントローラーはメニューナビゲーションで動作（リポジトリ例: DualShock 4、DualSense、Xbox、8BitDo）。

• エミュレーターのインストール方法は？ アプリのSettingsタブでリアルタイムインストール状況表示、スクリプト（特にscripts/install-emulators.sh）経由ワンクリックインストール。リポジトリに各エミュレーターのHomebrewインストールコマンド記載。

• ConsoleMiniをTV/キオスクアプリとして実行可能ですか？ リポジトリにキオスクセットアップスクリプト（scripts/setup-kiosk.sh）あり、ログイン時自動起動、Dock非表示、スリープ防止。

代替品

• OpenEmu (macOS エミュレーター フロントエンド): macOS で複数システムを対象とするが、プロジェクトの説明では OpenEmu が「現代の PlayStation」をカバーしないと記載。
• RetroArch (マルチシステム エミュレーター フロントエンド): ソースでは RetroArch を強力だが TV で使いにくいメニューと記述。ConsoleMini はコントローラー優先の大画面 UI に特化。
• 他のエミュレーター フロントエンドやランチャー風アプリ: 異なるワークフロー（例: エミュレーターごとの UI ナビゲーション）を好む場合、代替フロントエンドを使用可能。ただし、ここでは Mac mini → TV → コントローラーループを重視。