Cubis 2 1.0.1 — an iPod game, recompiled
=========================================

This is the game from an iPod, translated to run on this machine. It is the program only.

WHAT YOU HAVE TO SUPPLY
-----------------------

The game's own files: the folder named

    99999

as it sits on your iPod, under iPod_Control/Games (the games live inside the .bin next to it on
some models; whichever way you get at it, the folder is the thing). Nothing in this download is
the game itself, and nothing here will work without that folder. It is not included because it
is not ours to include: it is the game you bought, and yours to copy off your own device.

INSTALLING
----------

1. Keep cubis.exe and SDL3.dll together in the same folder. Nothing else is needed.
2. Run cubis.exe. The first launch asks for the 99999 folder (or a zip of it) with the
   ordinary file browser, checks every file in it against the sizes and checksums the game
   shipped with, and copies it to

       %APPDATA%\iPod Cubis 2\99999

   Your saves, settings and key bindings live beside it.

There is no console window; the game is one window. Run it from a terminal and its messages
print there, and anything that stops it starting is said in a message box.

WINDOWS MAY WARN ABOUT IT
-------------------------

The program is not signed with a code-signing certificate, so SmartScreen may say it is from an
unknown publisher. "More info" then "Run anyway" starts it.

CONTROLS
--------

The iPod's click wheel and its five buttons, on whatever this machine has. Every one of them can
be rebound; the settings window (Ctrl+, on Windows, ⌘, on macOS) lists them, and the console
build has a controls screen of its own. See the project's README for the defaults.

WHAT ELSE IS IN HERE
--------------------

  COPYING.txt        the GNU General Public License, version 3, which this program is under.
  SDL3-LICENSE.txt   SDL3's licence. The program uses SDL for its window, input and sound, and
                     that licence asks to travel with it.

LICENCE
-------

This port is free software under the GNU General Public License, version 3 or later, whose full
text is in COPYING.txt beside this file. You may use it, study it, change it and pass it on, and
anyone you pass a changed version to is owed its source.

The source is published with this release, as the `-source.tar.gz` file released alongside it.
Note that five of the six titles need one more step before they build: the machine-translated
half of those ports is written on your own machine from your own copy of the game, because it is
a translation of that game's binary rather than anything the port authors wrote. The source's
RELEASING.md and each title's README say how.

What the licence covers is the port. The game it runs is not the port authors' to license, and
none of it is in this download.

THE GAME'S FILES ARE STILL NOT IN HERE
--------------------------------------

Worth saying twice. This download is a program that can run the game you own. It contains none
of that game's code, art, music or levels.
