glenda.party
term% ls -F
term% cat index.txt
NINTENDO(1)                 General Commands Manual                NINTENDO(1)

NAME
       gb, gba, nes, snes - emulators

SYNOPSIS
       games/gb [ -23acdT ] [ -C ...  ] romfile
       games/gba [ -23aT ] [ -b biosfile ] [ -s savetype ] romfile
       games/nes [ -23aos ] romfile
       games/snes [ -23ahmsT ] romfile

DESCRIPTION
       Gb,  gba, nes and snes are emulators for the Nintendo Game Boy and Game
       Boy Color (GB and GBC), Nintendo Game Boy Advance (GBA),  Nintendo  En‐
       tertainment  System  (NES),  and  Super  Nintendo  Entertainment System
       (SNES).  They execute the romfile given as an argument.  The z,  x,  a,
       s,  return  and  shift keys correspond to B, A, Y, X, Start and Select,
       respectively.  Other keys:

       F5     Save the current state  in  gb.save  /  gba.save  /  nes.save  /
              snes.save.

       F6     Load  the  current  state  from  gb.save / gba.save / nes.save /
              snes.save.

       Esc    Pause the emulator.

       Del    Exit the emulator.

       Command line options:

       -2 -3  Scale the screen by the given factor.

       -a     Enable audio output.

       -T     Display percentage of how fast the emulator is running  relative
              to a real console.

       gb options:

       -c     Run GBC roms in GBC mode and DMG (GB) roms in GBC's DMG compati‐
              bility mode.

       -d     Run  GB  roms  in  DMG  mode. GBC-only roms will not run in this
              mode; others will run only in black & white.

       -Cnnnnnn,nnnnnn,nnnnnn,nnnnnn
              Select a color palette. Has no effect on roms in color mode. The
              syntax is of the form -C ffffff,aaaaaa,555555,000000 (using HTML
              style rrggbb notation).

       gba options:

       -b     Location of the GBA BIOS file (required to  operate  the  emula‐
              tor). Default is /sys/games/lib/gbabios.bin.

       -s     Save  format  used by the original game. Valid formats are: eep‐
              rom4, eeprom64, sram256, flash512, flash1024. The number  corre‐
              sponds  to  the size, in kilobits, of the save file. By default,
              the emulator attempts to automatically detect the  save  format,
              but does not always succeed.

       nes options:

       -o     Hide  the  top  and  bottom eight pixels (overscan area), like a
              real television would.

       -s     Save contents of battery backed SRAM (used  by  some  games  for
              savegames)  as  a file (gb and snes automatically detect if this
              is needed).

       snes options:

       -h     Override HiROM/LoROM detection: -h sets LoROM, -hh sets HiROM.

       -m     Enable mouse emulation using system mouse. Mouse button 1  (left
              button)  engages  the  SNES  left  mouse  button. Mouse button 3
              (right button) engages the SNES right mouse button. Holding down
              mouse button 2 (middle button) disengages  the  SNES  mouse  en‐
              tirely so that the Plan 9 cursor offset can be adjusted to align
              with the SNES cursor.

SOURCE
       /sys/src/games/gb
       /sys/src/games/gba
       /sys/src/games/nes
       /sys/src/games/snes

BUGS
       You bet!
       SRAM saving on the NES only functions when the -s option is used.
       The SNES horizontal hires mode is supported only with -2 scaling.
       All  emulators  assume  a  North American (i.e. NTSC) system. PAL games
       (and in some cases Japanese games) are not supported.

HISTORY
       Gb first appeared in 9front (April, 2012).
       Gba first appeared in 9front (September, 2014).
       Nes first appeared in 9front (February, 2014).
       Snes first appeared in 9front (March, 2014).

                                                                   NINTENDO(1)