obhq/obliteration
1
0
Fork 0
mirror of https://github.com/obhq/obliteration.git synced 2024-11-27 05:00:24 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
Experimental free and open-source PlayStation 4 kernel
904 Commits 1 Branch 0 Tags 27 MiB
Rust 94.3%
C++ 3.6%
Slint 0.9%
CMake 0.8%
Python 0.3%
Other 0.1%
4a2fef1c5e
Go to file
Putta Khunchalee 4a2fef1c5e
Checks ID_AA64MMFR0_EL1 if page size is supported (#965)
2024-09-05 01:06:37 +07:00
.github Prints panic message (#949) 2024-08-25 20:13:12 +02:00
.vscode Uses cbindgen to generate core binding (#893) 2024-07-21 12:18:19 +02:00
cmake Uses Ninja to build on Windows (#785) 2024-03-31 19:33:46 +07:00
src Checks ID_AA64MMFR0_EL1 if page size is supported (#965) 2024-09-05 01:06:37 +07:00
.clangd Moves to clangd (#756) 2024-03-23 20:02:54 +07:00
.gitignore Moves to clangd (#756) 2024-03-23 20:02:54 +07:00
.obliteration-development Extracts kernel into a separated process 2022-10-06 21:49:39 +07:00
CMakeLists.txt Removes LLVM (#743) 2024-03-16 20:01:57 +01:00
CMakePresets.json Uses Ninja to build on Windows (#785) 2024-03-31 19:33:46 +07:00
entitlements.plist Enables com.apple.security.hypervisor on macOS (#737) 2024-03-10 17:39:56 +07:00
flatpak.yml Revises console (#946) 2024-08-24 15:03:14 +02:00
LICENSE-APACHE Makes new contribution dual license (#961) 2024-09-02 18:32:36 +02:00
LICENSE-MIT Makes new contribution dual license (#961) 2024-09-02 18:32:36 +02:00
logo.png Reset logo. 2022-11-04 07:57:31 -04:00
README.md Makes new contribution dual license (#961) 2024-09-02 18:32:36 +02:00

README.md

Logo

About

CI

Obliteration is a free and open-source PlayStation 4 kernel rewritten in Rust. Its goal is to run the PlayStation 4 system software on Windows, Linux and macOS using a custom made virtualization stack optimized specifically for Obliteration. The project is under development and cannot run any games yet. The reason it take so long is because we decided to go with the correct path without stubbing as much as possible.

This project started as a hard-fork from Kyty. Then we decided to rewrite the whole project from scratch by using Kyty and Uplift as a reference to help us getting started with the project.

The project logo and icon was designed by VocalFan.

Get a daily build

You can download binaries from the latest commits here. You MUST sign in to GitHub otherwise you will not be able to download files.

System requirements

  • Windows 10, Linux or macOS 11+.
    • On Windows and Linux make sure you have Vulkan 1.3 installed. If you encountered Failed to initialize Vulkan (-9) that mean you don't have a Vulkan installed.
  • x86-64 CPU. We want to support non-x86 but currently we don't have any developers who are willing to work on this.
  • CPU with hardware virtualization supports.
    • Windows and Linux users may need to enable this feature on the BIOS/UEFI settings.
  • A PS4 with system software version 11.00 for firmware dumping.

Windows-specific requirements

Building and Development

Information on building Obliteration and preparing to be a developer can be found on our Wiki.

License

  • src/ansi_escape.hpp, src/ansi_escape.cpp, src/log_formatter.hpp and src/log_formatter.cpp are licensed under GPL-3.0 only.
  • src/param, src/pfs and src/pkg are licensed under LGPL-3.0.
  • All other source code are licensed under either MIT License or Apache License, Version 2.0; or both. If the file header does not specify which license then it is licensed under MIT License.
  • All release binaries are under GPL-3.0.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Obliteration by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

UI Icons

We use icons from https://materialdesignicons.com for UI (e.g. on the menu and toolbar).