Guide: Iconoclasts on Retro Handhelds (via PortMaster)

UPDATE: PortMaster has recently created a one-stop shop for all things related to running ports on retro handhelds. I recommend checking out their website and my most recent PortMaster guide instead of the guide below; I’m leaving this page up for posterity’s sake only. To get started, head over to their Games tab, find the game you want to run, and check out their instructions on that page. If you run into any issues, their discord server is also a great place to start.

Today we’re going to set up the indie game Iconoclasts to work on RK3326-powered retro handheld devices such as the RG351MP and the RG351V, as well as the RG552, RG503, and RG353P devices running PortMaster-friendly custom firmware. This port is available thanks to the PortMaster platform, which is available on the ArkOS, Retro Arena, JELOS, and AmberELEC firmwares.

Some notes

  • The video guide shows you how to set up the device on ArkOS, but the process will be the same for the other firmwares.
  • This game isn’t meant to play on low-resolution screens, and so the text is mostly illegible on 480×320 displays like on the RG351P, RG351M, and RGB10. In general, I would recommend this game for the RG351MP, RG351V, and the Chi GameForce.
  • As of making this video, the port doesn’t work on RetroOZ, so there is no option to play this on the RGB10 Max or ODROID Go Super.

Setup instructions

  • Purchase Iconoclasts via Steam or the Humble Store. Be on the lookout for sales! The simplest way to set this up is to buy it via the Humble Store, since that will allow you to download the Linux version directly and it will also generate a Steam redemption code so that you can use the game on that platform, too. However, if you purchase it directly from Steam, it’s simple to grab the Linux version (see the box below!).

How to download the Linux version of Iconoclasts via Steam on PC

– On your PC, press Win+R and type: “steam://open/console” (Steam will now show console command)
– In the Steam console, type: “download_depot 393520 393524”
– After a minute or two, it will show you the location of the game files on your PC. Navigate to that location and grab those files!

For future reference, this method can be done when trying to download the Linux version of other games via Steam. The App ID and Depot ID of the game can be found on the site steamdb.info. When you search for a game on this site you’ll immediately see the App ID. Scroll down a bit and click on Depots. Here you’ll find all the available OS versions of the game and the corresponding Depot ID. The download command in the steam console is: “download_depot <appid> <depotid>”

If you are using a Mac computer, the process is the same, other than how to open up the Steam console. To do so, open the Terminal app and type the following line of code:

/Applications/Steam.app/Contents/MacOS/steam_osx -console

  • Once you have the Linux version of the game downloaded, let’s set up your device. You’ll want to have PortMaster installed on your device, and be sure to update it to the latest version.
  • Within PortMaster, install the Iconoclasts backend files.
  • Remove the SD card from your device, and plug it into your PC. Inside the Ports > Iconoclasts > gamedata folder, move over all of the Iconoclasts game files from your Linux version.
  • Put the SD card back into your device, navigate to the Ports section, and boot up the game
  • Have fun

Note: if your game is missing music, we’ve recently learned that it’s because the music files don’t properly download from the Steam Console method above. To get the music files working, install the Windows-based version to your PC, and then navigate to the game file directory at Local Disk > Program Files (x86) > Steam > steamapps > common > Iconoclasts > data and then add the “music” folder to the Ports > Iconoclasts > gamedata > data folder on the SD card.

15 thoughts on “Guide: Iconoclasts on Retro Handhelds (via PortMaster)

  1. Thanks for the video. Just got it installed on my 351v. Did you ever figure out if it’s possible to fill the screen? Would be nice to play without the black bars.

    Like

  2. Few Mac tips:

    After downloading your data should be in:
    ~/Library/Application Support/Steam/Steam.AppBundle/Steam/Contents/MacOS\steamapps\content\app_393520\depot_39352

    Easiest way to see the data is:

    mv ~/Library/Application Support/Steam/Steam.AppBundle/Steam/Contents/MacOS\steamapps\content\app_393520\depot_39352 ~/Desktop

    You want to put *everything* in the depot_39352 into Games/ports/iconoclasts/gamedata/ on your device.

    Like

  3. Just three little things….

    1) You don’t need all the contents of the Linux version on your SD card – just ‘bin32’, ‘data’, and ‘Assets.dat’ should suffice.
    2) The Humble Store appears to offer only a Steam key for the game and no DRM-free builds by the looks of it. Bit pointless when you could just go to Steam itself and get it for cheaper that way.
    3) You do know Iconoclasts is also on GOG, right? And that it’s currently 70% off there as well until the end of tomorrow? That’s what I’m going for at least. 😀

    https://www.gog.com/game/iconoclasts

    Like

    1. I just had that issue on my rg353p. Not sure why that’s the only port that isn’t working rn.

      Like

      1. I tried the GOG version on a hunch and the music was working on that version.

        Like

    2. Hi, same problem here on my RG552. it says “ERROR” and where to put music (path) but none of the paths mentionned is in the package!

      Like

  4. any help ? have iconoclasts_1_15_chinese_24946.sh from gog but when i open it to get the files its missing some folders and files dat are mentioned in the guide i only have 3 folders named script meta and data

    Like

  5. In my Powkiddy X55 I the screen is in the wrong rotation… any thoughts about how to fix it?
    And I tried celeste (the game from Steam, Linux), Timespinner and Owlboy and they not open on my X55.

    Like

  6. Does not work with the RG35XX plus, the screen just stays black and returns to portmaster after 20 seconds. Using Postmaster version: 2024.05.14-1028.

    Like

      1. Can confirm. I own the 35XX H and tried via KNULLI (this CFW does not even see the game in the Portmaster list. Needed to “sideload”) and muOS (this one sees the game in the list). Both turn out with the same result: Screens becomes black for a few seconds, then crashed back into main menu. 😦 So sad.

        Like

Leave a comment