Sunteți pe pagina 1din 5
Apps / Games / Documentation Home RecentChanges Schedule Login Home Documentation Games Browse and play
/ Games / Documentation Home RecentChanges Schedule Login Home Documentation Games Browse and play your games

Games

Browse and play your games

Here is some useful information about how Games works:

Installing Games

Flatpak (recommended)

Games is available via Flatpak. The stable Flatpak version is the recommended way of getting Games. Also, your system needs to have at least Tracker 2.0 installed for Games to work.

Get Games 3.30.2
Get Games 3.30.2

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

Stable version:

Contents 1. Installing Games 1. Flatpak (recommended) 2. Distributions 2. Your games collection 1. Supported
Contents
1. Installing Games
1. Flatpak (recommended)
2. Distributions
2. Your games collection
1. Supported platforms
2. Adding games
3. Covers
3. Running games
1. Retro games
1. Packaged Libretro cores
2. Firmware configuration
3. LÖVE
4. Gamepad handling
1. Supported gamepads
5. Testing
6. Logo

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

Nightly version:

flatpak install https://gitlab.gnome.org/GNOME/gnome-apps-nightly/raw/master/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. the stable version is available from the [community] repository.

version is available from the [community] repository. Debian unstable: install the gnome-games-app package

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

Debian unstable: install the gnome-games-app package openSUSE Tumbleweed: install the gnome-games package

openSUSE Tumbleweed: install the gnome-games package install the gnome-games package

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

Ubuntu 17.04: install the gnome-games-app package Note that the packaged versions fuctions differently

Note that the packaged versions fuctions differently regarding to non-native games support; see the Packaged Libretro cores

section below for more info.

Your games collection

regarding to non-native games support; see the Packaged Libretro cores section below for more info. Your

Games tries to present all your games regardless of their platform of origin:

