01 — BASICS
시작하기 · 기본 개념Getting Started
이 프로그램은 콘솔 에뮬레이터용 ROM 파일에 메타데이터(제목·설명·이미지·영상·매뉴얼)를 자동으로 붙여, ES-DE·EmulationStation 같은 프론트엔드용 gamelist.xml을 만들고, 그 결과를 PC·안드로이드·리눅스 휴대용 기기로 내보내는 도구입니다. This tool automatically attaches metadata (title, description, images, video, manuals) to console-emulator ROM files, builds a gamelist.xml for front-ends like ES-DE / EmulationStation, and exports the result to PC, Android, or Linux handhelds.
화면 구성Screen layout
화면은 왼쪽의 시스템 목록, 가운데의 게임 목록, 오른쪽의 게임 정보 패널로 나뉩니다. 시스템을 고르면 그 시스템의 게임들이 가운데에 뜨고, 게임을 고르면 오른쪽에 정보·미디어·영상·매뉴얼이 펼쳐집니다(그동안 시스템 목록은 좁게 접힙니다). 상단 바 우측에는 Tools(도구 — APK 보관함 · 게임저장 공유 · BIOS 점검)·⚙ 설정(언어·테마·AI·ScreenScraper)·♥ 후원 버튼이 있고, 앱 이름 옆에 현재 버전과 BETA / PLUS+ 배지가 표시됩니다. 게임이 많은 시스템을 열면 목록 자리에 돌림표와 "게임 목록 불러오는 중..."이 떠서, 멈춘 것인지 읽는 중인지 알 수 있습니다(v1.0.10). The screen is split into the system list (left), the game list (center) and the game info panel (right). Pick a system to list its games; pick a game and its info, media, video and manual open on the right (the system list folds narrow meanwhile). The top bar holds Tools (APK library, game saves, BIOS check), ⚙ Settings (language, theme, AI, ScreenScraper) and ♥ Donate, with the current version and BETA / PLUS+ badges next to the app name. Opening a system with many games shows a spinner and "Loading the game list..." in the list area, so you can tell it is reading rather than stuck (v1.0.10).
시스템 목록 위의 도구줄에는 + 시스템, ⬆ 내보내기(누르면 일반 내보내기와 HB런처 내보내기 중 고릅니다 — 따로 있던 초록 HB런처 버튼은 v1.0.7 에서 이 아래로 들어갔습니다) 와 아이콘 버튼 — ↻ 선택 재스캔, 프론트엔드 설정(코어/실행기), 🎮 컨트롤러 키설정, 🌐 전역 리전 우선순위, 🗑 선택 삭제 — 가 있습니다. 게임 목록 위에는 + 폴더·+ 파일·복사·이동·숨김·삭제·검색·중복만·롬없음만(v1.0.10)이 있고, 디스크를 여러 장 고르면 M3U 병합 버튼이 나타납니다. 게임 목록과 정보 패널 사이의 경계는 마우스로 끌어 너비를 조절할 수 있고, 게임 목록의 컬럼 너비는 시스템을 바꿔도 최대한 유지됩니다(v1.0.7). The toolbar above the system list has + System, ⬆ Export (it asks whether you want a regular export or an HB Launcher export — the separate green HB Launcher button moved under it in v1.0.7) and icon buttons — ↻ rescan selected, front-end settings (cores/launch), 🎮 controller mapping, 🌐 global region priority, 🗑 delete selected. Above the game list are + Folder, + Files, Copy, Move, Hide, Delete, search, Duplicates and No ROM (v1.0.10); select several discs and a Merge M3U button appears. The divider between the game list and the info panel can be dragged, and game-list column widths are kept as far as possible when you switch systems (v1.0.7).
02 — SYSTEMS
시스템 관리Managing Systems
시스템 추가Add a system
왼쪽 목록의 + 시스템을 누르면 먼저 추가 방식을 묻습니다 — 로컬 (롬 파일)은 내 PC의 롬 폴더를 스캔해 자동 매칭하고, 외부 세팅 정보 (가져오기)는 ES-DE·Pegasus 라이브러리나 안드로이드·SFTP 기기의 목록을 그대로 들여옵니다(10장). 로컬을 고르면 콘솔 종류(예: 메가드라이브, 슈퍼패미컴, PSX…)와 그 콘솔의 ROM 폴더를 지정합니다. Press + System on the left panel and choose how to add — Local (ROM files) scans a ROM folder on this PC and auto-matches it, while External library (Import) pulls in an existing ES-DE / Pegasus library or a list from an Android / SFTP device (chapter 10). For Local, pick the console type (e.g. Mega Drive, Super Famicom, PSX…) and that console's ROM folder.
- 콘솔 종류 선택 — 지원 시스템 목록에서 선택합니다. 시스템별로 인식하는 ROM 확장자가 정해져 있습니다.Pick the console from the supported list. Each system knows which ROM extensions to recognize.
- ROM 폴더 지정 — 폴더를 고르면 하위의 ROM을 스캔합니다. (폴더 없이 빈 시스템으로 먼저 추가한 뒤 나중에 ROM을 넣어도 됩니다.)Choose the ROM folder — its ROMs are scanned. (You can also add an empty system first and add ROMs later.)
- 표시 이름 · 리전 접미사 — 목록에 보일 이름을 정하고, 원하면 파일명 리전 태그를 제목 접미사로 표시를 켭니다 — (Korea)는 (정발판), (Japan)은 (일본판)처럼 제목 뒤에 붙습니다. 기본은 꺼짐입니다.Display name · region suffix — set the name shown in the list and, if you like, turn on append filename region tag to title — (Korea) and (Japan) tags become a suffix on the title. Off by default.
- 자동 매칭 + 미디어 다운로드 — 파일명을 분석해 게임을 찾아 제목·장르·이미지·영상 등을 자동으로 채웁니다. 진행률은 0~20% 매칭, 20~95% 미디어 다운로드로 표시됩니다.Auto-match + media download — filenames are analyzed to identify each game and fill in title, genre, images, video, etc. Progress shows 0–20% matching, 20–95% media download.
하위 폴더가 있는 롬 폴더(v1.0.9) — + 시스템이나 + 폴더로 고른 폴더 안에 롬셋·장르별 하위 폴더가 있으면(예: fbneo 아래 neogeo · cps1 · cave …) 구조를 먼저 살펴 "폴더를 살펴봤습니다 — 어떻게 넣을까요?" 창을 띄웁니다. 폴더별로 구분해서 시스템 생성(권장)은 체크한 하위 폴더마다 시스템을 따로 만들고(폴더 바로 아래의 롬도 함께 넣습니다), 각 폴더를 게임 1개로 처리는 나누지 않고 시스템 하나로 넣되 하위 폴더 하나를 게임 하나로 셉니다. 파일을 열지 않고 이름만 보고 세므로 폴더가 많아도 바로 뜨고, 롬이 아닌 폴더는 빼며, 같은 이름의 CHD 폴더 · 압축을 푼 사본 · bios 같은 곁다리 폴더를 걸러 중복 등록을 막고, 여러 장짜리 CD 게임은 한 게임으로 셉니다. 폴더별로 나눈 시스템도 내보낼 때 한 폴더 아래 하위 폴더로 모을 수 있습니다(8장 3)). ROM folders with sub-folders (v1.0.9) — if the folder picked with + System or + Folder contains romset or genre sub-folders (e.g. neogeo, cps1, cave … under fbneo), its structure is read first and a "Looked through this folder — how should it be added?" dialog opens. Create a system per folder (recommended) makes a system for each ticked sub-folder (ROMs sitting directly in the folder are included too); Treat each folder as one game keeps a single system and counts each sub-folder as one game. It counts by name without opening files, so it opens instantly even with many folders; non-ROM folders are skipped, side folders such as a same-named CHD folder, an unzipped copy or bios are filtered out so nothing is registered twice, and multi-disc CD games count as one game. Systems split per folder can still be exported as sub-folders under one folder (chapter 8, step 3).
추가 후 시스템 행에서 설명(표시 이름)과 메타 폴더명을 편집할 수 있습니다. 폴더명은 내보낼 때 사용되는 시스템 폴더 이름입니다(비워 두면 표준 이름 사용). After adding, you can edit the system's display name and meta folder name on its row. The folder name is used as the system's folder when exporting (leave blank to use the standard name).
v1.0.10 매칭 개선 — 속편이 1편으로 잡히던 문제를 고쳤습니다. 이름 끝에 붙은 버전 표기(삼국지 DS 3 v1.2 (K))와 부제 쪽에 붙은 편 번호(Trauma Center - Under the Knife 2)를 가려내고, 20th Anniversary 처럼 편 번호가 아닌 숫자는 편 번호로 보지 않으며, 제목이 비슷한 게임(엔드리스 프론티어 ↔ 엔드리스 프론티어 엑시드)도 더 정확히 구분합니다. 25개 기종 · 약 1만 6천 개의 실제 롬 파일 이름으로 시험한 전체 정확도는 77% → 98.5%, 버전 표기가 붙은 파일 이름은 평균 30%대 → 96% 이상입니다. 예전에 이름이 틀렸던 게임은 재스캔하면 새 결과로 바뀝니다. Matching in v1.0.10 — sequels no longer fall back to the first game. A version tag at the end of a name (Sangokushi DS 3 v1.2 (K)) and a sequel number in the subtitle (Trauma Center - Under the Knife 2) are recognised, numbers that are not sequel numbers such as 20th Anniversary are ignored, and near-identical titles (Endless Frontier vs. Endless Frontier EXCEED) are told apart better. Tested on about 16,000 real ROM filenames across 25 systems: overall accuracy 77% → 98.5%, filenames with a version tag from the 30% range to over 96%. Games that were misnamed before switch to the new result when you rescan.
게임 추가 · 복사 · 이동 · 우클릭 메뉴Adding, copying, moving & the right-click menu
이미 만든 시스템에 게임을 더하거나 옮길 때 쓰는 기능입니다. 게임 목록 위의 버튼과, 게임을 우클릭했을 때 뜨는 메뉴 두 곳에서 쓸 수 있습니다.Once a system exists, these add or move games within it — from the buttons above the game list, or from the right-click menu on a game.
| 기능Feature | 설명What it does |
|---|---|
| + 폴더+ Folder | 폴더를 골라 그 안의 ROM을 스캔해 현재 시스템에 추가합니다. 이미 있는 파일은 건너뜁니다.Pick a folder; its ROMs are scanned and added to the current system. Existing files are skipped. |
| + 파일+ Files | 개별 ROM 파일을 골라(또는 드래그드롭) 추가합니다.Select individual ROM files (or drag-and-drop) to add. |
| 복사 / 이동Copy / Move | 체크한 게임을 같은 종류의 다른 시스템으로 복사하거나 이동합니다. 같은 콘솔이라 미디어·캐시가 그대로 호환됩니다. 여러 개를 체크한 채 우클릭하면 그 전부에 걸립니다.Copy or move checked games to another system of the same type. Media and cache stay compatible since the console is identical. Right-clicking with several checked applies to all of them. |
| 새 시스템으로 복사 / 이동Copy / Move to new | 같은 종류의 새 빈 시스템을 만들어 선택 게임을 옮깁니다. (장르·지역별로 목록을 나눌 때 유용)Creates a new empty system of the same type and moves the selected games there. (Handy for splitting lists by genre/region.) |
| 삭제Delete | 체크한 게임을 목록에서 지웁니다. 확인 창의 롬 파일도 삭제를 체크하면 ROM 파일까지 지웁니다(m3u·cue 가 딸고 오는 디스크 파일과 게임 폴더 포함). 체크하지 않으면 목록에서만 지우고 파일은 그대로입니다. 몇 개가 지워지는지, 휴지통으로 가는지 아니면 바로 지워지는 드라이브(SD·USB)인지 체크박스에 미리 적어 줍니다.Removes the checked games from the list. Tick Also delete the ROM files in the confirmation to remove the ROM files too (including disc files listed by m3u/cue and game folders). Leave it unticked and only the list entry goes. The checkbox tells you how many files are involved and whether they go to the Recycle Bin or are deleted permanently (SD/USB). |
| 파일 교체… (우클릭)Replace file… (right-click) | v1.0.9. 그 게임에 연결된 파일을 이 PC 의 다른 파일로 바꿉니다. 제목·설명·미디어·매칭·손수 고친 값은 그대로 이어집니다. 새 파일이 롬 폴더 밖에 있으면 옛 파일이 있던 폴더로 복사하고, 옛 파일은 확인 창에서 체크할 때만 지웁니다. 롬을 다른 판(한글 패치판 · 리비전)으로 갈아 끼울 때 씁니다. PRO 기기 시트에서는 새 파일(딸린 디스크 파일 포함)을 기기에 올리고 옛 파일은 지우며, 목록의 경로와 파일명 기반 미디어(ES-DE · 페가수스)도 새 이름으로 고칩니다.v1.0.9. Swaps the file linked to a game for another file on this PC. Title, description, media, match and your manual edits carry over. A new file from outside the ROM folder is copied into the folder the old one was in, and the old file is deleted only if you tick it in the confirmation. Use it to swap a ROM for another version (a translation patch, a revision). On the PRO device sheet the new file (with its disc parts) is uploaded, the old one deleted, and the list path plus filename-based media (ES-DE, Pegasus) are renamed to match. |
우클릭 메뉴에는 메뉴 위쪽에 지금 고른 게임 이름·파일명이 보이고, 메타 편집 · 패치 적용…(아래) · 이 게임만 재스캔 · 파일 교체…(v1.0.9) · 미매칭 전환 · 탐색기에서 보기 · 숨김 / 숨김 해제 · 다른 시스템으로 복사/이동 · 삭제가 모여 있습니다. 이 게임만 재스캔은 시스템 전체를 돌리지 않고 그 한 게임만 다루는데, v1.0.8 부터는 창에서 완전 재스캔(다시 매칭, 수동 편집도 덮어씀)과 비어 있는 미디어만 보강(빈 메타·미디어만 채우고 입력·교체한 값은 유지) 중 고르고, 파일명 리전 태그 옵션도 함께 정합니다. 미매칭 전환은 잘못 붙은 정보를 떼어 제목을 파일명으로 되돌립니다. 우클릭은 그 행만 대상으로 하며 체크 상태를 몰래 바꾸지 않습니다(v1.0.7 에서 고침). 게임 목록에서는 체크박스 다중 선택과 검색도 됩니다. The right-click menu names the selected game and file at the top and gathers Edit metadata, Patch ROM… (below), Rescan this game, Replace file… (v1.0.9), Set unmatched, Show in Explorer, Hide / Unhide, Copy / Move to another system and Delete. Rescan this game handles a single title without re-scanning the system; since v1.0.8 it asks whether you want a full rescan (re-match, overwriting manual edits) or fill empty media only (fills blank fields and media, keeps what you typed or replaced), with the filename region-tag option alongside. Set unmatched strips a wrong match back to the filename. Right-click acts on that row only and no longer toggles checkboxes behind your back (fixed in v1.0.7). The game list also supports multi-select checkboxes and search.
숨김 · 중복만 · 롬 없는 게임Hide · Duplicates · missing ROMs
[숨김](v1.0.7) — 체크한 게임을 숨김으로 두면 목록에는 남지만 이 시스템의 내보내기에서 빠집니다. 목록은 그대로 두고 기기에는 보내고 싶지 않은 게임(리전 중복, 해킹판, 아직 손보지 않은 것)을 골라내는 용도이며, 숨긴 행은 색으로 구분되고 목록 위 카운터에 "숨김 N"으로 셉니다. 같은 버튼(또는 우클릭 메뉴)으로 숨김 해제합니다. HB런처 내보내기에서도 똑같이 빠집니다. [Hide] (v1.0.7) — hidden games stay in the list but are left out of this system's export. Use it for games you want to keep around but not send to the device (region duplicates, hacks, things you have not cleaned up yet); hidden rows are tinted and counted as "hidden N" above the list. The same button (or the right-click menu) unhides. HB Launcher export skips them too.
[중복만] — 검색칸 옆의 이 버튼을 누르면 같은 게임이 여러 파일로 들어온 것만 걸러 보여 줍니다(같은 제목의 리전판·리비전, 자동 매칭에서 같은 게임으로 잡힌 것). 버튼에 중복 개수가 함께 표시되고, v1.0.8 부터는 같은 게임끼리 뭉쳐서 보이고 묶음마다 음영이 번갈아 들어가 어디까지가 한 게임인지 한눈에 보입니다. 필요 없는 쪽을 지우면 짝을 잃은 나머지 하나도 이 보기에서 빠집니다 — 목록이 비면 정리가 끝난 것입니다. 다른 시스템으로 옮기면 저절로 꺼집니다. [Duplicates] — the button next to the search box filters the list to games that arrived as several files (region variants, revisions, or anything auto-matched to the same game), with the count shown on the button. Since v1.0.8 the copies of one game are grouped together with alternating shading per group, so you can see at a glance where one game ends. Delete the copy you don't want and the remaining one leaves the view too — an empty list means you are done. Switching systems turns it off automatically.
롬 파일이 없는 게임 — 목록에는 있는데 실제 롬 파일이 사라진 게임은 줄 전체가 붉은 음영으로 칠해지고 파일명에 줄이 그어지며, 매칭 방식 칸에 [롬 없음] 배지가 붙습니다(v1.0.10 — v1.0.8 에서는 파일명만 빨갰는데 눈에 잘 띄지 않아, PRO 기기 시트와 같은 모양으로 맞췄습니다). [롬없음만](v1.0.10) — [중복만] 오른쪽의 이 단추를 누르면 그런 게임만 모아 보여 주고, 단추에 개수가 함께 표시됩니다. [중복만]과 함께 켜면 둘 다 해당하는 게임만 남고, 롬 없는 게임이 없으면 누를 수 없습니다(PRO 기기 시트에서도 같습니다). 파일을 제자리에 되돌리거나, 재스캔의 롬파일만 정리로 목록에서 걷어 내세요. 메타 편집을 적용하거나 게임 하나를 재스캔한 뒤에도 목록이 맨 위로 튀지 않고 그 자리에 머뭅니다(v1.0.8). Games whose ROM is missing — entries whose ROM file has vanished get a red-tinted row, a struck-through filename and a [no ROM] badge in the Matching column (v1.0.10 — v1.0.8 only turned the filename red, which was easy to miss, so it now matches the PRO device sheet). [No ROM] (v1.0.10) — the button to the right of [Duplicates] filters the list to just those games, with the count on the button. Turned on together with [Duplicates], only games that are both remain; with no missing ROMs it can't be pressed (the PRO device sheet works the same). Put the file back, or clear them with Prune ROM files only under Re-scan. The list also stays put after applying an edit or rescanning one game instead of jumping to the top (v1.0.8).
ROM 패치 적용 · M3U 병합Patch ROM · Merge M3U
게임을 우클릭해 패치 적용…을 누르면 그 ROM의 CRC32 · MD5 해시가 보이고, 항목마다 패치 파일을 지정해 바로 입힐 수 있습니다. 내 롬이 No-Intro 같은 대조표의 어느 판본인지 확인하고, 대한글화시대에서 받은 한글화 패치를 툴 안에서 바로 적용하는 자리입니다.Right-click a game and choose Patch ROM… to see its CRC32 · MD5 hashes and apply a patch file per entry. Use it to check which No-Intro dump you have and to apply Korean translation patches from the KR Patches page without leaving the tool.
- 지원 형식 — IPS · IPS32 · BPS · UPS · PPF · APS · Xdelta, 드림캐스트 GD-ROM은 DCP(디스크 전체에 적용)까지.Formats — IPS, IPS32, BPS, UPS, PPF, APS and Xdelta, plus DCP for Dreamcast GD-ROMs (applies to the whole disc).
- 압축 파일은 그릇일 뿐이라 통째로 패치하지 않고 압축 안의 롬에 겁니다 — 한글화 패치는 대개 압축을 푼 롬 기준이기 때문입니다. 안쪽 항목의 해시도 함께 보여 줍니다. 7z는 기본 설정으로 다시 묶이고, CHD는 풀고 → 적용하고 → 다시 묶습니다(몇 분 소요).Archives are only containers, so the patch goes on the ROM inside — translation patches are normally built against the unzipped ROM. Hashes of the inner entries are shown too. 7z files are repacked with default settings; a CHD is extracted → patched → repacked (takes a few minutes).
- 폴더형 게임(PS1의 cue/bin 등)은 폴더째 새로 만들어 그 안의 파일을 바꿉니다.Folder games (e.g. PS1 cue/bin) are recreated as a new folder with the files replaced.
M3U 병합 — 여러 장짜리 CD 게임은 디스크 2장 이상을 체크하면 목록 위에 M3U 병합 버튼이 나타납니다. 누르면 .m3u 하나로 묶여 목록에 한 줄로 합쳐지고, 에뮬레이터에서 디스크 교체도 알아서 됩니다. 원래 디스크 파일은 그대로 둡니다.Merge M3U — for multi-disc CD games, check two or more discs and a Merge M3U button appears above the list. It bundles them into one .m3u, shown as a single entry, and emulators handle disc swapping on their own. The original disc files are kept.
재스캔Re-scan
ROM 폴더가 바뀌었거나 매칭을 다시 돌리고 싶을 때 사용합니다. 세 가지 옵션이 있습니다.Use when the ROM folder changed or you want to re-run matching. Three options:
| 옵션Option | 동작Behavior |
|---|---|
| 전체 재스캔Total re-scan | 모든 게임을 다시 매칭합니다. 직접 수정했던 메타가 자동 매칭으로 초기화되며, 사라진 ROM은 목록에서 제거됩니다.Re-matches every game. Manually edited metadata is reset to auto-match; missing ROMs are removed from the list. |
| 재스캔 (수정한 게임 제외)Re-scan (keep edits) | 직접 수정한 게임은 건드리지 않고, 나머지만 다시 매칭합니다. 사라진 ROM은 제거됩니다.Leaves your edited games untouched and re-matches the rest. Missing ROMs are removed. |
| 삭제된 롬만 제거Prune deleted only | 매칭은 하지 않고, 폴더에서 사라진 ROM만 목록에서 정리합니다.No matching — just removes list entries whose ROM files are gone. |
게임 하나만 다루려면 우클릭 메뉴의 이 게임만 재스캔을, 여러 개는 체크 후 선택 게임 재스캔을 사용합니다. 게임 하나 재스캔 창에는 완전 재스캔(다시 매칭)과 비어 있는 미디어만 보강(빈 메타·미디어만 채우고 캐시에 없는 미디어를 받음, 입력·교체한 값 유지) 두 갈래와 파일명 리전 태그 옵션이 있습니다(v1.0.8). 손수 고친 게임의 빈 칸만 메우고 싶을 때는 후자를 고르세요.For a single game use Rescan this game from the right-click menu; for several, check them and use Rescan checked. The single-game dialog offers Full rescan (re-match) or Fill empty media only (fills blank fields and media, downloads what the cache lacks, keeps what you typed or replaced), plus the filename region tag option (v1.0.8). Pick the latter to top up a game you have edited by hand.
03 — VIEWING
게임 정보 & 미디어 보기Game Info & Media
게임을 선택하면 오른쪽 정보 패널이 펼쳐집니다. 제목 옆에는 ✎ 메타 편집 · 🎨 믹스 이미지 편집 · 📂 탐색기에서 보기 · 🎮 게임별 패드 설정(지원 시스템만) 버튼이 있고, 그 아래에 미디어 탭 — 그 게임에 있는 종류만 — 과 이미지 무대, 장르·출시일·개발사·플레이어·파일명, 설명이 차례로 놓입니다.Selecting a game opens the info panel on the right. Next to the title are ✎ Edit, 🎨 Mix image editor, 📂 Show in Explorer and 🎮 per-game pad settings (supported systems only); below come the media tabs — only the kinds this game has — the image stage, genre / release / developer / players / filename, and the description.
- 이미지 — 탭을 눌러 종류를 바꾸고, ⛶ 로 크게 볼 수 있습니다.Images — switch kinds with the tabs; ⛶ enlarges.
- 리전 칩 — 미디어 아래에 그 미디어가 있는 리전(us · jp · eu · kr …)이 칩으로 뜹니다. 누르면 그 종류만 그 리전으로 바뀝니다(캐시에 없으면 그 자리에서 내려받음). 예를 들어 박스아트는 일본판, 스크린샷은 북미판으로 둘 수 있고, 다시 누르면 기본 우선순위로 돌아갑니다. 이 선택은 믹스 이미지와 내보내기에도 반영됩니다.Region chips — below the media, the regions available for it (us · jp · eu · kr …) appear as chips. Click one to switch that kind only (downloaded on the spot if not cached) — e.g. Japanese box art with US screenshots. Click again to return to the default order. The choice carries into the mix image and exports.
- 영상 — 트레일러/게임플레이 영상을 재생합니다.Video — plays the trailer / gameplay clip.
- 매뉴얼 — 탭을 열면 표지 미리보기가 먼저 뜨고, 가운데 매뉴얼 내려받기를 눌렀을 때만 PDF를 받습니다. 받은 설명서는 페이지 뷰어(이전/다음·줌·전체화면)로 보고, 가 버튼으로 현재 페이지를 AI 번역해 원본 위에 덮어 볼 수 있습니다(AI 설정 필요). 결과가 마음에 안 들면 ↻ 로 다시 번역합니다.Manual — the tab shows the cover thumbnail first and fetches the PDF only when you press Download manual. Read it in the page viewer (prev/next, zoom, fullscreen) and press 가 to AI-translate the current page as an overlay (needs AI settings); ↻ re-translates if the result reads poorly.
미디어 종류
Media types
04 — META EDITOR
메타 편집기Meta Editor
게임을 우클릭하거나 게임 메타 편집을 눌러 엽니다. 잘못 매칭됐거나 비어 있는 정보를 바로잡고, 원하는 이미지·영상·매뉴얼로 교체하는 곳입니다.Right-click a game or press Edit Meta. This is where you fix wrong/missing matches and swap in the images, video and manual you want.
후보 찾기 — 추천 · 검색 · 실시간 조회Finding the right game
- 추천 리스트 — 현재 파일명에 가장 가까운 후보들을 자동으로 보여줍니다.Recommend list — auto-suggests the closest candidates for the current filename.
- 전체 검색 — 제목을 직접 입력해 마스터 DB에서 찾습니다.Search — type a title to search the master database directly.
- ScreenScraper 실시간 조회 — 로컬 DB에 없는 게임을 온라인(ScreenScraper)에서 즉시 검색해 적용합니다(계정 설정 필요).Live ScreenScraper lookup — for games not in the local DB, search online (ScreenScraper) and apply instantly (needs a configured account).
- AI로 채우기 — 텍스트 정보가 부족할 때 LLM으로 제목·설명 등을 보완합니다(AI 설정 필요).AI fill — when text info is sparse, use an LLM to complete title/description (needs AI settings).
후보를 고르면 미리보기(믹스 이미지)가 뜨고, 원하는 리전을 선택할 수 있습니다. 눌러 본 후보가 아니다 싶으면 [취소]로 고르기 직전 상태(편집하던 글자·바꿔 둔 미디어·리전·탭)로 되돌아갑니다(v1.0.8).Choosing a candidate shows a preview (mix image) and lets you pick the desired region. If the candidate turns out wrong, [Cancel] restores exactly what you had before choosing it — text you were editing, media you had swapped, region and tab (v1.0.8).
텍스트 편집Text fields
직접 고칠 수 있는 항목: 제목(영문), 제목(한글), 게임 설명, 장르, 출시일, 개발사, 플레이어 수.Editable fields: Title (EN), Title (KR), Description, Genre, Release date, Developer, Players.
미디어 편집Media editing
오른쪽 미리보기 아래 미디어 교체에 슬롯(스크린샷·타이틀·앞표지·케이스·3D박스·사이드바·휠·서포트·영상·매뉴얼)이 있고, 각 슬롯의 편집을 누르면 미디어 편집 창이 열립니다. × 는 그 미디어를 지웁니다.Under the preview on the right, Replace media lists the slots (screenshot, title, cover, box texture, 3D box, sidebar, wheel, support, video, manual); Edit on a slot opens the media editor, and × removes that media.
- 불러오기 — 내 PC 이미지 파일, URL, 또는 웹 이미지 검색으로 새 그림을 가져옵니다.Load — bring in a new picture from a file on your PC, a URL, or a web image search.
- 손질 — 이미지 슬롯의 편집은 아래 이미지 편집기에서 합니다(자르기 · 크기/회전 · 투명화 · 정면화 · 조각 얹기).Touch-ups — image slots open the image editor below (crop, resize/rotate, transparency, flatten, pieces).
- 조각 얹기 — 케이스 슬롯에서는 + 사이드바로 책등 조각을 바탕 위에 얹고, 끌어 옮기고 모서리로 크기를 맞춘 뒤 합치기로 한 장에 굽습니다.Pieces — on the box-texture slot, + Sidebar lays the spine on top of the base; drag it into place, resize by the corners, then Merge bakes it into one image.
- 3D 박스 생성 — 3D박스 슬롯에서 3D박스를 누르면 앞표지(와 사이드바)로 3D 박스를 만듭니다. 기종별로 실제 케이스 수천 장을 재어 맞춘 비율·기울기라 스크래퍼가 주는 박스와 거의 구분되지 않고, CD 기종은 힌지·투명 테두리가 있는 쥬얼 케이스로, 슈퍼패미컴·N64처럼 눕혀 놓는 상자는 가로형으로 그립니다. 사이드바가 있으면 그것이 옆면이 되고, 두께 슬라이더로 조절하는 즉시 미리보기에 반영됩니다.Generate 3D box — on the 3D-box slot, 3D box builds one from the cover (and sidebar). Proportions and tilt were measured from thousands of real boxes per system, so it is nearly indistinguishable from scraped art; CD systems get a jewel case with hinge and clear rim, and wide boxes (Super Famicom, N64) are drawn landscape. A sidebar becomes the side face, and the thickness slider updates the preview as you drag.
- 영상 가져오기 · 자르기 — 영상 슬롯의 편집은 YouTube 검색/URL로 영상을 받거나, v1.0.7 부터는 내 PC 의 영상 파일(mp4 등)을 그대로 불러온 뒤, 구간 바로 원하는 부분만 잘라 넣습니다. 매뉴얼은 PDF 파일을 골라 넣습니다.Fetch / trim video — the video slot grabs a clip via YouTube search/URL or, since v1.0.7, loads a video file from your PC (mp4 etc.), then trims it to the segment you want on the range bar. The manual slot takes a PDF file.
이미지 편집기 — v1.0.8 개편Image editor — reworked in v1.0.8
이미지 슬롯의 편집을 누르면 열립니다. 위쪽이 결과 미리보기, 아래가 도구줄입니다. 파워포인트처럼 틀(frame)을 잡고 손잡이를 끌어 다루며, 한 도구를 마친 뒤 다음 도구로 이어 갈 수 있습니다.Opens from Edit on an image slot: result preview on top, toolbar below. You work with a frame and its handles, PowerPoint-style, and can chain one tool after another.
| 도구Tool | 동작What it does |
|---|---|
| ✂ 자르기Crop | 개미줄 상자를 끌어 남길 부분을 정합니다. 사각형 또는 타원(밖은 투명) — Shift 를 누른 채 끌면 정사각/원.Drag the marching-ants box over the part to keep — as a rectangle or an ellipse (outside becomes transparent); hold Shift for a square / circle. |
| ⤢ 크기 / 회전Resize / Rotate | 상하좌우·모서리 손잡이로 가로세로 크기를 맞추고, 위 가운데의 ⟳ 손잡이를 끌어 회전합니다(Shift = 90° 단위). 숫자 입력도 됩니다.Edge and corner handles set width and height; drag the ⟳ handle at the top to rotate (Shift snaps to 90°). Numeric entry works too. |
| ◌ 투명화Transparency | 단색 배경 전체를 투명하게, 또는 클릭하면 이어진 색만·끌면 사각형 안을 통째로 지웁니다 — 색이 섞인 로고에 유용.Clears a whole solid background, or click for the connected colour / drag to clear a rectangle — handy for multicoloured logos. |
| ▱ 정면화Flatten | 비스듬히 찍힌 표지를 자동으로 물체를 찾아 펴거나, 모서리 4점을 직접 찍어 폅니다.Straightens a cover photographed at an angle — automatically or by placing four corners yourself. |
| ▣ 조각 얹기Pieces | 앞표지·사이드바를 조각으로 바탕 위에 얹고 옮기고 맞춰 한 장으로 굽습니다(케이스 슬롯).Lays the cover and sidebar on the base as pieces, lets you move and fit them, then bakes one image (box-texture slot). |
[취소]는 이 창에서 한 일을 전부 되돌리고 닫으며, [적용]은 남은 기하 작업(자르기·크기/회전·4점)을 실행해 저장합니다. ESC 는 창을 닫지 않고 끌던 동작만 끌기 전으로 되돌립니다. 3D 박스 생성과 조각 얹기의 자세한 설명은 위의 미디어 편집 항목을 보세요.[Cancel] undoes everything done in this window and closes it; [Apply] runs the pending geometry (crop, resize/rotate, four-point) and saves. ESC does not close the window — it only reverts the drag in progress. See the media-editing bullets above for 3D box generation and pieces.
리전 일괄 · 이용자 리전 — v1.0.8Batch regions · user region — v1.0.8
- 리전 일괄 — 미디어 교체 위의 콤보에서 리전을 고르면 그 리전 판이 있는 미디어는 전부 그 리전으로, 없는 미디어는 리전 우선순위대로 채워집니다. 우선순위(기본)로 되돌릴 수 있고, 내보내기와 믹스 이미지도 따라갑니다. 종류 하나만 바꾸려면 여전히 정보 패널의 리전 칩을 쓰세요.All regions — pick a region in the combo above Replace media and every media type that has that region switches to it; types without it fall back to your region priority. Priority (default) reverts it, and export and the mix image follow. To change a single type, the region chips in the info panel still do that.
- 이용자 리전 user · 이용자(내가 만든) — 내가 만들거나 손본 이미지를 저장할 리전입니다. 한글 패치판 표지, 직접 그린 로고처럼 마스터 DB 에 없는 내 그림을 이 리전으로 두면 그 게임에서 계속 우선 사용되고, 재스캔·미디어 보강에도 지워지지 않습니다. 이 PC 의 캐시에만 남으며, 리전 우선순위에서 맨 앞에 옵니다.User region user · User (mine) — the region for images you made or touched up yourself. Keep your own artwork that is not in the master database (a translation-patch cover, a logo you drew) here and that game keeps preferring it; rescans and fill-empty passes never remove it. It lives only in this PC's cache and sits first in the region priority.
미매칭 전환 — 잘못 매칭된 게임을 "매칭 안 됨" 상태로 되돌립니다. 적용을 누르면 편집 내용이 저장되고 목록·믹스 이미지가 갱신됩니다.Convert to unmatched — resets a wrongly matched game to "unmatched." Press Apply to save edits and refresh the list & mix image.
05 — MIX IMAGE
믹스 이미지 편집Mix Image Editor
스크린샷·박스아트·로고·카트리지를 하나로 합친 대표 이미지의 배치를 직접 디자인합니다. 각 구성요소를 드래그로 옮기고 크기를 바꿀 수 있으며, 실시간 미리보기로 결과를 확인합니다.Design the layout of the showcase image that combines screenshot, box art, logo and cartridge. Drag and resize each component and see the result in a live preview.
- 레이아웃 — 구성요소(스크린샷/박스/로고/서포트)의 위치·크기·순서를 조정.Layout — position, size and order of components (screenshot / box / logo / support).
- 전역 / 시스템별 설정 — 모든 게임에 공통으로 적용하거나 시스템마다 다른 레이아웃을 저장할 수 있습니다.Global / per-system — apply one layout to all games, or save a different layout per system.
06 — CONTROLLER
컨트롤러 & 게임별 설정Controller & Per-game Settings
시스템·게임별 입력 설정을 만들어 함께 내보낼 수 있습니다.Create input configs per system/game and export them together.
| 설정Config | 대상 · 내용Scope · what it does |
|---|---|
| 컨트롤러 키설정Controller mapping | 시스템별 패드 리맵. 버튼 배치, 변형(variant), 키보드 행 매핑까지 지정해 리맵 파일로 내보냅니다.Per-system pad remap — button layout, variant, and keyboard-row mapping, exported as remap files. |
| DOS 패드 설정DOS pad map | DOSBox-Pure용 게임별 키보드→패드 매핑.Per-game keyboard→pad mapping for DOSBox-Pure. |
| 아케이드 패드(.rmp)Arcade pad (.rmp) | MAME/FBNeo 등 아케이드 게임별 .rmp 리맵.Per-game .rmp remaps for arcade (MAME/FBNeo, etc.). |
| Dolphin (Wii/GC)Dolphin (Wii/GC) | Dolphin 게임별 컨트롤러(GameSettings INI) 구성.Per-game Dolphin controller (GameSettings INI) setup. |
07 — SETTINGS
전역 설정Global Settings
리전 우선순위Region priority
한 게임에 여러 지역판 미디어(일본/북미/유럽/한국 등)가 있을 때, 어느 지역을 우선으로 받고 표시할지 순서를 정합니다. 시스템 목록 위의 🌐 버튼이 전역 기본이고, 시스템 행의 리전 버튼으로 그 시스템만의 순서를 따로 저장할 수 있습니다(전역 기본 사용으로 되돌리기 가능). 매뉴얼도 같은 순위를 따라 내려받습니다. 순위 맨 앞의 user(이용자)는 내가 만든 이미지를 두는 이용자 리전이라 늘 먼저 쓰입니다.When a game has media for multiple regions (JP/US/EU/KR…), set the preferred order for downloading and display. The 🌐 button above the system list is the global default; the region button on a system row saves an order for that system only (revertable to the global default). Manuals follow the same ordering. user at the head of the order is the user region for your own artwork, so it always wins.
게임 하나에서 미디어 종류별로 리전을 달리 쓰고 싶으면(예: 박스아트는 일본판, 스크린샷은 북미판) 정보 패널의 리전 칩으로 그 종류만 바꿉니다. 이 선택은 우선순위보다 앞서고, 믹스 이미지와 내보내기에도 그대로 반영됩니다.To mix regions per media type on a single game (e.g. Japanese box art with US screenshots), use the region chips in the info panel to switch just that kind. That choice overrides the priority order and carries into the mix image and exports.
AI 설정AI settings
상단 ⚙ 설정의 AI (번역 · 롬 매칭) 항목입니다. 매뉴얼 번역, 메타 편집기의 AI로 채우기, 그리고 롬 자동 매칭(파일명으로 확정이 안 될 때의 최종 판정)에 쓰이는 LLM을 설정합니다. API 키는 이 PC에만 저장됩니다.The AI (translation & ROM matching) block in ⚙ Settings. It configures the LLM used for manual translation, Fill with AI in the Meta Editor, and ROM auto-matching (the final call when the filename alone can't decide). Keys are stored on this PC only.
- AI 사용 체크 — 끄면 번역·AI 채우기·AI 매칭이 모두 비활성화됩니다.Enable AI — off disables translation, AI fill and AI matching alike.
- 제공자 / 모델 / API 키 — Gemini 또는 ChatGPT를 고르고 모델과 키를 입력합니다. AI 키 검증은 고른 모델로 한 단어를 실제 번역해 키가 되는지 확인합니다.Provider / model / API key — pick Gemini or ChatGPT, choose a model, enter your key. Test AI key translates one word with that model to confirm it works.
ScreenScraper 계정ScreenScraper account
마스터 DB에 없는 게임을 메타 편집기의 외부 조회로 직접 찾으려면 개인 ScreenScraper 계정(아이디/비밀번호, 무료 가입)을 설정에 입력합니다. 본인 계정의 개인 쿼터를 쓰므로 더 안정적으로 조회됩니다. 계정 확인 버튼은 실제로 로그인해 남은 요청 수까지 보여 줍니다.To look up games missing from the master DB via the Meta Editor's external lookup, enter your personal ScreenScraper account (user/password, free signup) in Settings. It uses your own quota, so lookups are more reliable. Check account signs in and reports the remaining quota.
프론트엔드 설정 (코어 / 실행기)Front-end settings (cores / launch)
시스템 목록 위의 격자 아이콘 버튼으로 엽니다. 내보낼 때 어떤 에뮬레이터·코어로 실행되게 적을지를 프론트엔드별·OS별로 정해 두는 곳입니다. 입력칸에서 사용 가능한 코어·에뮬레이터가 자동완성되고, OS마다 따로 저장됩니다. v1.0.7 에서 고를 수 있는 코어와 스탠드얼론 에뮬레이터가 늘었고, v1.0.6 에서 들어온 PS3·Wii U·Switch·Xbox·Xbox 360·Model 3 의 에뮬레이터(RPCS3 · Cemu · Ryujinx · xemu · xenia · Supermodel)도 여기서 고릅니다. v1.0.9 부터는 FinalBurn Neo · Model 2 처럼 롬 경로 없이 게임 이름만 받는 스탠드얼론 실행기도, 시스템을 하위 폴더(fbneo/neogeo)로 내보냈을 때 그 폴더를 찾도록 실행기 설정의 롬 폴더를 채워 줍니다 — 적어 둔 경로는 건드리지 않고 빈 칸에만 넣습니다(Windows · Linux, 안드로이드는 해당 없음).Opened with the grid icon above the system list. This is where you decide, per front-end and per OS, which emulator or core the export should name. Available cores and emulators autocomplete in the fields, and values are stored per OS. v1.0.7 added more cores and standalone emulators to choose from, and the emulators for the v1.0.6 systems (PS3, Wii U, Switch, Xbox, Xbox 360, Model 3 — RPCS3, Cemu, Ryujinx, xemu, xenia, Supermodel) are picked here too. Since v1.0.9, standalone launchers that take only a game name rather than a ROM path — FinalBurn Neo, Model 2 — get their ROM folder settings filled in so they can find a system exported to a sub-folder (fbneo/neogeo); paths you already set are left alone and only empty slots are used (Windows · Linux; not needed on Android).
| 탭Tab | 내용What it sets |
|---|---|
| ES-DE | 빌드 OS(Android / Windows / Linux)를 고르고, 시스템별 대체 에뮬레이터를 정하면 gamelist.xml에 <altemulator>로 기록됩니다(비우면 ES-DE 기본). Wii/GC를 Dolphin·MMJR 계열 스탠드얼론으로 고르면 앱·경로가 자동 도출되고, 게임별 GameSettings가 Android 내보내기 때 그 앱 폴더로 함께 나갑니다.Pick the build OS (Android / Windows / Linux) and a per-system alternative emulator, written to gamelist.xml as <altemulator> (empty = ES-DE default). Choosing Dolphin / MMJR standalone for Wii/GC derives the app and path, and per-game GameSettings are pushed to that app folder on Android export. |
| RetroArch | OS(안드로이드 빌드 · Windows · Linux)별 시스템 → 코어 파일. 플레이리스트(.lpl)의 core_path / core_name 이 됩니다(비우면 DETECT). OS를 고르면 미설정 시스템에 기본 코어가 채워집니다.Per OS (Android builds, Windows, Linux) the system → core file map, written as core_path / core_name in the playlist (.lpl); empty = DETECT. Selecting an OS fills default cores for unset systems. |
| Pegasus | 플랫폼(OS)별 RetroArch 실행 템플릿({core} · {file.path})과 시스템별 코어 파일 또는 외부 에뮬레이터 전체 명령.Per platform (OS), the RetroArch launch template ({core} · {file.path}) plus a per-system core file or a full external emulator command. |
08 — EXPORT
내보내기Export
완성한 게임 목록과 미디어를 gamelist.xml과 함께 기기로 내보냅니다. 한 개 이상의 시스템을 골라 시작합니다.Send your finished game list and media — together with gamelist.xml — to a device. Pick one or more systems to begin.
1) 대상 기기와 프론트엔드 선택1) Choose the target & front-end
먼저 어디로 보낼지(연결 방식)를 고르고, 그 다음 어떤 프론트엔드 규약으로 만들지를 고릅니다. 이 두 가지는 별개입니다.First choose where to send it (the connection), then which front-end layout to build. These are two separate choices.
| 내보내기 대상Destination | 연결 방식Connection |
|---|---|
| 내 컴퓨터My Computer | 로컬 PC의 폴더로 내보내기. SD카드를 리더기에 꽂아 직접 쓸 때도 이 방식입니다.Export to a folder on this PC — also how you write directly to an SD card in a reader. |
| 안드로이드 (ADB)Android (ADB) | USB로 연결한 안드로이드 기기. 기기에서 개발자 옵션 > USB 디버깅 On 필요. 연결하면 기기의 실제 롬 경로를 자동으로 찾아 채웁니다.Android device over USB. Needs Developer Options > USB Debugging on. Once connected, the device's actual ROM path is detected and filled in. |
| 커스텀 리눅스 (SFTP)Custom Linux (SFTP) | 커스텀 OS 휴대용 기기에 IP·계정·비밀번호로 접속. 대상 OS를 고르면 계정·롬 경로 기본값이 자동 입력됩니다(수정 가능).Handhelds running a custom OS via IP / user / password. Picking the target OS auto-fills the usual account and ROM path (editable). |
대상 OS / 프론트엔드는 아래 중에서 고릅니다. 각각 폴더 구조·메타파일 형식·미디어 종류가 달라서, 고르는 순간 화면의 옵션이 그에 맞게 바뀝니다.Pick the target OS / front-end from the list below. Each has its own folder layout, metadata format and media set, so the options on screen change accordingly.
| 프론트엔드Front-end | 만들어지는 메타파일Metadata it writes |
|---|---|
| ES-DE | ES-DE/gamelists/<시스템>/gamelist.xml · 미디어는 downloaded_media 로 분리 · media kept separately in downloaded_media |
| Batocera · KNULLI | roms/<시스템>/gamelist.xml · 미디어도 롬 폴더 안 · 롬 경로 /userdata/roms · media inside the ROM folder · ROMs at /userdata/roms |
| ROCKNIX · JELOS | roms/<시스템>/gamelist.xml · 미디어도 롬 폴더 안 · 롬 경로 /storage/roms · media inside the ROM folder · ROMs at /storage/roms |
| ArkOS | roms/<시스템>/gamelist.xml · images/ 관례 · images/ convention |
| Pegasus (pegasus-frontend) | metadata.pegasus.txt · 기기로 보낼 때는 그 기기의 페가수스 미디어 구조를 그대로 따라 미디어를 놓습니다(v1.0.8) · device exports follow the Pegasus media layout that device already uses (v1.0.8) |
| RetroArch | playlists/<시스템>.lpl + thumbnails · 폴더 처리 방식을 v1.0.8 에서 손봤고, 하위 폴더로 내보낸 시스템(psx/usa)의 재생목록 경로가 빠져 실행되지 않던 것을 v1.0.9 에서 고쳤습니다 + thumbnails · folder handling reworked in v1.0.8; playlist paths for systems exported to a sub-folder (psx/usa) were missing that part, so games would not launch — fixed in v1.0.9 |
| muOS | 목록 파일(gamelist)을 읽지 않는 OS — 그림·설명은 MUOS/info/catalogue/<시스템 이름>/(box · preview · splash · text), 게임 이름(한글 제목)은 MUOS/info/name/<폴더>.json. 롬 폴더는 muOS 가 코어를 스스로 정하는 이름(NES · SNES · MD · PS …)으로 (v1.1.0)Reads no list file (gamelist) — art and descriptions go to MUOS/info/catalogue/<system name>/ (box, preview, splash, text), game titles to MUOS/info/name/<folder>.json. ROM folders use names muOS assigns a core to by itself (NES, SNES, MD, PS …) (v1.1.0) |
| OnionOS | miyoogamelist.xml + Imgs/ + Imgs/ |
| RG34xxSP / TSP StockOS | 메타파일 없이 이미지만(기기 규약 폴더명 자동 고정)Images only, no metadata file (device folder names are fixed automatically) |
2) 내보낼 미디어 고르기2) Pick the media to export
프론트엔드마다 쓸 수 있는 이미지 자리(슬롯)가 다릅니다. 각 슬롯을 켜고 끌 수 있고, 그 자리에 어떤 원본을 넣을지도 따로 고를 수 있습니다.Each front-end exposes different image slots. Toggle each slot on/off, and choose which source goes into it.
- 슬롯 — 메인 이미지, 박스(3D), 마퀴/로고, 타이틀 화면, 앞표지, 카트리지, 영상, 매뉴얼 등. 프론트엔드가 지원하지 않는 슬롯은 아예 나타나지 않습니다.Slots — main image, box (3D), marquee/logo, title screen, cover, cartridge, video, manual and more. Slots a front-end doesn't support simply don't appear.
- 원본 선택 — 각 슬롯 옆 콤보에서 믹스 · 스크린샷 · 타이틀 · 앞표지 · 3D박스 · 케이스 · 휠/로고 · 서포트 중에 고릅니다. 예를 들어 메인 이미지에 기본값인 믹스(박스+스크린샷+로고 합성) 대신 스크린샷만 넣을 수도 있습니다.Source — the combo next to each slot offers mix · screenshot · title screen · cover · 3D box · box texture · wheel/logo · support. For example the main image defaults to mix (box + screenshot + logo composited) but you can switch it to plain screenshot.
- 제목 · 설명 언어 — 제목과 설명을 각각 한글/영문으로 내보냅니다.Title & description language — export title and description each in Korean or English.
- 저화질 모드 (용량 절약) — v1.0.7. 켜면 4~6인치 휴대용 기기에 맞게 이미지·영상을 줄여서 보냅니다. 원래 작던 미디어는 그대로 두고, 끝나면 몇 개를 줄여 약 몇 MB 를 아꼈는지 알려 줍니다. 저장 공간이 빠듯한 기기에 여러 시스템을 담을 때 켜세요.Low quality mode (save space) — v1.0.7. Sends downscaled images and video sized for a 4–6 inch handheld; media that was already small is left alone, and the summary tells you how many files were shrunk and roughly how many MB were saved. Turn it on when packing many systems onto a device short on storage.
3) 폴더 이름과 롬 경로3) Folder names & ROM paths
- 롬 경로 (기기) — 기기에서 게임이 들어갈 최상위 경로입니다. 안드로이드는 ES-DE 가 설정한 저장소를 그대로 따라갑니다 — ES-DE 마법사에서 롬·미디어를 SD 카드에 두었으면 SD 로, 내장 저장소면 내장으로 채워집니다. 연결하면 자동으로 채워지고, 📂 탐색으로 기기 안을 직접 둘러보며 고를 수도 있습니다.ROMs path (device) — the root where games go on the device. On Android it follows the storage ES-DE is set to: if the ES-DE wizard put ROMs and media on the SD card, that is where they go. It's auto-filled on connect, and 📂 Browse lets you pick it by exploring the device.
- 내보내기 폴더 — 시스템마다 폴더 이름을 지정할 수 있습니다. 고른 프론트엔드의 공식 시스템명으로 자동 보정되며(예: ES-DE에서 Atari Lynx는 atarilynx), 직접 고쳐도 됩니다. 바꾸면 즉시 저장됩니다. v1.0.9 부터는 그 프론트엔드가 모르는 이름을 적으면 알리고 맞는 이름으로 바꿉니다. 또 대상(PC 폴더 · SFTP · 안드로이드)에 이미 있는 시스템 폴더를 보고 후보 가운데 있는 이름에 맞춰 줍니다 — 판마다 이름이 갈리는 경우(Batocera 42 이상 megacd ↔ 그 이전 · KNULLI segacd)도 알아서 따라가고, 맞춘 것이 있으면 내보내기 뒤 안내 창으로 알립니다. 직접 지은 이름은 건드리지 않습니다.Export folder — a folder name per system. It's auto-corrected to the chosen front-end's official system name (e.g. Atari Lynx becomes atarilynx on ES-DE) and is editable. Edits save immediately. Since v1.0.9 a name the front-end doesn't know is flagged and corrected, and the tool looks at system folders already on the target (PC folder, SFTP, Android) and picks the matching candidate — so names that differ between releases (Batocera 42+ megacd vs. earlier releases and KNULLI segacd) are followed automatically, with a notice after export listing what was adjusted. Names you chose yourself are never touched.
- 하위 폴더 — / 로 구분해 snes/hack 처럼 적으면 그 하위에 들어갑니다. 여러 시스템을 같은 폴더로 지정하면 하나로 합쳐 내보냅니다.Subfolders — write snes/hack with a / to nest it. Point several systems at the same folder and they are merged on export.
- 롬 경로 (시스템별) — v1.0.7 부터 기기 설정을 읽어 그대로 보여 줍니다. ES-DE 의 custom_systems <path>, 페가수스의 game_dirs, RetroArch 플레이리스트 항목 경로에서 그 시스템의 롬이 실제로 읽히는 자리를 찾아 바탕값으로 채우고, 따로 정해 둔 자리는 그렇다고 표시합니다. 변경으로 다른 경로를 적으면(📁 로 기기에서 폴더를 찾아도 됩니다) "기기 설정과 다른 자리" 라고 알려 주고, 내보내기 때 물어본 뒤 기기 설정까지 그 경로로 고쳐 줍니다 — 롬만 옮겨 놓고 프론트엔드가 못 찾는 일이 없습니다. 비우면 Default(위의 롬 경로 기준)입니다. 하위 폴더 줄(megadrive/hacks)은 주인 줄의 경로를 따릅니다.Per-system ROM path — since v1.0.7 it reads the device's own settings and shows them: the <path> in ES-DE custom_systems, Pegasus game_dirs, or the RetroArch playlist entries tell it where that system's ROMs are actually read from, and a location set on purpose is flagged as such. Press Change to enter another path (or 📁 to find a folder on the device) and it is marked "differs from the device setting"; on export the tool asks, then updates the device's settings to that path — so the front-end never loses ROMs you moved. Leave it empty for Default (relative to the ROMs path above). Subfolder rows (megadrive/hacks) follow their parent row.
4) 게임 목록 처리 · 전송4) Game list handling & transfer
- 게임 목록(gamelist) 처리 — 병합 (권장)은 기기에 이미 있는 목록을 지우지 않고 선택한 게임만 갱신·추가합니다. 즐겨찾기·플레이 횟수처럼 기기에서 관리되는 값도 보존됩니다. 전체 교체는 목록을 통째로 새로 쓰고, 내보내기 전에 목록에 없는 파일 정리 창을 띄웁니다 — 기기에는 있지만 앱 목록에 없는 롬·미디어를 시스템·크기와 함께 보여 주고, 남길 것은 남김을 체크한 뒤 "N개 삭제하고 내보내기"로 진행합니다. 미디어 종류를 체크 해제했다고 해서 그 파일이 지워지지는 않습니다(정리 기준은 파일이 아니라 게임입니다).Game list handling — Merge (recommended) keeps the device's existing list and only updates/adds the selected games, preserving device-managed values like favorites and play counts. Replace rewrites the whole list and first shows a clean-up dialog listing ROMs and media on the device that are not in the app list (with system and size); tick Keep for anything to spare, then "Delete N & export". Unchecking a media type does not delete those files — clean-up is decided per game, not per file.
- 미디어가 겹칠 때 (병합 전용) — 보낼 게임의 이미지가 기기에 이미 있으면 어느 쪽을 남길지 고릅니다. 신규 우선(기본)은 해방툴 미디어로 덮어쓰고, 기존 우선은 기기에 있던 파일을 그대로 둡니다 — 기기에서 손수 넣거나 다른 스크래퍼로 받아 둔 그림을 지키고 싶을 때 쓰세요. 전체 교체는 늘 신규 우선입니다.When media already exists (merge only) — if the device already has images for a game you are sending, choose which wins. New wins (default) overwrites with HAE-BANG media; Keep existing leaves the device's files alone — useful for artwork you placed by hand or scraped elsewhere. Replace-all always uses the new media.
- ROM 파일도 복사 — 메타뿐 아니라 ROM 자체를 함께 보냅니다. 이름·크기가 같은 파일은 건너뛰므로, 두 번째 내보내기부터는 훨씬 빠릅니다. 이름이 같아도 크기가 다르면 다시 복사합니다 — 내 컴퓨터 내보내기가 이름만 보고 건너뛰던 오류를 v1.0.10 에서 고쳤습니다.Copy ROM files too — sends the ROMs as well as the metadata. Files with the same name and size are skipped, so repeat exports are much faster. A file with the same name but a different size is copied again — My Computer export used to skip on the name alone; fixed in v1.0.10.
- 컨트롤러 키 설정 포함 — 6장에서 만든 시스템·게임별 입력 설정을 함께 내보냅니다. RetroArch가 없는 기기에서는 무시됩니다. 리맵 경로는 자동으로 잡히고, 필요하면 직접 지정할 수 있습니다.Include controller mappings — exports the per-system/per-game input configs from chapter 6. Ignored on devices without RetroArch. The remap path is detected automatically, or you can set it yourself.
- PS Vita — .vpk 를 풀어 기기의 Vita3K 앱 폴더로 바로 설치합니다. 이미 설치된 타이틀은 건너뛰고, 기기에 Vita3K가 없으면 수 GB를 헛되게 보내지 않고 미리 알려 줍니다.PS Vita — .vpk files are unpacked straight into the device's Vita3K app folder. Already-installed titles are skipped, and if Vita3K is missing you're told up front instead of wasting a multi-GB transfer.
전송이 시작되면 단계별 진행률이 표시됩니다. 큰 ROM 파일은 게임파일명 (234MB / 764MB) [3/91] 처럼 바이트 단위로 진행 상황이 보이고, 취소도 가능합니다.Once transfer starts you get per-phase progress. Large ROMs report byte-level progress like game.zip (234MB / 764MB) [3/91], and you can cancel at any time.
09 — HB LAUNCHER
HB런처로 보내기Send to HB Launcher
HB런처는 게임 케이스를 3D로 진열하는 자매 프로젝트 런처입니다. 해방툴에서 세팅한 라이브러리(롬 · 미디어 · 한국어 정보)를 ⬆ 내보내기 → HB런처 내보내기(v1.0.7 부터 내보내기 버튼 아래로 들어갔습니다) 한 번으로 기기의 런처 폴더에 밀어 넣습니다 — 런처 쪽에서 다시 매칭할 필요가 없습니다. 숨김으로 둔 게임은 여기서도 빠집니다.HB Launcher is the sister project that shelves your games as 3D cases. ⬆ Export → HB Launcher export (it moved under the Export button in v1.0.7) pushes a library set up in the Rom Tool (ROMs, media, Korean metadata) straight into the launcher folder on the device — nothing to re-match on the launcher side. Games you have hidden are skipped here too.
- 연결 방식 — 유선 연결 (ADB)은 내보내기의 안드로이드 연결과 같습니다(USB 디버깅 허용 후 기기 연결). 무선 연결 (APP)은 기기에서 HB런처 앱이 켜 주는 서버로 붙습니다 — 계정·포트는 고정이라 앱 화면에 표시된 IP만 입력합니다.Connection — USB (ADB) is the same link the Android export uses (allow USB debugging, then Connect device). Wireless (APP) connects to the server the HB Launcher app runs on the device — account and port are fixed, so you only enter the IP shown in the app.
- 롬 경로 (기기) — 연결하면 자동으로 채워집니다(ES-DE가 있으면 그 롬 폴더). 라이브러리는 그 저장소의 HBLauncher 폴더에 만들어지고(SD 카드 롬이면 SD 카드에), 시스템별 내보내기 폴더 · 롬 경로는 ES-DE 내보내기와 같은 값을 씁니다.ROMs path (device) — auto-filled on connect (the ES-DE ROM folder if present). The library is created in an HBLauncher folder on that storage (on the SD card if the ROMs are there), and per-system export folders / ROM paths are shared with the ES-DE export.
- 제목 · 설명 언어 — 런처에 보일 제목과 설명을 각각 한글/영문으로.Title & description language — Korean or English for what the launcher shows.
- 게임 목록 처리 — 병합은 기기 목록을 유지하면서 같은 게임은 갱신하고 없던 게임은 더합니다. 동기화는 체크한 시스템만 이 앱의 목록으로 통째로 교체하고, 그 시스템의 런처 미디어 중 목록에 없는 파일을 정리합니다. 체크하지 않은 시스템은 두 경우 모두 그대로 두며, 롬 파일은 어느 경우에도 지우지 않습니다.Game list handling — Merge keeps the device list, updating games it already has and adding new ones. Sync replaces only the checked systems with this app's list and removes launcher media files of those systems that are no longer listed. Unchecked systems are left alone either way, and ROM files are never deleted.
- 미디어가 겹칠 때 — 병합에서만 나옵니다. 신규 우선은 해방툴 미디어로 덮어쓰고, 기존 우선은 기기에 있던 파일을 남깁니다(동기화는 늘 신규 우선).When media already exists — merge only. New wins overwrites with HAE-BANG media; Keep existing leaves the device's files (Sync always uses the new media).
- 영상 내보내기 — 기본 꺼짐. 켜면 플레이 영상을 런처용(20초 .ogv)으로 변환해 보내는데 게임당 2~3초씩 걸립니다(한 번 변환한 것은 다음에 건너뜀). 끄면 런처의 TV에는 스크린샷이 뜹니다. 동기화와 함께 끄면 기기에 있던 영상도 정리 대상이 되니 주의하세요.Export videos — off by default. On, gameplay videos are converted for the launcher (20 s .ogv) at 2–3 s per game (already-converted ones are skipped next time). Off, the launcher's TV shows the screenshot instead — and combined with Sync, videos already on the device are cleaned up too.
- 내보낼 시스템 — 오른쪽 목록에서 체크합니다. 런처가 케이스를 만들 수 있는 기종만 고를 수 있습니다.Systems to export — tick them in the right-hand list; only systems the launcher can build cases for are selectable.
미디어는 3D 케이스를 세우는 데 필요한 것들로 정해져 있어 고르지 않습니다 — 케이스 펼침(boxtexture) · 매체 사진(support) · 앞표지 · 책등(사이드바) · 설명서 표지 · 스크린샷. 기기용으로 줄여서 보내고, 한 번 만든 것은 다음 내보내기에서 건너뜁니다. 롬은 이름·크기가 같으면 건너뛰므로 두 번째부터는 빠릅니다.Media is a fixed set needed to build the 3D case — box texture, support photo, cover, spine (sidebar), manual cover and screenshot — downscaled for the device; already-built files are skipped next time, as are ROMs with the same name and size, so repeat exports are quick.
10 — IMPORT
가져오기Import
내보내기의 반대 방향입니다. 이미 다른 프론트엔드로 세팅해 둔 라이브러리를 이 프로그램으로 읽어들여 시스템과 게임을 한 번에 등록합니다. ROM 폴더를 처음부터 다시 스캔할 필요가 없습니다. 시스템 목록의 + 시스템 → 외부 세팅 정보 (가져오기)로 엽니다.The reverse of Export. Read a library you already set up in another front-end and register its systems and games in one pass — no need to re-scan your ROM folders from scratch. Open it via + System → External library (Import) in the system list.
지원하는 원본은 ES-DE(gamelist.xml)와 Pegasus(metadata.pegasus.txt)이며, 읽어올 위치는 내 컴퓨터 · 안드로이드 · 커스텀 리눅스(SFTP) 세 곳입니다.Supported sources are ES-DE (gamelist.xml) and Pegasus (metadata.pegasus.txt), read from this PC, Android, or custom Linux (SFTP).
내 컴퓨터에서 가져오기From this PC
- ES-DE — ES-DE/gamelists 폴더를 고릅니다. ES-DE 루트를 골라도 알아서 찾습니다. 미디어는 downloaded_media 규약을 따라 자동으로 연결됩니다.ES-DE — pick the ES-DE/gamelists folder (picking the ES-DE root works too). Media is matched automatically via the downloaded_media convention.
- Pegasus — 시스템 폴더들의 상위 폴더를 고르거나, 자동 감지로 설정 폴더(%LOCALAPPDATA%\pegasus-frontend)를 찾게 합니다. 설정 폴더를 고르면 game_dirs.txt에 등록된 게임 폴더들을 따라갑니다.Pegasus — pick the parent folder of your system folders, or hit Auto to locate the config folder (%LOCALAPPDATA%\pegasus-frontend). From there it follows the game folders listed in game_dirs.txt.
- 롬 루트 폴더 — 자동으로 추정하지만 맞지 않으면 직접 고칠 수 있습니다. 페가수스 롬 디렉토리에서 어느 시스템인지 알아보는 인식률이 v1.0.7 에서 높아졌고(nes · snes · segacd 같은 다른 철자도 v1.0.6 부터 알아봅니다), 시스템을 잘못 짚은 줄은 가져오기 전에 고를 수 있습니다.ROM root folder — auto-guessed, and editable if the guess is off. v1.0.7 improved how reliably Pegasus ROM directories are recognised as systems (alternate spellings like nes, snes, segacd have been understood since v1.0.6), and a mis-identified row can be corrected before importing.
- 아케이드 폴더(v1.0.9) — 프론트엔드가 아케이드를 arcade · neogeo · cps1 · cps2 · cps3 · naomigd · stv … 로 나눠 둔 것도 아케이드 시스템으로 알아봅니다(전에는 '미지원'으로 잡혀 매칭 · 메타 · 미디어가 붙지 않았습니다). game.zip 옆의 game/ CHD 데이터 폴더는 게임 하나로 접습니다.Arcade folders (v1.0.9) — front-ends that split arcade into arcade, neogeo, cps1, cps2, cps3, naomigd, stv … are now recognised as arcade systems (they used to come in as unsupported, with no matching, metadata or media). A game/ CHD data folder next to game.zip is folded into that one game.
기기에서 가져오기From a device
기기의 라이브러리를 지정한 로컬 폴더로 복제한 뒤, 그 파일을 기준으로 등록합니다. 원본 기기는 읽기만 합니다.The device library is copied into a local folder you choose, then imported from those files. The device itself is only read.
- 복제 대상 폴더를 지정합니다. 롬과 미디어가 이 폴더에 저장됩니다.Choose the destination folder — ROMs and media are copied here.
- 기기 검색을 누르면 메타파일만 먼저 빠르게 받아 시스템 목록을 보여줍니다. 게임 수도 함께 표시됩니다.Hit Scan device — only the metadata files are fetched first, giving you the system list with game counts.
- 가져올 시스템을 체크하고 표시이름 접두를 정한 뒤(예: [Android]) 실행합니다. 선택한 시스템의 롬·미디어만 내려받습니다.Check the systems you want, set a display-name prefix (e.g. [Android]) and run. Only the selected systems' ROMs and media are pulled.
| 가져올 위치Source device | 지원 원본 · 준비물Supported sources · requirements |
|---|---|
| 안드로이드Android | ES-DE 와 Pegasus 모두 가져올 수 있습니다. USB 연결 + 파일전송(MTP)·USB 디버깅 허용 상태여야 합니다.Both ES-DE and Pegasus. Requires USB connection with file transfer (MTP) and USB debugging allowed. |
| 커스텀 리눅스(SFTP)Custom Linux (SFTP) | EmulationStation 계열 구조(<시스템>/gamelist.xml)를 읽습니다. muOS · OnionOS · 순정 OS(RG34xxSP · TSP)는 기기가 목록을 만드는 방식 그대로(muOS 이름 json · miyoogamelist.xml · 게임 폴더) 읽습니다(v1.1.0). IP·계정·비밀번호와 원격 롬 경로가 필요합니다.Reads the EmulationStation-family layout (<system>/gamelist.xml). muOS, OnionOS and stock OS (RG34xxSP, TSP) are read the way the device builds its list (muOS name json, miyoogamelist.xml, the game folders) (v1.1.0). Needs IP, account, password and the remote ROM path. |
11 — DEVICE BROWSER
기기 탐색기 · 파일 편집Device Browser & File Editing
안드로이드(ADB) 또는 SFTP로 연결한 뒤 📂 탐색을 누르면 기기 내부를 직접 둘러볼 수 있습니다. 내보내기 화면에서 롬 경로를 눈으로 확인하고 지정할 때 가장 요긴합니다.Connect over Android (ADB) or SFTP, then hit 📂 Browse to explore the device. It's most useful for seeing and picking the ROM path during export.
- 폴더 작업 — 새 폴더 만들기, 복사·잘라내기·붙여넣기, 삭제, 여러 항목 선택.Folder operations — new folder, copy / cut / paste, delete, multi-select.
- 이 폴더로 지정 — 현재 보고 있는 폴더를 롬 경로로 바로 설정합니다. 시스템별 롬 경로도 각 행의 작은 📁 버튼으로 이렇게 지정할 수 있습니다.Use this folder — sets the folder you're viewing as the ROM path. Per-system ROM paths can be picked the same way via the small 📁 button on each row.
- 텍스트 파일 편집 — 파일을 더블클릭하면 내용을 보고 고쳐서 저장할 수 있습니다. gamelist.xml·.cfg·.ini·.m3u 같은 설정 파일을 기기에서 빼내지 않고 바로 손볼 때 편리합니다. 자동 줄바꿈 토글과 Ctrl+S 저장을 지원합니다.Text file editing — double-click a file to view, edit and save it. Handy for tweaking gamelist.xml, .cfg, .ini or .m3u right on the device. Word-wrap toggle and Ctrl+S are supported.
12 — TOOLS
도구 — APK 보관함 · 게임저장 공유 · BIOS 점검Tools — APK Library · Game Saves · BIOS Check
상단 바의 Tools는 롬 정리 밖에서도 쓸모 있는 기능을 모아 두는 자리입니다(베타 v1.0.4에서 생김). 첫 도구는 안드로이드 APK 보관함 — 기기에 깔아 줄 에뮬레이터·프론트엔드 APK를 한곳에 모아 두고 바로 설치합니다.Tools in the top bar collects features useful beyond ROM curation (introduced in beta v1.0.4). The first is the Android APK Library — keep the emulator and front-end APKs you install on devices in one place and install them directly.
- APK 가져오기 — 받아 둔 APK를 끌어다 넣거나 골라 넣으면 해방툴 폴더로 복사되므로 원본은 지워도 됩니다. 파일 안에서 이름 · 패키지 · 버전을 읽어 정리하고, 에뮬레이터라면 어느 기종용인지도 알아봅니다.Import APK — drop in or pick the APKs you have collected; they are copied into the tool folder, so the originals can go. The name, package and version are read from the file, and for emulators the systems they serve are worked out.
- 같은 앱의 여러 버전을 나란히 보관합니다. 새 버전이 말썽이면 예전 버전을 골라 되돌려 깔 수 있습니다.Several versions of one app are kept side by side, so you can roll back if a new build misbehaves.
- 기기에 설치 — 연결을 눌러 USB(ADB) 기기를 붙인 뒤(기기가 여럿이면 고름) 목록에서 바로 설치합니다. 창을 열자마자 기기를 붙잡지 않는 것은 adb가 기기를 깨우거나 USB 디버깅 허용 창을 띄우는 일이 있어서입니다.Install to device — press Connect to attach the USB (ADB) device (choose one if several) and install straight from the list. The window doesn't grab the device on open because adb can wake the device or pop the USB-debugging prompt.
- 보관 폴더 열기 — 복사된 APK가 있는 폴더를 탐색기로 엽니다.Open folder — reveals the folder holding the copied APKs in Explorer.
세이브 가져오기·내보내기 (게임저장 공유) — v1.0.5Save import & export (game save sharing) — v1.0.5
Tools의 두 번째 시트입니다. 앱에 추가한 시스템과는 무관하게, PC나 기기에 실제로 깔린 에뮬레이터의 세이브를 훑어 한곳에 모으고 다른 기기로 보냅니다. 새 게임기로 갈아탈 때 진행 상황을 그대로 들고 가는 용도입니다.The second Tools sheet. Independent of the systems you added, it scans the saves of emulators actually installed on your PC or device, gathers them in one place and sends them to another device — so a new handheld starts where the old one left off.
- 스캔 — 로컬은 프론트엔드(ES-DE/Pegasus)나 에뮬레이터 폴더를 골라 훑고, 안드로이드는 USB로 붙은 기기 전체를 훑습니다(설치된 에뮬레이터를 찾아 차례로). RetroArch와 스탠드얼론 에뮬레이터를 다룹니다.Scan — locally, pick a front-end (ES-DE/Pegasus) or emulator folder; on Android the whole USB-connected device is scanned, emulator by emulator. RetroArch and standalone emulators are covered.
- 식별 — 세이브 이름(롬 파일명)을 그 기기의 게임 목록 → 마스터 DB 롬 색인 → 코어가 말하는 기종 안에서의 흐린 매칭 순으로 되짚어 어느 게임 것인지 붙입니다. 한글 패치판처럼 이름이 조금 다른 것도 잡히고, 못 찾아도 목록에는 이름 그대로 올라갑니다.Identify — the save name (ROM filename) is traced through the device's game list → the master ROM index → fuzzy matching within the system the core belongs to. Slightly different names (e.g. translation patches) still match; unmatched saves are listed by name.
- 보관함 — 같은 파일은 한 벌만 남습니다. 종류·기종·저장 에뮬로 거르고 정렬할 수 있으며, 보관함에서 지워도 기기의 세이브는 그대로입니다.Library — identical files are kept once. Filter and sort by kind, system and emulator; deleting from the library never touches the device.
- 내보내기 — 고른 세이브를 대상 기기의 저장 에뮬레이터에 맞는 자리(코어별 세이브 폴더)로 씁니다. 같은 이름이 이미 있으면 덮기 전에 보관함으로 먼저 담습니다. 폴더 하나가 세이브 하나인 형식은 폴더째 다룹니다.Export — writes the chosen saves to the right folder for the target's emulator (per-core save folders). An existing save with the same name is archived before being overwritten; folder-type saves move as a whole.
BIOS 점검 — v1.0.10BIOS check — v1.0.10
Tools 의 세 번째 시트입니다. 연결한 기기의 BIOS 폴더를 훑어, 시스템마다 필요한 BIOS 가 제자리에 있는지 파일 내용(MD5)까지 확인합니다. 게임이 켜지지 않는 문제를 미리 짚어 보는 용도이며, 기기에는 아무것도 쓰지 않습니다(읽기만). 기준은 libretro 의 BIOS 목록(파일 이름 · 크기 · MD5)입니다.The third Tools sheet. It scans the BIOS folders of a connected device and checks, system by system, that each required BIOS is in the right place — down to the file contents (MD5). Use it to catch games that won't boot before you run into them; nothing is written to the device (read-only). The reference is libretro's BIOS list (file name, size, MD5).
- 연결 — 안드로이드 (USB) 또는 리눅스 기기 (Wi-Fi)(주소 · 사용자 · 비밀번호)를 고르고 점검 시작을 누릅니다.Connect — choose Android (USB) or Linux device (Wi-Fi) (address, user, password) and press Start check.
- 보는 자리 — 안드로이드는 RetroArch 의 system 폴더와 NetherSX2 · DuckStation 앱 폴더(앱에서 바꾼 폴더도 따라감), 리눅스 기기는 OS 의 bios 폴더입니다. 흔히 잘못 두는 자리도 함께 훑습니다.Where it looks — on Android, RetroArch's system folder plus the NetherSX2 and DuckStation app folders (following a folder changed inside the app); on Linux devices, the OS bios folder. Common wrong spots are scanned too.
- 결과 — 시스템마다 정상 · 확인 필요 · 부족으로 판정하고, 문제가 있는 시스템이 위로 올라와 펼쳐져 있습니다. BIOS 는 필수 · 권장 · 선택으로 나뉘고, 게임이 있는 시스템만으로 걸러 볼 수 있습니다.Results — each system is rated OK · Check · Missing, with problem systems moved to the top and expanded. BIOS files are marked required · recommended · optional, and Only systems with games narrows the list.
| 파일 판정File verdict | 뜻Meaning |
|---|---|
| 있음Found | 이름과 내용(MD5)이 맞는 파일이 제자리에 있습니다.The right file, with matching contents (MD5), is in place. |
| 있음 (다른 판본)Found (other version) | 제자리에 있고 크기도 같지만 내용이 다른 판본입니다. 아케이드 BIOS zip 은 롬셋마다 달라 늘 이렇게 나옵니다.In place and the same size, but a different dump. Arcade BIOS zips differ per romset, so they always show this. |
| 크기가 다름Size differs | 제자리에 있지만 크기까지 달라, 손상됐거나 엉뚱한 파일일 수 있습니다.In place but a different size — it may be damaged or the wrong file. |
| 대소문자가 다름Wrong letter case | 리눅스 기기에서 이름의 대소문자만 다릅니다. 알려 주는 이름으로 바꾸세요.On a Linux device only the letter case of the name is off — rename it as shown. |
| 다른 폴더에 있음In another folder | 파일은 있는데 에뮬레이터가 보지 않는 폴더에 있습니다. 옮길 위치를 알려 줍니다.The file exists, but in a folder the emulator doesn't read — it tells you where to move it. |
| 없음Missing | 어디에서도 찾지 못했습니다.Not found anywhere. |
펌웨어 · 키 — PS Vita(Vita3K) · Switch(Eden · Citron · Sudachi · Yuzu 등) · PS3(aPS3e · RPCSX) · Wii U(Cemu, 키는 선택)는 BIOS 파일 대신 에뮬레이터에 펌웨어·키가 설치돼 있는지 확인하고, 설치된 판(버전)도 보여 줍니다. 에뮬레이터가 없으면 앱 없음으로 표시합니다. 리눅스 기기에서는 Batocera 계열만 확인합니다.Firmware · keys — for PS Vita (Vita3K), Switch (Eden, Citron, Sudachi, Yuzu …), PS3 (aPS3e, RPCSX) and Wii U (Cemu; keys optional) it checks that firmware and keys are installed in the emulator instead of BIOS files, and shows the installed version. Without the emulator it reads No app. On Linux devices this is checked on the Batocera family only.
13 — PRO EDITION
PRO 에디션PRO edition
PRO 는 후원자께 발급하는 PRO 업그레이드 키로 활성화합니다. 헤더의 PRO UPGRADE 단추에 키를 넣으면 그 PC 가 PRO 가 되고, 이후 새 버전을 설치해도 PRO 로 유지됩니다. 키는 받은 뒤 48시간 안에 넣어야 하며, 키 하나는 PC 한 대에서만 쓸 수 있습니다(같은 PC 에 다시 설치하는 것은 괜찮고, 다른 PC 로는 옮겨지지 않습니다). 윈도우 재설치나 서브 PC 등으로 필요하시면 요청해 주세요 — 2~3회 정도 추가 발급해 드립니다. 일반판에서 PRO 기능 단추를 누르면 PRO 안내 창이 뜹니다. 지금 PRO 기능은 아래 세 가지이고, 베타 업데이트와 함께 계속 보완되고 더해집니다.PRO is activated with a PRO upgrade key issued to sponsors. Enter it with the PRO UPGRADE button in the header and that PC becomes PRO — and stays PRO when you install later versions. A key must be entered within 48 hours of receiving it and works on one PC only (reinstalling on the same PC is fine; it does not move to another PC). If you reinstall Windows or want it on a second PC, just ask — two or three extra keys can be issued. In the standard edition, pressing a PRO feature button shows the PRO notice. The PRO features today are the three below, and they keep growing with the beta.
- 외부 기기로 전환 — 안드로이드(USB) · 리눅스 휴대용 기기(Wi-Fi)에 직접 붙어 그 기기의 게임 목록 · 메타 · 미디어를 바로 편집Switch to device — attach to an Android (USB) or Linux handheld (Wi-Fi) and edit its game list, metadata and media in place
- 게임 아카이브로 전환 — 롬 없이도 모든 시스템의 게임 목록 · 메타 · 미디어를 해방툴 안에서 보기Switch to game archive — browse every system's games, metadata and media inside the Rom Tool, no ROMs needed
- HB파일 (.hbs) — 로컬 시스템 셋을 파일로 저장 · 불러오기(자동 보관본 · 되돌리기)HB file (.hbs) — save and load your local system sets as a file (automatic archives, restore)
외부 기기로 전환Switch to device
헤더의 외부 기기로 전환을 누르면 해방툴이 외부 기기(안드로이드 · 리눅스 커스텀 OS)에 직접 붙어, 그 기기의 ES-DE·페가수스 게임 목록을 그대로 해방툴 게임 목록으로 보여 줍니다. PC 에 복제해 오는 가져오기와 달리 기기 자체가 라이브러리입니다 — 메타 정보 편집, 미디어 업데이트, 재스캔, 실행기 설정, 게임 추가·삭제를 기기에 붙은 채로 바로 합니다. 해방툴을 쓰는 PC 가 허브 역할을 하기 어려울 때(하드디스크 여유가 없을 때 등), 또는 특정 기기만 빠르게 손보고 싶을 때 쓰는 모드입니다.Press Switch to device in the header and the Rom Tool attaches directly to an external device (Android or custom Linux OS), showing that device's ES-DE / Pegasus game list as-is as its own library. Unlike Import, which copies to the PC, the device itself is the library — edit metadata, update media, rescan, set up launchers and add or remove games while attached. It is the mode for when your PC cannot act as the hub (no disk space, say) or you just want to touch up one device quickly.
- 연결 방식 — 케이블로 붙은 안드로이드(USB 디버깅 필요), 또는 같은 Wi-Fi 에 있는 리눅스 핸드헬드(SFTP — IP · 계정 · 비밀번호): Batocera · KNULLI · ROCKNIX · JELOS · ArkOS 의 EmulationStation 목록(v1.0.9), muOS · OnionOS · 순정 OS(RG34xxSP · TSP)의 게임 폴더(v1.1.0). Wi-Fi 기기도 USB 와 똑같이 다룹니다.Connection — Android over cable (USB debugging required), or a Linux handheld on the same Wi-Fi (SFTP with IP, user and password): the EmulationStation library of Batocera, KNULLI, ROCKNIX, JELOS and ArkOS (v1.0.9), or the game folders of muOS, OnionOS and stock OS (RG34xxSP, TSP) (v1.1.0). Wi-Fi devices are handled exactly like USB.
- 기기 연결 — 붙으면 기기에 깔린 프론트엔드를 찾아 "설치됨 · 볼 수 있음"으로 보여 줍니다.Connect device — once attached, the front-ends installed on the device are listed as "installed · viewable".
- 프론트엔드 고르기 — 어느 프론트엔드의 목록을 볼지 고르면 그 라이브러리가 기기 시트로 열립니다.Pick a front-end — choose whose list to view and that library opens as the device sheet.
v1.0.8 에서 더해진 것
Added in v1.0.8
- 등록 안 된 롬 폴더 자동 감지 — 해방툴이 기기의 롬 폴더 경로를 추적해, ES-DE·페가수스에 메타로 등록되지 않은 롬 폴더를 찾아 시스템으로 추가할 수 있게 합니다.Unregistered ROM folders detected — the Rom Tool tracks the device's ROM folders and finds ones ES-DE / Pegasus have no metadata for, so you can add them as systems.
- 모드 전환 — 한 기기에 ES-DE 와 페가수스가 둘 다 세팅되어 있으면, 다시 붙지 않고 다른 프론트엔드의 목록으로 바로 넘어가는 버튼이 생깁니다.Mode switch — if a device has both ES-DE and Pegasus set up, a button jumps straight to the other front-end's list without reconnecting.
- 페가수스 편집 — 페가수스 프론트엔드의 메타 데이터와 미디어도 기기에서 바로 고칩니다.Pegasus editing — Pegasus metadata and media can be edited on the device as well.
- [롬 없음] 배지 — 게임 정보만 있고 롬 파일은 없는 항목에 붙습니다. 같은 이름의 롬을 넣으면 사라집니다.[no ROM] badge — marks entries that have game info but no ROM file; it clears once a ROM of that name is added.
- 리전 순위 · 롬 삭제 — 기기 시트에서도 기본적인 리전 우선순위와 롬 파일 삭제가 됩니다.Region priority · ROM deletion — basic region priority and ROM file deletion work on the device sheet too.
v1.0.9 에서 더해진 것
Added in v1.0.9
- Wi-Fi(SFTP) 리눅스 핸드헬드 — Batocera · KNULLI · ROCKNIX · JELOS · ArkOS 의 EmulationStation 목록을 USB 연결과 똑같이 다룹니다. 빈 시스템 폴더가 많은 기기(ROCKNIX 등)도 빠르게 엽니다.Wi-Fi (SFTP) Linux handhelds — the EmulationStation lists of Batocera, KNULLI, ROCKNIX, JELOS and ArkOS are handled exactly like a USB connection, and devices with many empty system folders (ROCKNIX and others) open quickly.
- 기기에서 M3U 병합 — 로컬과 같은 규칙으로 기기에 .m3u 를 만들고 목록 · 미디어를 한 게임으로 묶습니다. ES-DE 와 페가수스 모두 메타 정보까지 함께 고칩니다.M3U merge on the device — builds the .m3u on the device by the same rules as locally and folds list entries and media into one game, fixing the metadata for both ES-DE and Pegasus.
- 파일 교체 — 기기의 파일을 이 PC 의 파일로 바꿉니다(2장).Replace file — swap a file on the device for one on this PC (chapter 2).
- 탐색기와 목록이 이어집니다 — 기기 시트의 탐색기에서 파일을 지우거나 옮기면 목록이 곧바로 [롬 없음]으로 바뀝니다.Explorer and list stay in step — deleting or moving a file in the device sheet's explorer flips the entry to [no ROM] at once.
- 재스캔 · 롬 추가의 미디어 — 내보내기처럼 자리 ← 소스로 고릅니다(프론트엔드마다 미디어 자리가 달라서).Media for rescan and adding ROMs — chosen as slot ← source, just like export (each front-end has its own media slots).
- USB 가 빠지면 — 알리고 스스로 로컬 라이브러리로 돌아갑니다.If the USB cable comes out — you are told, and the tool returns to the local library on its own.
v1.0.10 에서 달라진 것
Changed in v1.0.10
- 시스템을 더 빨리 엽니다 — 시스템을 열 때 롬 폴더 안의 미디어(media/ · images/ 등)까지 전부 읽던 것을, 게임 목록에 필요한 롬만 읽도록 바꿨습니다. 대형 MAME 폴더처럼 파일이 많은 시스템에서 특히 빨라집니다. 읽는 동안엔 목록 자리에 "기기에서 게임 목록을 읽는 중..." 이 뜹니다.Systems open faster — opening a system used to read every media file in the ROM folder (media/, images/ …) as well; now only the ROMs the game list needs are read. Especially quicker on file-heavy systems such as a large MAME folder. While it reads, the list area shows "Reading the game list from the device...".
- 시스템 목록 — 제조사 - 기종처럼 긴 이름은 두 줄로 나눠 보여 주고, 목록이 길어 스크롤바가 생겨도 오른쪽의 게임 수 · 재스캔 단추가 가려지지 않습니다.System list — long names such as Maker - Model wrap onto two lines, and the game count and rescan button on the right stay visible even when a scrollbar appears.
- 게임 수 — 목록 옆 게임 수가 실제로 열었을 때의 개수와 다르게 나오던 문제를 고쳤습니다. 시스템을 열면 목록이 센 실제 수로 맞춰집니다.Game count — the count beside the list could differ from what you saw on opening the system; opening it now corrects the count to the real number.
- 재스캔 창 — [재스캔]을 누르면 한참 뒤에야 뜨던 창이 바로 뜹니다. 창을 열면 그 시스템이 기기에 이미 가진 미디어 종류가 기본으로 체크되고(ES-DE · 페가수스 · EmulationStation 모두), 재스캔은 체크한 미디어만 받습니다 — 전에는 체크하지 않은 미디어까지 받았습니다.Rescan dialog — it opens straight away instead of after a long wait. It preselects the media kinds that system already has on the device (ES-DE, Pegasus and EmulationStation alike), and the rescan fetches only the media you tick — before, unticked media was downloaded too.
- [롬없음만] — 로컬 게임 목록과 같은 걸러 보기 단추가 기기 시트에도 있습니다(2장).[No ROM] — the same filter button as in the local game list is on the device sheet too (chapter 2).
v1.1.0 에서 더해진 것
Added in v1.1.0
- muOS · OnionOS · 순정 OS 기기 시트 — 목록 파일이 다른 꼴인 리눅스 핸드헬드도 기기가 목록을 만드는 방식 그대로 읽고 씁니다. muOS 는 게임 폴더 + 이름 json + catalogue 그림·설명, OnionOS 는 miyoogamelist.xml 에 적힌 게임(없으면 폴더의 롬) + Imgs/, 순정 OS 는 게임 폴더(이름은 파일 이름) + Imgs/.muOS, OnionOS and stock OS device sheets — Linux handhelds with their own list formats are read and written the way the device builds its list: muOS = game folders + name json + catalogue art and descriptions, OnionOS = the games in miyoogamelist.xml (or the folder's ROMs) + Imgs/, stock OS = game folders (names are file names) + Imgs/.
- 할 수 있는 것 — 보기 · 메타 편집 · 재스캔 · 롬 추가 · 삭제 · 파일 교체 · 시스템 추가/삭제. M3U 묶기는 OnionOS 만 됩니다(muOS · 순정 OS 는 폴더의 파일을 모두 보여 줘서 묶어도 디스크가 따로 보입니다).What you can do — view, edit metadata, rescan, add ROMs, delete, replace files, add/remove systems. M3U grouping works on OnionOS only (muOS and stock OS list every file in the folder, so discs would still show separately).
- 기기에서 할 일 — muOS · 순정 OS 는 게임 목록에 다시 들어가면 보입니다(muOS 한글 이름은 기기 언어가 한국어일 때). OnionOS 는 Games 탭에서 SELECT → Refresh All Roms 를 한 번 해 주세요.On the device — on muOS and stock OS, re-enter the game list (muOS shows Korean names only with the Korean language). On OnionOS, run SELECT → Refresh All Roms on the Games tab once.
- Wi-Fi 가 끊겨도 — 잠깐 끊기면 스스로 다시 연결해 이어서 하고, 끝내 연결이 안 되면 반쯤 읽은 목록으로 열지 않습니다.If Wi-Fi drops — a short drop reconnects and carries on; if the device cannot be reached again, a half-read list is never opened.
게임 아카이브로 전환 — v1.0.9Switch to game archive — v1.0.9
헤더의 게임 아카이브를 누르면 해방툴이 아는 모든 시스템 · 모든 게임을 훑어보는 시트가 열립니다. 롬을 추가하지 않아도 어떤 기종에 어떤 게임이 있는지, 그 게임의 메타 정보와 미디어가 어떤지 해방툴 안에서 바로 확인합니다. 호박색 틀과 "게임 아카이브 · 보기 전용" 배지로 구분되며, 로컬로 돌아가기로 내 라이브러리에 돌아옵니다.Press Game archive in the header to open a sheet that browses every system and every game the Rom Tool knows. No ROMs needed — see which games exist for which system, and what their metadata and media look like, right inside the tool. An amber frame and a "Game archive · view only" badge set it apart, and Back to Local returns you to your own library.
- 보기 전용 — 목록은 바뀌지 않고, 재스캔 · 리전 · 삭제 같은 고치는 단추가 없습니다. 파일 열은 숨깁니다(거기 값은 파일 이름이 아니라 게임 번호라서).View only — the list never changes and there are no editing buttons (rescan, region, delete). The File column is hidden, since its value is a game number, not a filename.
- 미디어는 필요할 때만 — 게임을 고르면 정보와 믹스 이미지를 곧바로 받고, 나머지 탭 · 영상 · 매뉴얼은 누를 때 한 장씩 받습니다.Media on demand — picking a game fetches its details and mix image straight away; other tabs, video and manual are fetched one at a time when you open them.
- v1.0.10 — 게임을 고르면 제목 대신 id 같은 값이 보이던 문제를 고쳤습니다.v1.0.10 — fixed an id-like value showing in place of the title when a game is selected.
HB파일 (.hbs)HB file (.hbs)
시스템 목록 제목 옆의 작은 HB파일 버튼입니다. 로컬로 추가한 시스템의 저장 정보(시스템 · 게임 · 메타)를 .hbs 파일 하나로 파일로 저장…하고, 파일에서 불러오기…로 되살립니다. 나만의 시스템 셋을 파일 단위로 관리하는 용도입니다 — PC 를 옮기거나, 용도별 셋(거실용 · 휴대용)을 바꿔 끼우거나, 손보기 전 상태를 남겨 둘 때.The small HB file button next to the system-list title. It saves the systems you added locally (systems, games, metadata) as a single .hbs file with Save to file… and restores them with Load from file… — a way to manage your own system sets one file each: moving to another PC, swapping between sets (living room vs. handheld), or keeping a snapshot before a big clean-up.
- 자동 보관본(v1.0.8) — 파일에서 불러올 때 불러오기 직전의 라이브러리를 자동으로 보관본으로 남깁니다. 잘못 불러왔어도 이걸로 되돌리기로 돌아갈 수 있습니다.Automatic archives (v1.0.8) — loading a file first archives the library as it was just before. If the load was a mistake, Restore this brings it back.
- 보관본 관리 — 보관본…에서 목록을 보고 되돌리거나 지우고, 폴더 열기로 보관 폴더를 탐색기에서 엽니다.Archive management — Archives… lists them for restore or deletion, and Open folder reveals the archive folder in Explorer.
- 목록에 없는 파일 정리 (전체 교체) — 불러온 파일에 없는 시스템을 어떻게 할지 모두 남김 / 모두 삭제로 정합니다.Clean up files not in the list (replace all) — decide what happens to systems the loaded file does not contain: keep all or delete all.
14 — MORE
후원 · 업데이트Support · Updates
이 프로그램은 개발자 1인이 기획·개발·DB 구축·서버 운영·테스트까지 모두 맡고 있습니다. 도움이 되었다면 후원 ♥ 버튼으로 작은 응원을 보내 주세요. 후원하시면 스폰서 코드가 발급되고, 그 코드로 후원자 베타를 받으실 수 있습니다 — 마이너 업데이트(v1.1.0 제공 중 → v1.1.1 …)를 계속 받고, 시스템 제외가 없으며, 새 기능이 가장 먼저 도착하는 곳입니다. 후원은 미디어 서버와 마스터 DB를 유지하는 데 쓰입니다.This tool is built by a single developer handling planning, development, database, server ops and testing. If it helped you, consider a small token of support via the Donate ♥ button. Sponsoring issues a sponsor code that unlocks the sponsor beta — continuous minor updates (v1.1.0 available now → v1.1.1 …), no systems left out, and where new features land first. Donations keep the media server and master database running.
새 버전 확인 — 현재 버전은 상단 바의 앱 이름 옆에 표시됩니다(BETA · PLUS+ 배지도 함께). 앱 내 자동 업데이트 알림은 준비 중이라, 새 버전 소식은 새로운 소식 페이지와 다운로드에서 확인해 주세요.Checking for updates — your current version is shown next to the app name in the top bar (with BETA / PLUS+ badges). In-app update notifications are still in the works, so please watch the News page and the download page for new releases.