summaryrefslogtreecommitdiffstats
path: root/games/higan/higan.rst
blob: fb452fb58194809376969b3f93d02119974707f1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
.. RST source for higan(6) man page. Convert with:
..   rst2man.py higan.rst > higan.6
.. rst2man.py comes from the SBo development/docutils package.

.. |version| replace:: 106
.. |date| date::

=====
higan
=====

-----------------------------
multi-system console emulator
-----------------------------

:Manual section: 6
:Manual group: SlackBuilds.org
:Date: |date|
:Version: |version|

SYNOPSIS
========

higan [--fullscreen] [GAME [SUBGAME1 [SUBGAME2]]]

DESCRIPTION
===========

When launched with --fullscreen, higan will automatically enter fullscreen mode
when it starts, otherwise it starts in windowed mode. This is not much use
unless you also specify GAME, because you won't be able to load a game until you
exit fullscreen mode by pressing the "Toggle Fullscreen" hotkey.

When GAME is not given, higan starts with no game loaded.

When GAME is the path to an existing game folder for any supported console, that
game will automatically be loaded after higan starts.

When GAME is the path to a ROM file for any supported console, it will be
imported into a game folder in the Game Library, and loaded from there after
higan starts.

When GAME is of the form REGION|PATH (that is, a region code, a vertical bar
(|), and a path to a game folder or ROM file) higan will load the game at PATH
into the REGION variant of the appropriate console, rather than detecting which
variant the game expects. This is the command-line equivalent of choosing a
region from the drop-down in the bottom-right of the filesystem browser window
when you load a game from the game library. The list of region codes differs
from console to console, so load a game from the library and check the list
before loading it from the command-line.

When GAME refers to a game with a Satellaview memory pak slot, SUBGAME1 should
be the path to a game folder or ROM file representing the memory pak to insert
into the slot. If SUBGAME1 is not supplied, higan will prompt for one. SUBGAME2
is ignored.

When GAME refers to the Super Game Boy or Super Game Boy 2, SUBGAME1 should be
the path to a game folder or ROM file representing a Game Boy game to insert
into the slot. If SUBGAME1 is not supplied, higan will prompt for one. SUBGAME2
is ignored.

When GAME refers to the Sufami Turbo, then SUBGAME1 should be the path to a game
folder or ROM file representing the mini-cartridge to be inserted into slot A of
the Sufami Turbo base cartridge, and SUBGAME2 is the same thing for slot B.
higan will prompt for any mini-cartridges not supplied on the command-line.

When GAME refers to any other game, both SUBGAME1 and SUBGAME2 are ignored.

EXAMPLES
========

Play a previously-imported copy of Super Mario World in fullscreen (assuming
Linux defaults):

  higan --fullscreen "$HOME/Emulation/Super Famicom/Super Mario World.sfc"

Play a previously-imported copy of Sonic the Hedgehog 3, forcing higan to
emulate a Japanese Mega Drive:

  higan "NTSC-J|$HOME/Emulation/Mega Drive/Sonic the Hedgehog 3.md"

AUTHORS
=======

higan was written by byuu.

This man page created for the SlackBuilds.org project
by B. Watson, by copying and reformatting higan-cli.md
from upstream's git.

SEE ALSO
========

icarus(6)

The higan homepage: https://byuu.org/emulation/higan/

Full documentation: https://higan.readthedocs.io/en/stable/