shadPS4/README.md

164 lines
6.3 KiB
Markdown
Raw Normal View History

2024-02-23 21:32:32 +00:00
<!--
SPDX-FileCopyrightText: 2024 shadPS4 Emulator Project
SPDX-License-Identifier: GPL-2.0-or-later
-->
2024-06-04 18:55:16 +00:00
<h1 align="center">
<br>
<a href="https://shadps4.net/"><img src="https://github.com/shadps4-emu/shadPS4/blob/main/.github/shadps4.png" width="220"></a>
<br>
<b>shadPS4</b>
<br>
2024-06-23 06:57:32 +00:00
</h1>
2024-06-04 18:55:16 +00:00
2024-06-23 06:57:32 +00:00
<h1 align="center">
2024-06-04 18:55:16 +00:00
<a href="https://discord.gg/MyZRaBngxA">
<img src="https://img.shields.io/discord/1080089157554155590?color=5865F2&label=shadPS4 Discord&logo=Discord&logoColor=white" width="240">
<a href="https://github.com/shadps4-emu/shadPS4/releases/latest">
<img src="https://img.shields.io/github/downloads/shadps4-emu/shadPS4/total.svg" width="140">
<a href="https://shadps4.net/">
<img src="https://img.shields.io/badge/shadPS4-website-8A2BE2" width="150">
<a href="https://x.com/shadps4">
<img src="https://img.shields.io/badge/-Join%20us-black?logo=X&logoColor=white" width="100">
<a href="https://github.com/shadps4-emu/shadPS4/stargazers">
<img src="https://img.shields.io/github/stars/shadps4-emu/shadPS4" width="120">
2024-06-23 06:57:32 +00:00
</h1>
2024-06-04 18:55:16 +00:00
2024-06-14 12:53:18 +00:00
<p align="center">
<a href="https://shadps4.net/">
2024-06-23 06:57:32 +00:00
<img src="https://github.com/shadps4-emu/shadPS4/blob/main/documents/Screenshots/Sonic Mania.png" width="400">
2024-07-10 17:01:59 +00:00
<img src="https://github.com/shadps4-emu/shadPS4/blob/main/documents/Screenshots/Bloodborne.png" width="400">
2024-06-23 06:57:32 +00:00
<img src="https://github.com/shadps4-emu/shadPS4/blob/main/documents/Screenshots/Undertale.png" width="400">
<img src="https://github.com/shadps4-emu/shadPS4/blob/main/documents/Screenshots/We are DOOMED.png" width="400">
</p>
2024-06-05 05:17:02 +00:00
# General information
2023-06-12 08:00:30 +00:00
shadPS4 is an early **PlayStation 4** emulator for **Windows**, **Linux** and **macOS** written in C++.
2023-06-20 12:42:36 +00:00
2024-06-24 18:34:06 +00:00
If you encounter problems or have doubts, do not hesitate to look at the [**Quickstart**](https://github.com/shadps4-emu/shadPS4/blob/main/documents/Quickstart/Quickstart.md).
2024-07-10 17:01:59 +00:00
To verify that a game works, you can look at [**shadPS4 Game Compatibility**](https://github.com/shadps4-emu/shadps4-game-compatibility).
To discuss shadPS4 development, suggest ideas or to ask for help, join our [**Discord server**](https://discord.gg/MyZRaBngxA).
To get the latest news, go to our [**X (Twitter)**](https://x.com/shadps4) or our [**website**](https://shadps4.net/).
2023-06-20 12:42:36 +00:00
2023-06-12 08:00:30 +00:00
# Status
> [!IMPORTANT]
> shadPS4 is early in developement, don't expect a flawless experience.
2024-08-25 12:12:16 +00:00
Currently, the emulator successfully runs small games like [**Sonic Mania**](https://www.youtube.com/watch?v=AAHoNzhHyCU), [**Undertale**](https://youtu.be/5zIvdy65Ro4) and it can even *somewhat* run [**Bloodborne**](https://www.youtube.com/watch?v=wC6s0avpQRE).
2024-06-04 20:43:10 +00:00
2024-07-31 11:43:30 +00:00
# Why
2023-06-12 08:00:30 +00:00
This project began as a fun project. Given our limited free time, it may take some time before shadPS4 can run more complex games, but we're committed to making small, regular updates.
2023-06-12 08:00:30 +00:00
# Building
2023-06-12 08:00:30 +00:00
2023-06-23 01:48:55 +00:00
## Windows
2024-06-11 19:14:18 +00:00
Check the build instructions for [**Windows**](https://github.com/shadps4-emu/shadPS4/blob/main/documents/building-windows.md).
2023-06-23 01:48:55 +00:00
## Linux
Check the build instructions for [**Linux**](https://github.com/shadps4-emu/shadPS4/blob/main/documents/building-linux.md).
2023-08-08 19:31:21 +00:00
## Building status
2022-10-28 06:54:36 +00:00
2024-07-31 11:43:30 +00:00
<details>
<summary><b>Windows</b></summary>
| Windows | Build status |
|--------|--------|
2024-06-01 06:18:33 +00:00
|Windows SDL Build|[![Windows-sdl](https://github.com/shadps4-emu/shadPS4/actions/workflows/windows.yml/badge.svg)](https://github.com/shadps4-emu/shadPS4/actions/workflows/windows.yml)
|Windows Qt Build|[![Windows-qt](https://github.com/shadps4-emu/shadPS4/actions/workflows/windows-qt.yml/badge.svg)](https://github.com/shadps4-emu/shadPS4/actions/workflows/windows-qt.yml)
2024-07-31 11:43:30 +00:00
</details>
<details>
<summary><b>Linux</b></summary>
2024-06-04 18:55:16 +00:00
2024-07-31 11:43:30 +00:00
| Linux | Build status |
|--------|--------|
2024-06-01 06:18:33 +00:00
|Linux SDL Build|[![Linux-sdl](https://github.com/shadps4-emu/shadPS4/actions/workflows/linux.yml/badge.svg)](https://github.com/shadps4-emu/shadPS4/actions/workflows/linux.yml)
|Linux Qt Build|[![Linux-qt](https://github.com/shadps4-emu/shadPS4/actions/workflows/linux-qt.yml/badge.svg)](https://github.com/shadps4-emu/shadPS4/actions/workflows/linux-qt.yml)
2024-07-31 11:43:30 +00:00
</details>
<details>
<summary><b>macOS</b></summary>
| macOS | Build status |
|--------|--------|
|macOS SDL Build|[![macOS-sdl](https://github.com/shadps4-emu/shadPS4/actions/workflows/macos.yml/badge.svg)](https://github.com/shadps4-emu/shadPS4/actions/workflows/macos.yml)
|macOS Qt Build|[![macOS-qt](https://github.com/shadps4-emu/shadPS4/actions/workflows/macos-qt.yml/badge.svg)](https://github.com/shadps4-emu/shadPS4/actions/workflows/macos-qt.yml)
</details>
2024-06-01 06:18:33 +00:00
# Debugging and reporting issues
For more information on how to test, debug and report issues with the emulator or games, read the [Debugging documentation](https://github.com/shadps4-emu/shadPS4/blob/main/documents/Debugging/Debugging.md).
# Keyboard mapping
> [!NOTE]
2024-08-25 12:37:17 +00:00
> Xbox and DualShock controllers work out of the box.
2024-07-01 16:27:22 +00:00
| Controller button | Keyboard equivelant |
2024-07-31 11:43:30 +00:00
|-------------|-------------|
2024-07-01 16:27:22 +00:00
LEFT AXIS UP | W |
LEFT AXIS DOWN | S |
LEFT AXIS LEFT | A |
LEFT AXIS RIGHT | D |
RIGHT AXIS UP | I |
RIGHT AXIS DOWN | K |
RIGHT AXIS LEFT | J |
RIGHT AXIS RIGHT | L |
TRIANGLE | Numpad 8 |
CIRCLE | Numpad 6 |
CROSS | Numpad 2 |
SQUARE | Numpad 4 |
PAD UP | UP |
PAD DOWN | DOWN |
PAD LEFT | LEFT |
PAD RIGHT | RIGHT |
OPTIONS | RETURN |
TOUCH PAD | SPACE |
L1 | Q |
R1 | U |
L2 | E |
R2 | O |
L3 | X |
R3 | M |
2024-03-23 08:05:45 +00:00
# Main team
2023-06-12 08:00:30 +00:00
2024-06-11 19:14:18 +00:00
- [**georgemoralis**](https://github.com/georgemoralis)
- [**raphaelthegreat**](https://github.com/raphaelthegreat)
- [**psucien**](https://github.com/psucien)
- [**skmp**](https://github.com/skmp)
- [**wheremyfoodat**](https://github.com/wheremyfoodat)
- [**raziel1000**](https://github.com/raziel1000)
2024-03-28 14:38:14 +00:00
2024-06-11 19:14:18 +00:00
Logo is done by [**Xphalnos**](https://github.com/Xphalnos)
2023-06-12 08:00:30 +00:00
2024-06-11 19:14:18 +00:00
# Contributing
2023-06-12 08:00:30 +00:00
2024-06-11 19:14:18 +00:00
If you want to contribute, please look the [**CONTRIBUTING.md**](https://github.com/shadps4-emu/shadPS4/blob/main/CONTRIBUTING.md) file.
Open a PR and we'll check it :)
2023-02-24 09:10:30 +00:00
2024-06-04 18:55:16 +00:00
# Contributors
<a href="https://github.com/shadps4-emu/shadPS4/graphs/contributors">
2024-07-31 11:43:30 +00:00
<img src="https://contrib.rocks/image?repo=shadps4-emu/shadPS4&max=15">
2024-06-04 18:55:16 +00:00
</a>
2023-08-14 17:29:16 +00:00
# Sister Projects
2024-06-11 19:14:18 +00:00
- [**Panda3DS**](https://github.com/wheremyfoodat/Panda3DS): A multiplatform 3DS emulator from our co-author wheremyfoodat.
- [**hydra**](https://github.com/hydra-emu/hydra): A multisystem, multiplatform emulator (chip-8, GB, NES, N64) from Paris.
2024-07-10 17:01:59 +00:00
# License
- [**GPL-2.0 license**](https://github.com/shadps4-emu/shadPS4/blob/main/LICENSE)