Main_MiSTer 한글 OSD 빌드 (Korean OSD Fork)

이 저장소는 MiSTer-devel/Main_MiSTer의 한글 패치 포크입니다. 공식 upstream 업데이트가 있을 때마다 자동으로 빌드되어 릴리즈에 업로드됩니다.

---

한글 패치 내용

• OSD 한글 파일명 표시 — 게임 목록에서 한글 파일명 깨짐 없이 표시
• 메뉴 한국어 로컬라이제이션 — OSD 메뉴 한국어 지원
• Galmuri8 비트맵 폰트 — MiSTer OSD에 최적화된 한글 픽셀 폰트 적용

---

설치 방법

방법 1 — 자동 업데이트 스크립트 (권장)

1. Scripts/korean_update.sh 파일을 SD카드의 /media/fat/Scripts/ 폴더에 복사
2. MiSTer OSD → Scripts → korean_update.sh 실행
3. 아래와 같이 단계별로 진행 상황이 표시됩니다

=====================================
  MiSTer Korean OSD Update Script
=====================================

[1] Checking internet connection...
    OK Connected.
[2] Fetching latest release info from GitHub...
    OK Latest: korean-final-260405 (2026-04-05)
[3] Checking installed version...
    OK Installed: 2026-04-04 02:35
    New version available!
[4] Backing up current binary...
    OK Saved to: /media/fat/MiSTer_Backups/MiSTer_20260406_103000
[5] Downloading new binary...
    ################################ 100.0%
    OK Downloaded (1094 KB).
[6] Installing...
    OK Installed to: /media/fat/MiSTer

=====================================
  Update complete!
  Version: korean-final-260405
=====================================

Rebooting MiSTer in 3 seconds...

---

한글 게임명 적용 스크립트

ROM 파일명을 변경하지 않고 OSD에서 보여줄 때만 한글 게임명으로 표시합니다.

실제 파일:  Super Mario Bros (USA).nes  ← 변경 없음
OSD 표시:  슈퍼 마리오 브라더스         ← names.txt 참조

지원 시스템: NES, SNES, 메가드라이브, 네오지오, 게임보이/컬러/어드밴스, PC엔진, MSX, 마스터시스템, 세가32X, 아케이드

사용법

1. Scripts/korean_names.sh 파일을 SD카드의 /media/fat/Scripts/ 폴더에 복사
2. MiSTer OSD → Scripts → korean_names.sh 실행
3. 완료 후 코어 재시작 시 한글명으로 표시됩니다

=====================================
  MiSTer Korean Game Names Script
=====================================

  Korean game name data provided by:
  텐타클 팀 (tentacleteam)
  https://github.com/tentacleteam/romlistkr
  License: MIT

[1] Checking internet connection...
    OK Connected.
[2] Checking Python 3...
    OK Python 3.x
[3] Downloading romlistkr game data...
    OK Downloaded 12 system(s).
[4] Parsing game names...
    OK  nes            4,388개 → /media/fat/games/NES/names.txt
    OK  snes           X,XXX개 → /media/fat/games/SNES/names.txt
    OK  megadrive      X,XXX개 → /media/fat/games/MegaDrive/names.txt
    ...
    Total: XX,XXX개 게임명 적용

=====================================
  Korean game names applied!
=====================================

  Data by 텐타클 팀 (tentacleteam)
  https://github.com/tentacleteam/romlistkr
  MIT License

출처

한글 게임명 데이터는 텐타클 팀의 오픈소스 프로젝트 romlistkr에서 제공됩니다. MIT 라이선스에 따라 출처 표기 하에 사용합니다.

---

방법 2 — 수동 설치

1. Releases 에서 최신 MiSTer 파일 다운로드
2. SD카드 루트(/media/fat/MiSTer)에 복사하여 덮어쓰기
3. MiSTer 재시작

---

자동 빌드

GitHub Actions가 매일 00:00 KST에 upstream 변경을 감지합니다.

상태	설명
새 upstream 커밋 있음	한글 패치 rebase → 빌드 → 릴리즈 자동 생성
변경 없음	스킵
rebase 충돌	GitHub 이슈 자동 생성으로 알림

---

빌드 환경

• 기반: MiSTer-devel/Main_MiSTer 공식 upstream
• 컴파일러: arm-none-linux-gnueabihf-gcc 10.2
• 빌드: GitHub Actions (ubuntu-latest)

---

원본 저장소

This repo is a Korean-localized fork of the official MiSTer main binary. For the original repository, wiki, and documentation:

• 원본: MiSTer-devel/Main_MiSTer
• 위키: MiSTer Wiki
• 컴파일 가이드: MiSTer Compile Guide