https://wiki.gnome.org/Apps/Games?action=AttachFile&do=get&target=games-logo.png

Games

Browse and play your games



Here is some useful information about how Games works:

Installing Games

Flatpak (recommended)

Games is available via Flatpak, make sure that your have Flatpak in order to use these. The stable version is the recommended way of getting Games.

Software should open the .flatpakref file, iIf this does not work, you can just run one of the following commands to install Games:

Stable version:

flatpak install https://flathub.org/repo/appstream/org.gnome.Games.flatpakref

Nightly version:

flatpak install https://git.gnome.org/browse/gnome-apps-nightly/plain/gnome-games.flatpakref

Distributions

Alternatively, your software distribution may offer you packages for Games. Here is a list of known supporting distros:

  • Arch Linux: the stable version is available from the [community] repository.

  • Debian unstable: install the gnome-games-app package

  • openSUSE Tumbleweed: install the gnome-games package

  • Ubuntu 17.04: install the gnome-games-app package

Your games collection

Games tries to present all your games regardless of their platform of origin. For non-native games to be launched, other pieces of software are needed; see the Running games section below.

Games will present you:

  • games you can already find in your applications list, i.e your native desktop games
  • installed Steam games

  • games for several game engines
  • and games for many retro video game systems

Here are the supported platforms as of 3.26:

Platform

Common File Extensions

Automatically Listed

Playable in 3.26 Flatpak

Playable in Unstable Nightly Flatpak

Amiga

*.adf

No plugin provided

No plugin provided

Atari 2600

*.a26

Stella

Stella

Atari 7800

*.a78

No plugin provided

ProSystem

Atari Lynx

*.lnx

No plugin provided

Handy

Desktop

*.desktop

Not in Flatpak

773781

773781

Dreamcast

*.dc

No plugin provided

No plugin provided

Famicom Disk System

*.fds

Nestopia

Nestopia

GameCube

*.gc

No plugin provided

No plugin provided

Game Boy Advance

*.gba

mGBA

mGBA

Game Boy Color

*.gbc

Gambatte

Gambatte

Game Boy

*.gb

Gambatte

Gambatte

Game Gear

*.gg

No plugin provided

No free-software plugin

id Tech

*.wad

No plugin provided

PrBoom

Libretro

*.libretro + *.so

LÖVE

*.love

773781

773781

MAME

*.zip 1

No plugin provided

MAME

MS-DOS

*.exe

Can't discriminate games

No plugin provided

DOSBox

Neo Geo Pocket Color

*.ngc

Beetle NeoPop

Beetle NeoPop

Neo Geo Pocket

*.ngp

Beetle NeoPop

Beetle NeoPop

Nintendo 64

*.n64

No plugin provided

No plugin provided

Nintendo DS

*.nds

No plugin provided

DeSmuME

Nintendo Entertainment System

*.nes

Nestopia

Nestopia

PlayStation

*.cue + *.bin

PCSX ReARMed

PCSX ReARMed

Sega 32X

*.32x

No plugin provided

No free-software plugin

Sega CD

*.cue + *.bin

No plugin provided

No free-software plugin

Sega Genesis/Mega Drive

*.gen 2

No plugin provided

BlastEm

Sega Master System

*.sms

No plugin provided

No free-software plugin

Sega Pico

*.gen

No plugin provided

No free-software plugin

Sega Saturn

*.cue + *.bin

No plugin provided

Beetle Saturn

SG-1000

*.sg

No plugin provided

No free-software plugin

Steam

*.acf

773781

773781

Super Nintendo Entertainment System

*.sfc

bsnes

bsnes

TurboGrafx-16

*.pce

Beetle PCE Fast

Beetle PCE Fast

TurboGrafx-CD

*.cue + *.bin

Beetle PCE Fast

Beetle PCE Fast

WiiWare

*.wad

No plugin provided

No plugin provided

Wii

*.wii

No plugin provided

No plugin provided

WonderSwan Color

*.wsc

Beetle Cygne

Beetle Cygne

