Announcing Pegasus Frontend

fluffypillow

@Darksavior I've just pushed an update, could you check if it fixes the issue? In case it doesn't, you can find the log file at ~/.config/pegasus-frontend/lastrun.log.

@bmonomad Thanks! At the moment the game list is read only: because metadata can come from various files and multiple sources, write support would work only with some limitations. There's no game list/data editor in the works right now, but might come in the future!

Darksavior

@fluffypillow No change with the update. That log is empty. Tried a fresh install of retropie and it works with that. Here's more info about the crash:
IMG_0142 (2).JPG

fluffypillow

@darksavior Haven't managed to reproduce the bug yet, but will try again tomorrow on a larger set of games. Likely Pegasus has problems with one of the gamelist XMLs, maybe the neogeo one, or something that comes after that but haven't had the time to print its name before the crash. Localizing the error could be done by temporarily renaming the gamelist XML or its directory to make Pegasus skip reading it, and see which one succeeds/fails. But I'll also try reproducing it tomorrow.

Darksavior

@fluffypillow I re-tested by removing systems until pegasus loaded. While pegasus did load, it did not use the xml's since the games are just white text on a black background.

I also reproduced the problem on a clean install of retropie 4.7.1 by transferring my xml's to it. There is definitely a problem with pegasus reading the gamelist xml's from ES.

fluffypillow

@darksavior Could you try the latest version? I think I might've fixed it.

Darksavior

@fluffypillow It fixes the crash but there's still the issue of pegasus not reading the xml's correctly. Most of my systems have no art or no proper title. Around 10 games do for some reason...

fluffypillow

@darksavior Just pushed another update, could you take a look?

Darksavior

@fluffypillow Everything working again. Thanks!

prefor

I have a few problems with this front-end. Don't get me wrong, so far this is the best looking Front-end I've used for Android, and that it includes Video snaps and the layout is gorgeous!

I'm using this on Android

However I have these two problems:

I'm using GameOS theme with this front-end and it looks good!
However 60% of the time when I launch a game (NES game in this case) through Pegasus Front-end using Retroarch, Retroarch just crashes and redirects me back to Pegasus Front-end...
And also when I launch a game the navigation bar shows up in Retroarch for some reason, which I can't remove.. Maybe that's the cause of the crashing? :/

Here is a crash log i get from Retroarch: https://del.dog/dunimuriph.txt
And here is a picture of what I mean about Navigation bar: https://i.imgur.com/cByCchc.jpg

