PSBBN Definitive Project

PS2 PSBBN Definitive Project 4.2

\\wsl.localhost\Debian\home\pi\PSBBN-Definitive-English-Patch\icons\art ?
Yes, that's the correct location. The art should be a 256×256 PNG, preferably in 8-bit colour for better performance.

Another question: I want to use this PlayStation 2 as my main console from now on, but I can't get ESR to work fine.
I'm not sure what could be causing this issue. If your console supports it, I recommend using MechaPwn instead to play imports and backups.
 
PSBBN Update: Definitive Patch v2.10 – Big Game Installer Changes & More!


Full Changelog:

PFS Shell.elf & HDL Dump.elf:
  • PFS Shell updated to support creating 8 MB PFS partitions
  • HDL Dump updated to properly modify their headers
PSBBN Disk Image Updated to Version 2.10:
  • Disk image created with a new version of PFS Shell for full compatibility with 8 MB PFS partitions
  • Added a direct link to the Game Collection in the Top Menu
  • Improved boot time for users without a connected Ethernet cable
  • Modified the startup script to format and initialize the Music partition, allowing it to be smaller or larger than before.
  • Reduced delay before button presses are registered when booting into Linux
  • PS2 Linux partition now uses `ext2` instead of `reiserfs`
  • Removed ISP Settings from the Top Menu
  • Removed Open PS2 Loader shortcut from the Navigator Menu (user can add a shortcut to their choice of game launcher manually)
  • Modified shortcuts to `LaunchELF` and `Launch Disc`
  • Updated the About PlayStation BB Navigator page
  • Enabled telnet access to PSBBN for development purposes
  • Corrections to the English translation
02-PSBBN-Installer.sh:
  • Prevents the script from installing the PSBBN Definitive Patch if the version is below 2.10
  • Partitions the remaing space of the first 128 GB of the drive:
  • Music partition can now range between 1 GB and 104 GB
  • POPS partition can now range between 1 GB and 104 GB
  • Space reserved for 800 BBNL partitions
  • Removed POPS installer (now handled by the Game Installer script)
  • Code has been significantly cleaned up and optimized
03-Game-Installer.sh:
  • Added a warning for users running PSBBN Definitive Patch below version 2.10
  • The PS2 drive is now auto-detected
  • Added an option to set a custom path to the `games` folder on your PC
  • Allows new games and apps to be added without requiring a full sync
  • BBNL partition size reduced from 128 MB to 8 MB, enabling up to 800 games/apps to be displayed in the Game Collection
  • Fixed a bug preventing games with superscript numbers in their titles from launching
  • General improvements to error checking and messaging
  • Fixed issues detecting success/failure of some `rsync` commands
  • `rsync` now runs only when needed
  • Improved update process for POPStarter, OPL, NHDDL and Neutrino
  • Game Installer now installs POPS binaries if missing
  • Reduced number of commands executed with `sudo`
  • ELF files are now installed in folders and include a `title.cfg`
  • Code has been significantly cleaned up and optimized
list-builder.py:
  • Merged `list-builder-ps1.py` and `list-builder-ps2.py` into a single script
  • Now extracts game IDs for both PS1 and PS2 games
list-sorter.py:
  • Game sorting logic has been moved here from the previous list builder scripts
  • Sorting has been significantly improved
General:
  • PSBBN Installer and Game Installer scripts now prevent the PC from sleeping during execution
  • Added a check in each script to ensure it is run using Bash
  • Updated README.md
 
Last edited:
PSBBN Update: Definitive Patch v2.11 - Boot Security Patched! Button Swap, VMC Groups & More!


Full Changelog: New in Definitive Patch v2.11:
  • Boot Security Patched. The CRC security check in PSBBN's boot ELF has been bypassed, allowing the loading of custom kernels.
  • The `X` and `O` buttons have been swapped: `X` is now Enter, and `O` is now Back.
  • Added support for the PlayStation 2 DVD remote control. The `PLAY`, `PAUSE`, `STOP`, `PREV`, `NEXT`, `SCAN`, and `DISPLAY` buttons can now be used during music and movie playback in the Music and Movie channels. The `ENTER` button can also be used when navigating menus.
  • The `PlayStation BB Guide` has been updated to reflect the button swap and the relocation of the `Game Collection`. A new section has been added covering the Online Channels. Numerous improvements to the English translation.
  • Improves the update process. A USB drive and keyboard will not be required for future updates.
