ico-pc

This is ICO (Sony Computer Entertainment, 2001) made to run as a normal program on a Windows or Linux PC, the Steam Deck, 64-bit ARM Linux handhelds, Android phones and tablets, iPhones and Apple-silicon Macs. It runs the game's own code, so it plays, sounds and feels like the PAL PlayStation 2 game. There are extras, such as a sharper picture, widescreen and smoother motion. The sharper picture, widescreen and the other picture extras stay off until you turn them on, and the frame rate is not held to the PS2's unless you choose Original. The mouse camera starts on.

• Your own disc image of ICO, PAL version (SCES-50760, the number printed on the disc and on the case). A disc image is one file that holds the whole disc. It ends in .iso, .chd or .bin (a .bin can come with a .cue file, which also works). Other regions and editions do not work.
• Something to play on:
  • a 64-bit Windows 10 or 11 PC, or a Linux PC, with an up-to-date graphics driver (any recent NVIDIA, AMD or Intel graphics card works);
  • a Steam Deck;
  • a 64-bit ARM Linux handheld or board with an up-to-date graphics driver;
  • or a 64-bit Android phone or tablet with Android 10 or later, usually one from 2022 or newer. More about Android;
  • or an iPhone (iOS 15 or newer) or an Apple-silicon Mac (macOS 12 or newer); see Supported platforms.
• About 1 GB of free space for the game's files, which the first start copies out of the disc image.

Not supported: 32-bit systems, Windows 7 and 8, Intel Macs, and any disc other than the PAL release (SCES-50760).

Download the file for your device from the releases page.

1. Download the file whose name ends in -win.zip.
2. Right-click the file and choose Extract All, then pick a folder you can write to, such as Documents or a Games folder. Keep all the files together.
3. Open the x64 folder and double-click ico_pc_x64.exe.

1. Download the file whose name ends in -linux.tar.gz.
2. Right-click the file and choose Extract (or Extract Here), into a folder in your home folder.
3. Double-click ico_pc, or run it from a terminal. If your file manager asks, choose Run or Execute.

The Linux version needs a fairly new system: Debian 13, Ubuntu 24.04 or newer. On a Steam Deck, unpack it in Desktop Mode and start it once there so it can ask for the disc image, then close Steam (right-click its icon in the taskbar and choose Exit Steam) and choose Options > Extras > Add to Steam on the title screen (or add ico_pc by hand with Steam > Add a Non-Steam Game) and play in Game Mode. Steam Deck tips.

On a 64-bit ARM Linux handheld or board, download the file whose name ends in -linux-arm64.tar.gz instead and follow the same steps. It also needs a fairly new system: Debian 13, Ubuntu 24.04 or newer.

1. Download the file whose name ends in -android.apk on your phone or tablet.
2. Open it. Your phone may ask you to allow installing apps from your browser or file manager first. Say yes.
3. Open ICO from your apps.

The Android guide explains the first start, the touch controls and where your saves are.

1. Download the file whose name ends in -macos-arm64.dmg (or the one ending in -macos-arm64.zip, which holds the same app).
2. Open it. Open a second Finder window on Applications (Go > Applications) and drag ICO into it.
3. The first time, right-click ICO and choose Open, then Open again. Apple has not checked this app, so a plain double-click only shows a warning the first time. If your Mac still will not open it, go to System Settings > Privacy & Security, scroll down and choose Open Anyway next to ICO. After that, open it like any other app.

The Mac keeps your saves, your settings, ico-pc.ini and the logs folder in a folder of its own, usually ~/Library/Application Support/ico-pc/ico-pc/. To get there, open Finder, choose Go > Go to Folder, type that path and press Return.

The iPhone version is not in the App Store. You run it inside LiveContainer; set that up first with its own instructions.

1. Download the file whose name ends in -ios-unsigned.ipa on your iPhone.
2. Add it to LiveContainer and start ICO once. It says the game data is missing and closes. (The message names a game data file; you do not need it: your disc image does the same job.) That is expected: it has not seen your disc image yet.
3. Copy your disc image into ICO's Documents folder through LiveContainer's data-folder access, and name it Ico_PAL.iso (or Ico_PAL.chd, Ico_PAL.bin or Ico_PAL.cue). The iPhone version does not ask for the disc image, so it has to be there with one of those names.
4. Start ICO again. It copies the game's files out of the image, as described in The first start.

Your saves (the memcard folder), your settings (config.toml) and the logs folder are in that same Documents folder.

The first time you start the game, it asks for your disc image (an iPhone uses the one you copied in, as above). Choose the file and wait while it copies the game's files out of it. This takes a minute or two and happens only once. From then on the game runs without the disc image, so you can move or delete it. On Android, the screen says what the game is doing the whole time (the Android guide has the steps).

On Windows and Linux you can skip the question. Put the disc image beside the program and name it Ico_PAL.iso (or Ico_PAL.chd, Ico_PAL.bin or Ico_PAL.cue). On Windows, "beside the program" means inside the x64 folder.

• Ico walks when I push the stick all the way. Why can't he run? The original game only runs in eight directions. Turn on Options > Gameplay > Analogue stick fix to run in any direction. The full answer.
• How do I use a texture pack? Copy it into the textures folder that comes with the game (on a Mac or an iPhone, the guide says where to make one). Step by step.
• Can I turn off the blur or the glow? Yes, in Options > Effects. What each one does.
• Where are my saves? In a folder the game makes for you. Where that is.

More questions and answers.

When something goes wrong, the game writes what happened into a file named ico-pc.log, in a folder named logs. Where that folder is:

• Windows and Linux: beside the program (on Windows, inside the x64 folder).
• Mac: in the game's folder, usually ~/Library/Application Support/ico-pc/ico-pc/logs.
• iPhone: in ICO's Documents folder.
• Android: in the game's folder, Android/data/com.defnf.icopc/files/logs (how to reach it).

Open a report on the issues page and attach that file. When something goes wrong explains the error messages and what to try first.

The title screen has an Options line and a Quit to desktop line (Quit game on a phone); starting a New Game shows one more screen, with Mirror mode and New Game+ (more about them); the language and 50/60 Hz questions the PS2 asks at first start live in Options instead, and the language can change in the middle of a game; the ending credits have one more heading and name, for this project; and the pause menu shows your journey's numbers. Everything else is meant to match the PS2: if the picture or the timing is different from the console, that is a bug worth reporting. The full list of differences, written for people who work on the code, is in docs/port/DIVERGENCES.md.

See docs/BUILDING.md. You do not need the disc image to build it. How the port works, for contributors: docs/port/ARCHITECTURE.md.

• Sad Origami, for the ICO PAL HD texture pack, and for the support and blessing to test the port with it (GBAtemp thread).
• katsifolis, for the iOS support (through LiveContainer).
• braito4, for the Apple-silicon macOS app.

The code in this repository is MIT licensed (LICENSE). The licence covers the code written for this project and grants no rights in the game, its data or anything else owned by Sony Interactive Entertainment or Team Ico. docs/LEGAL.md says what may and may not be in the repository, and docs/THIRD_PARTY.md lists the third-party code the program uses. The game code began as a fork of the ICO project, which rebuilds the game's source code from the PS2 release.