The Mira Project is a set of tools that grants you more power and control over your jailbroken Playstation 4. It is the result of all the hard work by the OpenOrbis team.
It works differently to the custom firmware experience on Playstation 3, where CFW would be installed on the system via modified PUP files (e.g. Rebug), however once the framework is installed and ran it gives users the same functionality they were previously used to. This can be installed by exploiting specififc system applications to load the kernel exploit and load Mira (Persistence Boot), as well as being ran from WebKit.
If you would like to contribute join us on Open Orbis Discord, it is the only location where you can find the official project.
| Firmware Version | Passing |
|---|---|
| 4.05 | WIP |
| 4.55 | WIP |
| 4.74 |  |
| 5.01 |  |
| 5.03 |  |
| 5.05 |  |
| 6.20 |  |
| 6.72 |  |
| 7.00 | WIP |
| 7.55 | WIP |
- Homebrew Enabler (HEN)
- Trainer Support (Thanks theorywrong)
- Device driver for kernel extensions
- RPC
- Debugger
- File Manager
- All modules are embedded into the loader
- Emulated Registry (EmuReg)
- Emulated NVS (EmuNVS)
- Kernel Debugger
- Remote GDB
- System-level FUSE implementation (Experimental, WIP)
- Kernel Soft Reboot
- FakeDex Support
- Linux loader
- Mount and decrypt local gamesaves (Thanks ChendoChap) (WIP)
- Implement your own dynamically loaded plugins (RPC using protobuf)
- Substitute hooking library
- Dumping per-console keys
- Update Removal
- Game dumping and decryption
- Remote registry
- Remote NVS
- SpoofNP (Fake NP for LAN usage)
In order to start development on the mira-project, you will need a few components installed.
- clang
- clang-tidy
- cppcheck
- objcopy
- llvm-ar
- ld (or lld.ld)
- git
- python3 (3.6.9 at time of writing, but any newer version should work)
- cmake
These can be installed (on Ubuntu, other platforms may vary) by using the command(s):
sudo apt install git build-essential clang lldb clang-tidy clang-tools cppcheck git python3 cmake
Cloning the repository is easily done by:
git clone https://github.com/OpenOrbis/mira-project.git
The current mira-project repository is self-contained, meaning everything the project depends on should be within the repo itself. Here is a layout of the source repository (all from root of mira-project directory)
| Directory | Purpose |
|---|---|
build |
Working/output build files, as well as final executables and payloads |
daemon |
The userland daemon that handles most background tasks for Mira |
docs |
Documentation about PlayStation 4/Mira twiddly bits |
external |
External resources, contains freebsd-headers (MODIFIED FOR KERNEL/PS4 USAGE), hde64 for disassembly, mira for Mira headers/code shared across multiple projects |
kernel |
The kernel component of Mira |
loader |
This is the MiraLoader which is required to properly relocate the main ELF in kernel memory and execute in a new kernel thread |
mira_module |
This is a prx that will be loaded into every created process, it will contain common code for trainers and interfacing with the kernel driver |
scripts |
Build/Helper scripts |
tests |
Test application to ensure that mira_module, and the kernel driver ioctl's are operating correctly |
trainer_loader |
Stub that gets injected and ran on every new process start which will ioctl to Mira's device driver to load trainers |
Want to contribute? Great! There is no set limit on contributors and people wanting to help out in any way!
Join the OpenOrbis discord and have knowledge of C/C++ and FreeBSD or unix-like operating systems, web design and programming, rust-lang, content creator (youtube, twitch), or artist, or just want to find something to help out with like documentation, hosting, etc, kernel experience is a plus but not required by any means.
If using and IDE such as VSCode, it should automatically pick up and generate the files for use with CMake. If not you can use CMake to generate the project for you by doing
mkdir mira-build
cd mira-build
cmake -G "Unix Makefiles" ../mira-project
make
After following the instructions on cloning the repository and generating the protobuf files, you should be ready to build Mira from source. It was designed to be as easy as possible to build with the provided makefiles.
Each makefile (for MiraLoader, and Mira itself) follow a specific format due to compilers ignoring most changes in header (.h) files causing issues down the line.
In order to create the proper build directory output (so you don't get "directory not found errors") is done with
make create this will generate the proper folder structure that's required to build Mira.
After this is done, then you will need to make clean which will clean up old object files (.o), payloads (.bin), and elf files. Without doing this, any changes you make in the headers will not be cleaned up and you will be wondering why you are getting a kernel panic on correct code (due to offset change or what not, that you can verify yourself in the binary)
Finally build Mira, this will automatically build everything into the specified build directory using the default MIRA_PLATFORM target. You are able to override these options in both MiraLoader and Mira using MIRA_PLATFORM=<specified platform> make for your specific platform. (this works with make clean, make create as well)
| Available Overrides | Description |
|---|---|
MIRA_PLATFORM |
Changes firmware version that MiraLoader/Mira targets, they must match for your firmware you are building for |
BSD_INC |
freebsd-headers include path, defaults to external/freebsd-headers/include |
OUT_DIR |
Output directory, defaults to build |
There is a list of available platforms that Mira can be configured with located in src/Boot/Config.hpp for the most up-to-date, but as of writing here is the available list.
| Support Status | Description |
|---|---|
| Unsupported | May build, may not, previously was updated but no active updating |
| Supported | Active updating and testing, as well as producing builds on CI |
| No Support | No real support added, needs developer work to become functional + stable |
| Available Platforms | Firmware |
|---|---|
MIRA_PLATFORM_ORBIS_BSD_176 |
(Unsupported) 1.76 |
MIRA_PLATFORM_ORBIS_BSD_355 |
(Unsupported) 3.55 |
MIRA_PLATFORM_ORBIS_BSD_400 |
(Unsupported) 4.00 |
MIRA_PLATFORM_ORBIS_BSD_405 |
(Supported) 4.05 |
MIRA_PLATFORM_ORBIS_BSD_407 |
(Unsupported) 4.07 |
MIRA_PLATFORM_ORBIS_BSD_455 |
(Supported) 4.55 |
MIRA_PLATFORM_ORBIS_BSD_474 |
(Unsupported) 4.74 |
MIRA_PLATFORM_ORBIS_BSD_500 |
(Unsupported) 5.00 |
MIRA_PLATFORM_ORBIS_BSD_501 |
(Unsupported) 5.01 |
MIRA_PLATFORM_ORBIS_BSD_503 |
(Unsupported) 5.03 |
MIRA_PLATFORM_ORBIS_BSD_505 |
(Supported) 5.05 |
MIRA_PLATFORM_ORBIS_BSD_550 |
(No Support) 5.50 |
MIRA_PLATFORM_ORBIS_BSD_553 |
(No Support) 5.53 |
MIRA_PLATFORM_ORBIS_BSD_555 |
(No Support) 5.55 |
MIRA_PLATFORM_ORBIS_BSD_600 |
(No Support) 6.00 |
MIRA_PLATFORM_ORBIS_BSD_620 |
(Unsupported) 6.20 |
MIRA_PLATFORM_ORBIS_BSD_650 |
(Unsupported) 6.50 |
MIRA_PLATFORM_ORBIS_BSD_672 |
(Supported) 6.72 |
MIRA_PLATFORM_ORBIS_BSD_700 |
(Unsupported) 7.00 |
MIRA_PLATFORM_ORBIS_BSD_755 |
(Unsupported) 7.55 |
Lets say you are an eager developer, even a newbie that wants to try and contribute in some way or form to porting to a firmware that is not under active support. Here's the steps you would need to accomplish new builds from scratch. We will start by adding a non-existent firmware and work our way from that.
NOTE: This assumes you already have a kernel dump for your firmware, and things already labeled. If you need help with this step, you can ask in #help on the Discord but you are pretty much on your own.*
WARNING: DO NOT SEND YOUR DUMPED KERNEL IN THE CHANNEL/DISCORD SERVER AS IT IS COPYRIGHTED MATERIALS AND YOU WILL BE WARNED/BANNED!!
Lets assume our firmware is 8.88 found in the PlayStation 4 System Software menu.
- Add your new firmware to
external/mira/Kernel/Boot/Config.hppyou will see a bunch of defines already there, add your firmware in the correct version order a. #define MIRA_PLATFORM_ORBIS_BSD_888 888 - Fix any structure changes for the kernel in freebsd-headers. You should compare against what's already there and add fields that have been added via
a. #if MIRA_PLATFORM==MIRA_PLATFORM_ORBIS_BSD_888
b. HINT: These are usually done in
struct proc,struct thread,struct ucredif applicable, located inexernal/freebsd-headers/include. - Add a new static function in
kernel/src/Boot/Patches.hppwith your pre-boot patches, this will be called both before MiraLoader and Mira launch a. static void install_prerunPatches_888(); - Add your firmwares version to the case within
install_prePatchesinkernel/src/Boot/Patches.cppa.case MIRA_PLATFORM_ORBIS_BSD_888: install_prerunPatches_888(); break; - Next create a new file named
Patches888.cppinside ofkernel/src/Boot/Patchesdirectory (or copy an existing one and rename it) - You must follow the same format as all of the other patch files, this involves including the
Patches.hppand defining theinstall_prerunPatches_888()function with all needed patches a. As new features are added, this will need to be updated for any kernel patches required, so far a baseline is Enable UART, Verbose Kernel Panics, Enable RWX mappings, Enable MAP_SELF, Patching copy(in/out)(str) checks, patching memcpy checks, patching ptrace checks, patching setlogin (for autolaunch check), patch mprotect to allow RWX, patching pfs signature checking, patching to enable debug rifs, patch to enable all logs to console, (newer fws: disable sceverifier, delayed panics) b. All patches are required for full functionality, but to get up and running only the rwx patches, copy(in/out)(str), memcpy, mprotect patches are needed (I think, someone correct documentation + send PR if wrong). - Add support to the MiraLoader by copying the newly finished
kernel/src/Boot/Patches.cpptoloader/src/Boot/Patches.cppand the newkernel/src/Boot/Patches/Patches888.cpptoloader/src/Boot/Patches/Patches888.cpp - Next would be to create a new kernel symbol file in
external/mira/Kernel/Utils/Kdlsym/Orbis888.hppor copy one from a supported platform (more offsets than what's probably needed) - Add support by modifying
external/mira/Kernel/Utils/Kdlsym.hppand adding a line for your firmware file (make sure these are in numeric order)#elif MIRA_PLATFORM==MIRA_PLATFORM_ORBIS_BSD_888 #include "Kdlsym/Orbis888.hpp" - The next step would be finding all of the functions that Mira/MiraLoader use in the kernel... This is the most time consuming portion of this and will need to be verified before upstreamed. The easiest way to handle this is to try building (using the build instructions provided) you will get a massive ton of errors around
kdlsymand it not being able to find errors. One of such errors are shown as such:
src/Utils/Kdlsym.hpp:49:52: error: ‘kdlsym_addr_printf’ undeclared (first use in this function)
#define kdlsym(x) ((void*)((uint8_t *)&gKernelBase[kdlsym_addr_ ## x]))
- (continued) This means if you break it down, that printf was undeclared, look in your kernel dump with a dissassembler of choice (Ghidra/IDA Preferred, untested with others such as Binary Ninja, Relyze) and get the offset from the start of the loading address for the function
printf(Calculated by Function Address - Base Address of Kernel where it was dumped from) and add it to yourexternal/mira/Kernel/Utils/Kdlsym/Orbis888.hppwith the line#define kdlsym_addr_printf 0x<offset address>and repeat for all other build errors. - Once complete you should have a full port to a new firmware completed (unless I missed a step/something unclear, create issue or fix + PR please)
This project would not be possible without these people (no paticluar order):
- kiwidog - Developer
- SpecterDev - Developer
- flatz - Developer (Code, writeups, non-stop help we <3 u flatz)
- CrazyVoid - Developer (Loader/self/SDK help, overall general help, OO moderator)
- theorywrong - Developer (Substitute, OverlayFS, general)
- SiSTR0 - Developer (HEN support, general)
- SocraticBliss - Developer (HEN support, general)
- valentinbreiz - Developer (Mira Companion App v1)
- Seremo - Developer (Mira Companion App v2, Log plugin)
- Al-Azif - Developer (5.05 lead maintainer, general)
- z80 - Developer (5.05 maintainer)
- balika011 - Developer (Fixing userland elf loader entry point, general developer)
- Zer0xFF - Developer (OverlayFS, general)
- CelesteBlue - Developer (Bugfixes, plugins)
- Joonie - Developer (Offsets porting 5.01/5.05)
- AlexAltea - Low level and kernel help (go check out Orbital Emulator)
- qwertyoruiop - Security (4.55-5.05 kernel exploits)
- CTurt - Security (Initial payload PS4 SDK and 1.76 kernel exploit)
- m0rph3us1987 - Developer (Code examples, kernel SDK, overall general help)
- sleirsgoevy - Developer
- eeply - Developer (UART)
- zecoxao - RE (4.74 Port)
- aerosoul - Developer (Everything elf related, loaders, etc)
- therootlord - Developer
- maxton - Developer (Everything pkg related, etc) (Rest In Peace)
- ChendoChap - RE, Development, Trainers (Bug hunting, general kernel help)
- sugarleaf - Initial 4.55 private exploit, inital help with Mira dev (retired/left)
- kozarovv - RE (4.05 offsets)
- LM - RE (Research on System-Library-Loading), assembler and linker script help
- TheFlow - RE
- samsepi0l - Offset Porting
- xvortex - Original VTX-Hen
- 2much4u - Ptrace patches
- golden - Ptrace patches, rpc ideas
- idc - Developer
- lordfriky - MacOS support and script fixes
- ethylamine - Developer
- bigboss - liborbis with examples and orbisdev (and complaining a lot)
- rogero - Original 5.01 testing
- AbkarinoMHM - Original 5.01 testing
- wildcard - General questions, and hardware help
- frangarcj - orbisdev sdk, musl, C++ support
- masterzorag - orbisdev sdk, musl, C++ support
- fjtrujy - orbisdev sdk, musl, C++ support
- [Anon #1] - Developer (Code, Non-stop help, <3 thx bruv)
- [Anon #2] - Developer (Code, Non-stop help, gl with job!)
- [Anon #3] - Security (Future proofing design)
- [Anon #4] - Developer (Ideas from Vita)
- [Anon #5] - Security (Software and hardware)
GPLv3
Free Software, Hell Yeah!