mirror of
https://github.com/rommapp/docs.git
synced 2026-04-20 01:04:29 +08:00
35 lines
2.0 KiB
Markdown
35 lines
2.0 KiB
Markdown
<!-- trunk-ignore-all(markdownlint/MD033) -->
|
|
<!-- trunk-ignore-all(markdownlint/MD041) -->
|
|
|
|
<div align="center">
|
|
<img src="../../resources/romm/integrations/muos.svg" height="200px" width="200px" alt="romm[muos] isotipo">
|
|
</div>
|
|
|
|
<a href="https://muos.dev" target="_blank">muOS</a> is a Custom Firmware (CFW) primarily for handheld devices. Configurable, themeable, friendly, easy-to-use.
|
|
|
|
The <a href="https://github.com/rommapp/muos-app" target="_blank">muOS app</a> connects to your RomM instance and allows you to fetch games wirelessly from your Anbernic device.
|
|
|
|
## Setup
|
|
|
|
### muOS
|
|
|
|
We leverage the muOS [Archive Manager](https://muos.dev/installation/archive) to install/update the app.
|
|
|
|
1. Head to the [latest release](https://github.com/rommapp/muos-app/releases/latest) and download the `RomM.muOS.x.x.x.muxapp` file.
|
|
2. Move the muxapp file to `/mnt/mmc/ARCHIVE` on your device.
|
|
3. Launch the manager from `Applications > Archive Manager` and select `RomM.muOS.x.x.x.muxapp`.
|
|
4. Once installed, make a copy of `/mnt/mmc/MUOS/application/RomM/env.template`, rename it to `/mnt/mmc/MUOS/application/RomM/.env`, edit it (any method is fine, we recommend SSH) and set `HOST`, `USERNAME` and `PASSWORD`.
|
|
5. Launch the app from `Applications > RomM` and start browsing your collection.
|
|
|
|
### EmulationStation
|
|
|
|
We use PortMaster to install the app on devices running EmulationStation.
|
|
|
|
1. Download the `RomM App.sh` file and `RomM/` folder to the `roms/ports` on your device.
|
|
2. Make the `RomM App.sh` file executable by running `chmod +x RomM App.sh`.
|
|
3. Launch EmulationStation and navigate to the `Ports` section.
|
|
|
|
<!-- prettier-ignore -->
|
|
!!! note
|
|
Your device must connect to your RomM instance or home server over Wi-Fi. The easiest method is to keep them on the same network and set HOST to the server's IP and the port where RomM is running. Advanced users or those using reverse proxies can configure their network and DNS settings as needed, using a URL with a domain like `https://romm.domain.com`.
|