Skip to content

Latest commit

 

History

History
138 lines (104 loc) · 4.81 KB

installation.md

File metadata and controls

138 lines (104 loc) · 4.81 KB
Raw

How to install µMPS3

µMPS3 was already packaged for the distros listed below. If you can't find your distro here, you will have to build from source (example).

If you create a package for any other distribution, please consider contributing the template.

Ubuntu

If you are using Ubuntu 21.04 Hirsute Hippo, 21.10 Impish Indri or 22.04 Jammy Jellyfish, you can install the official µMPS3 package using:

$ sudo apt install umps3

If you are using Ubuntu 20.04 Focal Fossa, 18.04 Bionic Beaver or 16.04 Xenial Xerus (Checking your Ubuntu Version) or derivatives (e.g. Linux Mint), you need to:

  1. enable Universe
$ sudo add-apt-repository universe
$ sudo apt update
  1. add the virtualsquare/umps PPA
$ sudo add-apt-repository ppa:virtualsquare/umps
$ sudo apt update
  1. install
$ sudo apt install umps3

Debian

If you are using Debian 11 Stable ("bullseye"), Debian 12 Testing ("bookworm") or Debian Unstable ("sid"), you can install the official µMPS3 package using:

$ sudo apt install umps3

If you are using Debian 10 Oldstable ("buster"), you need to:

  1. add the virtualsquare/umps PPA for the Ubuntu 18.04 (Bionic Beaver) version to your Apt sources configuration file:
$ echo 'deb http://ppa.launchpad.net/virtualsquare/umps/ubuntu bionic main' | sudo tee /etc/apt/sources.list.d/virtualsquare-ubuntu-umps-bionic.list
  1. import the signing key:
$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 046AB1F65C49333A
  1. re-synchronize the package index files:
$ sudo apt update
  1. install
$ sudo apt install umps3

Arch Linux

If you are using Arch Linux or derivatives (e.g. Manjaro), you can install the AUR package umps3-git to get the latest version, or umps3 for the latest stable release.

Building from source

Please report any problems you run into when building the project.

Dependencies

A compiler with C++11 support (clang-3.3+, gcc-4.8+), cmake 3.5+, git

  • Qt 5.5+
  • libelf
  • boost 1.34+ (headers)
  • libsigc++ 2.0

Apart from the dependencies listed above, you will also need a MIPS cross toolchain in your PATH. CMakelists.txt will do its best to detect one; if that fails, you can pass the toolchain tool prefix to cmake using -DMIPS_TOOL_PREFIX=PREFIX. Known prefixes are:

  • mips-sde-elf-
  • mips64-linux-gnu-
  • mips(el)-elf-
  • mips(el)-linux-
  • mips(el)-linux-gnu-

Get the source code, from the root of the source tree run:

$ mkdir build
$ cd build
$ cmake ..
$ make
$ sudo make install

By default, the software is installed locally in /usr/local/. If you want to install it somewhere else (e.g. in /usr/) you can pass the path using -DCMAKE_INSTALL_PREFIX:PATH=/usr.

Uninstallation

From the root of the binary tree run:

$ sudo make uninstall

N.B.: "install_manifest.txt" is generated during the installation process.

Examples

Step-by-step

Here is an example of how to build from source and install µMPS3 on Debian and derivatives (e.g. Ubuntu, Pop!_OS)

Install dependencies

$ sudo apt install git build-essential cmake qtbase5-dev libelf-dev libboost-dev libsigc++-2.0-dev gcc-mipsel-linux-gnu

Get the source code

$ git clone https://github.com/virtualsquare/umps3

Build and Install

$ cd umps3
$ mkdir build
$ cd build
$ cmake ..
$ make
$ sudo make install

Launch

You should now be able to launch µMPS3 via the application menu of your desktop environment, or by typing umps3 at the command line.