ConsoleMini

ConsoleMini란?

ConsoleMini는 macOS Electron + React 런처로, Mac mini를 여러 에뮬레이터 시스템의 게임을 즐길 수 있는 거실 콘솔 경험으로 바꿔줍니다. 컨트롤러 우선 탐색을 중심으로 제작되었으며, “Mac mini → TV → 컨트롤러” 루프를 위해 설계되었습니다. 여기서 대형 TV 친화적 인터페이스로 시스템을 선택하고 게임을 실행합니다.

ConsoleMini는 자체 세이브 스테이트 형식을 만들지 않고, 지원 에뮬레이터를 실행하며 디스크상의 에뮬레이터 네이티브 세이브 위치를 인덱싱해 대시보드 스타일 세이브 스테이트 뷰를 제공합니다.

주요 기능

• HTML5 Gamepad API를 통한 컨트롤러 우선 탐색: 브라우저/게임패드 API로 노출된 모든 컨트롤러를 메뉴 탐색에 사용할 수 있습니다 (D-패드/왼쪽 스틱으로 이동, A/크로스로 확인, B/서클로 뒤로).
• Mac mini용 “키오스크” 모드: 로그인 시 자동 실행, Dock 숨기기, 슬립 비활성화 등을 위한 설정 스크립트를 포함해 TV 준비 경험을 지원합니다.
• Apple Silicon 네이티브 앱 및 서명된 릴리스: Apple Silicon 네이티브 동작을 지원하며, 서명 및 공증된 DMG로 배포됩니다.
• 여러 에뮬레이터 시스템을 위한 단일 런처: 설정 탭에서 에뮬레이터 설치 노트와 스크립트 기반 원클릭 설치를 제공합니다.
• ROM/BIOS 번들링 없음: 프로젝트에서 “ROM 0개, BIOS 0개”를 명시하며, 사용자가 직접 콘텐츠를 제공해야 합니다.
• 세이브 스테이트 대시보드 (읽기 전용): ConsoleMini는 세이브 스테이트를 재구현하지 않고, 각 에뮬레이터의 네이티브 세이브 “볼트”를 표시하며 Finder에서 세이브 폴더를 열 수 있습니다.

ConsoleMini 사용 방법

1. macOS에 설치 (제공된 옵션 중 하나 사용):
   • Homebrew (권장): tap 추가 후 cask 설치. GitHub 릴리스의 서명 및 공증된 DMG를 가져와 SHA-256 검증 후 /Applications에 ConsoleMini.app을 배치합니다.
   • 릴리스에서: 최신 서명 DMG 다운로드, ConsoleMini.app을 /Applications로 이동 후 실행.
2. 키오스크 모드 설정 (선택): 키오스크 설정 스크립트 실행으로 로그인 시 자동 실행, Dock 숨기기, 슬립 방지 설정.
3. 컨트롤러 연결: Bluetooth로 페어링; ConsoleMini는 HTML5 Gamepad API로 메뉴 탐색, 에뮬레이터 입력은 각 에뮬레이터가 처리.
4. 앱에서 에뮬레이터 설치/확인: 앱의 설정 탭 열어 설치 상태 확인 및 원클릭 설치 사용.
5. 세이브 스테이트 패널 사용: 설정 → 세이브 스테이트 열어 사용 가능한 세이브 볼트, 파일 수, 최종 수정 시간 확인 및 Reveal로 Finder에서 열기.

사용 사례

• Mac mini 거실 콘솔 설정: 키오스크 모드와 컨트롤러 우선 UI로 TV에서 마우스/키보드 없이 시스템 탐색 및 게임 실행.
• macOS 플레이스테이션 중심 에뮬레이션: Mac mini → 컨트롤러 워크플로에 최적화된 메뉴 경험을 위해 사용, 지원 PS1–PS4/PSP 에뮬레이터와 함께.
• 다중 에뮬레이터 라이브러리 관리: PS1, PS2, PSP, N64, SNES/NES, GBA, Dreamcast 등 여러 시스템을 단일 런처로 관리.
• 도구 중복 없이 세이브 스테이트 검사: 읽기 전용 대시보드로 각 에뮬레이터의 세이브 볼트 확인 및 디스크 폴더 열기.
• 설치 프로그램 기반 에뮬레이터 프로비저닝: 설정 탭에서 설치 상태 표시 및 프로젝트에 나열된 Homebrew 포뮬러로 스크립트 처리.

자주 묻는 질문

• ConsoleMini가 ROM이나 BIOS 파일을 제공하나요? 아니요. 프로젝트에서 “ROM 0개, BIOS 0개”라고 명시하며, 사용자가 법적으로 직접 제공해야 합니다.

• ConsoleMini는 세이브 스테이트를 어떻게 처리하나요? ConsoleMini 자체적으로 세이브 스테이트를 구현하지 않습니다. 각 에뮬레이터의 네이티브 세이브 시스템에 위임한 후 세이브 볼트를 인덱싱해 표시 및 Finder “Reveal” 지원.

• 지원 컨트롤러는? HTML5 Gamepad API로 노출된 모든 컨트롤러가 메뉴 탐색에 작동 (리포지토리 예: DualShock 4, DualSense, Xbox, 8BitDo).

• 에뮬레이터는 어떻게 설치하나요? 앱의 설정 탭에서 실시간 설치 상태 표시 및 스크립트 (scripts/install-emulators.sh)로 원클릭 설치. 리포지토리에서 각 에뮬레이터 Homebrew 설치 명령 문서화.

• ConsoleMini를 TV/키오스크 앱으로 실행할 수 있나요? 리포지토리의 키오스크 설정 스크립트 (scripts/setup-kiosk.sh)로 로그인 시 자동 실행, Dock 숨기기, 슬립 방지 지원.

대안

• OpenEmu (macOS 에뮬레이터 프론트엔드): macOS에서 여러 시스템을 대상으로 하지만, 프로젝트 설명에 따르면 OpenEmu는 “modern PlayStation”을 지원하지 않습니다.
• RetroArch (멀티 시스템 에뮬레이터 프론트엔드): 소스에서 RetroArch를 강력하지만 TV에서 메뉴가 거칠다고 설명합니다. ConsoleMini는 컨트롤러 우선 대형 UI에 중점을 둡니다.
• 기타 에뮬레이터 프론트엔드 또는 런처 스타일 앱: 다른 워크플로우(예: 단일 컨트롤러 우선 런처 대신 에뮬레이터별 UI 탐색)를 선호한다면 대체 프론트엔드를 사용할 수 있지만, 여기서는 Mac mini → TV → 컨트롤러 루프에 중점을 둡니다.