LibNXboxNROHelper Switch: Difference between revisions

LibNXboxNROHelper
LibNXboxNROHelper
General
Author	ursusworks
Type	Developments
Version	1.0.0
License	N/A
Last Updated	2026/03/05
Links
	Download
	Website
	Source

Latest revision as of 05:56, 5 July 2026

LibNXboxNROHelper is a tool that helps you download and process Xbox Game Pass game images with a custom overlay. Perfect for creating custom artwork for your game library.

Features

Search for Xbox Game Pass games by name.
Download official game tile images.
Apply a custom overlay to the images.
Save processed images with the game's xCloud ID.

User guide

What you'll need

Xbox/Microsoft Account - You need to sign in with your Microsoft account when the tool starts.
Overlay Image (optional) - Place a file named overlay.png in the same folder as the application if you want to add a custom overlay to your images.

How to use

Step 1: Double-click the application to start it. You will be prompted to sign in with your Microsoft account.

Step 2: When prompted with Enter title name..., type the name of a game you want to find. The tool will show all matching games with their IDs. Continue entering more game names to add them to your list. When you are done searching, press Enter without typing anything to continue.

Step 3: The tool will automatically download each game's tile image, resize it to 242x242 pixels, apply your overlay (if provided), and save the processed image.

Step 4: Once complete, the processed images are in the ProcessedImages folder, located in the same directory as the application. Each image is named with the game's xCloud ID (e.g., 123456789.png).

Output files

ProcessedImages folder - Contains all processed game images.
titles.txt - A text file listing all processed games with their names and xCloud IDs.

Tips

Custom Overlay - Your overlay.png file will be automatically resized to 242x242 pixels and placed on top of each game image.
No Overlay - If you don't have an overlay file, the tool will still work and save the original game images (resized).
Duplicates - The tool automatically skips duplicate games, so you don't need to worry about searching for the same game twice.

Troubleshooting

"Warning: Overlay not found"

This is just a warning. The tool will continue without an overlay. Place overlay.png in the application folder if you want to use one.

Image download fails

Some games may not have images available. The tool will display an error message but continue processing other games.

Authentication issues

Make sure you're signed in with a valid Microsoft account. Or check your internet connection.

Changelog

v1.0

First Release.

External links

GitHub - https://github.com/ursusworks/LibNXboxNROHelper

@@ Line 19: / Line 19: @@
 |image_alt=LibNXboxNROHelper
 }}
-LibNXboxNROHelper is a tool that helps you download and process Xbox Game Pass game images with a custom overlay, intended for creating custom artwork for a game library. The application lets you search for Xbox Game Pass games by name, download official game tile images, apply a custom overlay to the images, and save processed images with the game's xCloud ID.
+LibNXboxNROHelper is a tool that helps you download and process Xbox Game Pass game images with a custom overlay. Perfect for creating custom artwork for your game library.
 == Features ==
-* Search for Xbox Game Pass games by name
+* Search for Xbox Game Pass games by name.
-* Download official game tile images
+* Download official game tile images.
-* Apply a custom overlay to the images
+* Apply a custom overlay to the images.
-* Save processed images with the game's xCloud ID
+* Save processed images with the game's xCloud ID.
-== Installation ==
+== User guide ==
-'''Before you start'''
+=== What you'll need ===
+* Xbox/Microsoft Account - You need to sign in with your Microsoft account when the tool starts.
+* Overlay Image (optional) - Place a file named <code>overlay.png</code> in the same folder as the application if you want to add a custom overlay to your images.
-* '''Xbox/Microsoft Account''' – You need to sign in with your Microsoft account when the tool starts.
+=== How to use ===
-* '''Overlay Image''' (optional) – Place a file named <code>overlay.png</code> in the same folder as the application if you want to add a custom overlay to your images.
+Step 1: Double-click the application to start it. You will be prompted to sign in with your Microsoft account.
-'''How to use'''
+Step 2: When prompted with <code>Enter title name...</code>, type the name of a game you want to find. The tool will show all matching games with their IDs. Continue entering more game names to add them to your list. When you are done searching, press Enter without typing anything to continue.
-Step 1: Launch the application. Double-click the application to start it. You will be prompted to sign in with your Microsoft account.
+Step 3: The tool will automatically download each game's tile image, resize it to 242x242 pixels, apply your overlay (if provided), and save the processed image.
-Step 2: Search for games. When prompted with <code>Enter title name...</code>, type the name of a game you want to find. The tool will show all matching games with their IDs. Continue entering more game names to add them to your list. When you are done searching, press Enter without typing anything to continue.
+Step 4: Once complete, the processed images are in the <code>ProcessedImages</code> folder, located in the same directory as the application. Each image is named with the game's xCloud ID (e.g., <code>123456789.png</code>).
-Step 3: Processing. The tool will automatically download each game's tile image, resize it to 242x242 pixels, apply your overlay (if provided), and save the processed image.
+=== Output files ===
+* ProcessedImages folder - Contains all processed game images.
+* titles.txt - A text file listing all processed games with their names and xCloud IDs.
-Step 4: Find your images. Once complete, the processed images are in the <code>ProcessedImages</code> folder, located in the same directory as the application. Each image is named with the game's xCloud ID (e.g., <code>123456789.png</code>).
+=== Tips ===
+* Custom Overlay - Your <code>overlay.png</code> file will be automatically resized to 242x242 pixels and placed on top of each game image.
-'''Output files'''
+* No Overlay - If you don't have an overlay file, the tool will still work and save the original game images (resized).
+* Duplicates - The tool automatically skips duplicate games, so you don't need to worry about searching for the same game twice.
-* '''ProcessedImages folder''' – Contains all processed game images.
-* '''titles.txt''' – A text file listing all processed games with their names and xCloud IDs.
-== Tips ==
-* '''Custom Overlay''': Your <code>overlay.png</code> file will be automatically resized to 242x242 pixels and placed on top of each game image.
-* '''No Overlay''': If you don't have an overlay file, the tool will still work and save the original game images (resized).
-* '''Duplicates''': The tool automatically skips duplicate games, so you don't need to worry about searching for the same game twice.
 == Troubleshooting ==
 '''"Warning: Overlay not found"'''
-* This is just a warning. The tool will continue without an overlay. Place <code>overlay.png</code> in the application folder if you want to use one.
+This is just a warning. The tool will continue without an overlay. Place <code>overlay.png</code> in the application folder if you want to use one.
 '''Image download fails'''
-* Some games may not have images available. The tool will display an error message but continue processing other games.
+Some games may not have images available. The tool will display an error message but continue processing other games.
 '''Authentication issues'''
-* Make sure you're signed in with a valid Microsoft account.
-* Check your internet connection.
+Make sure you're signed in with a valid Microsoft account. Or check your internet connection.
 ==Changelog==
@@ Line 69: / Line 68: @@
 == External links ==
-* Github - https://github.com/ursusworks/LibNXboxNROHelper
+* GitHub - https://github.com/ursusworks/LibNXboxNROHelper