README.md

ScpToolkit

Windows Driver and XInput Wrapper for Sony DualShock 3/4 Controllers

Archive statement

Dear community, it has been an amazing ride but the time has come to let go. The ScpToolkit has outgrown itself and won't be continued any longer. As we're speaking the team behind this solution is working on various successor projects so keep an eye open! Good bye!

Credits

Community

• Major props to original author Scarlet.Crush for developing this awesome toolkit!
• Original PCSX2 forums thread

Sponsors

• ScpToolkits Setup is created with Advanced Installer, a feature-rich and yet easy to learn installation package creation framework for the Windows platform.
• Development is assisted by JetBrains ReSharper Ultimate tool collection, a must-have for every serious .NET developer.

Used libraries and other 3rd party code

• MadMilkman.Ini parsing library by Mario Z.
• reactivesockets library by Daniel Cazzulino
• Windows Driver Installer library for USB devices
• PortableSettingsProvider
• log4net logging library
• Libarius .NET library
• Rx networking library
• libusbK driver package
• irrKlang cross platform sound library
• Metro Light and Dark Themes for WPF
• Fody/PropertyChanged
• ScpCleanWipe uses code from DriverStore Explorer
• AutoDependencyProperty.Fody
• HIDSharp library
• Windows Input Simulator
• AutoDependencyProperty.Fody
• LoadAssembliesOnStartup
• Costura
• DBreeze NoSql embedded object DBMS
• Newtonsoft.Json

Installation requirements

• Microsoft Windows Vista/7/8/8.1/10 x86 or amd64
• Microsoft .NET Framework 4.5
• Microsoft Visual C++ 2010 Redistributable Package
• Microsoft Visual C++ 2013 Runtime
• DirectX Runtime
• Xbox 360 Controller driver
• Already integrated in Windows 8.x or greater
• At least one supported Sony DualShock 3/4 controller (see Compatible Controllers)
• Administrator rights during driver setup

Optional

• A supported Bluetooth 2.0 (or higher) compatible USB dongle with EDR (Enhanced Data Rate)
• See Compatible Bluetooth Devices
• For DS4s to be useable the minimal supported Bluetooth version is 2.1!

Installation How-To

1. Connect your Dongle (only needed if you want to use it wirelessly) and controllers (yes, all of them) via USB and let Windows install its default drivers. Leave them plugged in during the entire installation process!
2. Download the latest release of the ScpToolkit Setup to an arbitrary location on your PC.
3. Run the Setup and follow it's instructions. Should be fairly straight-forward.
4. Wait for the Setup to finish.

• If you're performing a fresh installation, run the Driver Installer afterwards.
• If you're upgrading from an older installation you may skip the Driver Installer.

5. When running the Driver Installer, choose your Bluetooth and controller devices you like to use with ScpToolkit.
6. The next step depends on your operating system:

• Vista: check the Force Install option.
• Win 7/8/8.1/10: leave it unchecked (or check if you're facing installation troubles, might help).

7. Click Install.
8. You're done!

To-Do list

• Rewrite profile manager
• Add support for fake PANHAI DS3 controllers
• Implement gyroscope and accelerometer readout for DS3 and DS4
• Implement touchpad readout for DS4

Compatible Controllers

To be filled...

• USB\VID_054C&PID_0268
• Original Sony DualShock 3 Controller
• USB\VID_054C&PID_0268&REV_0100
• BigBen BB4401 PS3PADRFLX (3rd Party Controller)
• USB\VID_0E6F&PID_0214&REV_0580
• Afterglow AP.2 Wireless Controller for PS3 (3rd Party Controller)
• Although it's a wireless controller, technically it's an USB controller because it uses a proprietary protocol and ships with it's own USB dongle which can't/must not be paired manually.
• Rumble, LED-Control and battery charging status isn't supported/implemented yet.