Nsx Library Manager Switch

Nsx Library Manager
General
Author	ivaano
Type	PC Utilities
Version	0.5.3
License	MIT License
Last Updated	2025/07/24
Links
Download
Website
Source

The Nsx Library Manager is a PC utility to organize and visualize a Nintendo Switch library. The tool was created out of a desire for a data grid that allows easy filtering and sorting of games, and it offers the added convenience of server-based access from any device.

Features

• Web interface.
• API for searching, and refresh reload library.
• Runs on Windows, Linux and Mac.
• Supports NSP, NSZ, XCI, XCZ files.
• Read a folder and analyze all the files.
• Extract metadata from the files, like name, size, titleId, publisher and Icon.
• Use titledb to aggregate more information.
• Create a database with all the information.
• Shows a list or grid of all your games.
• Filter by name, publisher, size, titleId, region, type, etc.
• Sort by name, publisher, size, titleId, region, type, etc.
• List missing DLC or updates for your games.
• Local TitleDb, no need to download it every time.

Installation

Requirements:

• dotnet 8.0
• a recent browser (didn't worked on Edge 13)
• prod.keys

Installation guide.

Screenshots

Changelog

v0.5.3

• This release adds some fixes and a new endpoint in the API:
  • #109 A new renamer endpoint was added, this will trigger bundle or package renames
  • #71 A change was made to avoid removing files with no titleid when doing a refresh
  • #96 A fix was made to use titledb region when running the rename process, as the region will come from titledb instead of the file this should solve most of the issues related to regions.
  • Some minor fixes and improvements has been made and some libraries have been updated.
• To upgrade just close the app copy the your data and config folders and run, if you are using a container just pull the latest image.
• What's Changed
  • features/renamer-api-endpoint by @ivaano in #111
  • Setting titled.Region to fileInfo to fix renamer issues with region by @ivaano in #112
  • Refresh now checks if the file was already on the library, so if the filename doesn't include titleId, it wont be removed. by @ivaano in #113
  • Adding a check for titledb.sql version number, if is larger or shorter than a SHA5, is not going to save it as this causes confusion. by @ivaano in #114

v0.5.2

• Features/api by @ivaano in #107.
• Assembly version update by @ivaano in #108.

v0.5.1

• Features/api by @ivaano in #101.
• Features/api by @ivaano in #102.
• warning-cleanup by @ivaano in #103.
• Warning cleanup by @ivaano in #104.
• Disable RowSelectOnClick for library, use row checkbox instead. by @ivaano in #105.

v0.5.0

• Added new feature to persist user data on library reloads by @ivaano in #87.
• Adding assembly version to NavLayout by @ivaano in #88.
• Fix "in" folder permissions by @MasterPhooey in #89.
• Features/webhook-on-library-load by @ivaano in #91.
• Features/release-date-missing-dlc-updates by @ivaano in #92.

v0.4.7

• Docker compose by @ivaano in #84.
• Added release date to title page missing update and missing dlc. by @ivaano in #85.

v0.4.5

• This is a support release, no new features were added just some bugfixes to address issue #78 and probably #71.

v0.4.4

• Features/multiple library paths by @ivaano in #74.
• Code cleanup by @ivaano in #75.
• updating assembly version by @ivaano in #76.

v0.4.3

• Features/nsw releases support by @ivaano in #67.
• Adding a file Icon if title is not found to titledb by @ivaano in #68.

v0.4.2

• This release adds a new feature to transfer titles on your library to an anonymous FTP server, you can queue many titles, this feature will select only the base title, the latest owned update and all the owned dlcs, it will create a list of files and a background service will start sending the files to the ftp server.
• You can copy your previous database over this new release to keep your user settings.

v0.4.1

• This release is a fix on the CI pipeline, no new changes have been added to the app, just matching the assembly info, but now new releases will be tagged properly and you can get the right image

v0.4.0.2

• Content rating in library by @ivaano in #60
• Content rating in library by @ivaano in #61

v.0.4.0.1

• readme screenshots update by @ivaano in #56
• Readme update by @ivaano in #57
• File structure organization by @ivaano in #58
• Age rating in library by @ivaano in #59

v0.4.0

• Fix docker permissions problem by @Darkangeel-hd in #26
• Publish to GHCR by @markp-mckinney in #39
• Features/sqlite version by @ivaano in #55
• Library now show title categories
• No need to edit config.json file anymore, download the app and run it, the configuration can be done on the settings page
• New standalone renamer called bundle renamer, this renamer focus is to have all the related titles (base, patch, addon) in one place.
• New placeholders to the package renamer, package rename is used if you want to have your titles organized by conten type.
• New Library renamer, for now this will only work with the new collections field, collections is a user generated input so you can group titles
• by collection, it works like the bundle renamer you can have all related titles in one place and group them together by collection.
• Delete empty folders after the rename process has run, this is per renamer and you can enable disable this feature.
• Better handling of invalid characters when renaming.
• Titlecase naming for folders of renamed titles.
• Improvements to the age rating system, now instead of just the age the esrb will be shown on detail title.
• Added ability to filter by titleid or name in GameList and GameCard pages, making it easier to find your games.
• Added more fields to the library grid.
• Added new Find Duplicates function, it will find all titles that are the same, useful for removing old patches or duplicate titles, the delete has * A backup function so anything you delete is moved to the backup folder.
• Added the ability to rate your library titles
• Added the ability to export/import your data (user rating, and title collections), so if you want to reload the database you don't lose your ratings.

v0.3.1

• Config save fix by @ivaano.

v0.3.0

• Libraries updates.
• Dockerfile modification.
• Titledb Insertbulk reduced to chunks of 1k to decrease memory while importing.
• Titles that are not in cnmt are marked as unknown, marking them as base if titleid ends in 000.
• TitleDb Categories filter.
• Saving grid settings on library grid.
• Rename now creates subdirectories if needed.
• Config now read from config directory the default will be titledb so it can be mounted in docker.

v0.2.0

• License by @ivaano.
• Renamer initial release by @ivaano.
• Settings moved to config by @ivaano.

v0.0.1

• First Release.
  • Features/odata service.
  • Features/component refactor.
  • Libhac Update.
  • Deltas for faster library updates.
  • Dashboard.
  • Added game list page, and game card to easy browse games in library.
  • Library Title detail moda.
  • Move title detail in library to a modal.
  • Versions update.
  • Readme updates.

Credits

• Libhac For the amazing library to read nintendo switch files.
• Titledb For the excellent database with all the information.
• Radzen.Blazor

External links

• GitHub - https://github.com/ivaano/NsxLibraryManager
• GBAtemp - https://gbatemp.net/threads/nsx-library-manager.646336/