From 46dbc4a9c50027ed03d895c9048e952b0a22e765 Mon Sep 17 00:00:00 2001
From: kalaposfos13 <153381648+kalaposfos13@users.noreply.github.com>
Date: Wed, 1 Apr 2026 16:50:18 +0200
Subject: [PATCH] readme
---
README.md | 58 +++++++++++++++---------------------
documents/Screenshots/2.png | Bin 1170138 -> 450921 bytes
documents/Screenshots/3.png | Bin 1034261 -> 193572 bytes
documents/Screenshots/4.png | Bin 1967974 -> 821896 bytes
4 files changed, 24 insertions(+), 34 deletions(-)
diff --git a/README.md b/README.md
index 0fb5c26ed..94f93ccb6 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,7 @@ SPDX-License-Identifier: GPL-2.0-or-later
- shadPS4
+ shadBloodborne
@@ -24,43 +24,43 @@ SPDX-License-Identifier: GPL-2.0-or-later
-| Bloodborne by From Software | Hatsune Miku Project DIVA Future Tone by SEGA |
+| Bloodborne by From Software | Bloodborne by From Software |
| :-----------------------------------------------------------: | :--------------------------------------------------------------------------------------------: |
-|  |  |
+|  |  |
-| Yakuza 0 by SEGA | DRIVECLUBâ„¢ by Evolution Studios |
+| Bloodborne by From Software | Bloodborne by From Software |
| :------------------------------------------------------------------------: | :------------------------------------------------------------------: |
-|  |  |
+|  |  |
# General information
-**shadPS4** is an early **PlayStation 4** emulator for **Windows**, **Linux** and **macOS** written in C++.
+**shadBloodborne** is an early **Bloodborne** emulator for **Windows**, **Linux**, **macOS** and **FreeBSD** written in C++.
> [!IMPORTANT]
> This is the emulator core, which does not include a GUI. If you just want to use the emulator as an end user, download the [**QtLauncher**](https://github.com/shadps4-emu/shadps4-qtlauncher/releases) instead.
If you encounter problems or have doubts, do not hesitate to look at the [**Quickstart**](https://github.com/shadps4-emu/shadPS4/wiki/I.-Quick-start-%5BUsers%5D).\
-To verify that a game works, you can look at [**shadPS4 Game Compatibility**](https://github.com/shadps4-compatibility/shadps4-game-compatibility).\
-To discuss shadPS4 development, suggest ideas or to ask for help, join our [**Discord server**](https://discord.gg/bFJxfftGW6).\
+To verify that Bloodborne works, you can look at [**bloodbornePS4 Compatibility Status**](https://github.com/shadps4-compatibility/shadps4-game-compatibility/issues?q=is%3Aissue%20state%3Aopen%20in%3Atitle%20%22bloodborne%22).\
+To discuss shadBloodborne development, suggest ideas or to ask for help, join our [**Discord server**](https://discord.gg/bFJxfftGW6).\
To get the latest news, go to our [**X (Twitter)**](https://x.com/shadps4) or our [**website**](https://shadps4.net/).\
You can donate to the project via our [**Kofi page**](https://ko-fi.com/shadps4).
# Status
> [!IMPORTANT]
-> shadPS4 is early in development, don't expect a flawless experience.
+> shadBloodborne is early in development, don't expect a flawless experience.
-Currently, the emulator can successfully run games like [**Bloodborne**](https://www.youtube.com/watch?v=5sZgWyVflFM), [**Dark Souls Remastered**](https://www.youtube.com/watch?v=-3PA-Xwszts), [**Red Dead Redemption**](https://www.youtube.com/watch?v=Al7yz_5nLag), and many other games.
+Currently, the emulator can successfully run [**Bloodborne**](https://www.youtube.com/watch?v=5sZgWyVflFM), but not every feature is fully emulated.
# Why
-This project began for fun. 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.
+This project began for fun. Given our limited free time, it may take some time before shadBloodborne can do Bloodborne multiplayer, but we're committed to making small, regular updates.
# Building
## Docker
-For building shadPS4 in a containerized environment using Docker and VSCode, check the instructions here:
+For building shadBloodborne in a containerized environment using Docker and VSCode, check the instructions here:
[**Docker Build Instructions**](https://github.com/shadps4-emu/shadPS4/blob/main/documents/building-docker.md)
## Windows
@@ -76,7 +76,7 @@ Check the build instructions for [**Linux**](https://github.com/shadps4-emu/shad
Check the build instructions for [**macOS**](https://github.com/shadps4-emu/shadPS4/blob/main/documents/building-macos.md).
> [!IMPORTANT]
-> macOS users need at least macOS 15.4 to run shadPS4. Due to GPU issues there are currently heavy bugs on Intel Macs.
+> macOS users need at least macOS 15.4 to run shadBloodborne. Due to GPU issues there are currently heavy bugs on Intel Macs.
# Usage examples
@@ -87,11 +87,11 @@ To get the list of all available commands and also a more detailed description o
Below is a list of commonly used command patterns:
```sh
-shadPS4 CUSA00001 # Searches for a game folder called CUSA00001 in the list of game install folders, and boots it.
-shadPS4 --fullscreen true --config-clean CUSA00001 # the game argument is always the last one,
-shadPS4 -g CUSA00001 --fullscreen true --config-clean # ...unless manually specified otherwise.
-shadPS4 /path/to/game.elf # Boots a PS4 ELF file directly. Useful if you want to boot an executable that is not named eboot.bin.
-shadPS4 CUSA00001 -- -flag1 -flag2 # Passes '-flag1' and '-flag2' to the game executable in argv.
+shadBloodborne CUSA00001 # Searches for a game folder called CUSA00001 in the list of game install folders, and boots it.
+shadBloodborne --fullscreen true --config-clean CUSA00001 # the game argument is always the last one,
+shadBloodborne -g CUSA00001 --fullscreen true --config-clean # ...unless manually specified otherwise.
+shadBloodborne /path/to/game.elf # Boots a PS4 ELF file directly. Useful if you want to boot an executable that is not named eboot.bin.
+shadBloodborne CUSA00001 -- -flag1 -flag2 # Passes '-flag1' and '-flag2' to the game executable in argv.
```
# Debugging and reporting issues
@@ -145,33 +145,23 @@ Keyboard and mouse inputs can be customized in the settings menu by clicking the
# Firmware files
-shadPS4 can load some PlayStation 4 firmware files.
-The following firmware modules are supported and must be placed in shadPS4's `sys_modules` folder.
+shadBloodborne can load some PlayStation 4 firmware files.
+The following firmware modules are supported and must be placed in shadBloodborne's `sys_modules` folder.
-| Modules | Modules | Modules | Modules |
-|-------------------------|-------------------------|-------------------------|-------------------------|
-| libSceCesCs.sprx | libSceFont.sprx | libSceFontFt.sprx | libSceFreeTypeOt.sprx |
-| libSceJpegDec.sprx | libSceJpegEnc.sprx | libSceJson.sprx | libSceJson2.sprx |
-| libSceLibcInternal.sprx | libSceNgs2.sprx | libScePngEnc.sprx | libSceRtc.sprx |
-| libSceUlt.sprx | libSceAudiodec.sprx | | |
+| Modules | Modules |
+|-------------------------|-------------------------|
+| libSceLibcInternal.sprx | libSceRtc.sprx |
> [!Caution]
-> The above modules are required to run the games properly and must be dumped from your legally owned PlayStation 4 console.
+> The above modules are required to run the game properly and must be dumped from your legally owned PlayStation 4 console.
# Main team
-- [**georgemoralis**](https://github.com/georgemoralis)
-- [**psucien**](https://github.com/psucien)
-- [**viniciuslrangel**](https://github.com/viniciuslrangel)
-- [**roamic**](https://github.com/roamic)
-- [**squidbus**](https://github.com/squidbus)
-- [**frodo**](https://github.com/baggins183)
-- [**Stephen Miller**](https://github.com/StevenMiller123)
- [**kalaposfos13**](https://github.com/kalaposfos13)
Logo is done by [**Xphalnos**](https://github.com/Xphalnos)
diff --git a/documents/Screenshots/2.png b/documents/Screenshots/2.png
index 7f701916a5f696ce671ef18bc611b09ad3060ba6..0b03747f8b036e5ccd194e465d8fceffb2275a17 100644
GIT binary patch
literal 450921
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