`02-PSBBN-Installer.sh`:
  • You can now set a custom size for the POPS partition. Previously, it filled all remaining space after creating the music partition.
`03-Game-Installer.sh`, `ps2iconmaker.sh` & `txt_to_icon_sys.py`:
  • Multi-disc PS1 games now support disc swapping without additional setup. A `DISCS.TXT` file is created for every multi-disc game. Multi-disc games also now share a POPStarter Virtual Memory Card (VMC)
  • POPStarter VMC Groups for PS1 games: games that can interact with each other's save data now share a single VMC. For example, licenses earned in Gran Turismo can be transferred to Gran Turismo 2, and Metal Gear Solid's Psycho Mantis can comment on other Konami games you've played.
  • VMCs now display clearer titles in `Save Data Management` and `Browser 2.0` with custom icons for each game and group.
  • The game installer now automatically generates HDD-OSD (Browser 2.0) icons if not found on the HDD-OSD Icon Database. If cover images for a game are available in the OPL Manager Art Database, a 3D icon for the game will be automatically generated. 3D icons are also created for VMCs when a game logo is available. All newly generated icons are automatically contributed to the HDD-OSD Icon Database, and missing icons are reported.
  • Fixed a bug where incorrect publisher information could be displayed for `ELF` files
`list-builder.py`:
  • Improved Game ID extraction for edge cases. Now handles non-standard IDs like `LSP99016.101` and PS1 games with non-standard `system.cnf` files.
Neutrino Updated to Version 1.7.0
  • Full changelog for Neutrino can be found here
Open PS2 Loader Updated to v1.2.0 Beta-2210-6b300b0
  • Adds support for VMC Groups and bug fixes.
wLaunchELF
  • Upgraded to wLaunchELF v4.43x_isr. Improves stability, and adds support for exFAT on external drives and MMCE (SD card browsing on Mem Card Pro 2/SD2PSX).
 
here again with another question. i know that using wsl on windows is a bit of a pain for most who do not know how to use Linux systems (I'm still learning) but i have a question. if i have to have my disc images on different drives (for space saving purposes) i know that Linux ca make symlinks so that they appear as being in whatever place you put them. do your scripts play well with symlinks? cause if i can have my pops games in one drive and OPL folders in another but still have them show up as being in the games folder how they should be, it can save me a headache of trouble trying to figure out how to move things to proper locations.
 
do your scripts play well with symlinks?

Yep, symbolic links work fine. Something you might not know is that you can drag and drop PS2 games and homebrew apps directly onto the PS2 drive in Windows. When you run the game installer and choose "Add additional games" it will generate all the necessary assets for everything on your drive. The only exception is PS1 games, they need to be in a specific folder on your PC, since they must be copied to an APA partition. Hope that helps!
 
PSBBN Update: Definitive Patch v3.0 - Music Installer, Menu System, Faster Installs & More!


NEW! Menu System:
  • New central menu system instead of separate scripts, making it easier to navigate the various features of the PSBBN Definitive Patch
  • Setup now runs automatically if missing dependencies are detected
NEW! Music Installer:
  • Install music for playback on the PSBBN Music Channel. Supported formats: `.mp3`, `.m4a`, `.flac`, and `.ogg`
NEW! PSBBN Installer:
  • PSBBN has fully transitioned from ReiserFS (an old, no-longer-supported filesystem) to ext2, allowing direct access to all BBN partitions
  • The new PSBBN Installer works with a tar archive instead of a disk image, reducing download size and drastically improving install time
  • When installing, you can set a custom size for the `contents` partition used for movies and photos (previously limited to 5 GB)
  • Increased maximum size of the Music, Contents, and POPS partitions — now up to 111 GB
NEW! PSBBN Updater:
  • Allows updating to the latest version of the Definitive Patch directly from the menu. No USB thumb drive or USB keyboard required!
Game Installer:
  • The game installer now offers an HDTV fix for PS1 games, allowing them to display on TVs that do not support 240p
  • Bug fixes and improved Game ID extraction for ISO and VCD files.
  • Extracts Game ID directly from ZSO files by decompressing only part of the disc image; ZSO files no longer need to be fully decompressed or renamed, greatly improving processing time
Extras:
  • PS2 Linux is now an optional install. You can set a custom size for your home partition. PS2 Linux can also be reinstalled if you experience issues
  • Swap the functions of the Cross and Circle buttons on your controller. Choose between the standard layout (Cross = Enter, Circle = Back) or the alternate layout (Circle = Enter, Cross = Back)
HDD-OSD (Browser 2.0):
  • New PSBBN icon designed by Yornn
  • New improved background colour when viewing game icons
 
hello @CosmicScale , great work with PSBBN! :encouragement:

I was trying it out (v2.11), and I think I found a bug or issue with the game installer.
My system: PS2 FAT 50001 (no modchip), with the original adapter + bitfunx SATA mod, 2TB Seagate hard disk (regular HDD, no ssd)
I used a Debian 12 linux to do all the setup and install.

I installed a bunch of PS2 games first (with the first install option with OPL), then a day later I decided to add some PS1 games too (using the update option), to test out the POPstarter option. I added a bunch of .VCD files to the POPS folder, and everything got copied ok.

Today, After the setup, I connected the HDD to the ps2, and PSBBN was running fine, completed all the networking setup and stuff. Then I went to the Game Collection, and all my PS2 games showed up, but not a single PS1 game was listed.

I just saw that v3.00 was released, but I didn't want to touch things, so I better ask first before breaking something.
Let me know if you need more info or details, at least to see if I did something wrong or if there's a bug somewhere. (PS1 is not critical for me so right now I'm fine with my new PS2 setup thanks to your PSBBN work)

