lutris/README.rst

169 lines
4.9 KiB
ReStructuredText
Raw Normal View History

2014-09-12 14:57:34 +00:00
******
2010-08-31 00:44:09 +00:00
Lutris
2014-09-12 14:57:34 +00:00
******
2010-08-31 00:44:09 +00:00
2014-09-12 14:57:34 +00:00
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.
2010-01-22 18:38:20 +00:00
2014-09-12 14:57:34 +00:00
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
and Web browsers) are provided by Lutris, you don't need to install them
2014-09-12 14:57:34 +00:00
with your package manager.
2014-09-12 14:57:34 +00:00
We currently support the following runners:
* Linux (Native games)
* Steam
* Web
2014-09-12 14:57:34 +00:00
* Wine
* Wine + Steam
* Libretro
* DOSBox
* MAME
* MESS
2014-09-12 14:57:34 +00:00
* ScummVM
* ResidualVM
* Adventure Game Studio
2014-09-12 14:57:34 +00:00
* Mednafen
* FS-UAE
* Vice
* Stella
* Atari800
* Hatari
* Virtual Jaguar
* Snes9x
* Mupen64Plus
* Dolphin
2016-03-22 16:43:19 +00:00
* PCSX2
* PPSSPP
2014-09-12 14:57:34 +00:00
* Osmose
* Reicast
2014-09-12 14:57:34 +00:00
* Frotz
* jzIntv
* O2EM
2015-12-29 09:27:35 +00:00
* ZDoom
* Citra
* DeSmuME
* DGen
2014-09-12 14:57:34 +00:00
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
2014-09-12 14:57:34 +00:00
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
<https://lutris.net>`_ and connect to this
2014-09-12 14:57:34 +00:00
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 credentials on your computer.
Instead, when you authenticate, the website will send a token which will
be used to sync your library. This token is stored in
``~/.cache/lutris/auth-token``
2010-01-22 18:38:20 +00:00
Configuration files
2014-09-12 14:57:34 +00:00
===================
The client, runner and games configuration files are stored in
``~/.config/lutris``. There is no need to manually edit these files as
2014-09-12 14:57:34 +00:00
everything should be done from the client.
``lutris.conf``: stores preferences for the client's UI
2014-09-12 14:57:34 +00:00
``system.yml``: stores configuration that will be used for every game
2014-09-12 14:57:34 +00:00
``runners/*.yml``: stores configuration used for any game from a particular
2014-09-12 14:57:34 +00:00
runner
``games/*.yml``: stores configuration used for a specific game
2014-09-12 14:57:34 +00:00
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``
2014-09-12 14:57:34 +00:00
``pga.db``: stores your game library, the installation status, the location
2014-09-12 14:57:34 +00:00
on the filesystem plus some additional metadata. This file is a SQLite
database.
``runners/*``: runners downloaded from lutris.net (emulators and such)
2010-01-22 18:38:20 +00:00
``icons/*.png`` and ``banners/*.jpg``: images for the games.
2010-01-22 18:38:20 +00:00
2014-09-12 14:57:34 +00:00
Command line options
====================
2010-01-22 18:38:20 +00:00
2014-09-12 14:57:34 +00:00
The following command line arguments are available::
2010-01-22 18:38:20 +00:00
2014-09-12 14:57:34 +00:00
--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
2016-09-29 03:21:05 +00:00
-o, --installed Only list installed games
-j, --json Display the list of games in JSON format
--list-steam-games List available Steam games
--list-steam-folders List all known Steam library folders
2014-09-12 14:57:34 +00:00
--reinstall Reinstall game
2010-01-22 18:38:20 +00:00
Additionally, you can pass a ``lutris:`` protocol link followed by a game
2014-09-12 15:00:03 +00:00
identifier on the command line such as::
2014-11-11 15:00:43 +00:00
2014-09-12 15:00:03 +00:00
lutris lutris:quake
This will install the game if not already installed or launch the game
otherwise (unless the ``--reinstall`` flag is passed).
2010-01-22 18:38:20 +00:00
2014-09-12 15:50:13 +00:00
Planned features
================
Lutris is far from complete and some of the most intertesting features
are yet to be implemented!
Here's what to expect from the future versions of lutris:
* Integration with GOG and Humble Bundle
2017-09-16 19:35:29 +00:00
* Integration with the TOSEC database
2014-09-12 15:50:13 +00:00
* Management of Personnal Game Archives (let you store your games files on
private storage, allowing you to reinstall them on all your devices)
* Game saves sync
* Community features (friends list, chat, multiplayer game scheduling)
2017-05-30 02:59:57 +00:00
* Controller configuration GUI (with xboxdrv support)
2014-09-12 15:50:13 +00:00
Come with us!
=============
Want to make Lutris better? Help implement feature, fix bug, test our
pre-releases or simply chat with the developers?
You can always reach us on:
2015-03-03 16:31:48 +00:00
2014-09-12 15:50:13 +00:00
* IRC: #lutris on the Freenode servers
2017-09-16 19:35:29 +00:00
* Github: https://github.com/lutris
2014-09-12 15:50:13 +00:00
* Twitter: https://twitter.com/LutrisGaming
* Google+: https://plus.google.com/+LutrisNet
* Email: contact@lutris.net