games you can already find in your applications list, i.e your native desktop games (installed from a flatpak file or your distro's package manager)all your games regardless of their platform of origin: installed Steam games games for several game

installed Steam games Steam games

games for several game enginesyour distro's package manager) installed Steam games and games for many retro video game systems Supported

and games for many retro video game systemsinstalled Steam games games for several game engines Supported platforms Here are the supported platforms as

Supported platforms

Here are the supported platforms as of version 3.30:

 

Common File

Playable in 3.30 Flatpak

Playable in Unstable Nightly Flatpak

 

Platform

 

Extensions

Automatically Listed

 
*.adf
*.adf

No plugin provided

No plugin provided

 
 
*.a26
*.a26

     
 
*.a78
*.a78

 
*.lnx
*.lnx

     
     

 

 

No plugin provided

No plugin provided

 

Nestopia (Firmware

Nestopia (Firmware

 
 

required)

 

required)

 

No plugin provided

No plugin provided

 
     
   

No plugin provided

   
 

 

 

No plugin provided

   
   
*.exe
*.exe
 

Can't discriminate

 

games

No plugin provided

   
Neo Geo Pocket Color *.ngc   ✓ Beetle NeoPop   Beetle NeoPop  
*.ngc
*.ngc
 

   
Neo Geo Pocket   *.ngp ✓ Beetle NeoPop Beetle NeoPop
Neo Geo Pocket
 
*.ngp
*.ngp

Nintendo 64   *.n64 ✓ No plugin provided No plugin provided  
Nintendo 64
 
*.n64
*.n64

No plugin provided

No plugin provided

 
Nintendo DS   *.nds ✓   DeSmuME 2015   DeSmuME 2015  
Nintendo DS
 
*.nds
*.nds

     
   
Entertainment System *.nes   ✓   Nestopia   Nestopia  
*.nes
*.nes
 

     
PlayStation   *.cue + *.bin   ✓   PCSX ReARMed   PCSX ReARMed  
PlayStation
 

*.cue + *.bin

 

     
 
*.32x
*.32x

No plugin provided

No free-software plugin

 

*.cue + *.bin

 

No plugin provided

No free-software plugin

   
*.gen 3
*.gen 3
       

No plugin provided

 
 
Sega Master System
 
*.sms
*.sms

     
 
*.gen
*.gen

No plugin provided

No free-software plugin Beetle Saturn

   
 
Sega Saturn
 

*.cue + *.bin

 

No plugin provided

 
*.sg
*.sg

No plugin provided

No free-software plugin

 
*.acf
*.acf

 

 

 
Super Nintendo        
Super Nintendo
       
 

 
 
Entertainment

System

*.sfc
*.sfc
       
 
 
*.pce
*.pce

 

(Firmware required)

(Firmware required)

 

*.cue + *.bin

 
*.vb
*.vb
*.wad
*.wad

Wii

*.wii
*.wii
*.wsc
*.wsc
 
*.ws
*.ws

"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. Adding games section below.

"Playable in 3.30 Flatpak" means that the games can be played as-is with our stable Flatpak of Games.didn't work, see the Adding games section below. "Playable in Unstable Nightly Flatpak" means that

"Playable in Unstable Nightly Flatpak" means that the games can be played as-is with our Unstable Nightly Flatpak version of Games.games can be played as-is with our stable Flatpak of Games. "No plugin provided" means that

"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). Roadmap for more info).

"No free-software plugin" means that we don't know free-software plugins supporting this platform.games of that platform (see the Roadmap for more info). Adding games In order for Games

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"place. If your games don't show up, follow these steps: click on the "gear" button in

click on the "gear" button in the bottom right of the Control Center windowopen the GNOME Settings app and click on "Search" setup the places where Games is allowed

setup the places where Games is allowed to search for your games (for example, in a "Games" directory located in your home directory)button in the bottom right of the Control Center window If your games or not automatically

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. If your PlayStation games are splitted into multiple *.bin files without a cue sheet, you can generate one on this website.

a cue sheet, you can generate one on this website . Covers Games fetchs your games'

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:

similar filename, as demonstrated in the screenshots below: Alternatively, you could name the file cover.* or

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. The bundled cores are listed in the "Supported platforms" table above. More technical info can be found on our design page.

More technical info can be found on our design page . Packaged Libretro cores If you
More technical info can be found on our design page . Packaged Libretro cores If you

Packaged Libretro cores

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.

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. If you're encoutering issues with missing core descriptor files, please see this Ubuntu bug report for more info.

files, please see this Ubuntu bug report for more info. Some cores that cannot be bundled
files, please see this Ubuntu bug report for more info. Some cores that cannot be bundled

Some cores that cannot be bundled with the official Flatpak releases of Games (such as non-free cores) are available as Flatpak extensions; those are listed on our design page.

Flatpak extensions; those are listed on our design page . Firmware configuration In most of the

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.

describe them in their Libretro Core Descriptor file . Your firmware files for a specific platform

Your firmware files for a specific platform will be looked for in a specific directory depending of the version of Games you're using:

LÖVE Flatpak version: ~/.var/app/org.gnome.Games/config/gnome-games/platforms/[PLATFORM]/system , where [PLATFORM] is

LÖVE

LÖVE Flatpak version: ~/.var/app/org.gnome.Games/config/gnome-games/platforms/[PLATFORM]/system , where [PLATFORM] is

Flatpak version: ~/.var/app/org.gnome.Games/config/gnome-games/platforms/[PLATFORM]/system , where [PLATFORM] is the corresponding platform ~/.var/app/org.gnome.Games/config/gnome-games/platforms/[PLATFORM]/system , where [PLATFORM] is the corresponding platform as defined here (i.e. "TurboGrafxCD").

platform as defined here (i.e. "TurboGrafxCD"). Other versions:
platform as defined here (i.e. "TurboGrafxCD"). Other versions:
platform as defined here (i.e. "TurboGrafxCD"). Other versions:
platform as defined here (i.e. "TurboGrafxCD"). Other versions:

Other versions: ~/.config/gnome-games/platforms/PLATFORM/system ~/.config/gnome-games/platforms/PLATFORM/system

The files must match the ones described by the core's descriptor. Check the cores listed in the supported platforms list and

read the corresponding libretro docs page to know which firmware files are needed and how to name them.

Gamepad handling

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;are automatically assigned to players following this scheme: when a gamepad is plugged out, the player

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

the keyboard is assigned to the first player with no controller after reassigning the gamepads.no gamepad instead and any other player keep its controller; Supported gamepads The following gamepads have

Supported gamepads

The following gamepads have been tested with Games and should work out-of-the-box (for wireless support, make sure Bluetooh is supported by your system):

Xbox 360 Controller for Windows (Wired only)support, make sure Bluetooh is supported by your system): DUALSHOCK 3 DUALSHOCK 4 8Bitdo SF30 Pro

DUALSHOCK 3your system): Xbox 360 Controller for Windows (Wired only) DUALSHOCK 4 8Bitdo SF30 Pro (in XInput

DUALSHOCK 4Xbox 360 Controller for Windows (Wired only) DUALSHOCK 3 8Bitdo SF30 Pro (in XInput mode) Mouse

8Bitdo SF30 Pro (in XInput mode) 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. Mario Paint) are currently not supported. Gamepad layouts are provided by the SDL_GameControllerDB project.

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).

Testing

To help ensuring that the Libretro cores we ship in the Flatpak version are of good quality, Games run reference tests powered by the retro-gtk based retro-reftest program. If you want to write such tests to improve Games or to run automated tests on your Libretro core, please read the Retro Reference Test Case Specification.

Logo Visit the logo page to get the logos.

Logo

Logo Visit the logo page to get the logos.
Logo Visit the logo page to get the logos.

Visit the logo page to get the logos.

. Logo Visit the logo page to get the logos. Deserialization crashes Games. ( 1 )

Deserialization crashes Games. (1) Please note that MAME ROMs must not be unzipped. (2) Some Mega Drive roms come with the *.md extension instead; you can safely rename them to *.gen . (3)

instead; you can safely rename them to *.gen . ( 3 ) Apps/Games/Documentation (last edited 2019-01-19
instead; you can safely rename them to *.gen . ( 3 ) Apps/Games/Documentation (last edited 2019-01-19

Apps/Games/Documentation (last edited 2019-01-19 15:01:16 by AlexanderMikhaylenko)

Titles Text
Titles
Text

Copyright © 2005 - 2019 The GNOME Project. Hosted by Red Hat.

15:01:16 by AlexanderMikhaylenko ) Titles Text Copyright © 2005 - 2019 The GNOME Project . Hosted