Cheers!
 
hello @CosmicScale , great work with PSBBN! :encouragement:

I was trying it out (v2.11), and I think I found a bug or issue with the game installer.
My system: PS2 FAT 50001 (no modchip), with the original adapter + bitfunx SATA mod, 2TB Seagate hard disk (regular HDD, no ssd)
I used a Debian 12 linux to do all the setup and install.

I installed a bunch of PS2 games first (with the first install option with OPL), then a day later I decided to add some PS1 games too (using the update option), to test out the POPstarter option. I added a bunch of .VCD files to the POPS folder, and everything got copied ok.

Today, After the setup, I connected the HDD to the ps2, and PSBBN was running fine, completed all the networking setup and stuff. Then I went to the Game Collection, and all my PS2 games showed up, but not a single PS1 game was listed.

I just saw that v3.00 was released, but I didn't want to touch things, so I better ask first before breaking something.
Let me know if you need more info or details, at least to see if I did something wrong or if there's a bug somewhere. (PS1 is not critical for me so right now I'm fine with my new PS2 setup thanks to your PSBBN work)

Cheers!

That's a strange one. Can you post the game-installer.log so I can try to figure out what went wrong? GitHub is the best place to do that.
 
PSBBN Definitive English Patch v3.0 is out!

hq720.jpg

More info here:
https://www.psx-place.com/threads/psbbn-definitive-english-patch.45502/page-4#post-415699.​
 
Updated to 3.00, awesome work :)
I am trying to update the DVD player from 2.13e to 3.11j (rgb/progresive hack).

What is the recommended way to this with PSBBN? Can someone please list the necessary steps, because I am stuck after trying many things. Also, is an MC or USB needed for this to work, or can the update also be persisted on hdd?

Update: finally got it to work. However, PSBBN still shows 2.13E as dvd player under Version information, where I expected 3.11J there?

Update 2: OSD browser does correctly show 3.11 (RPC 1) at the DVD version

Other feedback on 3.00:
- When choosing Save data management and then Memory Card PS2 1, the screen shows the files and 'Loading Data' but hangs. Have to reset console.
 
Last edited:
Update: finally got it to work. However, PSBBN still shows 2.13E as dvd player under Version information, where I expected 3.11J there?
Yes, this is normal. PSBBN only checks the memory card for a Japanese system update, so if you have a console from another region it will not show up in the version information. This does not affect how the DVD Player works in any way.

