PS5 Library

A game library for jailbroken PS5.
Pick a game, verify its download on your PS5, play it from your home screen.

💬 Join the PS5 Library Discord: help, release pings and ideas.

• One payload. ps5-library.elf adds a PS5 Library tile to your home screen. The tile opens the library in the PS5 browser.
• Feels like the console. The game you select fills the screen, rows of games sit underneath, and every game has a full-screen page. The layout gets denser in the PS5 browser's window, so more of the library fits.
• Install from the console. After you complete the host's verification, the console downloads, unpacks and installs the game. When it's done, the game is on your home screen.
• Internal SSD or USB. Pick a drive per game, or set a default. Games in exFAT/FFPKG format run from that drive through ShadowMountPlus. PKG games go through the system installer.
• Downloads resume after a pause, a dropped connection, a failed attempt or a console restart. Partial files are cleaned up after the install.
• Room for the queue. The game page shows the space free on the drive, what unfinished downloads still need (and which downloads that is) and what is left after them and this game. An archive counts with its unpacked size when the catalog gives one. A download that would not fit asks first. The console checks again with the file's real size once the host sends it, so a catalog that lists the unpacked size as the download's does not block a game that fits.
• Download while unpacking. While one game unpacks or installs, the next one in the queue downloads, then unpacks in its turn. One game downloads and one unpacks at a time; Settings → Downloads → While a game unpacks can switch it off.
• Rest Mode on internal storage. Downloads and unpacking continue while the console rests, and the console goes to sleep once the work finishes. Adding the game to the home screen waits until you wake it. USB support in Rest Mode is in progress: see Rest Mode.
• Notifications. A PS5 notification says when a game is ready to play, a download failed or ShadowMountPlus could not add a game, even with the library closed. Settings → Downloads → Notifications turns them off.
• Newer versions. With ShadowMountPlus 1.7beta5 or later, My games shows each game's version and marks a game when your catalogs have a newer one.
• Storage overview. Settings → Storage lists the library's folders on every drive with paths and sizes, shows what games and running downloads still use, and deletes what nothing needs after showing what goes. See Storage.
• Queue in your order. Downloads has Active, Finished, Failed and Cancelled tabs. A waiting download can move up, move down or go next, and finished, failed or cancelled downloads clear in one go.
• Favourites. The heart on a game page adds it to your favourites: they get their own row in the Store and a filter in Browse. The list is kept on the console, so the console and your phone share it.
• Parallel downloads. Up to 4 connections per file by default; choose 1, 4 or 8 in Settings. With 8 connections a wired console reached a full 1 Gbps line. Hosts without compatible range support use one connection.
• Made for the controller. Move with the D-pad, select with Cross, go back with Circle.
• Files. A simple file manager in the top bar for the internal SSD and USB drives: unpack archives, install what you copied over, copy or move between drives, rename, delete. See Files.
• Password-protected archives. Encrypted RAR4/RAR5, 7z and ZIP unpack on the console, including encrypted names and split RAR/7z sets. The library tries the catalog password, then pippo. If neither works, Enter password retries unpacking with another password and keeps the downloaded files (0.7.33). In Files, Unpack with password takes the password up front, and Unpack here asks for it on the spot (0.7.36).
• Several catalogs at once. Every catalog gets its own row in the Store, games first and homebrew after them. Catalogs made for Pegasus DL work too. A homebrew catalog is on from the start.
• Covers and details: size, region and minimum firmware for every game.
• Browse by region and size. Filter by region and size, and sort by size. The region comes from the catalog, or from the tags in its description.
• Catalog versions and backports. Game versions, reported backport revisions/firmware targets, and the original download-source labels stay visible. Dump, FPKG, DLC and Backport links can be distinguished before downloading.
• Phone and computer. Open http://<ps5-ip>:9999 on your phone or PC to queue games from the couch (19999 if another payload uses 9999). Phones get a one-column layout with a tab bar at the bottom. Each device pairs once with a code from the console: see Phones and computers.
• Updates from the library. Settings → Updates finds a new release, checks it and switches to it. See Update.
• Diagnostic report. Settings → Console → Diagnostic report collects what a bug report needs, without keys, passwords, catalog addresses or download links.
• Browser downloads. Open a host on your PS5, complete its verification and press Download. The library captures a usable file link and adds it to Downloads. A phone or computer can also supply a download link.
• Link-Vault hosts. The PS5 reads the file list, opens the selected host automatically and remembers its links and filenames, including multipart downloads.
• Optional accounts. An AllDebrid, Real-Debrid (0.7.34) or TorBox account, or a host's premium key, downloads from supported hosts directly: the game page offers Download with AllDebrid (or the account you saved) next to the browser verification. For a Link-Vault source the PS5 reads Link-Vault first, then the account takes the host's link (0.7.28). See Download accounts.

