Shibari installation instructions



  • Talking about this Shibari 😏

    Attention

    Shibari isn't a finished product nor is it a drop-in replacement for the ScpToolkit and it never will be. Shibari is an ongoing test platform and proof of concept for dispatching input and output data between gaming peripherals. It's currently used to translate data between FireShock Gen2, AirBender and ViGEm.

    Target audience

    You're running Windows 8.1 or 10, wanna use your DualShock 3 (not 4!) controller in pretty much any game and can't run/don't want to deal with ScpToolkit. You might give this a shot then 😊

    Prerequisites

    Make sure all of the following conditions are met and all dependencies are installed.

    Installation guide

    If you can follow a cooking recipe the following section should be a piece of cake 😉 If you can't cook, well, learn it, it's about time 😲 Alright, here we go.

    Get all the files

    Attention: after you downloaded the archives, make sure to unblock them before extraction!

    • Get the latest Shibari.zip from here (always pick the highest version number for most recent release)
    • Get the latest FireShock.zip (version 2.X.X.X) from here
      • This is required for USB connection
    • (Optional) Get the latest AirBender.zip from here
      • This is required for Bluetooth connection
    • Unblock all the archives. If you forget that, weird things may happen 🙁
      d4a1ccff-934f-4b9e-9d34-cf30673eca6a-image.png
    • Extract the contents to a location of your choice (e.g. C:\Shibari)

    Install drivers

    • Right-click on the FireShock.inf file and select Install. If your DS3(s) is/are already connected, unplug and plug back in for the driver change to become active
    • (Optional) Same goes basically for the AirBender.inf but be careful if you have multiple dongles and using Bluetooth for other devices; they might lose connectivity. If you wanna selectively use a dongle for the DS3, replace the stock driver with AirBender via Windows Device Manager. If you're not comfortable with that please stop before you ruin your system. You have been warned.
    • Install the ViGEm Bus Driver

    Ready for some action

    You made it this far? Great! Now simply fire up Shibari.Dom.Server.exe and your connected DS3 should spawn a virtual Xbox 360 controller which your games can pick up. Enjoy!

    Run Shibari in the background

    Shibari can easily be installed as a Windows Service running in the background without the need to start it every time you'd like to use your DS3 and have an additional Window open all the time.

    Fire up PowerShell as Administrator and run the Shibari.Dom.Server.exe file with install as an argument, like so:

    bca87e6e-473e-4445-8f6b-bc7017518e91-image.png

    The path to the executable file has to match the one on your machine of course 😉

    Right after that start the service:

    Start-Service Shibari.Dom.Server
    

    Check that the service is running:

    Get-Service Shibari.Dom.Server
    

    b99c4a26-c6fa-4c3d-8186-f63d21412955-image.png

    Done, delightful 😃



  • Bluetooth Pairing with Shibari

    About

    Pairing a DS3 to a new Bluetooth host has to be done with a little help from a tool knowing what to send to the DS3. Shibari can do that through FireShock with a little management helper module.

    Preparations

    Navigate to the PowerShell subfolder within the directory you extracted Shibari to, hold the Shift key and right-click into the folder, giving you the Open PowerShell window here option:

    df379feb-abc6-4304-8453-a777ae0ce81f-image.png

    You're then greeted by a new PowerShell where you enter the following command:

    Import-Module .\Shibari.Dom.Management.PowerShell.dll
    

    7371b042-1269-41b8-838e-e21ddbe19436-image.png

    Action!

    Now while keeping the PowerShell window open and on stand-by, launch the Shibari.Dom.Server.exe program ans keep an eye out for the line with Bluetooth Host Address: like so:

    91b0dfbb-ed16-4bf8-a318-138c1232e502-image.png

    Note this down, we gonna need that now. Leave the process running and switch back to the PowerShell window. If you haven't already, plug in the DS3 you'd like to pair. Enter the command Get-FireShockDevice, which should return something similar to this:

    5e8c0d72-525d-4eed-a307-3f4acd844b47-image.png

    Now enter the following in one go and adjust the host address to the one you've copied before:

    Get-FireShockDevice | Set-FireShockDevice -HostAddress 00:1A:7D:DA:71:13
    

    ebaa0e84-0a16-4577-b83d-e75498515fdd-image.png

    If there's no error returned, the command succeeded and the controller is now paired to the current Bluetooth dongle 🎉


Log in to reply