muOS にアプリをインストール：Archive Manager で .muxapp・.muxzip ファイル

muOS のアプリは、末尾が .muxapp のひとつのファイルとして配布されます。展開したりフォルダーをコピーしたりする必要はありません。muOS には Archive Manager というインストーラーが組み込まれていて、代わりにやってくれます。このガイドでは、全体の流れ、裏で何が起きているか、そしてつまずきやすい 2 つの点（アップデートで設定がリセットされること、アンインストールの方法）を説明します。

動作確認： Anbernic RG40XXH · muOS 2601.0 Jacaranda。ほかの muOS 携帯ゲーム機でも同じです。

.muxapp ファイルとは

.muxapp ファイルは、拡張子が違うだけのふつうの ZIP アーカイブです。中にはアプリ名のフォルダーがひとつ入っています。例：

WiFiTransfer.muxapp
└── WiFiTransfer/
    ├── mux_launch.sh    ← muOS はこれでアプリを起動します
    ├── config.ini
    └── …

インストールとは、そのフォルダーを SD カードの MUOS/application/ に展開することです。このフォルダーにあるアプリはすべて Applications メニューに表示されます。

ステップ 1：ファイルを ARCHIVE フォルダーにコピーする

Archive Manager は、SD カード 1（muOS が動いているカード）の一番上にある ARCHIVE フォルダーのファイルを一覧にします。フォルダーがなければ、大文字で作成してください。

ファイルを置く簡単な方法は 3 つあります：

カードリーダー： 携帯ゲーム機の電源を切り、SD カード 1 をパソコンに入れて .muxapp ファイルを ARCHIVE にコピーします。取り出す前に、きちんと取り出し操作をしてください。
Wi-Fi で Wi-Fi Transfer を使う： 携帯ゲーム機でアプリを開き、表示されたアドレスをスマホや PC のブラウザーで開いて、SD カード 1 のタブで ゲームを追加 をタップして .muxapp を選びます。自動で ARCHIVE に入ります。
SFTP： muOS は SFTP サーバーを動かせます。Configuration → Connectivity → Web Services で SFTP + Filebrowser をオンにしてください。あとは SFTP アプリ（FileZilla、Cyberduck、WinSCP）で SD カード 1 の ARCHIVE にファイルをコピーできます。

ファイル名は変えないでください。Archive Manager は末尾（.muxapp）を見て何をするか決めます。

ステップ 2：Archive Manager でインストールする

携帯ゲーム機で Applications → Archive Manager を開きます。
.muxapp ファイルを選んで A を押します。
作業中、muOS はメニューを閉じてテキスト画面を表示します：Inspecting Archive…、展開中のファイル、Sync Filesystem、最後に All Done!
数秒で Archive Manager に戻ります。ファイルには INSTALLED と表示されます。

Applications を開くと、新しいアプリが一覧にあります。起動前に Wi-Fi をオンにする必要があるアプリもあります（Configuration → Connectivity → Wi-Fi Network）。

インストール後も .muxapp ファイルは ARCHIVE に残ります。バックアップとして残しても、削除してもかまいません。インストールしたアプリには必要ありません。

Archive Manager が実際にしていること

何かを展開する前に、Archive Manager はアーカイブを確認し、中のパスがひとつでも対象フォルダーの外を指していれば（絶対パスや ..）インストールを拒否します。そのため、壊れたパッケージや悪意のあるパッケージが、この方法で muOS のシステムファイルを上書きすることはできません。

この確認はファイルの置き場所についてであり、アプリが動き出したあとに何をするかではありません。muOS のアプリはシステムに完全にアクセスできる状態で動くので、.muxapp ファイルは信頼できる入手先（開発者自身のウェブサイトや GitHub のリリースページ）からだけインストールしてください。

Archive Manager はアプリ専用ではありません。ファイルの末尾によってインストール方法を選びます：

末尾	中身	入る場所
`.muxapp`	アプリ	`MUOS/application/`
`.muxthm`	テーマ	`MUOS/theme/<名前>/`
`.muxalt`	現在のテーマの別の見た目	使用中のテーマのフォルダー
`.muxzip`	コンテンツパッケージ（中身によってセーブ、BIOS、コレクションなど）	対応する muOS のフォルダー
`.muxcat`	カタログパッケージ（ボックスアートと説明）	`MUOS/package/catalogue/`
`.muxcfg`	RetroArch の設定パッケージ	`MUOS/package/config/`
`.muxupd`	muOS のシステムアップデート	システムそのもの

アプリのアップデート：先に設定を保存する

アップデートするには、新しい .muxapp を ARCHIVE にコピーして同じようにインストールします。Archive Manager は既存のアプリフォルダーの上から展開します：

新しいパッケージにあるファイルは古いものを置き換えます。config.ini も含みます。
パッケージにないファイル（アプリの data/ や logs/ フォルダーなど）は残ります。

つまり、アプリの config.ini で変えた設定は、アップデート後に初期値に戻ります。アップデートの前に、アプリの config.ini を安全な場所にコピーしておき（または設定をメモしておき）、あとで変更を戻してください。ただし Game Manager は例外です。パッケージに config.ini が入っていないので、itch.io の API キーを含む設定はアップデート後も残ります。インストール済みのゲームの一覧は data/ にあり、アップデート後も残ります。

新しいファイルが古いものと同じ名前なら、どちらをインストールするのかはっきりさせるため、先に ARCHIVE の古いファイルを削除するか置き換えてください。

アプリのアンインストール

muOS 2601 にはアプリのアンインストールボタンがありません。削除するには、そのフォルダーを削除します：

SD カード 1 → MUOS/application/<アプリ名>

カードリーダー、SFTP、または Wi-Fi Transfer で削除してください。そのあとメインメニューに戻って Applications を開き直すと、アプリは消えています。フォルダーを削除すると、アプリ自身の設定やデータも消えるので、残したいものは先にコピーしてください。

困ったとき

Archive Manager に “No Archives Found” と表示される： ファイルが SD カード 1 の一番上の ARCHIVE にないか、フォルダー名が違います。ROMS や MUOS の中ではなく、ARCHIVE でなければなりません。
一覧には出るが “unsafe paths” でインストールに失敗する： パッケージの作りが間違っています。アプリの開発者に連絡してください。手で展開しようとしないでください。
“Could not open archive… Corrupt?”： ダウンロードが最後まで終わっていないか、コピーが途中で切れています。もう一度ダウンロードし、開発者が SHA-256 チェックサムを公開していれば比べてください（Mac や Linux で shasum -a 256 file.muxapp）。
インストールしたのに表示されない： メインメニューに戻って Applications を開き直してください。それでもなければ、MUOS/application/<アプリ名>/mux_launch.sh があるか確認してください。
アプリが起動してすぐ閉じる： 多くのアプリは自分のフォルダーにログを書きます（たいてい logs/app.log）。確認してみてください。インターネットが必要なアプリなら Wi-Fi をオンにしてください。

まとめ

.muxapp ファイルを SD カード 1 の ARCHIVE に置く。
Applications → Archive Manager でファイルを選び、A を押して All Done! を待つ。
Applications からアプリを開く。
アップデートの前にアプリの config.ini を保存。アンインストールは MUOS/application/ のフォルダーを削除。

ご質問は feedback@pocketkode.com までメールでどうぞ。

PocketKode は muOS、Anbernic とは関係ありません。