Introducing Project Pegasus (A Written Tutorial on It's usage)

Discussion in 'Xbox One - Tutorials' started by wiired24, May 16, 2017.

  1. wiired24
    OP

    Member wiired24 GBAtemp Fan

    Joined:
    Sep 3, 2013
    Messages:
    391
    Location:
    Dev_Home
    Country:
    United States
    Project Pegasus
    A Written tutorial and full guide on it's usage

    As the Xbox One scene has continued to grow there has been a growing amount of homebrew software that has become available for the platform. But how easy is it to obtain this homebrew? Up til now the solution for obtaining homebrew had been to just scout through the pages of gbatemp and try and find what you we're looking for. While that does work, as more and more software becomes available it's not the best method going forward. This problem led me to developing a solution. It's called ProjectPegasus.

    [​IMG]

    What is it?

    ProjectPegasus is a command line tool for downloading Xbox One homebrew right to your PC. It currently has a good majority of homebrew that already exists for the Xbox One platform with more to be added in future releases.


    Installation

    To install ProjectPegasus just go to the github page here
    https://github.com/wiired24/ProjectPegasus

    You can either download the zip or do a git clone
    Once downloaded just open the binaries file and you will see an
    executable that can easily be ran.


    A word of advice

    Project pegasus by default will download your homebrew to C:\Users\Public\homebrew. If you don't have this folder that's okay the client will create it for you.

    This should be obvious to some but if your someone who is unfamilar with how to install the homebrew to your Xbox One you can follow my written guide here where I cover in detail sideloading the APPX Package.
    (Begin from Step 3) https://gbatemp.net/threads/how-to-sideload-chip8-emulator-on-xbox-one.470025/




    Final thoughts

    Moving forward ProjectPegasus will be the default way to download Xbox One homebrew. It will support virtually all or at least nearly all homebrew that is available giving end users the convience of having a central homebrew hub.

    Currently this tool runs on
    [*] Windows

    [*]
    Linux (Mono Required just do sudo apt-get install mono-complete)
    In order to run just locate where you downloaded Project Pegasus at and change to the binaries directory. Then just type mono Project_Pegasus.exe and it will start. Note: On Linux your homebrew will automatically download to the "binaries"
    folder. The only time you need to create the C:/Users/Public/homebrew directory is if your using Windows.



    [*] Mac It runs on Mac with mono. Thanks to gbatemp user @jackb994 for verifying.


    Update: The link issue has been resolved all links now work as expected. You no longer have to create a homebrew folder in your C:\Users\Public Directory. It will now create one for you by default if you don't already have one "Thanks to Iglitch for the fix" I've also fixed the annoying issue where you would have to reopen ProjectPegasus every time you wanted to download something else.


    A wiki has also been added if you'd like to check that out.
    https://github.com/wiired24/ProjectPegasus/wiki
     
    Last edited by wiired24, May 19, 2017 at 5:00 AM


  2. Sasori

    Member Sasori GBAtemp Maniac

    Joined:
    Jan 28, 2015
    Messages:
    1,315
    Country:
    United States
    Your downloads don't work. They download broken files. They need to be direct links with the method you're using unless you use Mediafire's API
     
  3. dominater01

    Member dominater01 GBAtemp Regular

    Joined:
    Mar 13, 2009
    Messages:
    113
    Country:
    United States
    same problem the downloads arnt working
     
  4. Sasori

    Member Sasori GBAtemp Maniac

    Joined:
    Jan 28, 2015
    Messages:
    1,315
    Country:
    United States
    He needs to make them direct links thats why. either via Dropbox premium or a webhost
     
  5. wiired24
    OP

    Member wiired24 GBAtemp Fan

    Joined:
    Sep 3, 2013
    Messages:
    391
    Location:
    Dev_Home
    Country:
    United States
    Hey guys, I Just realized the issue. Would google drive remedy this? Don't have the cash for Dropbox Premium atm.

    Currently uploading to Dropbox Pro. Will test and report back.


    Edit: I'm migrating all the files over to Google Drive. I have tested and it works. I Apologize for any incovenience.
     
    Last edited by wiired24, May 16, 2017
    Subtle Demise likes this.
  6. ElijahZAwesome

    Member ElijahZAwesome GBATemp's official... uh... uhhhhhhhhhhhh

    Joined:
    Jul 12, 2016
    Messages:
    540
    Location:
    Narnia
    Country:
    United States
    I can test this on Mac using winebottler this Friday :)
     
  7. wiired24
    OP

    Member wiired24 GBAtemp Fan

    Joined:
    Sep 3, 2013
    Messages:
    391
    Location:
    Dev_Home
    Country:
    United States
    Awesome :) What exactly is winebottler though btw?
     
  8. ElijahZAwesome

    Member ElijahZAwesome GBATemp's official... uh... uhhhhhhhhhhhh

    Joined:
    Jul 12, 2016
    Messages:
    540
    Location:
    Narnia
    Country:
    United States
    It's like a mini virtual machine. It uses like, a runtime to run exes on Mac. You can also compile it as a .app which is basically the same thing but in one file.
    http://winebottler.kronenberg.org/
     
    wiired24 likes this.
  9. wiired24
    OP

    Member wiired24 GBAtemp Fan

    Joined:
    Sep 3, 2013
    Messages:
    391
    Location:
    Dev_Home
    Country:
    United States
    Oh okay cool. If that doesn't work for Mac try it with mono on Mac and see
     
  10. ElijahZAwesome

    Member ElijahZAwesome GBATemp's official... uh... uhhhhhhhhhhhh

    Joined:
    Jul 12, 2016
    Messages:
    540
    Location:
    Narnia
    Country:
    United States
    I've never tried mono so I'll see
     
    wiired24 likes this.
  11. wiired24
    OP

    Member wiired24 GBAtemp Fan

    Joined:
    Sep 3, 2013
    Messages:
    391
    Location:
    Dev_Home
    Country:
    United States
    Should just be able to download install it and then in the Mac Terminal it's

    mono exampleprogram.exe
     
  12. ElijahZAwesome

    Member ElijahZAwesome GBATemp's official... uh... uhhhhhhhhhhhh

    Joined:
    Jul 12, 2016
    Messages:
    540
    Location:
    Narnia
    Country:
    United States
    Dang. It seems I can't test mono. It installs with a pkg, but since the computer is my dad's he put restrictions on so I can't make low level changes... I can still test wine tho, it's for the most part just as good from what I can tell
     
    wiired24 likes this.
  13. wiired24
    OP

    Member wiired24 GBAtemp Fan

    Joined:
    Sep 3, 2013
    Messages:
    391
    Location:
    Dev_Home
    Country:
    United States
    Lol that sucks. Okay Sounds good
     
    ElijahZAwesome likes this.
  14. wiired24
    OP

    Member wiired24 GBAtemp Fan

    Joined:
    Sep 3, 2013
    Messages:
    391
    Location:
    Dev_Home
    Country:
    United States
    @dominater01 @Sasori @ElijahZAwesome

    The problem with the links has been fixed. Everything should work :D The only issue remaining is with Dungeon Run but it's minor and will be fixed soon I just need to compress the program down enough so google drive can scan it for download. I Updated the binary on the github page as well to the latest build so feel free to re-test/test and confirm
     
  15. Zapper_

    Newcomer Zapper_ Newbie

    Joined:
    Jan 8, 2017
    Messages:
    8
    Country:
    Netherlands
    I like the whole concept you are doing, but I however do have some points to address:

    1. Consider switching from hardcoded paths and filenames in your binary to something like a JSON-file approach. This way, people don't have to download your executable over and over again; only with specific changes to the executable code. The JSON-file could even be hosted on Github Pages so that other developers could send pull requests. This saves you time and saves your users hassle. Just make sure you are using some RawGit.com-type link to prevent having your Github Pages site down in no time.

    2. It might be an idea to skip the whole menu thingie and make command-line arguments like search or index available. I know some here will appreciate it! Including me.

    Don't get me wrong, it's a great project! Hopefully it will help aspiring Xbox One/UWP developers to get some more shine.
     
    Subtle Demise and wiired24 like this.
  16. wiired24
    OP

    Member wiired24 GBAtemp Fan

    Joined:
    Sep 3, 2013
    Messages:
    391
    Location:
    Dev_Home
    Country:
    United States

    Thanks for the kind words as well as the constructive feedback I do appriciate it :)
    I'll look into the JSON Approach in the future.


    "Don't get me wrong, it's a great project! Hopefully it will help aspiring Xbox One/UWP developers to get some more shine."


    That's what this project is all about. The idea that anyone can write homebrew on their computer for the Xbox One and then have it featured for download to reach thousands of users is an incredibly powerful concept.
     
    Last edited by wiired24, May 16, 2017
    Subtle Demise likes this.
  17. ScarletDreamz

    Member ScarletDreamz [Debug Mode]

    Joined:
    Feb 16, 2015
    Messages:
    2,209
    Location:
    California
    Country:
    United States
    Havent check this, but if this is C#, i can do some pimping on this C:
     
    wiired24 likes this.
  18. wiired24
    OP

    Member wiired24 GBAtemp Fan

    Joined:
    Sep 3, 2013
    Messages:
    391
    Location:
    Dev_Home
    Country:
    United States
    Yep just standard C#. Using the Webclient class to retrieve homebrew files from the net and a simple Switch Block for the Menu. I try to keep my code clean for others so it should be pretty easy to look at
     
  19. ScarletDreamz

    Member ScarletDreamz [Debug Mode]

    Joined:
    Feb 16, 2015
    Messages:
    2,209
    Location:
    California
    Country:
    United States
    If its Console based, i can tryto port it to a GUI based client.
     
  20. Sasori

    Member Sasori GBAtemp Maniac

    Joined:
    Jan 28, 2015
    Messages:
    1,315
    Country:
    United States
    You mean like this?

    (complete with a webhost for faster and more reliable downloads btw)
    [​IMG]

    *ps* even auto generates the needed folders in a more accessible path
     
    ElijahZAwesome likes this.

Share This Page