Table of contents
libTAS is a software for Linux that provides TAS tools to games, such as frame advance, inputs recording, savestates. It is not a Linux emulator as games are running natively on the user system, but it creates an intermediate layer between the game and the operating system, feeding the game with altered data (such as inputs, system time). We can call such tool an API translation layer. It tries to make the game running deterministically, although it is still an issue when dealing with multithreaded games. This layer connects to an external program to provide a graphical interface to the user, with tools such as input editor or RAM watch/search.
- You can download the latest version of the releases page.
- Installation and compilation instructions are indicated on the main repository page.
- Official documentation.
Documentation and Help
When you submit a libTAS movie to TASVideos, the following rules apply.
Use stable versioned releases
Only use stable releases of games, Linux distributions, dependencies, and libTAS itself. Install everything from versioned packages to prevent issues with dependencies. You are allowed to use any distro you want, however your run must sync on one of the following distros:
- Ubuntu and its derivatives (Kubuntu, Lubuntu, etc)
- i386 / i486 / i586 / i686 / x86-32
- AMD64 / x86-64
Document sync requirements
We want common and easy configuration steps to simplify the submission and verification process for libTAS movies. You must provide the full installation instructions required for your submission, including your distro and kernel versions, the required dependencies for your game, and any installation steps needed for them.
Debian Stretch AMD64, Linux 4.15.0-1-amd64
- Execute this command in the terminal to get the OS information:
uname -a && lsb_release -a
If any libTAS settings were changed, these changes must be documented as well. This should be written in the movie annotations or in the submission description. Providing links for everything is also highly recommended.
Avoid stray save data
If you've played the game outside libTAS, it may leave config or in-game save files on the disk. While editing config before starting the movie is okay, stray save data can mess up your run's startup state and break movie sync for other people.
libTAS option Runtime -> Prevent Writing to Disk (enabled by default) is meant to protect the user from accidentally editing or creating files that affect movie sync, so only uncheck it with caution.
Submissions that use Wine for Windows games are currently not allowed, though it is highly recommended that this workflow be tested, as we are working towards allowing them in the future.
Submissions using PCem for DOS games are allowed: Please see our PCem page for details on how to use it with libTAS.
We allow Flash game submissions using Ruffle. For some guidelines and instructions on how to use it with libTAS, please see our Ruffle page.
Submissions using MAME are allowed: Please see our MAME page for details on how to use it with libTAS.
PICO-8 submissions are allowed: Please see our PICO-8 page for details on how to use it with libTAS.