Other feedback on 3.00:
- When choosing Save data management and then Memory Card PS2 1, the screen shows the files and 'Loading Data' but hangs. Have to reset console.

I've never experienced this, and I'm not aware of anyone else experiencing it either. It's most likely an issue with your memory card.
 
Yes, this is normal. PSBBN only checks the memory card for a Japanese system update, so if you have a console from another region it will not show up in the version information. This does not affect how the DVD Player works in any way.



I've never experienced this, and I'm not aware of anyone else experiencing it either. It's most likely an issue with your memory card.

Clear, makes sense it only displays Japanese version.

And will check some other memory cards as well, to see if only that one causes problems
 
Big thanks to @CosmicScale for the awesome work! I tried setting up PSBBN on my 500GB HDD, but I noticed that if I keep the minimum size for PS1, music, and media, I end up with about 100GB just sitting there unallocated-it feels like a waste. Honestly, I only want to play PS2 games on my PS2. I don't plan on adding PS1 games, music, or movies-maybe just a few NES, SNES, or Sega titles at most. Is there a way to skip the partitions I don't need and make sure none of the space gets left unused?
 
Big thanks to @CosmicScale for the awesome work! I tried setting up PSBBN on my 500GB HDD, but I noticed that if I keep the minimum size for PS1, music, and media, I end up with about 100GB just sitting there unallocated-it feels like a waste. Honestly, I only want to play PS2 games on my PS2. I don't plan on adding PS1 games, music, or movies-maybe just a few NES, SNES, or Sega titles at most. Is there a way to skip the partitions I don't need and make sure none of the space gets left unused?

Most people do use that space for PS1 games, music, movies, photos, PS2 Linux etc. APA-Jail gets too complicated if I were to allow custom sizes for APA. If you want more space on the exFAT side, I suggest getting a bigger drive. The exFAT partition can be up to 2 TB.
 
Is it possible to unpack the hosdsys.xlf to see the paths to the pfs hdd files the same as the rom0: osdsys elf file?
I can partitialy see some but I can't unpack/uncompress the elf.
pcsx2 loading the sectors off the hdd but not paths so I don't know if the hosdsys elf even uses file names.
I want to redirect the pfs to either mc?: or rom0.
I've tried decrypting .xlf but all it seems to do is strip the kelf header, SCEDoormat_NoME just seems add two kelf headers?
 
Last edited:
PSBBN Definitive Patch v4.0 - OSDMenu, support for 3rd-Party HDD adapters with HOSDMenu and more!


NEW! OSDMenu MBR:
Replaced Sony's original MBR application with OSDMenu MBR, a homebrew alternative that:

  • Handles launching games and apps directly instead of relying on BBN Launcher (BBNL)
  • Improves boot speed
  • Games now launch up to 6 seconds faster
  • Eliminates the need for the PlayStation 2 Basic Boot Loader (PS2BBL) — OSDMenu MBR natively supports launching ELFs by holding a gamepad button at startup, drastically reducing boot times compared to PS2BBL
  • PS2 Linux is now booted directly by holding `circle` at power-on instead of interrupting PSBBN startup
  • Removed the "Launch Disc" app — simply insert a game disc to play, with support for Game ID, MechaPwn and built-in PS1VmodeNeg!
  • Improves Retro GEM Game ID handling — PSBBN and HOSDMenu now both set a Game ID on boot, removing the need for the Retro GEM Game ID Resetter
  • When using a MemCard Pro 2 or SD2PSX, unnecessary VMCs are no longer generated when launching PS1 games with POPStarter or other homebrew apps

NEW! HOSDMenu:
Patches HDD-OSD and introduces several improvements:

  • Supports larger drives — previously limited to 1 TB
  • Launch homebrew apps directly from the OSDSYS menu
  • Launch SAS-compatible applications from Memory Cards and from the internal drive in Browser 2.0
  • Support for launching applications from MMCE, MX4SIO, UDPBD, iLink devices and APA- and exFAT-formatted HDDs
  • Integrated GSM for disc games and applications
  • Support for 1080i and 480p
  • And more — see the GitHub repository for full details

