게임 및 에뮬레이터 프론트엔드 Pegasus Frontend 설치와 메타데이터 파일 작성하기 - 윈도우11

Pegasus Frontend

Pegasus는 Steam등 게임 플랫폼과 각종 콘솔 에뮬레이터의 프론트엔드(Frontend) 프로그램입니다. 에뮬레이터 초보자들에게는 프론트엔드라는 용어가 생소할 수 있습니다만, 쉽게 말해서 PC에 여기저기 흩어져 있는 게임들을 한곳에 모아주는 껍데기와 같은 것 입니다. 웹기술의 프론트엔드 처럼 앞쪽에 보여지는 것을 담당하는 것이지요.

 

에뮬레이터 프론트엔드의 종류는 여러가지가 있는데 코어를 단일화하여 통일된 인터페이스를 제공하는 Retroarch가 유명한데 Pegasus는 그런 방식은 아니고 구동은 개별 에뮬레이터의 실행기에 맡기고 좀 더 보여지는 측면을 강조합니다. Pegasus는 사용자가 커스터마이즈할 수 있는 도구를 제공하여 완전히 새로운 Theme (테마)을 구성하는 것도 가능합니다.

 

다른 프론트엔드 옵션으로는 LaunchBox도 있는데 취향에 따라 사용하면 좋을 듯 합니다.

Pegasus Frontend 설치

프로그램은 아래 웹사이트에서 설치할 수 있습니다. 최신버전과 스테이블 버전이 있습니다. 여기서는 스테이블 버전을 설치합니다.

 

https://pegasus-frontend.org/#downloads

Pegasus Frontend

참고로 Scoop 패키지 매니저 설치 커맨드는 다음과 같습니다.

scoop bucket add games

scoop install pegasus

다운로드 받아서 압축을 풀면 pegasus-fe 가 실행파일입니다. 이동하기 쉽게 포터블을 만들건데 portable.txt 파일을 만들어서 같은 폴더에 넣습니다. (빈 텍스트 파일이면 된다, 혹은 실행 인자에 --portable을 줘도 되는데 윈도우니까 그냥 portable.txt 파일이 쉽다)

 

그러면 실행시 config 폴더가 생성되어 이 폴더안에 모든 설정 정보를 저장합니다.

 

처음 실행하면 발견된 게임 없음 - 이 나옵니다. Esc키를 누르면 오른쪽에 설정 메뉴로 들어갈 수 있습니다.

 

 

여기서 언어설정, 테마설정, 컨트롤, 게임 디렉토리 설정 등을 할 수 있습니다.

 

 

데이터 소스를 활용한 게임 검색 기능도 있습니다. Steam, GOG, LaunchBox 도 있네요. 이 포스트에서는 자체 에뮬레이터로 설치할 거니까 여기는 그냥 놔두겠습니다.

 

 

게임 추가하기

Pegasus에서는 메타에이타 파일을 작성하여 게임을 추가할 수 있습니다.

메타데이타 파일

메타데이타 파일을 제대로 작성해야 게임이 추가되기 때문에 초보자에게는 난관입니다. 여기서는 SNES 게임을 추가하면서 어떤 식으로 파일관리를 해야하는지 알아봅니다.

 

텍스트 파일인 metadata.pegasus.txt를 만들어서 에뮬레이터 폴더에 넣습니다.

 

여기서 잠깐 폴더 구조를 보면 metadata.pegasus.txt가 있는 폴더에 롬파일이 배치되고 하위 폴더에 에뮬레이터와 Assets(커버 아트 등)을 만들었습니다. Portable한 Pegasus의 사용은 이런 구조가 적당한 것 같습니다. Pegasus의 공식문서에도 보면 이런 식으로 구조를 만든 예시를 보여줍니다.

SNES, NES 등이 실행가능한 Mesen은 아래 사이트에서 다운로드 받을 수 있습니다.

 

https://www.mesen.ca/

Mesen - Emulator

 

메타데이터 파일을 그냥 작성할 수도 있지만 에디터를 사용하면 수월합니다. 아래 깃허브에서 에디터를 다운로드 받아 실행합니다.

 

