2.1 pegasus notes

click each heading to expand

Guides & Links

• pegasus installer - all in one script to install pegasus and scrape games directly on the device
  • pegasus installer
• quick guides on basic installation and metadata setup
  • video guide
  • written guide
• advanced metadata configuration documentation
  • determining activity launch strings
  • android setup docs
  • metadata options
  • android activity metadata generator

---

Good Themes

• https://github.com/plaidman/retromega-next
• https://github.com/dragoonDorise/RP-Switch
• https://github.com/dragoonDorise/RP-RG351
• https://github.com/dragoonDorise/RP-epic-noir
• https://github.com/DFOXpro/rp2-pegasus-theme-grid

---

Multi-Folder Collections

All instances of shmup.pegasus.metadata.txt files must have the same collection and shortname, then the games must have a game and file. everything else should be pulled automatically from the corresponding pegasus.metadata.txt file

roms/
  - psx/
    - pegasus.metadata.txt
    - shmup.pegasus.metadata.txt
  - snes/
    - pegasus.metadata.txt
    - shmup.pegasus.metadata.txt

---

Activity History Options in Launch Commands

The last three lines in the android metadata page are extra and are there to modify activity history, so it doesn't attempt to launch a game but resumes a currently running game instead. If you include these lines, you will be unable to resume a game if, for instance, you accidentally press the home button. If you leave these lines off, you must remember to exit the game properly in your emulator before starting a new one.

  --activity-clear-task
  --activity-clear-top
  --activity-no-history

---

Retroarch Aarch64 Launch Command

The Android Metadata Generator tool generates a launch command for 32bit retroarch, here is the one for aarch64. There are also a few extra CLI options that aren't needed, which I have removed.

am start
  -n com.retroarch.aarch64/com.retroarch.browser.retroactivity.RetroActivityFuture
  -e ROM {file.path}
  -e LIBRETRO /data/data/com.retroarch.aarch64/cores/<CORENAME>_libretro_android.so
  -e CONFIGFILE /storage/emulated/0/Android/data/com.retroarch.aarch64/files/retroarch.cfg

---

Dolphin Handheld launch command (RP2+ custom version)

am start
  -n org.dolphinemu.handheld/org.dolphinemu.dolphinemu.ui.main.MainActivity
  -a android.intent.action.VIEW
  --es AutoStartFile "{file.path}"

---

Custom Android App Collection

• settings -> sources -> android apps will create a new collection named Android, shortname android
  • you can turn this source off, and replace with your own collection, and themes will pick it up like normal.
  • if you create this custom collection, but leave the android source on, it will overwrite the custom collection.
• sample metadata file for custom android collection
  • notice the collection info at the top has a dummy launch command
  • each game will need to specify its own custom launch command specific for that game
  • this video will explain the process of figuring out the launch commands
• each game will also need to have its own blank gamename.and file created, which acts like a rom file
  • just like a regular rom file, you can also supply gamename.png files in /media/screenshots/ etc

---

Pico-8 Collection

• each game will need its own launch command to open a browser directly into the lexaloffle site
• am start -a android.intent.action.VIEW -d https://www.lexaloffle.com/bbs/?pid=59253#p
  • change 59253 to the game id of your desired game
• still need a game file and a copy of the game file in metadata for screenshots
• unfortunately android webapp has stuttery sound, but still full speed. it's a known thing.

---

ScummVM Collection

• CLI options are hard coded, so a game cannot be started directly
• you must load ScummVM app, then navigate to the game

---

AetherSX Launch Command

• AetherSX doesn't have the ability to load a specific game, so you must load into the app to select a game
• am start -n xyz.aethersx2.android/.MainActivity -a android.intent.action.MAIN

---