WonderSwan

*.ws

Beetle Cygne

Beetle Cygne

  • "Automatically listed" means that Games will try to automatically detect the games on your system. For games which are not automatically listed or if the detection didn't work, see the Adding games section below.

  • "Playable in 3.26 Flatpak" means that the games can be played as-is with our Flatpak version of Games.
  • "Playable in Unstable Nightly Flatpak" means that the games can be played as-is with our Unstable Nightly Flatpak version of Games.
  • "No plugin provided" means that we do not provide yet in our Flatpak version the required plugin to play games of that platform (see the Roadmap for more info).

  • "No free-software plugin" means that we don't know free-software plugins supporting this platform.

Adding games

In order for Games to discover your games, they have to be located in a searchable place. If your games don't show up, follow these steps:

  • open the GNOME Settings app and click on "Search"
  • click on the "gear" button in the bottom right of the Control Center window
  • setup the places where Games is allowed to search for your games (for example, in a "Games" directory located in your home directory)

If your games or not automatically detected or if the auto-detection didn't work, you can use the "Add game files…" button to select game files to add manually.

Please note that — except if stated otherwise — ROM files need to be unzipped for Games to list them.

Covers

Games fetchs your games' cover art from TheGamesDB, an open video game database that anyone can freely contribute to. If you find a missing cover, contributing to TheGamesDB should make it appear in Games.

If your game is represented by a file, you can use the image of your choice as the game's cover by putting it alongside the game's file and by giving it a similar filename, as demonstrated in the screenshots below:

  • attachment:gnome-games-custom-covers-files.png attachment:gnome-games-custom-covers.png

Alternatively, you could name the file cover.* or folder.*.

Running games

Retro games

Games is relying on Libretro cores to make retro games work.

Currently, the Flatpak releases of Games come bundled with functional Libretro cores, hand-picked for their good accuracy, their reasonable system requirements, their free license and their independence from proprietary (and forbidden to share) firmware files. Find out which ones are currently bundled on our design page.

If you don't use the Flatpak version and depending on your software distribution you may need to install Libretro cores separately. Check your distribution for more information.

Firmware configuration

In most of the situations, no external firmware (BIOS) file should be required to play retro games.

Some Libretro cores can or must use an external firmware, they describe them in their Libretro Core Descriptor file. You firmwares files for a specific platform will be looked for in the ~/.config/gnome-games/platforms/PLATFORM/system directory, where PLATFORM is the corresponding platform as defined here. The files must match the ones described by the core's descriptor.

LÖVE

Games using the LÖVE framework require LÖVE to be installed on your machine. As usual, check if your distribution supports LÖVE (the official LÖVE website provides PPAs for Ubuntu).

Gamepad handling

Games currently does not have a user interface to handle the gamepads. Controllers are automatically assigned to players, following this scheme:

  • when a gamepad is plugged in, it is assigned to the first player with no gamepad;
  • when a gamepad is plugged out, the player which had it have no gamepad instead and any other player keep its controller;
  • the keyboard is assigned to the first player with no controller after reassigning the gamepads.

Supported gamepads

The following gamepads have been tested with Games and should work out-of-the-box:

  • Xbox 360 Controller for Windows (Wired)
  • DUALSHOCK 3 (for wireless support, BlueZ needs to be installed on your system)

Mouse peripherals such as the Super NES Mouse (required by games such as Mario Paint) are currently not supported.

Gamepad layouts are provided by the SDL_GameControllerDB project.

Packaging Libretro cores

Games supports only Libretro cores shipping a Libretro Core Descriptor file. The cores and their descriptors are looked for in $(libdir)/libretro directory and in paths defined in the LIBRETRO_PLUGIN_PATH environment variable.

Visit the logo page to get the logos.

  1. Please note that MAME ROMs must not be unzipped. (1)

  2. Some Mega Drive roms come with the *.md extension instead; you can safely rename them to *.gen. (2)

Apps/Games/Documentation (last edited 2017-11-20 07:46:13 by AdrienPlazas)