Open-source project
CosmicScale/PSBBN-Definitive-Project avatar
CosmicScale/PSBBN-Definitive-Project

PSBBN Definitive Project turns the PS2 hard drive into a usable computer

The ultimate setup for the PlayStation 2's internal drive.

990 stars66 forksShellGPL-3.0

At a glance

What is it?
PSBBN Definitive Project is a long running patch and setup project for Sony's PlayStation Broadband Navigator, the Japan only software that gave the PlayStation 2 a hard drive, a browser and network channels. What it now delivers is a complete drive setup: a patched menu, a game and app installer, a partitioning scheme that mixes exFAT with the PlayStation file system, and a set of local channels that replace the ones Sony took offline.
Who is it for?
PSBBN Definitive Project suits a PS2 owner with a network adapter or a third party hard drive who wants the console's original software to keep working, and it suits anyone who wants the Music, Movie and Photo channels on hardware that has been offline since the service was discontinued.
Can I use it commercially?
Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly Shell, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on October 23, 2026, and from our analysis. They are not legal advice.

Editorial analysis

Starting from a service that only ever shipped in Japan

PSBBN is official Sony software for the PlayStation 2, released exclusively in Japan, known as the Broadband Navigator or BB Navigator. Introduced in 2002 as a replacement for the PS2's on screen display, it required both a hard drive and a network adapter to function at all. What it added was the entire idea of a console with storage: launching games from the hard drive, reaching online channels, downloading full games, demos, videos and pictures, ripping audio CDs and transferring music to MiniDisc recorders in the Music Channel, watching video in the Movie Channel, and transferring photos from a digital camera to view in the Photo Channel. The Definitive Project began in 2023 as an English language patch for that software and grew into a multi language project that aims to provide the complete setup for the internal drive, with Portuguese and Spanish readmes alongside the English one.

Two installation paths, and only one of them needs Sony hardware

The documentation is careful to split the install into two options, and the difference is hardware. The first installs PSBBN together with HOSDMenu and requires an official Sony Network Adapter, with a footnote pointing to a known issues section for the details of that requirement. The second installs HOSDMenu only and supports both official Sony Network Adapters and third party hard drive adapters. That second path is the more accessible one, because the menu can be put in place without the network functions that PSBBN itself depends on. Both paths share the same supporting pieces, so the installer, the drive layout and the included applications are the same either way, and the choice is about which half of the software you can run on your console.

APA-Jail is what makes one drive hold two file systems

The storage layout is the quiet technical centre of the project. Support for larger drives comes through APA-Jail, described as a hybrid partitioning scheme that allows an exFAT filesystem and the PlayStation File System, PFS, to coexist on the same drive. The two filesystems have clearly different jobs in this design. exFAT is used for storage and for easy management of both games and homebrew apps, which is what makes a large library workable with a file manager. PFS is used for the system software itself and for legacy support, so the parts of the console that insist on the original format still find it. Both installation options put the storage and the system software on a single drive, and the console's own installers are not what creates this layout, the project is.

HOSDMenu is a patched Sony menu, not FreeHDBoot

The front door for all of this is HOSDMenu, described as a patched version of Sony's HDD-OSD software that offers many advantages over FreeHDBoot, and the documentation links to a section listing them. What it does is let you view, browse and launch your games and apps directly from a browser, with the entries represented by 3D icons that come from a separate icon database repository. The README calls out the difference in approach from FreeHDBoot rather than claiming the same ground, which is the useful thing to know when you are choosing between them: one is a modification of the software Sony wrote. On a PSBBN install there is a second layer on top, the Game Collection, a cover flow style interface for the same library, and a list of bundled applications that ship with the project.

The Game and App Installer automates the repetitive work

The installer is the part of the project that does the most, and its own list of jobs is the clearest description of what setting up a PS2 drive involves in practice. It installs PS1 and PS2 games as well as homebrew apps, creates the assets and downloads artwork and icons for all of them, and can install widescreen hacks that enable 16:9 support in compatible PS2 games. It can create Virtual Memory Cards for PS2 games, with support for VMC Groups for both PS1 and PS2 titles, and it sets up multi disc PS1 games so that disc swapping works. It automatically installs the HugoPocked POPStarter fixes, converts .bin and .cue files to .VCD for PS1 and .ISO for PS2, offers to compress ISO files, configures the compatibility settings for the chosen game launcher, and finally adds the installed apps to the HOSDMenu system menu. Several applications come with the project itself, wLaunchELF-R3Z, R3CONFIGURATOR and POPSLoader, along with a choice of OPL or NHDDL as the game launcher.