From 0.7.29, Settings → Downloads → Rest Mode keeps downloading and unpacking by default. Choose internal storage for the download; for local archives, both the archive and its output must be on internal storage. In the PS5 settings, enable System → Power Saving → Features Available in Rest Mode → Stay Connected to the Internet, then enter Rest Mode normally.

While work runs, the library keeps the console's processor active. Once it finishes, the console can enter deep sleep; the library and FTP then stop answering until you wake it. Adding a game through the installer waits until the console wakes up. You can check progress from a paired phone or computer while the console is still working.

Tested on firmware 13.60: a 5 GiB download continued uninterrupted for 26 minutes 31 seconds in Rest Mode, and a separate archive unpacked 6,005 files on internal storage in 33 seconds. The console slept after completion and the library answered again after waking without reloading the payload. File sizes and selected hashes matched. Overnight runs and other firmware have not been verified.

Known USB issue: the drive can disappear during Rest Mode. After waking, automatic retry can run before the drive reconnects and report local source does not exist. Wait until the drive is visible in Files, then retry manually. Normal USB use while the console is awake remains supported.

In Settings → Download speed, choose 1, 4 or 8 connections per file. The default is 4. Changes apply to the next download or resume; pause and resume an active download to apply them.

Large files can download in parallel when the host provides byte ranges and a stable file identifier (strong ETag). Free connections pick up the next part without waiting for a whole batch. Interrupted parts retry individually; temporary host rate limits reduce concurrency, then the library gradually tries to increase it again after a quiet period. Unsupported or repeatedly refused ranges still fall back safely to one connection.

Downloads shows active versus selected connections (for example 4 / 8) and explains retries or fallback. The speed readout uses a short moving average. The library still checks every part, preserves pause/resume and bounds its memory use; fewer connections near the end of a file or while waiting for retries are normal.

