Installation on Windows

Windows Subsystem for Linux (WSL)

On Windows the PSPDEV toolchain is run on Ubuntu running on Microsoft’s WSL. This is very easy to set up and will offer us the full power of Linux from a Windows machine.

To set up WSL with Ubuntu in it run the following commands in a Powershell window started as administrator (right click run as administrator on Powershell in the start menu):

wsl --install

When this is done, restart your computer. Afterwards Ubuntu can be selected from the start menu to open a terminal, do this once to set up your user.

From now on the Ubuntu shell will be used when running commands going forward.

Note: You can open an Ubuntu terminal in a specific folder by holding shift and clicking the right mouse button on the background in the file explorer and selecting Open Linux shell here:

This can be useful when building a specific project.

Dependencies

The PSPDEV toolchain requires a couple of dependencies to be installed before use. To install them, run the following command from an Ubuntu terminal:

sudo apt-get update

sudo apt-get install build-essential cmake pkgconf libreadline8 libusb-0.1 libgpgme11 libarchive-tools fakeroot wget

Toolchain

Installing the PSPDEV toolchain itself can be done with the following steps:

1. In a fresh WSL Session download the Toolchain Archive using the following command:

    wget https://github.com/pspdev/pspdev/releases/latest/download/pspdev-ubuntu-latest-x86_64.tar.gz
   

2. Extract the archive using:

    tar -xvf pspdev-ubuntu-latest-x86_64.tar.gz
   

3. To make the toolchain usable, some environment variables need to be set. The first step in doing so it to open the ~/.bashrc file with the nano text editor using the following command from an Ubuntu terminal:

    nano ~/.bashrc
   

4. Add the following lines at the bottom of the file in the text editor:

    export PSPDEV="$HOME/pspdev"
    export PATH="$PATH:$PSPDEV/bin"
   

5. Now save and exit by pressing Ctrl+X, then Y and then enter/return.
6. Close the current Ubuntu terminal and open a new one.
7. From the new Ubuntu terminal, run the following command to confirm everything is set up correctly:

    psp-config --pspdev-path
   

   If everything is set up correctly, the path of the PSPDEV toolchain installation will be shown.

That’s it, now the PSPDEV toolchain can be used to build PSP software. Check out the How to Use page for a guide on how to do so.