fcdf6d2b93
Ignore commits to README.md, and /.github; This is future proofing for GitHub Actions, new issue template, etc. Capitalize Ubuntu. Change configuration to Release Optimized. Proper multi-command formatting. Use env matrix instead of shell to seperate steps for Windows and Linux. Add LICENSE to artifacts. Remove artifact type since it's unneeded. Windows: Use AppVeyor's build thing. Remove build verbosity since normal is the default. Remove build\bin crap from the zip. Linux: Make apt-get into one step. Speed up build by using -j. cd into APPVEYOR_BUILD_FOLDER to avoid problems. |
||
|---|---|---|
| .github | ||
| cmake | ||
| data | ||
| dist | ||
| DobieStation | ||
| ext/libdeflate | ||
| src | ||
| .gitignore | ||
| appveyor.yml | ||
| CMakeLists.txt | ||
| gen-clang.sh | ||
| LICENSE | ||
| README.md | ||
DobieStation
A young PS2 emulator with plans for an optimized Android port, as well as a fast, accurate, and easy-to-use PC port.
A large portion of the PS2's library can boot or get to menus. Some titles can even go in-game, including high-profile ones such as Final Fantasy X and Shadow of the Colossus. Not intended for general use.
Compiling
DobieStation uses Qt 5 and supports qmake and CMake.
Building with qmake
cd DobieStation/DobieStation
qmake DobieStation.pro
make
Building with CMake
# Linux
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo
make
# MacOS (using Homebrew Qt5)
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_PREFIX_PATH=/usr/local/opt/qt5
make
# Windows (MSVC)
# - change 'CMAKE_PREFIX_PATH' to point to your Qt installation.
# - replace 'Visual Studio 16 2017' with your desired VS version (eg: "Visual Studio 16 2019")
mkdir build && cd build
cmake -DCMAKE_PREFIX_PATH="C:/Qt/5.13.1/msvc2017_64" \
-G "Visual Studio 15 2017" -A x64 ..
start DobieStation.sln
Note for Ubuntu Xenial
While 16.04 is still officially supported they don't provide a recent enough version of Qt. As such if you wish to build Dobie on Xenial you will need to update Qt through a PPA
add-apt-repository ppa:beineri/opt-qt-5.11.1-xenial
apt-get update
apt-get install qt511-meta-minimal qt511multimedia libglu1-mesa-dev
source /opt/qt511/bin/qt511-env.sh
Alternatively, you may upgrade to the most recent Ubuntu LTS, 18.04.
Building with Visual Studio
DobieStation is known to compile on 2017 and 2019.
Before opening Visual Studio, you must set the QTDIR environment variable to your 64 bit QT install.
For example on Visual Studio 2017: C:\path\to\qt\5.12.1\msvc2017_64
Once the variable is set open DobieStation\DobieStation.sln in Visual Studio.
Using the Emulator
DobieStation requires a copy of the PS2 BIOS, which must be dumped from your PS2.
The various command line options are as follows:
-b [BIOS file] - Takes the form of /path/to/bios.bin. Required for booting DobieStation.
-f [file] (optional) - The ELF or ISO that DobieStation loads. Takes the form of /path/to/game.iso or /path/to/homebrew.elf.
-s (optional) - Skip the BIOS boot animation when starting DobieStation with an ISO/ELF loaded.
The key bindings are as follows:
| Keyboard | DualShock 2 |
|---|---|
| A | Triangle |
| S | Square |
| Z | Circle |
| X | Cross |
| Enter | Start |
| Shift | Select |
| Q | L1 |
| N/A | L2 |
| N/A | L3 |
| W | R1 |
| N/A | R2 |
| N/A | R3 |
| ↑ | D-pad up |
| ↓ | D-pad down |
| ← | D-pad left |
| → | D-pad right |
| I | Left Analog up |
| K | Left Analog down |
| J | Left Analog left |
| L | Left Analog right |
| Keyboard | DobieStation |
|---|---|
| F1 | Dump current frame from GS |
| F8 | Take a screenshot |
| . | Advance a single frame |
PS2 Homebrew
Want to test DobieStation? Check out this repository: https://github.com/PSI-Rockin/ps2demos
Compatibility not guaranteed, but some demos do work.
Contributing
First, review the Contribution Guide. Once you have done so, take a look at the issue tracker to look for tasks you may be interested in.
Legal
DobieStation uses arg.h by Christoph "20h" Lohmann.