shadps4-emu/shadPS4
1
0
Fork 0
mirror of https://github.com/shadps4-emu/shadPS4.git synced 2024-11-23 11:20:07 +00:00
Code Issues Actions 5 Packages Projects Releases Wiki Activity
3d04765a3f
shadPS4/documents/building-linux.md

62 lines
2.2 KiB
Markdown
Raw Normal View History

chore: Make shadps4 REUSE compliant
2024-02-23 21:32:32 +00:00
<!--
SPDX-FileCopyrightText: 2024 shadPS4 Emulator Project
SPDX-License-Identifier: GPL-2.0-or-later
-->
Update and rename linux_building to linux_building.md
2023-08-08 19:29:51 +00:00
documentation: fix Linux build instructions (#1107) * Fix linux build instructions * Validation layers and arch linux packages
2024-09-30 11:25:49 +00:00
## Build shadPS4 for Linux
Create linux_building
2023-08-08 19:29:16 +00:00
Update building-linux.md with full instructions (#260) * Update building-linux.md with full instructions * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update building-linux.md with build-essentials * Update building-linux.md --------- Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com>
2024-07-08 09:25:04 +00:00
### Install the necessary tools to build shadPS4:
#### Debian & Ubuntu
```
documentation: fix Linux build instructions (#1107) * Fix linux build instructions * Validation layers and arch linux packages
2024-09-30 11:25:49 +00:00
sudo apt install build-essential clang git cmake libasound2-dev libpulse-dev libopenal-dev libssl-dev zlib1g-dev libedit-dev libudev-dev libevdev-dev libsdl2-dev libjack-dev libsndio-dev qt6-base-dev qt6-tools-dev qt6-multimedia-dev libvulkan-dev vulkan-validationlayers
Update building-linux.md with full instructions (#260) * Update building-linux.md with full instructions * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update building-linux.md with build-essentials * Update building-linux.md --------- Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com>
2024-07-08 09:25:04 +00:00
```
#### Fedora
```
Fix fedora packages (#1174)
2024-10-01 04:53:36 +00:00
sudo dnf install clang git cmake libatomic alsa-lib-devel pipewire-jack-audio-connection-kit-devel openal-devel openssl-devel libevdev-devel libudev-devel libXext-devel qt6-qtbase-devel qt6-qtbase-private-devel qt6-qtmultimedia-devel qt6-qtsvg-devel qt6-qttools-devel vulkan-devel vulkan-validation-layers
Update building-linux.md with full instructions (#260) * Update building-linux.md with full instructions * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update building-linux.md with build-essentials * Update building-linux.md --------- Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com>
2024-07-08 09:25:04 +00:00
```
#### Arch Linux
```
documentation: fix Linux build instructions (#1107) * Fix linux build instructions * Validation layers and arch linux packages
2024-09-30 11:25:49 +00:00
sudo pacman -S base-devel clang git cmake sndio jack2 openal qt6-base qt6-declarative qt6-multimedia sdl2 vulkan-validation-layers
Update building-linux.md with full instructions (#260) * Update building-linux.md with full instructions * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update building-linux.md with build-essentials * Update building-linux.md --------- Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com>
2024-07-08 09:25:04 +00:00
```
#### OpenSUSE
```
documentation: fix Linux build instructions (#1107) * Fix linux build instructions * Validation layers and arch linux packages
2024-09-30 11:25:49 +00:00
sudo zypper install clang git cmake libasound2 libpulse-devel libsndio7 libjack-devel openal-soft-devel libopenssl-devel zlib-devel libedit-devel systemd-devel libevdev-devel qt6-base-devel qt6-multimedia-devel qt6-svg-devel qt6-linguist-devel qt6-gui-private-devel vulkan-devel vulkan-validationlayers
Update building-linux.md with full instructions (#260) * Update building-linux.md with full instructions * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update building-linux.md with build-essentials * Update building-linux.md --------- Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com>
2024-07-08 09:25:04 +00:00
```
### Cloning and compiling:
Clone the repository recursively:
```
git clone --recursive https://github.com/shadps4-emu/shadPS4.git
cd shadPS4
```
documentation: fix Linux build instructions (#1107) * Fix linux build instructions * Validation layers and arch linux packages
2024-09-30 11:25:49 +00:00
Generate the build directory in the shadPS4 directory. To disable the QT GUI, remove the ```-DENABLE_QT_GUI=ON``` flag:
**Note**: Clang is the compiler used for official builds and CI. If you build with GCC, you might encounter issues—please report any you find. If you choose to use GCC, we recommend building with Clang at least once before submitting a pull request.
Create linux_building
2023-08-08 19:29:16 +00:00
```
documentation: fix Linux build instructions (#1107) * Fix linux build instructions * Validation layers and arch linux packages
2024-09-30 11:25:49 +00:00
cmake -S . -B build/ -DENABLE_QT_GUI=ON -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
Create linux_building
2023-08-08 19:29:16 +00:00
```
Enter the directory:
```
cd build/
```
Use make to build the project:
```
Update building-linux.md with thread numbers (#275) Final-ish (?)
2024-07-09 23:24:42 +00:00
cmake --build . --parallel$(nproc)
Update building-linux.md with full instructions (#260) * Update building-linux.md with full instructions * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update building-linux.md with build-essentials * Update building-linux.md --------- Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com>
2024-07-08 09:25:04 +00:00
```
Redefined ffmpeg's av_err2str macro to be c++ friendly (#815) * Fixed compiler error for av_err2string by redefining in c++ friendly way * removed link from comment, putting in PR * fixed formatting * Minor fix: enable qt gui to find PKG files with lowercase extension .pkg * Added missing dependencies and instructions for enabling QT for linux builds
2024-09-08 21:30:18 +00:00
Now run the emulator. If QT is enabled:
```
./shadps4
```
Otherwise, specify the path to your PKG's boot file:
Update building-linux.md with full instructions (#260) * Update building-linux.md with full instructions * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update documents/building-linux.md Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com> * Update building-linux.md with build-essentials * Update building-linux.md --------- Co-authored-by: TheTurtle <47210458+raphaelthegreat@users.noreply.github.com>
2024-07-08 09:25:04 +00:00
```
./shadps4 /"PATH"/"TO"/"GAME"/"FOLDER"/eboot.bin
Create linux_building
2023-08-08 19:29:16 +00:00
```
Reference in New Issue Copy Permalink