Since 0.7.21, each connection asks the console for a 512 KiB TCP receive buffer (the console's default of 64 KiB limited every connection to roughly 1–6 MB/s), finished parts are written on their own thread, an idle connection takes over half of a part that holds the others up, and a connection that stops delivering for 3 seconds is replaced. A line under a running download shows each connection's speed, storage load, read-ahead use and these takeovers.

Parallel connections can help when a host limits each connection separately. They cannot increase your connection's capacity or remove a host's account-wide speed limit. Try 4 first; choose 8 if it helps with your host, or 1 for compatibility.

On Wi-Fi, the console's wireless link is often the limit. A cable works best; otherwise use the 5 GHz band (Settings → Network → Settings → Set Up Internet Connection, press Options on your network, Wi-Fi Frequency Bands → 5 GHz).

Files in the top bar browses the internal SSD (/data) and your USB drives. Move with the D-pad: the selected item's details and actions appear on the right (on a phone, right below the item you tap).

• Unpack here extracts a ZIP, 7z or RAR archive, split sets too (.7z.001, .part1.rar), into a new folder next to it. The archive stays. If the archive needs a password the library doesn't have, it asks for it there; Unpack with password gives it from the start.
• Install a game image (.exfat, .ffpkg, .ffpfs, .ffpfsc), a package, an archive or a game folder you copied over. It goes through the same steps as a download.
• Copy or Move, open the target folder, then Paste here. On the same drive a move is instant; between drives it runs in Downloads with progress, and can be paused or cancelled. The copy only appears once it is complete, and a move deletes the original last.
• Rename, New folder, Delete, a filter and sorting by name, size or date. On a phone or computer, Download saves a file to that device.
• Drive roots, the library's own settings files and the folders of a running job are protected.

Show in Files in My games, Show files in Downloads and Browse in Settings → Downloads open the matching folder.

Where PS5 Library keeps files:

• Downloads go to ps5-library/downloads/<download> and archives are unpacked into ps5-library/library/<download>, on the drive the game installs to (on the internal SSD: /data/ps5-library/downloads and /data/ps5-library/library).
• Games installed from folders and images stay in ShadowMountPlus's scan folder: /data/homebrew on the internal SSD, the drive itself or its homebrew folder on a USB drive. Packages are installed into the console's own storage.
• The PS5's Storage screen counts the library's folders and the folder and image games as Other.

What happens to the files:

A cancelled download keeps its partial files so Resume can continue. Settings → Storage → Cancelled downloads can delete them after 7 or 30 days (0.7.28, off by default); the download stays in the list and Resume starts it again. Select cancelled downloads selects all their folders for Delete selected.

Settings → Storage (0.7.27) shows every drive's library folders with path, size, download and state:

• Can be deleted: nothing uses it. Left by an earlier version or a removed download, a cancelled download's partial files, or what an install left. Selected when the page opens.
• Your choice: a failed download (Try again continues from it) or a Download only file.
• Kept: a paused download. Cancel it first.
• In use: a game ShadowMountPlus has registered or mounts from there, an entry of its manual list, or a running download. Never deleted.

Delete selected lists what goes and how much space it frees. The library checks every folder again before it deletes it, and it needs ShadowMountPlus running to see what games use; without it nothing is deleted. Remove and Clear keep the unpacked folder in that case. The page also lists the installed games on each drive with their paths (delete those in Manage) and what unfinished downloads still need. The diagnostic report includes the same summary and the last clean-up.

Open http://<ps5-ip>:9999 in a browser on the same network; Settings → Devices on the console shows the address. A phone or computer pairs once before it can use the library. The console's own browser never needs to.

• Scan the QR code in Settings → Devices on the console. It opens the library and pairs the phone in one step.
• Or open the address and choose Show code on PS5. The console shows a six-digit code in a notification; enter it and choose Pair.

A code works once and for five minutes; five wrong codes cancel it. The browser then stays paired. Settings → Devices lists every paired phone and computer, and Remove locks one out again. The console keeps only a hash of each device's key. To let every device on your network in without pairing, set "pairing": false in /data/ps5-library/config.json and load the library again.

On a phone the library uses one column, large touch targets and a tab bar along the bottom.

Choose Solve CAPTCHA → Open on PS5, complete the host's check yourself, then press its Download button. Every catalog host uses this path, including cached Link-Vault mirrors and hosts that sometimes work without a CAPTCHA. The Store, game page and individual versions no longer guess availability from the host's name. If the selected URL already serves a real file, the library verifies it and queues it directly. For multipart downloads, it opens the next part in turn and returns to Downloads after collecting the links. Files from GitHub releases show Download instead: there is no CAPTCHA, and the console checks the file and adds it to Downloads.

If you leave the host or get redirected, return to the library and press Retry next to Cancel. Retry reopens the current page, renews its waiting time and keeps earlier captured parts while the session is active. It also rechecks links that failed verification during that part. After a failed session, Retry starts a fresh attempt with the same game, mirror and drive. Queued downloads are managed in Downloads.

If verification cannot run in the console browser, press Change host or device. The library stops capture before returning to the mirror selector and Use phone or computer. A new attempt starts from the first part.

WebAssembly verification: a clean local test on PS5 firmware 13.60 returned typeof WebAssembly === "undefined". The library launches the system browser with its default options and does not disable WebAssembly. A host such as FileDitch that requires it may remain blocked even with ad blocking off. This update provides an alternative path; it does not enable WebAssembly or fix that host's native verification. Use another mirror, or try the existing phone/computer flow on the same network (links bound to browser cookies may still fail).

If a site does not work in the PS5 browser, choose Use phone or computer. Use the same Wi-Fi as the console, complete verification there, and copy the file's download link into the library.

For Link-Vault, the first attempt briefly opens Link-Vault on the PS5. Complete its verification if asked; the library reads the file list and opens your selected host automatically. Links and filenames are saved on the console, so later attempts go straight to the host. No PC, VPS or Telegram connection is needed.

Browser capture is tested on firmware 13.60 with controlled multipart files, and Link-Vault resolution is tested on the console through to the selected hosting page. Compatibility varies by host; links requiring browser cookies or a different browser may not work. CAPTCHA verification is manual.

Save a key in Settings → Accounts: AllDebrid, Real-Debrid, TorBox, or a host's premium key (FileKeeper, DataNodes, DataVaults). A source whose host the account supports then offers Download with that account, without the host's verification. AllDebrid and Real-Debrid support the hosts they list (1fichier, MEGA, Rapidgator and others), not DataNodes, VikingFile, AkiraBox, FileKeeper or Gofile; TorBox supports DataNodes, DataVaults and VikingFile. When no saved account supports a game's hosts, the game page names them (0.7.34).

• Link-Vault sources (0.7.28): when Link-Vault names a host the account supports (such as "Dump - DataNodes"), Download with TorBox opens Link-Vault on the PS5. Complete its verification; the library then sends the host's link to TorBox and the download continues in Downloads. The host's own page does not open. The link is saved, so the next time goes straight to TorBox.
• The account is the only route (0.7.28). If the account refuses the link or cannot fetch the file, the download stops with the account's own message. Try again asks the account again; Download from the host instead starts the host's normal download with its verification.
• While TorBox fetches the file to its own servers, the download shows "TorBox is fetching from … · N%"; then the console downloads it from TorBox.
• Keys stay in the library's settings.json on the console. They are not in the diagnostic report or the log.

The DNS workaround below is experimental; reliable blocking in the PS5 browser has not been verified. Adblock work is currently deferred.

DataNodes has two download steps; the first button does not provide the file yet. Some clicks can trigger a third-party popup script. If your PS5 already uses nanoDNS, add these two rules inside the existing [overrides] section of /data/nanodns/nanodns.ini, then reload nanoDNS and reopen the hosting page:

dcbbwymp1bhlf.cloudfront.net=127.0.0.1
d3jzhqnvnvdy34.cloudfront.net=127.0.0.1

The console must actually use nanoDNS: in the PS5 connection's manual DNS settings, use nanoDNS's bind address as the primary DNS (normally 127.0.0.1) and leave the secondary unset (0.0.0.0), so another resolver cannot bypass the rules. Fully close the browser before trying again. Keep nanoDNS running while using this DNS setup.

These are the two popup script domains observed on October 7, 2026. Keep the remaining nanoDNS rules; do not block all of cloudfront.net. The host's countdown and CAPTCHA still need to be completed. The Library ELF does not install or configure nanoDNS automatically. Ad providers can change their domains, so this is a targeted block, not a universal popup blocker.

• A jailbroken PS5 with an ELF loader. Tested on firmware 13.60.
• Free space: an archive (7z, rar, zip) and its full unpacked contents must fit together during installation. Highly compressed archives can expand to much more than twice the download size. The game page shows the space free now, what unfinished downloads on that drive still need and what is left after them and this game; a download that would not fit asks for confirmation. The library checks again before downloading and for each file during extraction. The downloaded archive is deleted after a successful install.
• kstuff
• ShadowMountPlus. With 1.7beta4 or newer, My games also lists games installed from PKG files, PS4 games included.

1. Download ps5-library.elf from Releases.
2. Load it with your ELF loader (port 9021) or your payload manager. Add it to autoload: the home screen tile only works while the payload is running.
3. A notification says PS5 Library added to the home screen. Open the tile.
4. The homebrew catalog PS5 Homebrew Catalog from homebrew.page is already on. Add more in Settings → Catalogs, see Catalogs below.

Settings → Updates (0.7.22 or newer) shows the running version and the latest release on GitHub, with what is new. The library checks shortly after it starts and twice a day, and shows a notification once per new version. Nothing installs on its own; automatic checks can be turned off there.

Install downloads ps5-library.elf and checks it against the release's SHA-256 file. A file that does not match replaces nothing. Then it writes the new version over every copy of PS5 Library that your console starts: the file your payload manager or autoloader loads at boot (Payload Manager, etaHEN or another payload folder, the root of a USB drive) and the library's own copy in /data/ps5-library. That way the next start loads the new version too. A file only counts as a copy when it is named ps5-library….elf and contains this library; other payloads are never touched. The new version then starts and takes over. Catalogs, settings, accounts, paired devices and downloads stay; a download in progress pauses and Resume continues it. While a package is installing, wait until it finishes.

Payload Manager can list PS5 Library too: in its Settings → Manage Sources → Add Source, add https://raw.githubusercontent.com/deox1111/ps5-library/main/payloads.json.

To update by hand, load the new ELF. Version 0.7.8 and newer replace whatever version is running (a notification says so) and keep your catalogs, settings, accounts and downloads. A download in progress pauses; Resume continues it.

To reset, delete /data/ps5-library and load the ELF again (0.7.8 or newer); the running library stops and starts fresh. An update never resets anything.

The guide opens expanded on the game page, in download-source selection and in Settings → Installation guide. Settings → Console also shows the detected console firmware.

On detected PS5 firmware above 11.60, source selection marks PS5 game sources that the catalog labels as FPKG (fake game packages) as unsupported and asks you to choose a Dump or image instead. A source's own Dump/image label takes precedence over the format of a mixed catalog entry. PS4 titles, packages in a catalog's PKG category and the apps in the default homebrew catalog are not affected. Unknown firmware or source formats are explained rather than guessed; this format check does not verify that every game or backport will run.

• PS5 firmware above 11.60: choose a compatible extracted game folder (Dump) or a ShadowMountPlus image: .exfat, .ffpkg, .ffpfs or .ffpfsc. PS5 game FPKG support is documented through 11.60 inclusive in kstuff-lite v1.11; support for the payload on newer firmware does not imply support for PS5 fake .pkg games there. Guidance checked October 8, 2026.
• FPKG and FFPKG are different. A fake PKG is a .pkg installed through the package installer. A .ffpkg is a UFS image mounted by ShadowMountPlus. See ShadowMountPlus's format table. The PS5 game FPKG warning is not a blanket restriction on PS4 packages or homebrew.
• Choose the right source. A catalog can put Dump, FPKG, DLC and Backport links under the same game. Read the source label: DLC or backport downloads may contain only an add-on or patch. Install the matching base game first and follow the author's instructions.
• Version and backport are separate. The library shows the game version and, when supplied, the backport revision and target firmware. A listed 4.xx target is the catalog author's claim, not a verified minimum for every source. A backport may be a separate download; missing metadata is left unspecified.
• Installation: choose a source and drive, complete host verification, and let the library download/extract supported archives. Folders and images are registered with ShadowMountPlus; keep those files on their drive. Compatible .pkg files go to the system installer—check the console's installation result.

Waiting for ShadowMount: registration is confirmed against the installed source path. Pending registrations stay in Needs attention, with the Install step pending; Ready is shown only after confirmation. The library rechecks while running and viewing the queue, including jobs left pending by an earlier version. Use Retry scan to ask ShadowMount to rescan existing files without downloading or moving them again. If the scan is deferred because a game is running, close the game and return to the console home screen. Finished entries remain as history until you clear them; removing an installed entry from this list does not uninstall its game.

PS5 Library does not publicly include, host or link to any games. The Store shows the games from the catalogs you add. A catalog is a JSON file at a web address.

Tip: typing a long address with the controller is slow. Open http://<ps5-ip>:9999 on your phone or PC and paste the address there.

1. Open Settings → Catalogs.
2. Add a catalog: the full address of the JSON file. It must start with http:// or https://.
3. Access key: fill it in only if the catalog's owner gave you a key. Otherwise leave it empty. The key is sent as Authorization: Bearer <key>.
4. Press Add catalog. The library reads the catalog straight away and its games show up in the Store.

Good to know:

• You can add up to 30 catalogs. The Store shows the games of every catalog that is on. When two catalogs have the same game, its page lists both.
• Turn off hides a catalog's games, Remove deletes the catalog from the list.
• The library checks catalogs by itself: catalogs with a key every minute, the others every 10 minutes. Refresh all checks them now. If a catalog goes offline, you keep its last copy.
• Catalogs are read side by side (0.7.30), so one that doesn't answer doesn't hold up the others. A catalog server that sends nothing for 30 seconds is given up on; one that keeps failing is tried again after 2, 5 and 10 minutes, then every 30 minutes. Each catalog's line says what it is doing: when it was last read, that it is being read now, or why it failed and when it is tried next.
• Catalogs on the same server are read one after another (0.7.31): the console's DNS failed when it had to look up one name several times at once. If the console can't look up a catalog's server, the library asks Cloudflare's DNS over HTTPS (1.1.1.1) once and keeps using it for that server for an hour. A catalog whose content hasn't changed isn't processed again.
• Browse can show the games of one catalog only.

Use the Raw address. Open the file on GitHub, press Raw and copy the address from the browser. The normal file page is a web page, not the JSON file.

Catalogs made for Pegasus DL work as they are: add the catalog's address like any other. Both Pegasus package shapes are read (downloadLinks, or url with filename), and every link of a package becomes a download mirror. A game split into parts is one download (0.7.37): links of one host named … part 1, … part 2, or files named .part01.rar or .7z.001, become one mirror with every part, downloaded one after another and unpacked together.

A Pegasus source list (a file with a "sources": [...] list) has no games in it, it names other catalogs. Adding a source list adds every catalog it names, turned on or off as the list says.

The PS5 Homebrew Catalog by darkxex, the list behind homebrew.page, is on from the start as PS5 Homebrew (homebrew.page): about 90 homebrew apps, games and tools, each from its author's GitHub release. The library checks every file against the SHA-256 the catalog lists and deletes a file that does not match. Homebrew apps keep their own names and icons; they are not mixed up with Store games that share their title ID. Turn the catalog off or remove it in Settings → Catalogs; a removed catalog does not come back.

Up to 0.7.36 the default catalog was evoX-CoreOS. Updating to 0.7.37 removes it once, with its entries; a catalog you add yourself afterwards stays.

Other catalogs in the homebrew.page format (a JSON file with an apps list) can be added by their address like any other.

The smallest catalog has one entry with one file:

{
  "entries": [
    {
      "title": "My Homebrew App",
      "files": [{"url": "https://example.com/my-app.pkg"}]
    }
  ]
}

Put the file anywhere that serves files over HTTP(S):

• GitHub: add catalog.json to a repository or a gist, then connect its Raw address.
• Your PC: in the folder with catalog.json, run python -m http.server 8000 and connect http://<pc-ip>:8000/catalog.json.

A complete entry, with a second mirror:

{
  "entries": [
    {
      "id": "my-game-exfat",
      "title": "Game name (v1.02)",
      "title_id": "PPSA01234",
      "kind": "game",
      "platform": "ps5",
      "format": "exfat",
      "size": "52GB",
      "region": "EUR",
      "firmware": "4.xx",
      "files": [{"url": "https://mirror-one.example/PPSA01234.7z", "name": "PPSA01234.7z"}],
      "source_sets": [
        {"host": "mirror-one.example", "files": [{"url": "https://mirror-one.example/PPSA01234.7z", "name": "PPSA01234.7z"}]},
        {"host": "mirror-two.example", "files": [{"url": "https://mirror-two.example/PPSA01234.7z", "name": "PPSA01234.7z"}]}
      ]
    }
  ]
}

What a download can be:

• A .pkg, an exFAT/FFPKG/FFPFS image, or an archive with one of them inside (.7z, .zip, .rar, .tar).
• Direct download links and host pages use Solve CAPTCHA → Open on PS5; files from GitHub releases use Download. Direct files are checked automatically; pages open for verification.
• AllDebrid: paste your API key in Settings → Download accounts. The library checks it, shows your plan and saves the hosts AllDebrid supports for your account. Sources on those hosts get Download with AllDebrid: the link is unlocked through the AllDebrid API (delayed links included) and downloads and installs like any other. Expired links are unlocked again; dead links, unsupported hosts, quota and API errors fall back to the normal flow and show AllDebrid's reason in Downloads. The key stays on the console.
• Real-Debrid (0.7.34): paste your API token from real-debrid.com/apitoken in Settings → Download accounts. The library checks it, shows your plan and premium end date, and saves the hosts Real-Debrid supports. Sources on those hosts get Download with Real-Debrid: the link is unlocked through Real-Debrid's API and downloads and installs like any other. A file Real-Debrid reports as gone fails at once with its reason. The token stays on the console.

Game page	Browse
Downloads	Settings → Catalogs
Settings → Devices	Settings → Updates

• The PS5 shows much more under "Other" than your games. Open Settings → Storage: it lists the library's downloads and unpacked folders on every drive with their sizes, and what can be deleted. Before 0.7.27, Remove and Clear left the unpacked folder, and a package's file stayed after its install. See Storage.
• Reporting a problem. Attach the report from Settings → Console → Diagnostic report (0.7.24 or newer): Copy it on a phone or computer, or save it on the console as diagnostics.txt in the library's folder. Read it before you share it; download links in it are cut down to their host.
• The tile cannot connect after Rest Mode. Update to 0.7.18. A failed HTTP listener now reopens automatically on the same port; recovery was verified on firmware 13.60 without relaunching the payload. Since 0.7.21 a notification says when the library is active again. If the console or loader terminates the whole process, the payload still needs to be loaded again.
• A phone or computer shows "Pair this device". Since 0.7.22 every phone and computer pairs once. Scan the QR code in Settings → Devices on the console, or choose Show code on PS5 and enter the code from the notification. A private browser window forgets the pairing when it closes.
• An update was saved but did not start. No ELF loader or Payload Manager answered on the console. The saved copies already hold the new version: load ps5-library.elf from your payload manager.
• Downloads are much slower than on a computer. Update to 0.7.21 and use 4 or 8 connections. The line under the download shows the speed of each connection. If the total stays near your Wi-Fi speed, the console's wireless link is the limit: see Download speed.
• The tile opens an empty page on startup. Make sure the payload is running. Load it, or add it to autoload.
• Can the library go full screen? No. The PS5 browser has no full-screen mode for web pages; its bars stay on screen. The library uses a denser layout in that window instead.
• A "?" appears instead of a symbol. Update to 0.7.20. The console's fonts lack some symbols (such as the Cross button sign); they are drawn as icons now.
• Covers are black in the PS5 browser. Older firmware browsers (for example 5.10) could not place the cover images before 0.7.8. Update.
• "PS5 Library is already running". The same version already runs, so the new launch exits. A different version replaces it (0.7.8 or newer).
• Another payload uses port 9999. PS5 Library moves to port 19999 (then 29999) and says so in a notification. It stays on that port on later launches, and the home screen tile follows it. On your phone or PC, open http://<ps5-ip>:19999. To pick the port yourself, set "port" in /data/ps5-library/config.json.
• "No catalog answered at that address". Open the address in a browser on your PC. If the browser can't open it either, the catalog is offline or the address is wrong. If the catalog has a key, check the key. From 0.7.30 the message says where it stopped: no connection within 5 seconds, a connection but nothing sent for 30 seconds, or a transfer that was too slow.
• Settings → Catalogs says "Loading…" for minutes, or working catalogs load late. Update to 0.7.30. Catalogs used to be read one after another, and each one that didn't answer held the rest for two minutes (#17). Now they are read side by side and a working catalog loads within seconds.
• The Store says "The catalog is empty" while your catalogs have games, or catalogs stay at "checking for changes…". Update to 0.7.31. With several large catalogs the console took up to two minutes to prepare the Store's list, and the page stayed empty meanwhile (#17); now it takes under a second. Catalogs on one server are read one after another, because the console's DNS failed on several lookups of the same name at once. An empty Store now says why: catalogs still being read, the list didn't load, or no catalog answered.
• "the console could not look up … within 5 seconds" or "the console's DNS took … seconds". The console's DNS didn't answer for the catalog's server in time. From 0.7.31 the library then tries Cloudflare's DNS over HTTPS by itself; "(also over DNS-over-HTTPS)" means that failed too. Check the DNS in the console's network settings, and if you use nanoDNS, that it is running.
• "the console's DNS points … at 0.0.0.0, which blocks it". A DNS filter on the console (nanoDNS, for example) blocks that server. From 0.7.32 the library then looks the server up over DNS over HTTPS by itself; the message appears only when that fails too. Remove the server's rule from the filter (for nanoDNS, the [overrides] section of /data/nanodns/nanodns.ini), or add the server under [exceptions]. Settings → Console → Diagnostic report lists the servers the console's DNS blocked.
• "Not enough free space" while unpacking. The message identifies the current file and its required/available space, not the total for the whole archive. Free space, then choose Try again; unpacking restarts from the saved archive. If even the error cannot be saved on a full disk, it stays visible in the running library but may not survive a payload restart.
• Unpacking appears stuck. Version 0.7.18 shows the current file, written bytes and a notice after a longer period without new output. An unknown archive total is not shown as a percentage. A pause or error remains on the Unpack step; retrying extraction starts it again rather than resuming inside the compressed stream. If unpacking finished and a later step failed, Try again continues from the unpacked files (0.7.23 or newer).
• An archive needs a password. Update to 0.7.33 or newer for encrypted RAR, 7z and AES ZIP support. The catalog password and pippo are tried automatically. If they fail, use Enter password → Unpack on the failed download (Downloads → Failed); an unpack started in Files asks for the password right there. This retries the saved archive without asking TorBox or the host to download it again. A damaged encrypted archive can also produce a password error; if its known password still fails, check the archive's integrity.
• Unpacking is slow. From 0.7.23 the download card shows how fast the game is written and the archive read, files per second, and whether the decoder (the console's CPU) or storage sets the pace. Strongly compressed archives are limited by the CPU; games made of many small files are limited by how fast the console's storage creates files. From 0.7.28, 7z archives made with 7-Zip's multithreaded compression decode on three threads (about twice as fast on a strongly compressed test archive); the card then says "Waiting for 3 decoding threads". "unpack_threads" in /data/ps5-library/config.json sets the number (1 turns it off). The PS5 browser shares the CPU: on the home screen a test archive unpacked about 15% faster than with the library open, and a notification says when the game is ready.
• "archive contains an invalid path" for a game with Japanese or accented file names. Update to 0.7.28; such names unpack now.
• "Directory scan limit exceeded" after unpacking. Versions before 0.7.23 listed every file of the unpacked game and stopped at 100,000 files. Update, then choose Try again; a game unpacked by an older version is unpacked once more.
• "That address returns a web page, not a catalog". Use the direct file address. On GitHub, use the Raw one.
• "ShadowMountPlus is not running". Start ShadowMountPlus, for example through your autoloader.
• ShadowMountPlus reports failed installs, or a game stays at "Waiting for ShadowMount registration". Before 1.7beta5, ShadowMountPlus could lose its install hook after a game launch or Rest Mode (drakmor/ShadowMountPlus#145, #147); its log then says "internal AppInstallTitleDir bridge unavailable" and no new game registers until it restarts. Update ShadowMountPlus to 1.7beta5 or later: it repairs the hook by itself. With an older version, choose Restart ShadowMount on that download (0.7.21); close any game that runs from an image or game folder first. From 0.7.25 the download shows this within seconds of ShadowMountPlus's attempt.
• A backport folder stayed in ps5-library/library. From 0.7.26 the backport for your firmware goes to ShadowMountPlus's backports/<title ID> folder, and none is used for a game your firmware runs. Settings → Downloads → Backports chooses between deleting the rest of the unpacked folder (default) and keeping it. Folders left by earlier versions can be deleted in Files. If the library can't find the ShadowMountPlus file, set "shadowmount_elf" in /data/ps5-library/config.json or restart ShadowMountPlus from your payload manager.
• A game waits for ShadowMount registration forever, and EUR or USA folders appeared next to it. Update to 0.7.31. Some releases ship small region folders with the game's title ID beside the game folder (Gran Turismo 7 does). Earlier versions installed them as games and ShadowMountPlus registered one of them. Now only the game folder is installed and the region folders stay in the unpacked folder. For a game installed before, move the region folders out of the drive's root and let ShadowMountPlus register the game folder again.
• PS4 games or games installed from PKG files are missing in My games. Update ShadowMountPlus to 1.7beta4 or newer; older versions only list the games they mount.
• AllDebrid or Real-Debrid is connected, but a game offers no Download with it. Neither supports DataNodes, VikingFile, AkiraBox, FileKeeper or Gofile, the hosts most catalogs use. From 0.7.34 the game page names the hosts your account doesn't support. TorBox covers DataNodes and VikingFile.
• Installing to internal storage stops with "settings fields have invalid types". Update to 0.7.34. When ShadowMountPlus scanned only USB folders, the library's request to add /data/homebrew was refused by ShadowMountPlus 1.7, which expects its other settings in the same request.
• An app or game installed to the internal SSD does not start, while the same one on USB does. Update to 0.7.37. Files unpacked to the internal SSD were saved without permission to run; USB drives don't store permissions, so everything there may run. 0.7.37 marks every installed folder runnable, and on each start it repairs game folders installed before, on the internal SSD and on USB.
• A game split into parts offers every part as a separate mirror, or its last parts are missing. Update to 0.7.37. Pegasus catalogs list each part as its own link; earlier versions offered the parts as alternatives, so a download held a single part, and links past the 20th were left out. Now the parts on one host are one mirror with every part, and its label says · N parts. If the catalog lists fewer parts than the archive has, unpacking cannot finish: the catalog itself is incomplete.
• Download with TorBox opened the host's free download or asked for its CAPTCHA. Update to 0.7.28. Before, a Link-Vault source never offered TorBox, and a TorBox error fell back to the host's free download. Now Download with TorBox reads Link-Vault on the PS5 and hands the host's link to TorBox; if TorBox fails, the download shows TorBox's message and Download from the host instead is a separate choice. See Download accounts.
• "Not enough free space" before a download although the game fits. Update to 0.7.28. Some catalogs list the unpacked game's size as the download's, and the check counted it twice. Now it counts only what is certain until the host sends the file's real size.
• A game shows "CAPTCHA / browser". Choose Solve CAPTCHA → Open on PS5. This is available for every host. Files from GitHub releases show Direct download and a Download button instead. A saved account (AllDebrid, Real-Debrid, TorBox or a host's premium key) that supports the host also offers Download with that account.
• A captured link fails with "filename exceeds 200 bytes". Update to 0.7.11. Long signed URLs could incorrectly be interpreted as filenames even when the browser supplied the correct name.
• A download fails with "returned a web page instead of a file" or "needs a browser CAPTCHA". The host only gives the file to a browser. Choose Solve CAPTCHA on that download. If the captured link doesn't work, pick another mirror.

Made by deox.

Shout-outs:

• Pippo26442999
• ps5upload by phantomptr. PS5 Library's package installer is built on it.
• Pegasus DL. Its catalogs work in PS5 Library too.
• PS5 Homebrew Catalog by darkxex (homebrew.page), the default homebrew catalog
• ShadowMountPlus by drakmor
• kstuff
• ps5-payload-sdk by John Törnblom
• cpp-httplib, nlohmann/json, curl, libarchive, OpenSSL

If PS5 Library saves you time, you can support it with any of these:

Bitcoin (BTC)

bc1qklrkv3x76662gx5ex5ndcs665ljd0cr2e0jnn8

Ethereum (ETH)

0x12b158C4fF55772214C598F8c68bd6f6Acb72981

Litecoin (LTC)

ltc1qgyva6rc5p42cz0tds3s88kmsvsmtgexfe98dpw

Solana (SOL)

Vd2Ex93oMRm3Wwpvamcf2pV2XnKZzHRYRzvcrp4cEZt

Monero (XMR)

4A66wqfp2Lp1TyBC5DGYA1DNYUv5RB1zPASbmCaus78PCbcEfvp3cjbR2HxFmnYbEVgZ7NZCCsuBcYLLnUuZYjej54YLoFS

BTC

ETH

LTC

SOL

XMR

PS5 Library is not affiliated with Sony Interactive Entertainment. PS5 Library is a downloader and local file-management tool. It does not include package catalogs, provide package links, bypass accounts, spoof PSN, bypass anti-cheat, or unlock content. Use it only with content you own or have permission to download.

GPL-3.0-or-later, see LICENSE. The source code will be published in this repository.

From 0.7.33, the payload includes 7-Zip 26.04 by Igor Pavlov (LGPL, with the additional unRAR restriction for the RAR decoder). Each release includes an archive-relink.tar.gz asset containing its notices, corresponding decoder sources and the application objects and instructions needed to relink with a modified decoder.