Added Download buttons to README.md (#507)

This commit is contained in:
Etienne Haarsma 2024-03-02 17:21:11 +01:00 committed by GitHub
parent de1c6a2598
commit 8024366fa0
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -1,8 +1,8 @@
# FCE Ultra GX # FCE Ultra GX
https://github.com/dborth/fceugx (Under GPL License) https://github.com/dborth/fceugx (Under GPL License)
FCE Ultra GX is a modified port of the FCE Ultra Nintendo Entertainment FCE Ultra GX is a modified port of the FCE Ultra Nintendo Entertainment
system for x86 (Windows/Linux) PCs. With it you can play NES games on your system for x86 (Windows/Linux) PCs. With it you can play NES games on your
Wii/GameCube. Wii/GameCube.
@ -17,11 +17,18 @@ Wii/GameCube.
## NIGHTLY BUILDS ## NIGHTLY BUILDS
|Download nightly builds from continuous integration: | [![Build Status][Build]][Actions] ### Download the latest builds from continuous integration:
|-------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|
| Name | Status | File |
|-------------------------|-----------------------------------|------------------------------------------|
| FCE Ultra GX Wii/Wii U | [![Build Status][Build]][Actions] | [![Emulator][Download]][fceugx-wiiu] |
| FCE Ultra GX GameCube | [![Build Status][Build]][Actions] | [![Emulator][Download]][fceugx-gamecube] |
[Actions]: https://github.com/dborth/fceugx/actions/workflows/build.yml [Actions]: https://github.com/dborth/fceugx/actions/workflows/build.yml
[Build]: https://github.com/dborth/fceugx/actions/workflows/build.yml/badge.svg [Build]: https://github.com/dborth/fceugx/actions/workflows/build.yml/badge.svg
[Download]: https://img.shields.io/badge/Download-blue
[fceugx-wiiu]: https://github.com/dborth/fceugx/releases/download/Pre-release/FCEUltraGX.zip
[fceugx-gamecube]: https://github.com/dborth/fceugx/releases/download/Pre-release/FCEUltraGX-GameCube.zip
## FEATURES ## FEATURES
@ -111,7 +118,7 @@ Wii/GameCube.
[3.4.6 - March 4, 2020] [3.4.6 - March 4, 2020]
* Fixed 3rd party controllers (again) * Fixed 3rd party controllers (again)
* Fixed GameCube version issues with SD2SP2 * Fixed GameCube version issues with SD2SP2
[3.4.5 - February 17, 2020] [3.4.5 - February 17, 2020]
@ -139,7 +146,7 @@ Wii/GameCube.
[3.4.2 - January 25, 2019] [3.4.2 - January 25, 2019]
* Fixed GameCube controllers not working * Fixed GameCube controllers not working
* Added ability to load external fonts and activated Japanese/Korean * Added ability to load external fonts and activated Japanese/Korean
translations. Simply put the ko.ttf or jp.ttf in the app directory translations. Simply put the ko.ttf or jp.ttf in the app directory
* Added ability to customize background music. Simply put a bg_music.ogg * Added ability to customize background music. Simply put a bg_music.ogg
in the app directory in the app directory
@ -299,7 +306,7 @@ Wii/GameCube.
* Fixed 16:9 correction in Original mode * Fixed 16:9 correction in Original mode
* Fixed PAL/NTSC timing switching issue * Fixed PAL/NTSC timing switching issue
* Ability to use both USB ports (requires updated IOS 202 - WARNING: older * Ability to use both USB ports (requires updated IOS 202 - WARNING: older
versions of IOS 202 are NO LONGER supported) versions of IOS 202 are NO LONGER supported)
* Hide non-ROM files * Hide non-ROM files
* Other minor improvements * Other minor improvements
@ -465,10 +472,10 @@ Wii/GameCube.
[3.0.0 - April 13, 2009] [3.0.0 - April 13, 2009]
* New GX-based menu, with a completely redesigned layout. Has Wiimote IR * New GX-based menu, with a completely redesigned layout. Has Wiimote IR
support, sounds, graphics, animation effects, and more support, sounds, graphics, animation effects, and more
* Thanks to the3seashells for designing some top-notch artwork, to * Thanks to the3seashells for designing some top-notch artwork, to
Peter de Man for composing the music, and a special thanks to shagkur for Peter de Man for composing the music, and a special thanks to shagkur for
fixing libogc bugs that would have otherwise prevented the release fixing libogc bugs that would have otherwise prevented the release
* Onscreen keyboard for changing save/load folders and network settings * Onscreen keyboard for changing save/load folders and network settings
* Menu configuration options (configurable exit button, wiimote orientation, * Menu configuration options (configurable exit button, wiimote orientation,
@ -548,7 +555,7 @@ Wii/GameCube.
* 7z support * 7z support
* Faster SD/USB (readahead cache enabled) * Faster SD/USB (readahead cache enabled)
* VS coin now mapped to 1 button for VS zapper games * VS coin now mapped to 1 button for VS zapper games
* Changed GC controller mappings - Select - Z, Start - Start, * Changed GC controller mappings - Select - Z, Start - Start,
Home - Start+A, Special - L Home - Start+A, Special - L
[2.0.3 - October 1, 2008] [2.0.3 - October 1, 2008]
@ -569,10 +576,10 @@ Wii/GameCube.
[2.0.1 - September 6, 2008] [2.0.1 - September 6, 2008]
* Zapper support! Turn this on in the Controller Settings - most games * Zapper support! Turn this on in the Controller Settings - most games
require you to have the Zapper on Port 2. Thanks go to aksommerville whose require you to have the Zapper on Port 2. Thanks go to aksommerville whose
previous work on the Zapper helped, and michniewski's cursor code previous work on the Zapper helped, and michniewski's cursor code
* RAM game save support! Now you can save your games just like the NES did. * RAM game save support! Now you can save your games just like the NES did.
By default game saves are saved/loaded automatically. This can be changed By default game saves are saved/loaded automatically. This can be changed
in the Preferences menu in the Preferences menu
* Start/Select reversed mapping fixed for Wii controllers * Start/Select reversed mapping fixed for Wii controllers
@ -585,10 +592,10 @@ Wii/GameCube.
* Button mapping for all controller types * Button mapping for all controller types
* Full support for SD, USB, DVD, GC Memory Card, and Zip files * Full support for SD, USB, DVD, GC Memory Card, and Zip files
* Game starts immediately after loading * Game starts immediately after loading
* Load/save preference selector. ROMs, saves, and preferences are * Load/save preference selector. ROMs, saves, and preferences are
saved/loaded according to these saved/loaded according to these
* Preliminary Windows file share loading/saving (SMB) support on Wii: * Preliminary Windows file share loading/saving (SMB) support on Wii:
You can input your network settings into FCEUGX.xml, or edit You can input your network settings into FCEUGX.xml, or edit
fceuconfig.cpp from the source code and compile. fceuconfig.cpp from the source code and compile.
* 'Auto' settings for save/load - attempts to automatically determine * 'Auto' settings for save/load - attempts to automatically determine
your load/save device(s) - SD, USB, Memory Card, DVD, SMB your load/save device(s) - SD, USB, Memory Card, DVD, SMB
@ -612,15 +619,15 @@ fceugx Contains the directory structure required for storing
Artwork, covers or screenshots will be displayed on the main menu when Artwork, covers or screenshots will be displayed on the main menu when
each game is selected. Select which type to display on the menu by going each game is selected. Select which type to display on the menu by going
to Settings > Menu > Preview Image. Each image resides in the respectively to Settings > Menu > Preview Image. Each image resides in the respectively
named folder (eg: sd:/fceugx/covers). They should be a PNG named exactly named folder (eg: sd:/fceugx/covers). They should be a PNG named exactly
the same as as the rom and sized no more than 640px by 480px. Recommendend the same as as the rom and sized no more than 640px by 480px. Recommendend
format is 160px x 224px PNG with a 32bit depth. format is 160px x 224px PNG with a 32bit depth.
### Loading / Running the Emulator: ### Loading / Running the Emulator:
#### Wii - Via Homebrew Channel: #### Wii - Via Homebrew Channel:
The most popular method of running homebrew on the Wii is through the Homebrew The most popular method of running homebrew on the Wii is through the Homebrew
Channel. If you already have the channel installed, just copy over the apps Channel. If you already have the channel installed, just copy over the apps
folder included in the archive into the root of your SD card. folder included in the archive into the root of your SD card.
Remember to also create the fceugx directory structure required. See above. Remember to also create the fceugx directory structure required. See above.
@ -629,43 +636,43 @@ If you haven't installed the Homebrew Channel yet, read about how to here:
http://hbc.hackmii.com/ http://hbc.hackmii.com/
#### Gamecube: #### Gamecube:
You can load FCEUGX via sdload and an SD card in slot A, or by streaming You can load FCEUGX via sdload and an SD card in slot A, or by streaming
it to your Gamecube, or by booting a bootable DVD with FCEUGX on it. it to your Gamecube, or by booting a bootable DVD with FCEUGX on it.
This document doesn't cover how to do any of that. This document doesn't cover how to do any of that.
#### ROMS, Preferences, and Saves: #### ROMS, Preferences, and Saves:
By default, roms are loaded from "fceugx/roms/" and saves / preferences are By default, roms are loaded from "fceugx/roms/" and saves / preferences are
stored in "fceugx/saves/". stored in "fceugx/saves/".
#### Wii #### Wii
On the Wii, you can load roms from SD card (Front SD or SD Gecko), USB, DVD, On the Wii, you can load roms from SD card (Front SD or SD Gecko), USB, DVD,
or SMB share. Note that if you are using the Homebrew Channel, to load from or SMB share. Note that if you are using the Homebrew Channel, to load from
USB, DVD, or SMB you will first have to load FCEUGX from SD, and then set USB, DVD, or SMB you will first have to load FCEUGX from SD, and then set
your load method preference. your load method preference.
If you are planning to use your Network (LAN) to load and/or save games from If you are planning to use your Network (LAN) to load and/or save games from
you will need to enter in the SMB share settings you haveve setup on your you will need to enter in the SMB share settings you haveve setup on your
computer via the Settings menu. You will need to enter in the SMB Share IP, computer via the Settings menu. You will need to enter in the SMB Share IP,
Share Name, Share Username and Share Password. Share Name, Share Username and Share Password.
#### Gamecube #### Gamecube
You can load roms from DVD or SD card. If you create a bootable You can load roms from DVD or SD card. If you create a bootable
DVD of FCEUGX you can put roms on the same DVD. You may save preferences and DVD of FCEUGX you can put roms on the same DVD. You may save preferences and
game data to SD or Memory Card. game data to SD or Memory Card.
#### Famicom Disk System (FDS) #### Famicom Disk System (FDS)
FCE Ultra GX supports loading FDS games. The FDS BIOS is required - put it FCE Ultra GX supports loading FDS games. The FDS BIOS is required - put it
in your fceugx folder, and name it disksys.rom (should be 8 KB in size). in your fceugx folder, and name it disksys.rom (should be 8 KB in size).
You can switch disks using the A button (by default). The mapped button You can switch disks using the A button (by default). The mapped button
can be changed under Controller Configuration ('Special' button). can be changed under Controller Configuration ('Special' button).
Compatibility is limited, so check that the game in question works on Compatibility is limited, so check that the game in question works on
FCEUX for Windows before asking for help. FCEUX for Windows before asking for help.
#### 3D Game Support #### 3D Game Support
Supported Famicom 3D System games: Supported Famicom 3D System games:
* Highway Star * Highway Star
* Famicom Grand Prix II * Famicom Grand Prix II
* 3D Hot Rally * 3D Hot Rally
@ -695,7 +702,7 @@ Timing - NTSC or PAL (Depends if you're running a PAL or NTSC game)
Logo design mvit Logo design mvit
Additional updates/fixes Zopenko, Burnt Lasagna, Askot Additional updates/fixes Zopenko, Burnt Lasagna, Askot
Beta testing, bug reports Sindrik, niuus Beta testing, bug reports Sindrik, niuus
FCE Ultra GX GameCube SoftDev, FCE Ultra GX GameCube SoftDev,
askot & dsbomb askot & dsbomb
@ -711,4 +718,4 @@ Timing - NTSC or PAL (Depends if you're running a PAL or NTSC game)
FCEUGX Web Site FCEUGX Web Site
https://github.com/dborth/fceugx https://github.com/dborth/fceugx