🌐 한국어
English日本語বাংলাEspañolFrançaisDeutschNederlandsРусский简体中文한국어हिन्दी
← 모든 글
· 2026년 10월 10일 업데이트

muOS에 앱 설치하기: Archive Manager로 .muxapp·.muxzip 파일

muOS 앱은 **.muxapp**으로 끝나는 파일 하나로 제공됩니다. 압축을 풀거나 폴더를 복사할 필요가 없습니다. muOS에는 Archive Manager라는 설치 도구가 내장되어 있어 대신 처리해 줍니다. 이 가이드에서는 전체 과정, 내부에서 일어나는 일, 그리고 사람들이 자주 헷갈리는 두 가지(업데이트하면 설정이 초기화되는 것, 제거하는 방법)를 설명합니다.

테스트 환경: 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 폴더에 있는 파일을 보여 줍니다. 폴더가 없으면 대문자로 만드세요.

파일을 그곳에 넣는 쉬운 방법은 세 가지입니다:

  • 카드 리더: 휴대용 게임기를 끄고 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로 설치하기

  1. 휴대용 게임기에서 Applications → Archive Manager를 엽니다.
  2. .muxapp 파일을 선택하고 A를 누릅니다.
  3. 작업하는 동안 muOS는 메뉴를 닫고 텍스트 화면을 보여 줍니다: Inspecting Archive…, 풀리는 파일들, Sync Filesystem, 그리고 마지막에 All Done!
  4. 몇 초 뒤 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를 켜세요.

요약

  1. .muxapp 파일을 SD 카드 1의 **ARCHIVE**에 넣습니다.
  2. Applications → Archive Manager에서 파일을 선택하고 A를 누른 뒤 **All Done!**을 기다립니다.
  3. Applications에서 앱을 엽니다.
  4. 업데이트 전에 앱의 config.ini를 저장하세요. 제거하려면 MUOS/application/에서 폴더를 삭제하세요.

질문이 있으신가요? feedback@pocketkode.com으로 메일을 보내 주세요.

PocketKode는 muOS, Anbernic과 관련이 없습니다.