README
September 26, 2025 · View on GitHub
README : WiiSX / CubeSX
LICENSE: This software is licensed under the GNU General Public License v2 which is available at: http://www.gnu.org/licenses/gpl-2.0.txt This requires any released modifications to be licensed similarly, and to have the source available.
WiiSX/CubeSX and their respective logos are trademarks of Team Wii64
and should not be used in unofficial builds.
QUICK USAGE:
- ISOs can be .bin/.cue (Make sure .cue contains relative directory!), .img, or .iso format
- To install: Extract the contents of wiiSX-
.zip to the root of your SD card - SD Card detection order is as follows: GameCube: GCLoader, SD2SP2, Slot A, Slot B. Wii: Front SD, Slot A, Slot B.
- For SD/USB: Put ISOs (.bin/.cue or other formats) in the directory named /wiisx/isos, All save types will automatically be placed in /wiisx/saves
- For DVD: ISOs may be anywhere on the disc, in ISO9660 format. GameCube: Currently broken due to libOGC issues with backups, XenoGC might still work. Wii: Requires a disc drive capable of reading DVD-R.
- For actual BIOS: Put SCPH1001.BIN in the directory on SD/USB named /wiisx/bios
- Load the executable from the HBC or in the loader of your choice Once loaded, select 'Load ISO' and choose the source and select the ISO to load (Note: to go up a directory select '..', B will exit the file browser)
- Select 'Play Game' to play The game can be exited any time by pressing a configurable key combination together on a GC pad (START & X), Classic Controller (HOME), Wiimote (- & +), Wiimote+Nunchuck (1 & 2), or the reset button (Note: this must be done to save your game; it will not be done automatically)
Controls:
- Controls are fully configurable so any button on your controller can be mapped
- The controller configuration screen presents each PSX button and allows you to toggle through sources
- There are 4 configuration slots for each type of controller
- To load a different, previously saved configuration, select the slot, and click 'Load'
- After configuring the controls as desired, select the slot, and click 'Save'
- After saving different configurations to the slots, be sure to save your configs in the input tab of the settings frame
- Clicking 'Next Pad' will cycle through the PSX controllers assigned
- There is an option to invert the Y axis of the PSX's analog sticks; by default this is 'Normal Y'
- The 'Menu Combo' configuration allows you to select a button combination to return to the menu
Settings:
- General
- Native Saves Device: Choose where to load and save native game saves
- Save States Device: Choose where to load and save save states
- Select CPU Core: Choose whether to play games with pure interpreter (better compatibility) or dynarec (better speed)
- Save settings.cfg: Save all of these settings either SD or USB (to be loaded automatically next time)
- Video
- Show FPS: Display the framerate in the top-left corner of the screen
- Screen Mode: Select the aspect ratio of the display; 'Force 16:9' will pillar-box the in-game display
- Input
- Configure Input: Select controllers to use in game
- Configure Buttons: Enter the controller configuration screen described above
- Save Button Configs: Save all of the controller configuration slots to SD or USB
- Auto Load Slot: Select which slot to automatically be loaded for each type of controller
- Audio
- Disable Audio: Select to mute the sound
- Saves
- Auto Save Native Saves: When enabled, the emulator will automatically load saves from the selected device on ISO load and save when returning to the menu or turning off the console
- Copy Saves: Not yet implemented
- Delete Saves: Not yet implemented
COMPATIBILITY: Report any issues to https://github.com/emukidid/pcsxgc/issues
CREDITS:
- General Coder: emu_kidid
- Graphics & Menu Coder: sepp256
- Audio & Core Coder: tehpola
- Artwork: drmr
- pcsx team http://www.pcsx.net/
- notaz for pcsx-ReARMed
- pcercuei for lightrec https://github.com/pcercuei/lightrec/
- originally based on pcsx 1.5-test3 mac version by Gil Pederson http://pcsx.gpost.dk/
- P.E.Op.S. PSX Gpu & SPU http://sourceforge.net/projects/peops/
- SSSPSX
- Compiled using the latest devKitPro/libOGC ( http://sourceforge.net/projects/devkitpro )
- Visit us on IRC. EFNet #gc-forever or www.gc-forever.com or https://github.com/emukidid/pcsxgc/
CHANGE LOG: * See releases on github for these now, this section here is no longer maintained. Beta 4.0: * libpsxcore properly integrated, no more hacky mess to receive fixes from upstream * switch to upstream unai gpu plugin for a huge performance boost * triple buffering * switch to cmake Beta 3.0: * Back nearly 13 years later with a new dynarec thanks to pcercuei's lightrec * Increases speed and compatibility * Sync'd with upstream pcsx-ReARMed * Eliminates XA/CDDA slowdown completely on Wii * dfsound audio plugin * speed improvements in the soft graphics plugin thanks to tips from Extrems * SD2SP2 support on GameCube * General UI bugfixes and memory leaks addressed Beta 2.1:
- Compiled with devkitPPC r21 / libOGC SVN
- Compiled with new libDI / DVDx V2
- Saving improvements
- Fixed issues where save was not written to memcard
- Audio state saved/loaded for save states
- Controller improvements
- Fixed inverted Y-axis on analog input
- Fixed rumble
- Fixed button presses on unused input port
- Added “Home” button as a menu combo for CC
- Added disable rumble setting
- Network improvements
- SMB correction to allow anonymous user and password
- Threaded network init and proper error messages when it fails Beta 2:
- Compiled with devkitPPC r21 / libOGC SVN
- Compiled with new libDI / DVDx V2
- DVD reads are now done with direct PowerPC access
- Samba loading
- Execute BIOS
- Controller improvements
- Rumble for Wiimote-based input
- Wiimote-only controls
- Classic Controller Pro & 3rd party controller support
- Reconfigurable button mapping
- Save/Load button mapping from file
- New menu system
- Classic Controller support
- Wiimote / Wiimote & nunchuck support
- Settings saving
- Auto load/save option for saves
- PEOPS GPU
- Pillar-boxing 'Force 16:9' mode
- Fixed color mapping for FMV
- FranSPU
- Smooth stereo audio at full FPS
- PEOPS SPU
- SSSPSX input plugin
- DualShock Controller support
- Rumble support
- Analog/Digital switching
- CDRMooby
- Improved compatibility
- CDDA not implemented yet Beta 1:
- Working audio (choppy)
- DVD loading
- Software GFX with GX scaling
- Saving to SD card
- Text UI
- Known Issues:
- CDDA audio streaming is not implemented
- XA audio fails at times
- Final Fantasy VII crashes Dynarec
- FPS limit not working at times