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:

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