JOY(1)                                                     JOY(1)

     NAME
          joy - joystick input for games

     SYNOPSIS
          joy [ player ]

     DESCRIPTION
          Joy interprets input from a USB joystick device (see
          nusb(4)) to pass it on to a console emulator as a string of
          controller keys which are pressed down.

          The optional player argument specifies a player number for
          those emulators that support it.  It should be an integer
          equal to 1 or greater.  Currently only players 1 and 2 are
          supported.

          Note that each USB controller has its own mappings and the
          program may have to be modified to use its own key ids.

     EXAMPLES
          Use USB device 10 as a joystick for the player number 1's
          controller with the Nintendo Entertainment System (NES) emu-
          lator:

               % nusb/joy /dev/usb/ep10.0 | joy 1 | games/nes -a rom.nes

     SEE ALSO
          atari(1), nintendo(1), sega(1), nusb(4)

     SOURCE
          /rc/bin/joy

     HISTORY
          Joy first appeared in 9front (June, 2014).

     Page 1                       Plan 9            (printed 10/25/25)