Skip to content
This repository was archived by the owner on Aug 17, 2026. It is now read-only.

PSPi OS Images v1.6.0

Choose a tag to compare

View all tags
@CManson38 CManson38 released this 10 Sep 08:00
· 1 commit to main since this release
v1.6.0
74e5916

Call for Testers - Raspberry Pi Zero 2W

I do not currently own a Raspberry Pi Zero 2W, so I’m unable to personally test these builds on that hardware. If you have a Zero 2W and are willing to help test, troubleshoot, or contribute fixes, your input would be greatly appreciated. Please share your findings or submit pull requests to improve support for this platform.

What's Changed

Improvements

  • Updated to latest driver source code from Othermod
  • Reverted change which presented PSPi-Controller as PS3 Controller
  • Updated asset names to improve readability

Driver Information

OS Build Information

Image Naming Convention

To help you choose the right image, here's how our file names are structured:

  • RetroPie 4.8 for Pi Zero 2: pspi-retropie4.8-zero2-32bit-v1.6.0.img.gz
  • RetroPie 4.8 for CM4: pspi-retropie4.8-cm4-32bit-v1.6.0.img.gz
  • Raspberry Pi OS: pspi-pios-universal-64bit-v1.6.0.img.gz
  • PiOS with RetroPie: pspi-pios-retropie-universal-64bit-v1.6.0.img.gz
  • Kali for Pi Zero 2: pspi-kali2025.2-zero2-32bit-v1.6.0.img.gz.7z.001 (split into parts)
  • Kali for CM4: pspi-kali2025.2-cm4-64bit-v1.6.0.img.gz.7z.001 (split into parts)
  • Lakka for Pi Zero 2: pspi-lakka5.0-zero2-64bit-v1.6.0.img.gz
  • Lakka for CM4: pspi-lakka5.0-cm4-64bit-v1.6.0.img.gz
  • Batocera for Pi Zero 2: pspi-batocera41-zero2-64bit-v1.6.0.img.gz.7z.001 (split into parts)
  • Batocera for CM4: pspi-batocera41-cm4-64bit-v1.6.0.img.gz.7z.001 (split into parts)
  • Recalbox for Pi Zero 2: pspi-recalbox9.2.3-zero2-32bit-v1.6.0.img.gz
  • Recalbox for CM4: pspi-recalbox9.2.3-cm4-64bit-v1.6.0.img.gz

Hardware & Architecture Guide:

  • zero2: Raspberry Pi Zero 2 W based PSPi builds
  • cm4: Compute Module 4 based PSPi builds
  • universal: Compatible with both Zero2 and CM4 platforms
  • Split files (.7z.001, .7z.002, etc.): Large images compressed and split - download all parts to the same folder before extracting

Image Details

RetroPie

How to SSH with RetroPie

These images support customisations via Raspberry Pi Imager

Username: pi
Password: raspberry

RetroPie 4.8 Standard

This image is recommended for most users. It is the standard 32-bit RetroPie installation.

PiOS RetroPie

When using Raspberry Pi Imager, do not change the default username from pi

This image a 64-bit PiOS base image which will build/install RetroPie on first boot. This image is recommended for advanced users.

The image should be flashed with Raspberry Pi Imager with WiFi customisations completed. Upon connecting to your network, RetroPie will start installing. This will take a time, make sure your PSPi is charging. Your PSPi may reboot several times during this process.

To install additional cores either use the retropie menu/script located at /opt/RetroPie/retropie_setup.sh or update retropie.conf located at /boot/firmware/retropie.conf You may also update this file by connecting your SD card to your PC and using a text editor.

Batocera

This image is now over 2GB and has been split into multiple parts. Download each part into the same directory then extract with 7zip before flashing.

This image comes with PortMaster preinstalled.

PortMaster does not (yet) officially support Batocera, though we can get some (not all) games working.

To get started:

  • Connect your device to the internet and launch PortMaster from the "ports" console. This will update PortMaster to the latest version.
  • Install whatever games you would like to try and follow any included instructions.

Accessing Batocera via SSH

This image does not support customisations via Raspberry Pi Imager

Username: root
Password: linux

Lakka

Accessing Lakka command line interface

This image does not support customisations via Raspberry Pi Imager

Username: root
Password: root

Recalbox

Root access via Terminal CLI

This image does not support customisations via Raspberry Pi Imager

Username: root
Password: recalboxroot

Raspberry Pi OS

Introduction to remote access

These images support customisations via Raspberry Pi Imager

Username: pi
Password: raspberry

Kali

Kali SSH Configuration

This image does not support customisations via Raspberry Pi Imager

Username: kali
Password: kali

Installation

  1. Download the appropriate image for your use case
  2. Flash to SD card using Raspberry Pi Imager or similar tool
  3. Insert SD card into your PSPi device
  4. Boot and enjoy!

Changelog

See changes since last release for detailed changes in this release.

Assets 20
Loading