Commit 15b3dc8b authored by Screwtape's avatar Screwtape

More cleanups and revision.

parent d621136d
Pipeline #11132328 passed with stage
in 12 minutes and 28 seconds
......@@ -61,8 +61,9 @@ because there's two parts to it:
telling icarus where to put imported games,
and telling higan where to find them.
1. If necessary,
create the folder you want higan to use
1. Move your existing game library folder
to the new location,
or otherwise create the folder you want higan to use
as its game library.
1. Launch icarus,
then click the "Settings ..." button in the lower-right,
......@@ -11,28 +11,56 @@ unusual hardware.
Regular games
icarus supports importing games
icarus can import games
in the most commonly-used formats
for each supported console,
and also those same formats inside `.zip` files.
and also those same formats inside `.zip` files
(as long as tthe `.zip` file contains only one game).
More advanced compression formats
like RAR or 7-zip are not supported.
For most games
that do not use special chips or co-processors,
importing a game is straight-forward.
From [the Library menu](../interface/
To import a game,
open [the Library menu](../interface/,
choose "Load ROM File ..."
to open [a filesystem browser](../interface/,
choose the game you want to play,
choose the ROM file of the game you want to play,
and it will be imported into the library and loaded.
To play the game again
select the console the game runs on from
[the Library menu](../interface/
to open another
[filesystem browser](../interface/
that lists all the previously-imported games for that platform.
If you want to import many games,
run icarus directly,
or choose "Import ROM Files ..."
from the Library menu
(which just runs icarus anyway).
See [the icarus documentation](../interface/ for details.
To play a game for a particular console from your library,
open the Library menu,
pick the console manufacturer submenu
(Nintendo for the Super Famicom,
Bandai for the WonderSwan,
then choose the appropriate console menu item.
A filesystem browser will appear
listing all the games in your library
for that particular console.
Select the game you want to play
and click the Open button,
or just double-click the game,
and it will begin playing as though you'd just turned on the console.
the NTSC and PAL variants of a particular console
behave differently,
or the Japanese and American variants.
When choosing a game from the Game Library,
a drop-down list in the bottom-right of the filesystem browser
allows you to choose which regional variation
of the console it should emulate.
For most consoles,
higan can reliably guess which variant to use,
and the list defaults to "Auto".
Games with co-processor firmware
......@@ -31,7 +31,7 @@ It also includes some level of support for these consoles:
- Sega Megadrive/Genesis
- NEC PC Engine/TurboGrafx 16 (but not the CD-ROM² System/TurboGrafx-CD)
- NEC SuperGrafx
- Bandai Wonderswan
- Bandai WonderSwan
- Bandai Wonderswan Color
**Note:** Some consoles were released under different names
This diff is collapsed.
......@@ -2,7 +2,15 @@ When launching icarus,
directly or by picking "Import ROM Files ..."
from higan's [Library menu](,
the main icarus window appears.
This is [a filesystem browser](,
This window allows you to bulk-import ROM files
into [higan's game library][gamelib],
and also to access icarus' settings.
Bulk importing ROM files
icarus' main window
is [a filesystem browser](,
with customisations:
- The filesystem browser only lists
......@@ -15,22 +23,24 @@ with customisations:
- You can un-tick all the check-boxes
by pressing "Unselect All" in the bottom-left.
Pressing "Settings ..." in the bottom-right
opens [the icarus Settings dialog](#the-icarus-settings-dialog).
Pressing "Import ..." in the bottom-right
will close the filesystem browser
then try to import all the files
whose check-boxes are ticked
into [the Game Library][gamelib].
icarus displays a progress dialog during the import process.
icarus displays a progress dialog during the import process,
and a result window if any errors occurred.
**Note:** Some games require extra steps to import correctly;
see [the Game Library][gamelib] for details.
see [Importing and playing games](../guides/ for details.
The icarus Settings dialog
Pressing "Settings ..."
in the bottom-right corner of the main icarus window
opens the settings dialog.
The icarus Settings dialog contains the following settings:
- **Library Location** determines
......@@ -98,6 +98,7 @@ struct InputJoypadUdev {
auto rumble(uint64_t id, bool enable) -> bool {
print("Joypad ", id, " rumble: ", enable, "\n");
for(auto& jp : joypads) {
if(jp.hid->id() != id) continue;
if(!jp.hid->rumble()) continue;
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment