Sign In

When you first start Xeiso, you will be immediately directed to download some games to your system. A few screens later, you should have a game installed and ready to play, simply by following the on-screen dialogs. But, one game is never enough.

Users

Downloading in Xeiso

Want to get a new game? Simple. From the Games menu in Xeiso, go to Options (left) and then switch to Download mode (down). The list of available games will be fetched, and you will be presented with games available for installation. Find a game you like, and press Right to download it.

When the game is downloaded, Xeiso will restart and prepare to install. Press Right to begin installation. The game will be installed, and Xeiso will automatically restart again. When it does, simply go to the Games menu and find the game you just downloaded.

XPKs

Is there a game you want that isn’t quite yet available in the Xeiso archives? If the game is available for download as a .xpk file, you may open it with Xeiso by double-clicking it. An installer will launch; simply press Right to continue and the game will be installed and Xeiso will restart.

Distributors and Developers

If you are packaging Xeiso for distribution or if you are developing your own packages, then the local directory will be of use to you.

First, make sure you have a source tarball or bzr branch. In the source, you will find a data directory; open it. In there, open the xpk folder (create it if it doesn’t exist). This is where you may place XPK directory trees, which will be included with Xeiso when installed into /usr/share/xeiso/xpk. When running Xeiso from the source directly, these XPKs will be automatically loaded without having to be installed.

Extracting an XPK

Extracting an XPK file will yield the files used to make that specific package, such as init and logos. The most useful reason to extract an XPK would be for distributing games with Xeiso directly (see above). XPKs don’t usually contain the source code used to create a package; you will want to ask the author of the package for the source if available.

No special tools are required to extract an XPK: it is simply a .tar.gz archive. If .xpk is registered as a mimetype in your system, it will not be obvious; the system will not know that an XPK can also be an archive. Simply rename the .xpk extension to .tar.gz and extract the files you need.