NEW! Install PSBBN and HOSDMenu:

  • The PSBBN Installer now installs HOSDMenu alongside PSBBN
  • Shows latest release notes when installing and updating
  • Supports smaller drives — minimum capacity reduced from 200 GB to 32 GB
  • Increased max APA partition size to 112 GB
  • After partitioning, any unallocated space is now assigned to the OPL partition
  • Advises users to check archive.org or use a VPN if downloads fail

NEW! Install HOSDMenu only:

  • Adds an option to install HOSDMenu only (for users with third-party HDD adapters)
  • Create a custom-size POPS partition (up to 118 GB), automatically assigning remaining space to the OPL partition (up to 2 TB)

Game Installer:

  • Game Installer now requires PSBBN Definitive Patch v4.0.0 and above or HOSDMenu-only
  • Adds support for HOSDMenu-only setups
  • Updates OSDMenu MBR and HOSDMenu if newer versions are available
  • Updates the Navigator Menu with shortcuts to your selected game launcher (OPL or NHDDL), HOSDMenu and wLaunchELF_ISR
  • Updates the HOSDMenu config to display installed homebrew apps in the OSDSYS menu
  • Automatically converts PS1 `BIN/CUE` files to `VCD` and PS2 `BIN/CUE` file to `ISO`
  • PS1 games are now copied and synced through `PFS FUSE` using `rsync`, with visible progress during transfer
  • Copies only valid game and homebrew files when syncing or adding games and apps — `rsync` now ignores Windows `:Zone.Identifier` metadata files that could cause sync failures
  • Automatically capitalizes lowercase `.VCD` extensions to ensure compatibility with POPStarter
  • Relocated `OPNPS2LD.ELF` and `nhddl.elf` to `__system/launcher` and `POPSTARTER.ELF` to `__common/POPS` from exFAT

`list-builder.py`:

  • Now scans the PFS `__.POPS` partition for `VCD` files instead of local `POPS` folder

`art_downloader.py`:

  • Converted `art_downloader` from JavaScript to Python, removing dependencies on Node.js, npm, Puppeteer, and Chromium

Install Music:

  • Adds support for multi-disc albums using disc numbers from metadata
  • Uses Album Artist metadata for albums, and Artist metadata for individual tracks
  • Replaces unsupported characters in metadata with safe alternatives
  • Clearly groups skipped files by reason

PS2 Linux Installer:

  • Updates OSDMenu MBR config to enable the booting of PS2 Linux.

PSBBN Launcher for Windows:

  • Minimum disk capacity reduced from 200 GB to 32 GB
  • User prompts are now more descriptive
  • Prevents users from selecting a WSL folder to store their games and media
  • Enforces build 19041 as the minimum Windows version required to run WSL
  • Runs `wsl --install --no-distribution` to ensure WSL 2 is available
  • Explicitly uses WSL 2 when installing the PSBBN distribution
  • Checks that apt successfully installed git; exits gracefully otherwise
  • Updated disk number input to support values greater than 9
  • Gracefully exits if disk mounting fails

NHDDL:

  • Updated to version v1.2.0

`Setup.sh` and `flake.nix`:

  • Added `bchunk` to dependences

Definitive Patch 4.0.0 Tar Archive:

  • Fixes file permissions and ownership
  • Removed cached files and other unnecessary bloat, reducing the archive size
  • Added additional folders for HOSDMenu and HDD-OSD files
  • Replaced encrypted osdboot.elf with unencrypted version

General:

  • Added support for ARM64 systems. Tested on a Raspberry Pi with the latest version of Raspberry Pi OS
  • `BOOT.ELF` replaced with SAS-compliant wLaunchELF_ISR version 4.43x_isr-bb13043
  • Removed `PS1VModeNeg.elf`
  • Changes locale setting from `en_US.UTF-8` to `C.UTF-8` (some systems lacked `en_US.UTF-8`), ensuring script output and logs remain in English and preventing related failures
  • Improved handling of mounting and unmouting APA partitions
  • Bug fixes
  • Added software licences
 

Similar threads

Back
Top