Bloodborne PC Port: Native Windows & Linux Setup

Download the port program from GitHub

Choose the release that matches your project and operating system:

On the release page, open Assets and select that program file. Keep the maintainer, tag and filename together when following the next steps. If you are choosing another native project such as bbhost, use PC port projects to reach its own setup instructions.

Bloodborne running through bbport on Linux, with the launcher beside the game.

Check your PC and storage

For storage, check the size of your own game directory in your file manager, then add room for the program, extracted files, saves and shader cache. Program downloads are about 114 MB for Supermedo, 189 MB for Mrsuss60 and 885 MB for the Linux AppImage. If you need the Linux extract-and-run workaround, allow about 2 GB more for the unpacked AppImage.

Check your game files and version

Choose the actual CUSA03173 game folder, containing these entries:

A folder called CUSA03173 is only a label. Check the version record for your own copy as well. On Linux, the launcher and run.sh also examine the executable and explain when the update is missing, the executable is old, or the edition is wrong. Leave this check enabled.

On Linux bbport, the original 1.00 base game alone crashes at startup. A separate update folder beside it does not satisfy the requirement: the game folder you select must already contain the 1.09 version.

Use CUSA03173 v1.09 for the three setup routes below. Supermedo needs 1.09 for its community frame-rate, resolution and effects patches; other game versions run at 30 FPS there. If your copy is CUSA00900, changing its folder name will not change its executable. Stop here if you have a different edition, missing files or an unknown version; prepare the required input before continuing.

Install on Windows

Supermedo Windows v1.5

1. Extract Bloodborne-Windows.zip into a folder for the program.
2. Open Bloodborne.exe.
3. In Game & effects, select your prepared game folder containing eboot.bin. Open Play → Ready check and check for Game version 01.09. If it shows another version or ?, recheck your prepared copy before using the community patches.
4. Start with 60 FPS. If you have an RTX 20-series or newer GPU with current drivers, you can select Graphics → Upscaler → DLSS for DLSS Super Resolution. Use another available upscaler on other GPUs.
5. Press PLAY. At character creation, press Enter to accept the name or Esc to cancel the name dialog.

If the preview is blank, you can still finish character creation and see your character in the game.

After saving the configuration, Play Bloodborne.exe starts with those settings. To update the program, use Update, or Advanced → Check for updates. Back up your saves first.

Mrsuss60 Windows v0.2

1. Install Python 3.10 or newer. Open a terminal and run python --version to check that it is available.
2. Extract bloodborne_pc_windows_port_v0.2_release.zip into your prepared game directory, beside eboot.bin and dvdroot_ps4.
3. Open a terminal in that directory and run python launcher.py. If the package includes launch_gui.bat, you can double-click that shortcut instead.
4. Select your eboot.bin or game folder in the launcher.
5. Choose 60 FPS as your starting target. Use FSR 3.1 and a lower internal resolution, such as 1280×720, if you need a lighter starting setup.
6. Click Launch Bloodborne.

At character creation, type your name into the dialog and press Enter to confirm it. Press Esc to use the default name. Mrsuss60 v0.2 fixes the older crash when you clicked Finalize.

For either Windows project, continue to startup and loading checks if the game fails to open.

Install on Linux

Use Bloodborne-bbport-x86_64.AppImage from the Linux 0.4 release above.

1. Put the AppImage in a folder where you want to keep the port program.

2. Give it permission to run. In a terminal in that folder, use:

   chmod +x Bloodborne-bbport-x86_64.AppImage
   ./Bloodborne-bbport-x86_64.AppImage
   

3. In the launcher, choose your prepared CUSA03173 directory in Game folder.

4. Start with FSR 3 and leave New memory and translation model off. On Steam Deck, choose 1280×720 output.

5. Start the game from the launcher. Read any file or CPU check message before changing other settings.

Use the highlighted Game folder picker to select your CUSA03173 directory.

The AppImage keeps its data under ~/.local/share/bbport; its saves are in the user directory there. You can select a different saves folder in the launcher.

If the AppImage cannot mount, follow the AppImage error steps.

If you already built the Linux source version, run it from the repository with:

BB_GAME_DIR=/path/to/CUSA03173 bash run.sh

Its graphical launcher starts with bash launcher/bb-launcher.sh. Keep these repository commands separate from the AppImage steps.

Check the first launch and exit

Once you reach a playable screen, check movement, sound and saving. Use the keyboard and mouse page for your project's keys. On Supermedo v1.5, disconnect controllers and their receivers when testing ordinary keyboard input.

Find your saves before making a backup:

• Supermedo: open Game & effects → Saves folder → Open. The default is user/ beside Bloodborne.exe; use the location you selected if you changed it.
• Mrsuss60: check user/ in the program/game directory.
• Linux AppImage: check ~/.local/share/bbport/user, or the different saves folder selected in the launcher. Linux source builds default to the repository's user/; use the launcher's selected saves folder if you changed it.

Before closing the game, let the current save finish and use the game's quit option to return to the title screen. Then close the game window. Start the port again, load the save you just made, and check that your progress is still there. If normal exit fails, save the error text and use the support checklist before your next attempt.

After installation

FAQ

Sources

• Linux bbport README
• Linux bbport 0.4 release
• Supermedo Windows README
• Supermedo Windows v1.5 release
• Supermedo Windows releases
• Supermedo v1.5 launcher
• Supermedo v1.5 input implementation
• Mrsuss60 Windows README
• Mrsuss60 Windows v0.2 release
• Installing bbport on Linux

Back to top