Difference between revisions of "List of Switch homebrew titleID"

Revision as of 12:23, 27 November 2018

This page will maintain a list of TitleID used by Homebrew using the NSP format to prevent conflict with other packed homebrew, or even retail games.

Please, help maintaining it and add your own homebrew or any nsp you create to help other developers and users.

You can find retail TitleID for system file and games on switchbrew.

Channel type

When you create and release an nsp file, you need to choosing between a Full homebrew or a Forwarder (nro loader).

The full nsp will contain the homebrew executable and will be stored on the console. If an updated version of the homebrew is released, the user will have to delete it before installing the new one.

The forwarder contains a small program which loads another nro file located on sdmc. The forwarder (or nro loader) will have the advantage of not needing any update or reinstall when you release a new homebrew revision, it will always load the .nro file located on the SD card. Forwarder are easier to use with Switchbru Appstore as users can update the nro on SD card and don't need to replace the installed channel.

NSP creation for your homebrew

HacBrewPack

You can use HacBrewPack(Thread), or NSPBuild to create an installable nsp file for your homebrew.

When you create your nsp, you have to edit a setting file (npdm.json) and specify the homebrew's title, its TitleID, etc.

You need a specific makefile for your homebrew in order to build a nsp, or you can generate a forwarder (nro loader) to install on your console.

A Homebrew Forwarder template is provided with HacBrewPack. Replace the path to the nro (sdmc:/hbmenu.nro) and the name and TitleID to use for your nsp, and the other parameters if needed.

HacBrewPack TitleID pattern

• Always use lower-case titleid
• Valid titleid range is: 0x0100000000000000 - 0x01ffffffffffffff
• It's not suggested to use a titleid higher than 0x01ffffffffffffff

nro2nsp Builder

This tool can convert nro to full nsp or generate a forwarder nsp pointing to the specified nro path.

When building a forwarder, the target path can be located on sdmc or ROMfs.

nro2nsp TitleID pattern

• Valid titleID pattern is: 05xxxxxxxxxx0000

Choosing the titleID

The Switch is using a TitleID protocol, and homebrew are encouraged to follow it too:

• ALL current Titles for Switch begins with 0100
• System Titles are all in "010000000000XXXX".
• Games end with "Y000". With Y being an even digit. Pattern: TitleID & 0xFFFFFFFFFFFFE000 (AND operand).
• DLCs ends with "YXXX". With Y being an odd digit, and XXX a DLC ID from 0x000 to 0xFFF. DLC is 0x1000 greater than base Title ID. Pattern: Base TitleID | 1XXX (OR operand).
• Updates ends with "0800"

TitleID generators

You can get an unique TitleID based on your app name by using this Python3 script. It converts 5 ASCII characters to HEX values, and encapsulate in with 01 and 000.

You can generate a random TitleID using this MSDos batch script. It generates random TitleID and encapsulate it with 01 and 000.

Note: These generators are not taking care of the DLC flag on bit 13.

Community recommendations

In an attempt to set a convention at the start of the homebrew development life on Nintendo Switch, you are encouraged to use a TitleID to clearly differentiate homebrew from retail titles. Some homebrew Title installers already use this pattern as white list to allow installation of homebrew nsp.

Current decision (up to debate as it's still new):

Homebrew Title ID mask : 05XXXXXXXXXXY000 where Y is an even digit.

Homebrew NSP TitleID List

Other available nsp files, full homebrew and forwarders:

• https://gbatemp.net/threads/520775/

Homebrew KIP Sysmodules TitleID List