mirror of
https://github.com/lutris/lutris
synced 2024-09-05 07:23:32 +00:00
132 lines
3.8 KiB
ReStructuredText
132 lines
3.8 KiB
ReStructuredText
******
|
|
Lutris
|
|
******
|
|
|
|
Lutris is an open source gaming platform for GNU/Linux. It makes gaming
|
|
on Linux easier by taking care of managing, installing and providing
|
|
optimal settings for games.
|
|
|
|
Lutris does not sell games, you have to provide your own copy of the games
|
|
unless they are Open Source or Freeware.
|
|
The games can be installed anywhere you want on your system, the tool
|
|
does not impose anything.
|
|
|
|
Lutris relies on various programs referenced as 'runners' to provide a
|
|
vast library of games. These runners (with the exception of Steam,Desura
|
|
and Web browsers) are provided by lutris, you don't need to install them
|
|
with your package manager.
|
|
We currently support the following runners:
|
|
|
|
* Linux (Native games)
|
|
* Steam
|
|
* Desura (Experimental support)
|
|
* Web browser
|
|
* Wine
|
|
* Wine + Steam
|
|
* DosBOX
|
|
* Mame
|
|
* Mess
|
|
* ScummVM
|
|
* Mednafen
|
|
* FS-UAE
|
|
* Vice
|
|
* Stella
|
|
* Atari800
|
|
* Hatari
|
|
* Virtual Jaguar
|
|
* Snes9x
|
|
* Mupen64 Plus
|
|
* PCSXR
|
|
* Osmose
|
|
* GenS
|
|
* NullDC (using wine)
|
|
* OpenMSX
|
|
* Frotz
|
|
* Jzintv
|
|
* O2em
|
|
|
|
Runners that will be added in future versions of Lutris:
|
|
|
|
* PCSX2
|
|
* Dolphin
|
|
* Reicast (replacing NullDC)
|
|
|
|
Installer scripts
|
|
=================
|
|
|
|
Lutris automates installation of games using configuration files written
|
|
in JSON or YAML, these scripts list various files needed to install a game
|
|
and run a list of actions on them (such as extract, move, execute, …).
|
|
The syntax of installers is described in `docs/installers.rst` (also
|
|
available on lutris.net when writing installers).
|
|
|
|
A web UI is planned to ease the creation of these scripts.
|
|
|
|
Game Library
|
|
============
|
|
|
|
You can optionally create an account on lutris.net and connect to this
|
|
account on the client. This will allow you to sync your game library from
|
|
the website to the client (not the other way around). If you wish, you can
|
|
sync your Steam library with your Lutris library on the website.
|
|
|
|
The client does not store your lutris.net on your computer. Instead, when
|
|
you authenticate, the website will send a token which will be used to
|
|
sync your library.
|
|
|
|
Configuration files
|
|
===================
|
|
|
|
The client, runner and games configuration files are stored in
|
|
~/.config/lutris. There is no need to manually edit these files as
|
|
everything should be done from the client.
|
|
|
|
`lutris.conf`: stores preferences for the client's UI
|
|
|
|
`system.yml`: stores configuration that will be used for every game
|
|
|
|
`runners/*.yml`: stores configuration used for any game from a particular
|
|
runner
|
|
|
|
`games/*.yml`: stores configuration used for a specific game
|
|
|
|
The game configuration can override previously defined runner and system
|
|
configuration and runner configuration can override system configuration.
|
|
|
|
Runners and game database
|
|
=========================
|
|
|
|
The data necessary to manage your library and run the game is stored in
|
|
~/.local/share/lutris .
|
|
|
|
`pga.db`: stores your game library, the installation status, the location
|
|
on the filesystem plus some additional metadata. This file is a SQLite
|
|
database.
|
|
|
|
`runners/*`: runners downloaded from lutris.net (emulators and such)
|
|
|
|
`icons/*.png` and `banners/*.jpg`: images for the games.
|
|
|
|
Command line options
|
|
====================
|
|
|
|
The following command line arguments are available::
|
|
|
|
--version show program's version number and exit
|
|
-h, --help show this help message and exit
|
|
-v, --verbose Verbose output
|
|
-d, --debug Show debug messages
|
|
-i INSTALLER_FILE, --install=INSTALLER_FILE
|
|
Install a game from a yml file
|
|
-l, --list-games List all games in database
|
|
-s, --list-steam List Steam (Windows) games
|
|
--reinstall Reinstall game
|
|
|
|
Additionally, you can pass a `lutris:` protocol link followed by a game
|
|
identifier on the command line such as::
|
|
lutris lutris:quake
|
|
|
|
This will install the game if not already installed or launch the game
|
|
otherwise (unless the `--reinstall` flag is passed).
|
|
|