https://github.com/mmatyas/pegasus-metadata-editor

GitHub - mmatyas/pegasus-metadata-editor: Graphical metadata editor for Pegasus

조금 작성해둔 메타데이터 파일을 열어보겠습니다.

 

아래와 같이 에디터를 쓰면 게임에 대한 정보(메타데이터)를 작성할 수 있습니다. LaunchBox는 이 메타데이터를 다운로드 받는게 자동화 되어 있어서 게임만 추가하면 알아서 잘 찾아주는데 Pegasus는 기본적으로 그런 기능은 없습니다. 대신 스크래이핑 도구들이 별도로 있습니다만, 그건 여기서 다루진 않을 겁니다.

해서 아래와 같이 작성하는데...

메타파일에 관한 Docs를 참고할 필요가 있습니다.

 

https://pegasus-frontend.org/docs/user-guide/meta-files/

Metadata files - Pegasus Docs

여기서 다 설명하기는 복잡한데 지금 작성한 파일의 예시를 보겠습니다. collection 은 게임 기종, 혹은 분류상 묶기 위한 그룹입니다. game은 개별 게임 타이틀입니다. file은 실제 파일 이름이고 assets.box_front는 게임의 프론트 커버입니다. 보통 Box Art(패키지 아트)를 가져다 쓰면 적당하지요.

 

collection 의 launch에는 에뮬레이터의 이름과 파일 이름 {file.path}을 넣어줘서 Pegasus에서 바로 해당 에뮬레이터를 실행할 수 있도록 합니다.

 

여기서 metadata 에디터에서 입력하지 않고 텍스트 파일에 직접 입력한 것은 assets.box_front 입니다. 

collection: Super Nintendo Entertainment System
shortname: SNES
extensions: smc, sfc
launch: {file.dir}/Mesen/Mesen.exe {file.path}


game: Dragonball Z Hyper Dimension
file: Dragonball Z Hyper Dimension (J).smc
players: 2
assets.box_front: assets/covers/Dragonball Z Hyper Dimension (J)-front.jpg


game: Final Fantasy V
file: Final Fantasy V (J).smc
players: 1
assets.box_front: assets/covers/Final Fantasy V (J)-front.jpg


game: Fire Emblem 문장의 비밀
file: Fire Emblem - Monshou no Nazo (J).sfc
players: 1
assets.box_front: assets/covers/Fire Emblem Monshou no Nazo (J)-front.jpg


game: Fire Emblem 성전의 계보
file: Fire Emblem - Seisen no Keifu (J).smc
players: 1
assets.box_front: assets/covers/Fire Emblem - Seisen no Keifu (J)-front.jpg

 

프론트엔드 화면입니다. 이런 식으로 게임을 추가하면 됩니다. collection 은 위에 탭으로 SNES와 GBA가 있지요? 컨트롤러라면 LB, RB버튼으로 이동할 수 있습니다.

 

커버 아트, 박스 아트 등은 아래 게시물을 참고합니다.

 

https://gametwentysecond.tistory.com/108

클래식 게임의 박스 아트, 커버 아트(Box Art, Cover Art) 이미지 다운로드 사이트 모음

 

게임을 더블 클릭해서 선택하면 상세한 메타 데이터가 나옵니다. play time 도 기록 해주고 뭔가 마음에 드네요. 게임에 대한 세부 정보 등은 일일히 입력해도 되지만 대부분은 스크레이퍼나 다른 플랫폼(LaunchBox같은) 데이터를 가지고 오는게 속이 편할 겁니다. 저는 개인적으로 애착이 있는 게임에 대해서만 기록하고 있습니다. 나중에 블로그를 쓸 때 꺼내기도 쉽겠지요.

 

Pegasus로 실행한 모습 입니다. 프로그램이 종료되면 다시 Pegasus Frontend로 돌아갑니다. 실행 속도는 꽤 나쁘지 않더군요.

 

이렇게 Pegasus Frontend의 메타데이터 파일 설정을 통한 플레이와 관리방법을 알아봤습니다. 다음은 테마에 대한 욕심이 생기기 마련인데... 테마에 관해서는 별도로 포스팅할 생각입니다.