Differences between revisions 1 and 48 (spanning 47 versions)
Revision 1 as of 2020-04-09 01:08:25
Size: 647
Editor: ?vv221
Comment: ./play.it page creation, with an introductory description
Revision 48 as of 2022-10-02 17:18:33
Size: 8091
Editor: ?vv221
Comment: Upstream release 2.18.1
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= ./play.it = #language en
##For Translators - to have a constantly up to date translation header in you page, you can just add a line like the following (with the comment's character at the start of the line removed)
##<<Include(Games/PlayIt, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
##TAG:TRANSLATION-HEADER-START
~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: [[Games/PlayIt|English]] - [[fr/Games/PlayIt|Français]] - [[pt_BR/Games/PlayIt|Português (Brasil)]]-~
##TAG:TRANSLATION-HEADER-END
Line 3: Line 8:
./play.it is a [[https://en.wikipedia.org/wiki/Free_software|libre software]] that automates the build of native packages for multiple distributions, including Debian and its derivatives, from [[https://en.wikipedia.org/wiki/Digital_rights_management|DRM-free]] installers for commercial games. The generated packages are then installed using the standard tools provided by the distribution, like [[dpkg]] or [[AptCLI|APT]]. {{https://img.dotslashplay.it/bannieres/play.it.png|./play.it banner}}
Line 5: Line 10:
Native Linux games are supported, as well as games developped for other systems thanks to tools like [[Wine]], [[https://en.wikipedia.org/wiki/DOSBox|DOSBox]] and [[https://www.scummvm.org/|ScummVM]]. '''./play.it''' is a [[WikiPedia:Free_software|libre software]] that automates the build of native packages for multiple distributions, including Debian and its derivatives, from [[WikiPedia:Digital_rights_management|DRM-free]] installers for commercial games. The generated packages are then installed using the standard tools provided by the distribution, like [[AptCLI|APT]] (or [[dpkg]]).

Native Linux games are supported, as well as games developed for other systems thanks to tools like [[Wine]], [[https://www.dosbox.com/|DOSBox]] and [[https://www.scummvm.org/|ScummVM]].

<<TableOfContents(3)>>

== Installation ==

=== Debian repositories ===

[[DebianPkg:play.it]] is provided in the [[https://www.debian.org/doc/debian-policy/ch-archive.html#the-contrib-archive-area|contrib]] section of [[DebianRepository|Debian repositories]].

=== Git repository ===

When installing from [[git]], running `make install` as the current user installs '''./play.it''' only for the current user, while running it as [[Root|root]] installs it system-wide.

You can provide an alternative installation prefix with `make -e prefix=/opt/play.it install`, default prefix is `/usr/local` if the command is run as root, `$XDG_DATA_HOME` otherwise (defaults to `$HOME/.local/share` if `$XDG_DATA_HOME` is not set).

Starting with ./play.it 2.16 release, game scripts are no longer provided in the main repository. You need to install a collection of game scripts in addition to the core library and wrapper to add support for some game installers.

==== Library and wrapper (required) ====

{{{
git clone --branch 2.18.1 --depth 1 https://forge.dotslashplay.it/play.it/scripts.git play.it.git
cd play.it.git
make
make install
}}}

==== Core game scripts collection ====

{{{
git clone --depth 1 https://forge.dotslashplay.it/play.it/games.git play.it-games.git
cd play.it-games.git
make install
}}}

== Usage ==

=== Using installed version ===

Assuming your game installer is called `setup.exe`, using '''./play.it''' to install a game is a two-steps process:

  1. Run '''./play.it''' by giving it the path to the game installer: {{{
play.it ~/Downloads/setup.exe
}}}
  1. Run the `apt` command provided at the end of the process as root (or `dpkg` command on old Debian versions), it should be something similar to: {{{
apt install /home/user/Downloads/game.deb /home/user/Downloads/game-data.deb
}}}

=== Using scripts from ./play.it website ===

{{{#!wiki caution
'''./play.it''' can be used without being installed. This is not the recommended method if your distribution provides packages for it.
}}}

Up-to-date '''./play.it''' scripts can be download from [[https://www.dotslashplay.it/en/start|its website]], these are the same that are provided by the master branch of the git repository.

To use these scripts on a system that does not have '''./play.it''' available, follow these steps:
  1. Find your game on the website, go to its page;
  1. Download in a same directory the two files provided on the game page, one is the '''./play.it''' library (`libplayit2.sh`) and the other a game-specific script (with a name similar to `play-game.sh`);
  1. Install the scripts dependencies listed on the game page;
  1. Run the game script by giving it the path to your game installer as its argument, this should be something similar to: {{{
./play-game.sh ~/Downloads/setup.exe
}}}
  1. Wait until the script ends its process by giving you the `apt` command to run as root to install your game (or `dpkg` command on old Debian versions), it should be something similar to: {{{
apt install /home/user/Downloads/game.deb /home/user/Downloads/game-data.deb
}}}

== Common issues ==

{{{#!wiki tip
The following issues are copied from the upstream documentation, and as such the list might be incomplete or outdated. The up-to-date list of common issues for Debian is available on '''./play.it''' forge: [[https://forge.dotslashplay.it/play.it/doc/-/wikis/user/distributions/debian|Common issues on Debian]]
}}}

=== Install i386 packages on a amd64 system ===

On a default `amd64` setup, `i386` packages can not be installed.

The following commands, that need to be run with the root account, allow the installation of `i386` packages with their dependencies:
{{{
dpkg --add-architecture i386
apt update
apt install libc6:i386
}}}

This needs to be done only once per system, after that all `i386` packages should be installable.

[[https://forge.dotslashplay.it/play.it/doc/-/wikis/user/distributions/debian#install-i386-packages-on-a-amd64-system|source]]

=== Available innoextract version is too old ===

When calling ./play.it on a Windows installer, you could get an error similar to this one:
{{{
Error: Available innoextract version is too old to extract data from the following archive: setup_heroes_of_might_and_magic_3_complete_4.0_(28740).exe
}}}

This happens when the installer you are trying to convert to native packages is an InnoSetup installer that is not supported by the version of innoextract currently available on your Debian. There is a package available from openSUSE Build Service to get an up-to-date version of innoextract: [[https://software.opensuse.org/download/package?project=home%3Adscharrer&package=innoextract|innoextract from home:dscharrer project]]

[[https://forge.dotslashplay.it/play.it/doc/-/wikis/user/distributions/debian#available-innoextract-version-is-too-old|source]]

=== Depends: libfaudio0 but it is not installable ===

When installing some packages generated by ./play.it on a '''Debian Buster''' (or some derivative), the installation might fail with a message similar to this one:
{{{
Some packages could not be installed. This may mean that you have
requested an impossible situation or if you are using the unstable
distribution that some required packages have not yet been created
or been moved out of Incoming.
The following information may help to resolve the situation:

The following packages have unmet dependencies:
 owlboy : Depends: libfaudio0 but it is not installable
E: Unable to correct problems, you have held broken packages.
}}}

This is because the `libfaudio0` package is only available starting with Debian Bullseye, so you need to enable the `buster-backports` repo, see [[Backports#Adding_the_repository]].

Once backports are enabled, you can run again the command to install your game packages. `apt` should no longer complain about some not installable `libfaudio0` package.

[[https://forge.dotslashplay.it/play.it/doc/-/wikis/user/distributions/debian#depends-libfaudio0-but-it-is-not-installable|source]]

== Contact ==

=== IRC channel ===

Some '''./play.it''' developers and users can be reached on [[WikiPedia:Internet_Relay_Chat|IRC]], channel is `#play.it` on network `irc.oftc.net`. The main language on this IRC channel is English, but most of us can speak French too.

=== E-mail ===

A contact e-mail for feedback can usually be found in each '''./play.it''' script, as well as the library. Open one of these files with any text editor to see the contact e-mail.

== Links ==

  * [[https://www.dotslashplay.it/en/start|Official website]]
  * [[https://news.dotslashplay.it/|Blog]]
  * [[https://forge.dotslashplay.it/play.it|Official git repositories]]
  * [[https://forge.dotslashplay.it/play.it/games/issues|Bugs tracker]]

----
CategoryGame

Translation(s): English - Français - Português (Brasil)

./play.it banner

./play.it is a libre software that automates the build of native packages for multiple distributions, including Debian and its derivatives, from DRM-free installers for commercial games. The generated packages are then installed using the standard tools provided by the distribution, like APT (or dpkg).

Native Linux games are supported, as well as games developed for other systems thanks to tools like Wine, DOSBox and ScummVM.

Installation

Debian repositories

play.it is provided in the contrib section of Debian repositories.

Git repository

When installing from git, running make install as the current user installs ./play.it only for the current user, while running it as root installs it system-wide.

You can provide an alternative installation prefix with make -e prefix=/opt/play.it install, default prefix is /usr/local if the command is run as root, $XDG_DATA_HOME otherwise (defaults to $HOME/.local/share if $XDG_DATA_HOME is not set).

Starting with ./play.it 2.16 release, game scripts are no longer provided in the main repository. You need to install a collection of game scripts in addition to the core library and wrapper to add support for some game installers.

Library and wrapper (required)

git clone --branch 2.18.1 --depth 1 https://forge.dotslashplay.it/play.it/scripts.git play.it.git
cd play.it.git
make
make install

Core game scripts collection

git clone --depth 1 https://forge.dotslashplay.it/play.it/games.git play.it-games.git
cd play.it-games.git
make install

Usage

Using installed version

Assuming your game installer is called setup.exe, using ./play.it to install a game is a two-steps process:

  1. Run ./play.it by giving it the path to the game installer:

    play.it ~/Downloads/setup.exe
  2. Run the apt command provided at the end of the process as root (or dpkg command on old Debian versions), it should be something similar to:

    apt install /home/user/Downloads/game.deb /home/user/Downloads/game-data.deb

Using scripts from ./play.it website

./play.it can be used without being installed. This is not the recommended method if your distribution provides packages for it.

Up-to-date ./play.it scripts can be download from its website, these are the same that are provided by the master branch of the git repository.

To use these scripts on a system that does not have ./play.it available, follow these steps:

  1. Find your game on the website, go to its page;
  2. Download in a same directory the two files provided on the game page, one is the ./play.it library (libplayit2.sh) and the other a game-specific script (with a name similar to play-game.sh);

  3. Install the scripts dependencies listed on the game page;
  4. Run the game script by giving it the path to your game installer as its argument, this should be something similar to:

    ./play-game.sh ~/Downloads/setup.exe
  5. Wait until the script ends its process by giving you the apt command to run as root to install your game (or dpkg command on old Debian versions), it should be something similar to:

    apt install /home/user/Downloads/game.deb /home/user/Downloads/game-data.deb

Common issues

The following issues are copied from the upstream documentation, and as such the list might be incomplete or outdated. The up-to-date list of common issues for Debian is available on ./play.it forge: Common issues on Debian

Install i386 packages on a amd64 system

On a default amd64 setup, i386 packages can not be installed.

The following commands, that need to be run with the root account, allow the installation of i386 packages with their dependencies:

dpkg --add-architecture i386
apt update
apt install libc6:i386

This needs to be done only once per system, after that all i386 packages should be installable.

source

Available innoextract version is too old

When calling ./play.it on a Windows installer, you could get an error similar to this one:

Error: Available innoextract version is too old to extract data from the following archive: setup_heroes_of_might_and_magic_3_complete_4.0_(28740).exe

This happens when the installer you are trying to convert to native packages is an ?InnoSetup installer that is not supported by the version of innoextract currently available on your Debian. There is a package available from openSUSE Build Service to get an up-to-date version of innoextract: innoextract from home:dscharrer project

source

Depends: libfaudio0 but it is not installable

When installing some packages generated by ./play.it on a Debian Buster (or some derivative), the installation might fail with a message similar to this one:

Some packages could not be installed. This may mean that you have
requested an impossible situation or if you are using the unstable
distribution that some required packages have not yet been created
or been moved out of Incoming.
The following information may help to resolve the situation:

The following packages have unmet dependencies:
 owlboy : Depends: libfaudio0 but it is not installable
E: Unable to correct problems, you have held broken packages.

This is because the libfaudio0 package is only available starting with Debian Bullseye, so you need to enable the buster-backports repo, see Backports#Adding_the_repository.

Once backports are enabled, you can run again the command to install your game packages. apt should no longer complain about some not installable libfaudio0 package.

source

Contact

IRC channel

Some ./play.it developers and users can be reached on IRC, channel is #play.it on network irc.oftc.net. The main language on this IRC channel is English, but most of us can speak French too.

E-mail

A contact e-mail for feedback can usually be found in each ./play.it script, as well as the library. Open one of these files with any text editor to see the contact e-mail.


CategoryGame