Mystro256 / wiisxr

Fork of wiisx, a gamecube/wii/wii U psx emulator
109 stars 29 forks source link
psx-emulator wii

WiiSXR logo

Fork of wiisx, a GameCube/Wii/Wii U PSX emulator.

The starting point for this code base will be daxtsu's libwupc mod of wiisx, which is in turn based off of Matguitarist's "USB mod5"

Please see the following link for details:

http://www.gc-forever.com/forums/viewtopic.php?t=2524

WiiSX is GNU GPL and the source can be found here:

https://code.google.com/p/pcsxgc/downloads/list

LibWupc is also GPL, which can be found here:

https://github.com/FIX94/libwupc

Please contact me if you have licensing concerns. I will try to make this as GPL2+/3+ compliant as possible.

Downloads

All downloads can be found here:

https://github.com/Mystro256/wiisxr/releases

Reporting Bugs

Feel free to report bugs, but if you can, please test pcsxr first, to eliminate redundant bugs. If it's not a bug in pcsxr, but a bug here, report it here if desired. I would hope this can be as aligned with pcsxr as possible, so any bugs in pcsxr will be inherited unfortunately. If it is a bug in pcsxr, feel free to report bugs with pcsxr... Please note that I am not affiliated with them, so mentioning me or wiisxr is unnecessary and unadvised to avoid confusion.

As well, I can't guarentee this project will be a success, unless I can get some help! So if you have any programming skill, feel free to fork me and check the Goals section!

Goals

The aim of this project is to maintain, update and improve the wiisx code to comply with building with the latest devkitPro (PPC), website can be found here: http://sourceforge.net/projects/devkitpro/files/devkitPPC/

Some Goals in mind:

Don't forget to fork me if you want to contribute! :) I'm open to collaborators! Unfortunately its a lot of work and I'm limited on time as is, so any help is appreciated.

How to Build

If don't have the build system setup yet, see "Build System Guide" first

For the Wii version, just cd into the wiisxr folder and run

make Wii

or to build it for GameCube:

make GC

If you're going to do some development, I would suggest always making a clean build and regenerating build.log. To do this, just call the make command like so and it'll do the rest for you:

make

To make a zip file to redistribute:

make dist

Build System Guide

I realize many people know how to build on devkitPro, but here's a guide for noobies:

  1. Download devkitPro (PPC version for your system) from here: http://sourceforge.net/projects/devkitpro/files/devkitPPC/ If you're using Windows, it's suggested to use the auto installer instead. After installing it, skip to step 7 (note that the default devkitPro folder is C:\devkitPro): http://sourceforge.net/projects/devkitpro/files/Automated%20Installer/

  2. Extract the devkitPPC folder from the file you downloaded into a folder called devkitPro (your file system should look like this: devkitPro/devkitPPC/, make the devkitPro folder where ever you want, I used ~/devkitPro)

  3. Download libogc: http://sourceforge.net/projects/devkitpro/files/libogc/

  4. Make a folder called libogc in the devkitPro folder like so: devkitPro/libogc

  5. Extract the libogc include and lib folders into the devkitPro/libogc folder.

  6. Download libfatmod: https://github.com/Mystro256/libfatmod/releases

  7. Extract the libfatmod include and lib folders into the devkitPro/libogc folder.

  8. Download zlib from here: http://sourceforge.net/projects/devkitpro/files/portlibs/ppc/

  9. Download libwupc: https://github.com/FIX94/libwupc/archive/master.zip

  10. Download libwiidrc: https://github.com/FIX94/libwiidrc/releases

  11. Make a portlibs folder in the devkitPro folder, then a ppc in the portlibs folder, like so: devkitPro/portlibs/ppc

  12. Extract the include, lib and share folders from zlib, libwupc, and libwiidrc into the devkitPro/portlibs/ppc folder.

  13. On Linux or Mac OSX only, make sure you specify the environment variables, like so (I used ~/devkitPro for the location; replace this with what you used):

export DEVKITPRO=$HOME/devkitPro
export DEVKITPPC=$DEVKITPRO/devkitPPC
export PATH=$PATH:$DEVKITPPC/bin

and if you want to add the manpage path too:

export MANPATH=$MANPATH:$DEVKITPPC/share/man

You can add this to your ~/.bashrc so you don't have to change them every time you open a new terminal, but be careful, as this can interfere with other build systems.