The channels are the reason the network adapter still matters

With a full PSBBN install you get the enhanced patch itself plus the three media channels, and these are the features that no other part of the setup reproduces. The Music Channel handles playback and CD ripping, with an installer that takes .mp3, .m4a, .flac and .ogg files from your computer. The Movie Channel plays video, and you can either download from the online channels or install .mp4, .m4v, .mkv, .vob, .pss and .psm files and similar formats from your PC. The Photo Channel displays images imported from a USB drive or a digital camera, or installed from your PC as .jpg, .png, .tif, .gif and .bmp. The Internet Channel offers access to mirrors of the original online game channels from various publishers, so you can pull down game trailers and screenshots and play classic retro games. Installing PS2 Linux is listed as an optional extra, and the disc side supports physical PS1 and PS2 discs with automatic PS2 logo patching, which is how imports and backup discs are launched.

Artwork pipelines, a paid dependency and a busy changelog

Two things about the project's operation are worth knowing before you rely on it. The first is that it uses webhook.site to automatically contribute and report missing artwork and icons to two databases it maintains, the PSBBN Art Database and the HDD-OSD Icon Database, and the documentation says plainly that the project has grown popular enough to exceed the limit offered by a free account there, that a paid subscription costs $9 a month or $90 a year, and that donations help fund it. So a piece of the install pipeline depends on a third party service with a paid tier, which is a real operational dependency for anyone reproducing the setup. The second is the pace of change. The changelog entry dated September 17, 2026 is titled around compressed games, widescreen hacks and an improved homebrew installer, and the repository was last pushed on 2026-10-14, with a release tagged latest on 2026-09-24. The licence is GPL-3.0, and the project is supported through a Ko-fi page.

Editorial conclusion

PSBBN Definitive Project suits a PS2 owner with a network adapter or a third party hard drive who wants the console's original software to keep working, and it suits anyone who wants the Music, Movie and Photo channels on hardware that has been offline since the service was discontinued. It is a poor fit if you want a one command install with no hardware decisions to make, because the choice between the full PSBBN path and the menu only path depends on whether you have an official Sony Network Adapter, and it is a poor fit if you are not comfortable with a partition layout that mixes two filesystems on one drive. Before you start, check three things: which network adapter or third party hard drive you have, since the two installation options differ in what they require, the known issues section linked from the installer list, and the fact that the artwork and icon pipeline depends on a paid subscription to a webhook service that the project says it is outgrowing, with the last push to the repository on 2026-10-14.

Frequently asked questions

What is the PSBBN Definitive Project?

It is a patch and setup project for Sony's PlayStation Broadband Navigator, the Japan only PS2 software that needed a hard drive and a network adapter. It began in 2023 as an English language patch and has grown into a complete drive setup with multiple languages, a patched menu, an installer and local media channels.

Do I need an official Sony Network Adapter for PSBBN Definitive Project?

Only for the full install. The PSBBN plus HOSDMenu option requires an official Sony Network Adapter, while the HOSDMenu only option supports both official Sony Network Adapters and third party hard drive adapters.

What is APA-Jail and why does it matter?

It is the hybrid partitioning scheme the project uses so that an exFAT filesystem and the PlayStation File System can coexist on the same drive. exFAT holds games and homebrew apps, while PFS holds the system software and provides legacy support.

What does the Game and App Installer do automatically?

It installs PS1 and PS2 games and homebrew apps, downloads artwork and icons, can install widescreen hacks, creates Virtual Memory Cards and VMC Groups, sets up multi disc PS1 games for disc swapping, applies POPStarter fixes, converts bin and cue files to VCD and ISO, can compress ISO files, configures launcher compatibility settings and adds the installed apps to the HOSDMenu system menu.

Is the PSBBN Definitive Project free to use?

The project is published under the GPL-3.0 licence. The documentation does note that the artwork and icon pipeline relies on webhook.site, whose free account limit the project has outgrown, and that a paid subscription there costs $9 a month or $90 a year, with donations also used to fund it.

Official sources

  1. CosmicScale/PSBBN-Definitive-Project on GitHub
  2. License: GPL-3.0
  3. Project website
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/cosmicscale-psbbn-definitive-project.svg)](https://hysenlabs.com/projects/cosmicscale-psbbn-definitive-project)

Was this useful?