/galaxy-integration-n64-RetroArch-

N64 RetroArch integration for GOG Galaxy 2.0

Primary LanguagePython

galaxy-integration-n64-RetroArch-

N64 RetroArch integration for GOG Galaxy 2.0

If you want the integration to work, please read the tutorial!

This integration is still work in progress, but it's core features are working and the worst bugs are removed, so try it out if you'd like to. Thanks to AHCoder for using his PS2 integration as base for this one. Also thanks to several people on the GOG Discord for helping me out with some problems.

Created with the Galaxy API: https://github.com/gogcom/galaxy-integrations-python-api

Working Features:

  • Add N64 Roms into the galaxy 2.0 library
  • Launch N64 Roms with RetroArch via Galaxy 2.0
  • Import RetroArch Playtime
  • Use Mupen64Plus_Next or ParaLLEl core, change it in user_config.py

Future Features:

  • MacOS Support (help from MacOS Users would be appreciated)
  • Add GUI (cef) for better usability
  • Add retroachievements via API
  • More launch options
  • Support for various emulators (might be another repository then)
  • Add more platforms supported by RetroArch (if Galaxy should support more than one platform per integration in the future. Currently working on PSX support in other repository, not quite usable right now though)

Tutorial

Setting up RetroArch (version 1.7.6 or higher required) - You need to repeat step 3 after adding new Roms to the path.

  1. Open RetroArch.
  2. Navigate to the left until you're at Main Menu, click on Load Core -> Download a Core and select Nintendo - Nintendo 64 (Mupen64Plus-Next).
  3. Navigate to the right until you're at Import Content, click on Scan Directory, navigate to the folder where your Roms are and click on Scan this Directory.
  4. Navigate to Settings, click on Saving, go to the last option there Save runtime log (aggregate) and turn it on.

Setting up the Integration:

  1. Download the integration (use clone or download or download the Source Code.zip file in releases or just click here).
  2. Extract the ZIP file.
  3. Put it into your Galaxy plugin folder (standard is: C:\Users\USERNAME\AppData\Local\GOG.com\Galaxy\plugins\installed)
  4. Open the file user_config.py with an editor.
  5. Add your emulator and roms path as described in the file.
  6. (Re)start Galaxy 2.0 and connect the integration.

If the integration doesn't work and you made sure that you set up everything correctly, here are some things that might fix it:

  1. In RetroArch, go to Settings -> Playlist and make sure that Save Playlist using old format is NOT active.
  2. More to be added