The second problem I noticed is when I tried to install this on another phone. For some reason I can't set game directories. It's all empty no matter which folder I open. Does someone knows why? I have granted permission on Pegasus-frontend to use and read file storage etc, but it stills happen. Does anyone knows why? :(
Here is a picture of what I mean: https://i.imgur.com/DWP4PgG.jpg

msheehan79

@fluffypillow I have a question around theme development. Is there a means within QML to identify when Pegasus is first being loaded up vs. when Pegasus has just returned from launching a game? From what I can gather the Component.onCompleted is usually where any logic is stored that executes when the theme finishes loading, but that triggers both on initial startup as well as after a game ends.

The use case I could envision is trying to control where Pegasus first lands on startup, for example to always display a specific home page or specific collection as a starting point, but I would not want to redirect there after launching every game, in those cases I would want to return the user to the last viewed collection etc.

PlayingKarrde

@msheehan79 said in Announcing Pegasus Frontend:

@fluffypillow I have a question around theme development. Is there a means within QML to identify when Pegasus is first being loaded up vs. when Pegasus has just returned from launching a game? From what I can gather the Component.onCompleted is usually where any logic is stored that executes when the theme finishes loading, but that triggers both on initial startup as well as after a game ends.

The use case I could envision is trying to control where Pegasus first lands on startup, for example to always display a specific home page or specific collection as a starting point, but I would not want to redirect there after launching every game, in those cases I would want to return the user to the last viewed collection etc.

What I do is store a variable when I launch the game and then check for it in Component.onCompleted, then clear it from memory.

// Launch the current game
    function launchGame(game) {
        if (game !== null) {
            saveCurrentState(game);
            game.launch();
        } else {
            saveCurrentState(currentGame);
            currentGame.launch();
        }
    }

    // Save current states for returning from game
    function saveCurrentState(game) {
        api.memory.set('savedState', root.state);
        api.memory.set('savedCollection', currentCollectionIndex);
        api.memory.set('lastState', JSON.stringify(lastState));
        api.memory.set('lastGame', JSON.stringify(lastGame));
        api.memory.set('storedHomePrimaryIndex', storedHomePrimaryIndex);
        api.memory.set('storedHomeSecondaryIndex', storedHomeSecondaryIndex);
        api.memory.set('storedCollectionIndex', currentCollectionIndex);
        api.memory.set('storedCollectionGameIndex', storedCollectionGameIndex);

        const savedGameIndex = api.allGames.toVarArray().findIndex(g => g === game);
        api.memory.set('savedGame', savedGameIndex);

        api.memory.set('To Game', 'True');
    }

    // Handle loading settings when returning from a game
    property bool fromGame: api.memory.has('To Game');
    function returnedFromGame() {
        lastState                   = JSON.parse(api.memory.get('lastState'));
        lastGame                    = JSON.parse(api.memory.get('lastGame'));
        currentCollectionIndex      = api.memory.get('savedCollection');
        storedHomePrimaryIndex      = api.memory.get('storedHomePrimaryIndex');
        storedHomeSecondaryIndex    = api.memory.get('storedHomeSecondaryIndex');
        currentCollectionIndex      = api.memory.get('storedCollectionIndex');
        storedCollectionGameIndex   = api.memory.get('storedCollectionGameIndex');

        currentGame                 = api.allGames.get(api.memory.get('savedGame'));
        root.state                  = api.memory.get('savedState');

        // Remove these from memory so as to not clog it up
        api.memory.unset('savedState');
        api.memory.unset('savedGame');
        api.memory.unset('lastState');
        api.memory.unset('lastGame');
        api.memory.unset('storedHomePrimaryIndex');
        api.memory.unset('storedHomeSecondaryIndex');
        api.memory.unset('storedCollectionIndex');
        api.memory.unset('storedCollectionGameIndex');

        // Remove this one so we only have it when we come back from the game and not at Pegasus launch
        api.memory.unset('To Game');
    }

    // Set default state to the platform screen
    Component.onCompleted: { 
        if (fromGame)
            returnedFromGame();
    }

msheehan79

@playingkarrde Ah! That makes sense. Set it during the launch command and unset it when you come back. Wasn't sure if there was any native way to detect it, but managing it with a variable indeed looks like a solid approach. Thanks for the advice!

Grila

Hi @fluffypillow . I recently received my Retroid Pocket 2 and am in the process of setting up with Pegasus. The RP2 comes with 2 versions of RetroArch, a up to date version and an older 1.5.0 version that is specifically for playing GBA.

My problem is that I can launch the up to date version thru Pegasus, but when I try to launch a GBA game with the 1.5.0 version of RetroArch it just exits immediately and returns me to Pegasus. (The 1.5.0 version works correctly if I load roms directly in RetroArch)

Here's my GBA metadata file and my lastrun.log

My guess is it has something to do with the launch parameters, but I've rooted the RP2 and double checked all the directories and they are correct.

If you have any suggestions it would be appreciated. Thanks!

fluffypillow

@prefor Sorry for the late reply!

Retroarch just crashes and redirects me back

That seems like a crash on RetroArch's side, maybe it expects some launch parameter it doesn't receive? Could you upload your metadata file and the Pegasus log (<storage>/pegasus-frontend/lastrun.log)?

For some reason I can't set game directories

Yeah, that looks like a permission issue. Could you try the very latest version? Try going up (..) as far as you can, on the top you will find all the storages Android allows Pegasus to use.

@Grilli Yeah, it likely requires a different launch command, but that's hard to tell without the exact source code. Is there a practical reason to use the older version? The latest official stable version is 1.9, according to the RetroArch site, which should also support playing GBA.

fluffypillow

"Weekly" update! This month there were lots of small fixes, following the data source rewrites from last time, Android updates, lots of new languages and the usual general improvements:

Added support for having multiple metadata files in a directory: similarly to the global metafiles directory, Pegasus can now see all files with .metadata.pegasus.txt or .metadata.txt extensions
Improved Android 11 support
Added Chinese (zh-TW) translation (thanks kenjivo1!)
Added Bosnian, Dutch and British English translations (thanks SecularSteve!)
Updated German translation (thanks SecularSteve!)
Fixed a crash on Android
Fixed portable mode issues
Fixed missing metadata for games present in multiple collections
Fixed ES2 games missing in certain cases
Fixed some log messages and typos
Linux: Fixed Markdown files not getting installed with make install
Updated the Android metadata generator page with new emulators and corrected the commands for some others
Updated the documentation and fixed some typos

sergioad

@fluffypillow I can not wait to see a possible future RetroPie release with Pegasus by default

Patientgamerfr

@fluffypillow Thank again for this wonderful frontend !

fluffypillow

Happy new year update! The winter holidays are over, and so I've also continued the development with some updates.

Main changes:

Added support for WebP and animated PNG image formats: themes now have the ability to use, and optionally, to enable animation on them (Note: APNG images should have .apng file extension to work)
GOG support is now turned on by default again
Minor Android improvements

Theme changes:

You can now use WebP and APNG images: similarly to GIFs, the QML AnimatedImage element (https://doc.qt.io/qt-5/qml-qtquick-animatedimage.html) can be used to display them animated, and the regular Image to display still images

Tool changes:

Updated the RetroArch command on the Android metadata generator page

Notes for maintainers:

WebP support requires Qt's imageformats module with WebP support
APNG support requires libpng with animation support (ie. the "APNG patch"). libpng might come from various sources (system/Qt/other library/custom), but this feature may not be enabled on them - to avoid breaking builds, APNG support in Pegasus is NOT enabled by default. You can define the ENABLE_APNG QMake variable to enable support. For the same reason, Pegasus also does NOT try to link to libpng automatically. Similarly to SDL2, you can use the PNG_LIBS and PNG_INCLUDES QMake variables to affect the build.

pootis spencer

Is it possible to start Pegasus on a category such as Arcade?

h2805270

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

It seems kind of "exhausting" to add all of the game lists manually to Pegasus.

So I propose a few ideas:

A simple GUI program that let's you make metadata files much more easily on OSes. Instead of doing it the old fashioned way:

# Selects all files with the provided extension, except two games
collection: Super Nintendo Entertainment System
shortname: snes
extensions: 7z, bin, smc, sfc, fig, swc, mgd, zip, bin
ignore-file: buggygame.bin
ignore-file: duplicategame.bin
launch: snes9x "{file.path}"

# A collection of 3 games. They're also part of 'My Games'.
collection: Platformer games
files: mario1.bin
files: mario2.bin
files: mario3.bin

# A regex example; includes games with '[number]-in-1' in their name.
collection: Multi-game carts
regex: \d+.in.1

An auto-detect program that you drop in where you want it to find the games based on very simple "[systemname].txt" files stored in the ROM folders themselves (and [emulatorname].txt for the emulators)
Better integration with RetroArch that converts everything you already set up in libretro, and uses Pegasus to open it.

But those are just my suggestions, let the debate commence.