SwitchVault - Nintendo Switch Game Library Manager with Ratings & Update Checker

[captainmorgan]

Hello everyone,

Happy New Year!
I’m sharing a personal project called SwitchLibrarian, a Python-based tool for organizing and browsing a Nintendo Switch game library. It focuses on metadata, ratings, and local file analysis, and outputs a clean HTML interface for viewing your collection.

What is SwitchLibrarian?​

SwitchLibrarian scans a user-defined Nintendo Switch game folder and collects publicly available metadata such as ratings, images, descriptions, and version information. The results are presented in an offline HTML viewer that allows easy browsing, filtering, and sorting.
This tool is intended for library management and analysis only.

Features​

Multi-Source Ratings​

• Metacritic (critic + user scores)
• Steam (user review scores)
• IGDB (fallback source)
• Critic and user scores displayed side by side

Game Artwork​

• Steam header images
• Nintendo eShop artwork (for exclusives)
• IGDB covers (fallback)

Update Detection​

• Compares detected game versions against titledb
• Displays available update version numbers

Smart Folder Parsing​

• Supports multi-game folders (e.g. Bayonetta 1+2, Portal Collection)
• Handles organizational subfolders (e.g. Multiplayer/Game [NSP])
• Automatically splits collections into individual entries

Cleanup & Analysis Tools​

• Detects duplicate update files (keeps highest version)
• Flags translation / language folders
• Score-based reports to identify low-rated titles

HTML Viewer​

• Offline, modern dark theme
• Filter by genre, player count, and score range
• Sort by any column
• Global search
• CSV export
• One-click folder path copy

Requirements​

pip install requests beautifulsoup4

Optional (IGDB fallback only):

• Twitch / IGDB API credentials (free)

How to Use​

1. Download:
   • SwitchLibrarian.py
   • SwitchLibrarian_viewer.html
2. Run the script:
   

   python SwitchLibrarian.py

3. Enter your game folder path (example: G:\NintendoSwitch)
4. Choose option 1 → 1 to scrape all games
5. Open game_ratings_viewer.html and load the generated game_info.json

Feedback is welcome. If anyone wants to test or suggest improvements, feel free to reply.

 

[Batteryless]

Displays available update version numbers

If a download link for the update file would be provided right there this would be very helpful.

 

[Dariodip]

Is it possible to manually mark the games in my collection from a list instead of scanning a folder?

 

[captainmorgan]

If a download link for the update file would be provided right there this would be very helpful.

This is not possible due to copyright reasons, but I totally understand your point.

Is it possible to manually mark the games in my collection from a list instead of scanning a folder?

The script is designed to scan a folder with game files and provide info on them, you can filter out the games you want to check using the search filter. Or if you want to check only certain games, you can try moving them to a separate folder and scan using the script.