mirror of https://github.com/stenzek/duckstation
				
				
				
			
		hacktoberfestappimageemulatorenhancementsfasthardware-renderersjit-compileropenglplaystationps1psxvulkan
		
		
		
		
		
			You cannot select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
		
			| 
				
					
						
							 | 
			6 years ago | |
|---|---|---|
| dep | 6 years ago | |
| src | 6 years ago | |
| .clang-format | 6 years ago | |
| .gitattributes | 6 years ago | |
| .gitignore | 6 years ago | |
| .gitmodules | 6 years ago | |
| CMakeLists.txt | 6 years ago | |
| CMakeSettings.json | 6 years ago | |
| LICENSE | 6 years ago | |
| README.md | 6 years ago | |
| duckstation.sln | 6 years ago | |
		
			
				
				README.md
			
		
		
			
			
		
	
	DuckStation - PlayStation (PSX) Emulator
Features
- CPU Recompiler/JIT (x86_64 work-in-progress, AArch64 planned)
 - Hardware (D3D11 and OpenGL) and software rendering
 - Upscaling and true colour (24-bit) in hardware renderers
 - "Fast boot" for skipping BIOS splash/intro
 - Save state support
 - Windows and Linux support - macOS may work, but not supported by author
 
Building
Clone the respository with submodules (git clone --recursive or git clone and git submodule update --init).
Windows
Requirements:
- Visual Studio 2019
 
- Open the Visual Studio solution 
duckstation.slnin the root, or "Open Folder" for cmake build. - Build, binaries are located in 
bin/x64. - Copy the DLL files from 
dep/msvc/bin64to the binary directory. - Run 
duckstation-x64-Release.exeor whichever config you used. 
Linux
Requirements:
- CMake
 - SDL2
 
- Create a build directory, either in-tree or elsewhere.
 - Run cmake to configure the build system. Assuming a build subdirectory of 
build-release,cd build-release && cmake -DCMAKE_BUILD_TYPE=Release -GNinja ... - Compile the source code. For the example above, run 
ninja. - Run the binary, located in the build directory under 
src/duckstation/duckstation. 
Running
- Configure the BIOS path in the settings.
 - Open a disc image file, enjoy.
 
Default keyboard bindings
Keyboard bindings are currently not customizable. For reference:
- D-Pad: W/A/S/D or Up/Left/Down/Right
 - Triangle/Square/Circle/Cross: I/J/L/K or Numpad8/Numpad4/Numpad6/Numpad2
 - L1/R1: Q/E
 - L2/L2: 1/3
 - Start: Enter
 - Select: Backspace
 
Gamepads are automatically detected and supported. Tested with an Xbox One controller. To access the menus with the controller, press the right stick down and use the D-Pad to navigate, A to select.
Useful hotkeys
- F1-F8: Quick load/save (hold shift to save)
 - F11: Toggle fullscreen
 - Tab: Temporarily disable speed limiter
 - Pause/Break: Pause/resume emulation
 - Space: Frame step
 - End: Toggle software renderering
 - Page Up/Down: Increase/decrease resolution scale in hardware renderers
 
Tests
- Passes amidog's CPU and GTE tests, partial passing of CPX tests
 
Screenshots
Disclaimers
Icon by icons8: https://icons8.com/icon/74847/platforms.undefined.short-title
"PlayStation" and "PSX" are registered trademarks of Sony Interactive Entertainment Europe Limited. This project is not affiliated in any way with Sony Interactive Entertainment.


