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.

Files in Ubuntu can be accessed through a network share. In This Computer right click on the background and select Map network drive. Set the folder to \\wsl$ to make it easily accessible.

Alternatively, you can open an Ubuntu terminal in a specific directory by holding shift and clicking the right mouse button on the background in the file browser and selecting Open Linux shell here.

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 Basic Programs page to for examples on what you can do with it.