mirror of
https://github.com/rashevskyv/dbi.git
synced 2024-12-29 19:05:06 +08:00
xHR
GitHub
commit
cdd973f51b
143
README_ENG.md
143
README_ENG.md
@ -5,7 +5,7 @@ This guide is based on [Brikachu's work](https://4pda.ru/forum/index.php?showtop
|
|||||||
|
|
||||||
[РУССКИЙ / Russian guide](README.md)
|
[РУССКИЙ / Russian guide](README.md)
|
||||||
|
|
||||||
The ultimate solution for NSP/NSZ/XCI installation along with many more advanced features to enhance your Nintendo Switch experience! DBI supports installation from SD card, via USB MTP, USB cable (using the dbibackend script or dbi-nsw tool), network (using your own http server) and external USB drives.
|
The ultimate solution for NSP, NSZ, XCI and XCZ installation along with many more advanced features to enhance your Nintendo Switch experience! DBI supports installation from SD card, via USB MTP, USB cable (using the dbibackend script or dbi-nsw tool), network (using your own http server) and external USB drives.
|
||||||
|
|
||||||
## Content:
|
## Content:
|
||||||
|
|
||||||
@ -31,7 +31,7 @@ The ultimate solution for NSP/NSZ/XCI installation along with many more advanced
|
|||||||
1. [Notifications](#warnings)
|
1. [Notifications](#warnings)
|
||||||
1. [Errors](#errors)
|
1. [Errors](#errors)
|
||||||
1. [dbi.config](#dbiconfig)
|
1. [dbi.config](#dbiconfig)
|
||||||
1. [Other possibilities](#other-possibilities)
|
1. [Other options](#other-options)
|
||||||
1. [Acknowledgements](#acknowledgements)
|
1. [Acknowledgements](#acknowledgements)
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
@ -44,14 +44,15 @@ Copy `dbi.nro` and `dbi.config` to your SD card at `/switch/DBI/` DBI can be the
|
|||||||
|
|
||||||
### Interface
|
### Interface
|
||||||
|
|
||||||
* **Browse SD Card** - installation of .NSP / .NSZ / .XCI files from your SD card.
|
* **Browse SD Card** - installation of .NSP / .NSZ / .XCI / .XCZ files from your SD card.
|
||||||
* **Browse USB0 Drive** - installation of .NSP / .NSZ / .XCI files from an external FAT32 or exFAT formatted USB drive (will only appear if a USB drive is connected)
|
* **Browse USB0 Drive** - installation of .NSP / .NSZ / .XCI / .XCZ files from an external FAT32 or exFAT formatted USB drive (will only appear if a USB drive is connected)
|
||||||
* **Install title from USB** - installation of .NSP / .NSZ / .XCI from a PC via USB 2.0 or 3.0 cable using the included dbibackend script. *Main menu hotkey for this option*: **Y** button.
|
* **Install title from USB** - installation of .NSP / .NSZ / .XCI / .XCZ from a PC via USB 2.0 or 3.0 cable using the included dbibackend script. *Main menu hotkey for this option*: **Y** button.
|
||||||
* **Install title from Gamecard** - install a game from gamecard to the console's internal NAND or SD card (will only appear if a gamecard is inserted)
|
* **Install title from Gamecard** - install a game from gamecard to the console's internal NAND or SD card (will only appear if a gamecard is inserted)
|
||||||
* **Home server** - install games over your local network (HTTP) using a LAN USB adapter or WiFi network. For full details see **[Home server](#home-server)**
|
* **Home server** - install games over your local network (HTTP) using a LAN USB adapter or WiFi network. For full details see **[Home server](#home-server)**
|
||||||
* **Browse installed applications** - view installed titles including base, update, DLC and whether or not a LayeredFS mod is present. Displays your total play time and how many times you've launched the title. Check file integrity for errors, transfer game data between internal NAND and SD card, delete individual or multiple titles and their LayeredFS mods with one click, individually remove updates and DLC and use the `Reset Required version` function to restore the system update check for the selected game back to base. *Main menu hotkey for this option*: **L** button.
|
* **Browse installed applications** - view installed titles including base, update, DLC and whether or not a LayeredFS mod is present. Displays your total play time and how many times you've launched the title. Check file integrity for errors, transfer game data between internal NAND and SD card, delete individual or multiple titles and their LayeredFS mods with one click, individually remove updates and DLC and use the `Reset Required version` function to restore the system update check for the selected game back to base. *Main menu hotkey for this option*: **L** button.
|
||||||
* **Cleanup orphaned files** - removes all orphaned installed content, tickets and pending firmware updates from the system with one click.
|
* **Cleanup orphaned files** - removes all orphaned installed content, tickets and pending firmware updates from the system with one click.
|
||||||
* **Browse tickets** - view and manually delete system tickets for games.
|
* **Browse tickets** - view and manually delete system tickets for games.
|
||||||
|
* **Browse saves** - view and manually delete game save data for all games.
|
||||||
* **Run MTP responder** - enables DBI's internal MTP server to connect the Switch to a PC or to an Android device (Some tested phone/tablet devices: Pixel 3, Xiaomi Mi A1, Lenovo Tab 4 7 "TB-7304X). On your device you will be presented with several virtual drives for installation and many advanced features for file management on your SD card and NAND. Please see **[Run MTP Responder](#run-mtp-responder)** for a full overview.
|
* **Run MTP responder** - enables DBI's internal MTP server to connect the Switch to a PC or to an Android device (Some tested phone/tablet devices: Pixel 3, Xiaomi Mi A1, Lenovo Tab 4 7 "TB-7304X). On your device you will be presented with several virtual drives for installation and many advanced features for file management on your SD card and NAND. Please see **[Run MTP Responder](#run-mtp-responder)** for a full overview.
|
||||||
* **Exit** - exit from the program. *Main menu hotkey for this option*: **+** button
|
* **Exit** - exit from the program. *Main menu hotkey for this option*: **+** button
|
||||||
|
|
||||||
@ -67,7 +68,7 @@ Bottom center (dbi: XXX) is the DBI version number - you should always use the m
|
|||||||
|
|
||||||
* **(X)** - file selection. **On the main screen** - hotkey for mounting MTP (menu item "**Run MTP responder**")
|
* **(X)** - file selection. **On the main screen** - hotkey for mounting MTP (menu item "**Run MTP responder**")
|
||||||
|
|
||||||
* **(Y)** - invert selection, select everything if nothing is selected. **On the main screen** - installation via USB using dbibackend (menu item "**Install title from USB **")
|
* **(Y)** - invert selection, select everything if nothing is selected. **On the main screen** - installation via USB using dbibackend (menu item "**Install title from USB**")
|
||||||
* **(ZL)**, **(ZR)** - fast movement through the menu
|
* **(ZL)**, **(ZR)** - fast movement through the menu
|
||||||
* **(L)** - **on the main screen** - (menu item "**Browse installed applications**")
|
* **(L)** - **on the main screen** - (menu item "**Browse installed applications**")
|
||||||
* **(R)** - change the order of displaying files / titles
|
* **(R)** - change the order of displaying files / titles
|
||||||
@ -84,10 +85,10 @@ Press the **(A)** button to confirm. A window with installation options will app
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
* **Total transfer size** - the total amount of data (.NSP / .NSZ / .XCI files) selected for installation.
|
* **Total transfer size** - the total amount of data (.NSP / .NSZ / .XCI / .XCZ files) selected for installation.
|
||||||
* **Total install size** - the amount of free space required to install the selected files.
|
* **Total install size** - the amount of free space required to install the selected files.
|
||||||
* **Install target** - data installation location: **NAND** - internal memory of the Nintendo Switch console, **SD** - SD card, **AUTO** - by default this will install to your SD card but if you don't have enough space the installation will fall back to NAND (internal memory).
|
* **Install target** - data installation location: **NAND** - internal memory of the Nintendo Switch console, **SD** - SD card, **AUTO** - by default this will install to your SD card but if you don't have enough space the installation will fall back to NAND (internal memory).
|
||||||
* **Delete after install** - deletes installation files (.NSP / .NSZ / .XCI files) from the source after they have been successfully installed; for this to work, the "Read-only" attribute must be removed from files if present. By default, files are not deleted. The option is visible only when installing from an SD card / external USB drive.
|
* **Delete after install** - deletes installation files (.NSP / .NSZ / .XCI / .XCZ files) from the source after they have been successfully installed; for this to work, the "Read-only" attribute must be removed from files if present. By default, files are not deleted. The option is visible only when installing from an SD card / external USB drive.
|
||||||
* **Turn off screen** - turns off the screen during installation to conserve battery, after installation successfully completes the screen will automatically turn back on. This option only works in handheld mode.
|
* **Turn off screen** - turns off the screen during installation to conserve battery, after installation successfully completes the screen will automatically turn back on. This option only works in handheld mode.
|
||||||
* Select **Start install** to begin the installation. After a successful installation *Installation Complete. Press B to return* will appear.
|
* Select **Start install** to begin the installation. After a successful installation *Installation Complete. Press B to return* will appear.
|
||||||
|
|
||||||
@ -95,7 +96,7 @@ Press the **(A)** button to confirm. A window with installation options will app
|
|||||||
|
|
||||||
### Install title from USB
|
### Install title from USB
|
||||||
|
|
||||||
If you cannot use DBI's MTP responder this is another convenient method for installing titles over USB. Installing over USB allows you to transfer files directly from your PC for example, which avoids the inconvenience and of having to first move the file to your SD card and then install it. Compared to using the MTP responder this mode will also allow direct installation of .XCI files.
|
If you cannot use DBI's MTP responder this is another convenient method for installing titles over USB. Installing over USB allows you to transfer files directly from your PC for example, which avoids the inconvenience and of having to first move the file to your SD card and then install it.
|
||||||
|
|
||||||
*Main menu hotkey for this option*: **Y** button.
|
*Main menu hotkey for this option*: **Y** button.
|
||||||
|
|
||||||
@ -170,30 +171,32 @@ switch:{SHA}N/omUzCtg+qoee+x4ttjgIls9jk=
|
|||||||
|
|
||||||
In **Browse installed applications** you can see a list of installed programs, updates and DLC with their occupied space, version (display version and hex version), their titleID, the total game time and the number of launches, the presence of installed LayeredFS mods for the game (for Atmosphére).
|
In **Browse installed applications** you can see a list of installed programs, updates and DLC with their occupied space, version (display version and hex version), their titleID, the total game time and the number of launches, the presence of installed LayeredFS mods for the game (for Atmosphére).
|
||||||
|
|
||||||
*Main menu hotkey for this option*: **L** button:Сверху в центре написано общее количество установленных игр и тип сортировки
|
*Main menu hotkey for this option*: **L** button:
|
||||||
|
|
||||||
At the top in the center, the total number of installed games and the type of sorting are written
|
At the top in the center, the total number of installed games and the type of sorting are written
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
In square brackets before the name of the game, basic information about the installation location, composition and availability of the game mod is written. Only what is installed is displayed. That is, if the letter b is not in square brackets, then the game itself does not have the base part installed (in this case, the line will be colored red)
|
On the left hand side in square brackets, information on the game installation location, installed file type and the presence of LayeredFS mods or cheats is denoted:
|
||||||
|
|
||||||
* **N / S / M** - NAND / SD / Mixed - means the place where the game is installed. If parts of the game are on different media, Mixed is displayed
|
* **N / S / M** - NAND / SD / Mixed - Location of installed files, Mixed denotes that installed files were detected on both NAND and SD card
|
||||||
* **b** - BASE - the game itself
|
* **b** - BASE - the base game itself
|
||||||
* **u** - Update - update the game
|
* **u** - Update - update installed
|
||||||
* **d** - DLC
|
* **d** - DLC - DLC installed
|
||||||
* **l** - LayeredFS mod - the presence of modifications, cheats or translation
|
* **l** - LayeredFS mod - LayeredFS mods or cheats for the game were detected in atmosphere/contents/
|
||||||
|
|
||||||
**Please note!** If the game is **highlighted in red**, then its base part is not installed, but only an update or DLC is installed
|
**Please note!** If the game is **highlighted in red** only an update and/or DLC is installed, the game itself is NOT installed
|
||||||
|
|
||||||
#### Title context menu
|
#### Title context menu
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Displayed by clicking on **(+)** on the selected titles (or title)
|
Displayed by clicking on **(+)** on the selected titles (or title)
|
||||||
|
|
||||||
* **Delete title** - delete selected titles
|
* **Delete title** - delete selected titles
|
||||||
* **Move title to MicroSD \ NAND** - move the selected titles to NAND or to a memory card, depending on where the title is currently located. If title parts are both there and there, both options will be displayed
|
* **Move title to MicroSD / NAND** - move the selected titles to NAND or to a memory card, depending on where the title is currently located. If content is installed to both locations then both options will be displayed
|
||||||
* **Reset required version** - reset the check of the system version required to run the title (debug must be enabled in Atmosphere)
|
* **Reset required version** - resets the system version check required to run the title (debug must be enabled in Atmosphere)
|
||||||
* **Check integrity** - checking the data integrity of the selected titles
|
* **Check integrity** - checks the data integrity of the selected titles
|
||||||
* **Expose contents via MTP** - mount the content of the selected titles by MTP
|
* **Expose contents via MTP** - mount the content of the selected titles by MTP
|
||||||
|
|
||||||
If you press the **(A)** button on the title, the detailed game menu will open
|
If you press the **(A)** button on the title, the detailed game menu will open
|
||||||
@ -202,23 +205,23 @@ If you press the **(A)** button on the title, the detailed game menu will open
|
|||||||
|
|
||||||
|
|
||||||
|
|
||||||
Game icon, **TitleID**, title (**name**), author (**Author **), version (**Version **), supported languages (**Language **) and availability of LFS- mod (**LFS-mod **)
|
Here you will be presented with the Game icon, **TitleID**, display title (**name**), developer/publisher (**Author**), display version (**Version**), supported languages (**Language**) and presence of a LayeredFS mod or cheat (**LFS-mod**)
|
||||||
|
|
||||||
Here you can also find out the amount of time spent in the game (**Total play time **), how many times the game was launched (**Total launches **), how much it weighs (in general (**Total occupied space **) , as well as how much space it takes in NAND (**Space in NAND **) and on SD (**Space on MicroSD **)), the size of the saves (**Total saves size **) and what language the game has active ( **Forced Language **)
|
Here you can also see the amount of time you've spent playing the title (**Total play time**), how many times the game was launched (**Total launches**), total installation size (**Total occupied space**) as well as how much space it takes in NAND (**Space in NAND**) and on SD (**Space on MicroSD**), the size of the saves (**Total saves size**) and what language is active for the game ( **Forced Language**)
|
||||||
|
|
||||||
#### Records context menu
|
#### Records context menu
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
isplayed by clicking on **(+) ** on selected records
|
Displayed by clicking on **(+)** on selected records
|
||||||
|
|
||||||
The top of the context window displays the number of selected records and their size
|
The top of the context window displays the number of selected records and their size
|
||||||
|
|
||||||
* **Delete record** - delete selected entry
|
* **Delete record** - delete selected entry
|
||||||
* **Move records to MicroSD \ NAND** - move the selected entry to NAND or to a memory card, whichever is where it is currently located. If title parts are both there and there, both options will be displayed
|
* **Move records to MicroSD / NAND** - move the selected titles to NAND or to a memory card, depending on where the title is currently located. If content is installed to both locations then both options will be displayed
|
||||||
* **Reset required version** - reset the check of the system version required to run the title (debug must be enabled in Atmosphere)
|
* **Reset required version** - reset the check of the system version required to run the title (debug must be enabled in Atmosphere)
|
||||||
* **Force language** - allows you to force the game to start in the selected language. By default, the game starts with the same language that is selected in the system, if there is none in the game, then depending on the region of the console. The selected language will be displayed next to the game icon in the **Forced Language ** field
|
* **Force language** - allows you to force the game to start in the selected language. By default the game will run based on the system language, if that language is not present in the game then it will run depending on the region of the console. The selected language will be displayed next to the game icon in the **Forced Language** field
|
||||||
* **Check integrity** - checking the data integrity of the selected titles
|
* **Check integrity** - checks the data integrity of the selected titles
|
||||||
* **Expose contents via MTP** - mount the content of the selected titles by MTP
|
* **Expose contents via MTP** - mount the content of the selected titles by MTP
|
||||||
|
|
||||||
### Cleanup orphaned files
|
### Cleanup orphaned files
|
||||||
@ -226,7 +229,7 @@ The top of the context window displays the number of selected records and their
|
|||||||
**Cleanup orphaned files** automatically cleans unnecessary game files, files from interrupted game installations, downloaded (officially) OFW firmware updates and all unused game tickets if found.
|
**Cleanup orphaned files** automatically cleans unnecessary game files, files from interrupted game installations, downloaded (officially) OFW firmware updates and all unused game tickets if found.
|
||||||
|
|
||||||
### Browse tickets
|
### Browse tickets
|
||||||
View and delete unnecessary game tickets. **Ticket (or encrypted title key) ** is a special encrypted unique information about the rights to launch the content of the game, which is installed in the system during the installation of each game (**000 ** at the end of the titleID) / update (**800 ** at the end of titleID) / of each DLC.
|
View and delete unnecessary game tickets. **Ticket (or encrypted title key)** is a special encrypted unique information about the rights to launch the content of the game, which is installed in the system during the installation of each game (**000** at the end of the titleID) / update (**800** at the end of titleID) / of each DLC.
|
||||||
|
|
||||||
* **+** means there is an installed game
|
* **+** means there is an installed game
|
||||||
* **[c]** — common-ticket (installed game dump or update)
|
* **[c]** — common-ticket (installed game dump or update)
|
||||||
@ -239,7 +242,7 @@ In all other cases, it is better not to touch anything here, in order to avoid e
|
|||||||
|
|
||||||
#### Tickets context menu
|
#### Tickets context menu
|
||||||
|
|
||||||
Displayed by clicking on **(+) ** on selected tickets
|
Displayed by clicking on **(+)** on selected tickets
|
||||||
|
|
||||||
* The number of selected tickets is displayed at the top of the context window
|
* The number of selected tickets is displayed at the top of the context window
|
||||||
|
|
||||||
@ -255,7 +258,7 @@ Saves for deleted games are highlighted in yellow.
|
|||||||
|
|
||||||
#### Saves context menu
|
#### Saves context menu
|
||||||
|
|
||||||
Displayed by clicking on **(+) ** on selected saves
|
Displayed by clicking on **(+)** on selected saves
|
||||||
|
|
||||||
The number of selected saves is displayed at the top of the context window
|
The number of selected saves is displayed at the top of the context window
|
||||||
|
|
||||||
@ -276,12 +279,14 @@ The number of selected saves is displayed at the top of the context window
|
|||||||
|
|
||||||
4: **Installed games** all installed games are displayed from both in NAND (internal memory of the Switch) and SD card. To dump installed games to your PC in .NSP format, just copy the folder with the name of the game from Installed games to your PC. A common ticket with completely cleared personal information is generated based on your personalized ticket. Your dump will be in separated files - the game itself, the update and DLC. If cheats or mods have been installed for the game, they will be located in the `Mods & Cheats` folder. You can also dump a single combined multicontent file containing the game itself, the update and all DLC. This file is located right at the root of the **Installed games** section.
|
4: **Installed games** all installed games are displayed from both in NAND (internal memory of the Switch) and SD card. To dump installed games to your PC in .NSP format, just copy the folder with the name of the game from Installed games to your PC. A common ticket with completely cleared personal information is generated based on your personalized ticket. Your dump will be in separated files - the game itself, the update and DLC. If cheats or mods have been installed for the game, they will be located in the `Mods & Cheats` folder. You can also dump a single combined multicontent file containing the game itself, the update and all DLC. This file is located right at the root of the **Installed games** section.
|
||||||
|
|
||||||
5: **MicroSD install** - Drop or copy your **NSP**/**NSZ** or **XCI** files in this folder. When the transfer is complete the game will be installed on the **SD card** of your console. When installing NSZ files, keep in mind that their actual size may differ greatly from their original size after installation: so if for example you start with 2GB free on your memory card and you do not have enough space to install an NSZ of 1GB in size, that is because NSZ files are compressed and must be decompressed for installation.
|
5: **MicroSD install** - Drop or copy your **NSP**/**NSZ**/**XCI** or **XCZ** files in this folder. When the transfer is complete the game will be installed on the **SD card** of your console. When installing NSZ or XCZ files, keep in mind that their actual size may differ greatly from their original size after installation: so if for example you start with 2GB free on your memory card and you do not have enough space to install an NSZ of 1GB in size, that is because NSZ and XCZ files are compressed and must be decompressed for installation.
|
||||||
|
|
||||||
6: **NAND install** - Drop or copy your **NSP**/**NSZ** or **XCI** files in this folder. When the transfer is complete the game will be installed on the **internal memory** of your console. When installing NSZ files, keep in mind that their actual size may differ greatly from their original size after installation: so if for example you start with 2GB free on your memory card and you do not have enough space to install an NSZ of 1GB in size, that is because NSZ files are compressed and must be decompressed for installation.
|
6: **NAND install** - Drop or copy your **NSP**/**NSZ**/**XCI** or **XCZ** files in this folder. When the transfer is complete the game will be installed on the **internal memory** of your console. When installing NSZ or XCZ files, keep in mind that their actual size may differ greatly from their original size after installation: so if for example you start with 2GB free on your memory card and you do not have enough space to install an NSZ of 1GB in size, that is because NSZ and XCZ files are compressed and must be decompressed for installation.
|
||||||
|
|
||||||
7: **Saves** - Access to all game saves - in accounts (Account), system programs (System), in Background Content Asymmetric synchronized delivery and Transmission (BCAT, for example: events in ACNH), temporary (Temporary), cache (Cache, for example: addons in DOOM), system BCAT (SystemBCAT), - stored in the internal memory of the Switch; in the Installed games folder - save for the currently installed games, Uninstalled games - save from deleted games that were previously launched. From here, you can make a backup of them by copying them to a PC, and also delete unnecessary ones - for this, open the folder with the name of the game you need, then delete the folder with the nickname of your account / Device-save.
|
7: **Saves** - Access to all save types stored in the internal memory of the Switch: accounts **(Account)**, system programs **(System)**, Background Content Asymmetric synchronized delivery and Transmission (**BCAT**, for example: events in ACNH), temporary **(Temporary)**, cache (**Cache**, for example: addons in DOOM), system BCAT **(SystemBCAT)** and Device Saves **(Device)**
|
||||||
In order to restore the save, copy them to the appropriate folder from your PC. DBI does not require pre-launching the game to restore a save, however this only applies to regular saves. BCAT or Cache saves require a pre-launch of the game before restoring.
|
|
||||||
|
Backup, restore and manage save data for both installed and uninstalled games. You can make a backup of them by copying them to a PC and also delete saves that you no longer want or need - to do this open the folder with the name of the game you need, then delete the required save folder.
|
||||||
|
In order to restore saves, copy them to the appropriate folder from your PC. DBI does not require pre-launching the game to restore a save, however this only applies to regular saves. BCAT or Cache saves require a pre-launch of the game before restoring.
|
||||||
|
|
||||||
8: **Album** - access to screenshots and videos (Album), similar to Nintendo's feature added OFW 11.0.0.
|
8: **Album** - access to screenshots and videos (Album), similar to Nintendo's feature added OFW 11.0.0.
|
||||||
|
|
||||||
@ -293,7 +298,7 @@ After activating the MTP server on the Switch a window will appear with your acc
|
|||||||
|
|
||||||
#: **Custom Storage** - If you have defined a custom MTP storage in the **[`dbi.config`](#dbiconfig)** file it will appear here.
|
#: **Custom Storage** - If you have defined a custom MTP storage in the **[`dbi.config`](#dbiconfig)** file it will appear here.
|
||||||
|
|
||||||
To turn off the MTP server and exit to the main menu, press the **X** button.
|
To turn off the MTP server and exit to the main menu, press the **X** or **B** button.
|
||||||
|
|
||||||
### Exit
|
### Exit
|
||||||
Exit - closes DBI and returns to either to hbmenu or bypasses hbmenu to go directly to your homescreen (this is configured in dbi.config). If DBI was launched from a title / forwarder, the program will restart or remain on a black screen
|
Exit - closes DBI and returns to either to hbmenu or bypasses hbmenu to go directly to your homescreen (this is configured in dbi.config). If DBI was launched from a title / forwarder, the program will restart or remain on a black screen
|
||||||
@ -302,26 +307,26 @@ Exit - closes DBI and returns to either to hbmenu or bypasses hbmenu to go direc
|
|||||||
|
|
||||||
### Warnings
|
### Warnings
|
||||||
|
|
||||||
* **«HASH MISMATCH»** — usually this is NOT an ERROR and the game was simply converted from an .XCI and everything is in order. Sometimes if there are problems with the integrity of the file, download it, rehash it, transferring data via a USB cable / port / during the installation process between the PC and the Switch.
|
* **«HASH MISMATCH»** - usually this is NOT an ERROR and the game was simply converted from an .XCI and everything is in order. Sometimes if there are problems with the integrity of the file, download it, rehash it, transferring data via a USB cable / port / during the installation process between the PC and the Switch.
|
||||||
If the game still does not start or starts with an error, try reinstalling it again, check or replace the USB cable / SD card / change the USB port.
|
If the game still does not start or starts with an error, try reinstalling it again, check or replace the USB cable / SD card / change the USB port.
|
||||||
* **DELTA SKIPPED** — this is NOT an ERROR but a notification that unnecessary and unused delta fragments in the update file were skipped during installation.
|
* **DELTA SKIPPED** - this is NOT an ERROR but a notification that unnecessary and unused delta fragments in the update file were skipped during installation.
|
||||||
* **«No tickets found. Possibly this NSP was converted from XCI.»** — this is NOT an ERROR and the performance of the game will not be affected. This informs you that the files do not include tickets, they may have been dumped from an .XCI file or converted to Standard Crypto.
|
* **«No tickets found. Possibly this NSP was converted from XCI.»** - this is NOT an ERROR and the performance of the game will not be affected. This informs you that the files do not include tickets, they may have been dumped from an .XCI file or converted to Standard Crypto.
|
||||||
* **«WARNING» title marked as Application but has AddonContent** — this is NOT an ERROR and usually it indicates a non-standard .NSP homebrew game, for example if an AddonContent flag (DLC) was added to the Application title (main game, v0).
|
* **«WARNING» title marked as Application but has AddonContent** - this is NOT an ERROR and usually it indicates a non-standard .NSP homebrew game, for example if an AddonContent flag (DLC) was added to the Application title (main game, v0).
|
||||||
If the application starts and works then everything is in order.
|
If the application starts and works then everything is in order.
|
||||||
|
|
||||||
### ERRORs
|
### ERRORs
|
||||||
|
|
||||||
* **«Can not find file for ncaid»** — The installation file of the game is corrupt (it does not contain the required .nca from the .cnmt list).
|
* **«Can not find file for ncaid»** - The installation file of the game is corrupt (it does not contain the required .nca from the .cnmt list).
|
||||||
* **«Invalid PFS0 magic!»** — download the installation file of the game and check its integrity, this file is corrupt.
|
* **«Invalid PFS0 magic!»** - download the installation file of the game and check its integrity, this file is corrupt.
|
||||||
* **«Received less data than expected»** or **Installation aborted** — data transfer error, recheck and if necessary replace the USB cable / USB port between the Switch and the PC. Also make sure you have the most recent version of the DBI installed.
|
* **«Received less data than expected»** or **Installation aborted** - data transfer error, recheck and if necessary replace the USB cable / USB port between the Switch and the PC. Also make sure you have the most recent version of the DBI installed.
|
||||||
* **«std::bad_alloc»** — rename the file without special characters and Cyrillic in the name and path to it, plus make sure that you are using the latest version of DBI and that the latest supported version of OFW and CFW is installed on the console.
|
* **«std::bad_alloc»** - rename the file without special characters and Cyrillic in the name and path to it, plus make sure that you are using the latest version of DBI and that the latest supported version of OFW and CFW is installed on the console.
|
||||||
* **«Nothing to install»** in the file selection window - rename the file without special characters, hieroglyphs or Cyrillic in the name and path to it.
|
* **«Nothing to install»** in the file selection window - rename the file without special characters, hieroglyphs or Cyrillic in the name and path to it.
|
||||||
* **«INVALID LENGTH»** — check the USB-C cable connection to your USB port, try with another USB-C cable, check the integrity of the game file and the SD card for errors, when installing via MTP - try to run DBI in application mode (title override) holding the R button while launching a title.
|
* **«INVALID LENGTH»** - check the USB-C cable connection to your USB port, try with another USB-C cable, check the integrity of the game file and the SD card for errors, when installing via MTP - try to run DBI in application mode (title override) holding the R button while launching a title.
|
||||||
* **«[FAILED] Unknown error»** when installing .tik (ticket) - add the latest sigpatches for Atmosphére.
|
* **«[FAILED] Unknown error»** when installing .tik (ticket) - add the latest sigpatches for Atmosphére.
|
||||||
* **«605: Content or placeholder path not exists»** or **«SOME CONTENTS ARE MISSING»** — broken file system on your SD card, or a non-working / low-quality flash drive. Check it in chkdsk and h2testw, if there are no errors reformat to FAT32.
|
* **«605: Content or placeholder path not exists»** or **«SOME CONTENTS ARE MISSING»** - broken file system on your SD card, or a non-working / low-quality flash drive. Check it in chkdsk and h2testw, if there are no errors reformat to FAT32.
|
||||||
* **WARNING! Extra buffers exceeded**, when installing via MTP - try to run DBI in application mode (title override) holding the R button while launching a title or alternatively via NSP forwarder and use a faster microSD card with a different USB cable / port.
|
* **WARNING! Extra buffers exceeded**, when installing via MTP - try to run DBI in application mode (title override) holding the R button while launching a title or alternatively via NSP forwarder and use a faster microSD card with a different USB cable / port.
|
||||||
* **No tickets found but they are required** — incorrect (incomplete, no ticket but with titlerights) dump of the game, use another one.
|
* **No tickets found but they are required** - incorrect (incomplete, no ticket but with titlerights) dump of the game, use another one.
|
||||||
* **SOME CONTENTS ARE MISSING. APPLICATION WILL BE UNUSABLE** — container is incomplete, check the integrity of the game installation file.
|
* **SOME CONTENTS ARE MISSING. APPLICATION WILL BE UNUSABLE** - container is incomplete, check the integrity of the game installation file.
|
||||||
## dbi.config
|
## dbi.config
|
||||||
The `dbi.config` file was added starting with version 253. It is located next to DBI.nro and replaces the old flags files `dbi.default.ascii` and `dbi.network.config` and also adds several new options for easy customization of settings for the user.
|
The `dbi.config` file was added starting with version 253. It is located next to DBI.nro and replaces the old flags files `dbi.default.ascii` and `dbi.network.config` and also adds several new options for easy customization of settings for the user.
|
||||||
|
|
||||||
@ -409,7 +414,7 @@ TurnOffScreen=false
|
|||||||
### General settings
|
### General settings
|
||||||
* **DefaultASCII** - **true** includes a standard font, **false** includes an alternative font
|
* **DefaultASCII** - **true** includes a standard font, **false** includes an alternative font
|
||||||
* **UseLibUsbHsFS** - **true** enables [libusbhsfs](https://github.com/DarkMatterCore/libusbhsfs) library for working with external USB drives via USB-OTG on Switch, **false** disables it.
|
* **UseLibUsbHsFS** - **true** enables [libusbhsfs](https://github.com/DarkMatterCore/libusbhsfs) library for working with external USB drives via USB-OTG on Switch, **false** disables it.
|
||||||
* **ExitToHomeScreen** — if **false**, the exit from DBI occurs in the hbmenu, if **true**, to the Switch's home menu
|
* **ExitToHomeScreen** - if **false**, the exit from DBI occurs in the hbmenu, if **true**, to the Switch's home menu
|
||||||
* **Visibility of main menu items** - customize which options will appear in DBI's main menu, you can prevent an option from appearing in the main menu by editing the item to **false**
|
* **Visibility of main menu items** - customize which options will appear in DBI's main menu, you can prevent an option from appearing in the main menu by editing the item to **false**
|
||||||
|
|
||||||
### MainMenu
|
### MainMenu
|
||||||
@ -417,30 +422,30 @@ Shows the corresponding menu items.
|
|||||||
|
|
||||||
**true** - display in main menu, **false** - hide from main menu
|
**true** - display in main menu, **false** - hide from main menu
|
||||||
|
|
||||||
* BrowseSD - item "**Browse SD card**, to install games from Sd card
|
* BrowseSD - item **Browse SD card**, to install games from Sd card
|
||||||
* USBHost - item "**Browse USB0 Drive**, to install games from an external USB
|
* USBHost - item **Browse USB0 Drive**, to install games from an external USB
|
||||||
* BackendInstall - item "**Install title from USB**, for installing games from PC via backend
|
* BackendInstall - item **Install title from USB**, for installing games from PC via backend
|
||||||
* GameCard - item "**Install title from Gamecard**, to install the contents of the cartridge in the memory of the console
|
* GameCard - item **Install title from Gamecard**, to install the contents of the cartridge in the memory of the console
|
||||||
* Network - item "**Home server**, to install games from a home web server
|
* Network - item **Home server**, to install games from a home web server
|
||||||
* BrowseApps - item "**Browse installed applications**, to manage installed applications
|
* BrowseApps - item **Browse installed applications**, to manage installed applications
|
||||||
* Cleanup - item "**Cleanup orphaned files**, to clean up" orphaned "files from the memory card
|
* Cleanup - item **Cleanup orphaned files**, to clean up" orphaned "files from the memory card
|
||||||
* Tickets - item "**Browse tickets**, to manage tickets
|
* Tickets - item **Browse tickets**, to manage tickets
|
||||||
* MTP - item "**Run MTP responder**, to start MTP
|
* MTP - item "**Run MTP responder**, to start MTP
|
||||||
|
|
||||||
### Install
|
### Install
|
||||||
* **CheckHash** — if **true**, hashes of .nca files are checked when installing games on the Switch, if **false**, no.
|
* **CheckHash** - if **true**, hashes of .nca files are checked when installing games on the Switch, if **false**, no.
|
||||||
|
|
||||||
### Applications
|
### Applications
|
||||||
|
|
||||||
* **CalculateLFSSize** — включает или отключает подсчёт размера установленных LFS-модов. Если включено, может повлиять на скорость открытия меню "*Browse installed applications*"
|
* **CalculateLFSSize** - enabled of disables the size check for LayeredFS mods, if enabled depending on the size of the mod a delay may occur when opening a game's information screen in **Installed applications**
|
||||||
|
|
||||||
### MTP
|
### MTP
|
||||||
* **LogAllFiles** — **false** disables logging of all files when working with MTP; if **true**, all files are logged, even those that are less than 4MB.
|
* **LogAllFiles** - **false** disables logging of all files when working with MTP; if **true**, all files are logged, even those that are less than 4MB.
|
||||||
* **ShowCombinedNSPInInstalledGames** — **false** disables display of combined (multi-title .NSP-file) titles.
|
* **ShowCombinedNSPInInstalledGames** - **false** disables display of combined (multi-title .NSP-file) titles.
|
||||||
* **ShowMACInInstalledGames** — **false** turns off the display of the virtual directory **"Mods & cheats"** in the Installed games item in the MTP, redirecting along the path `/atmosphere/contents/%titleid_game%` to the memory card.
|
* **ShowMACInInstalledGames** - **false** turns off the display of the virtual directory **"Mods & cheats"** in the Installed games item in the MTP, redirecting along the path `/atmosphere/contents/%titleid_game%` to the memory card.
|
||||||
* **CustomStorages** - show or hide storages, listed on **MTP custom storages** section
|
* **CustomStorages** - show or hide storages, listed on **MTP custom storages** section
|
||||||
* **EnableNANDInstallOnEmunand** - allows or denies the installation of games in NAND file EmuNAND (not relevant after the release of Atmosphere 0.19.3)
|
* **EnableNANDInstallOnEmunand** - allows or denies the installation of games in NAND file EmuNAND (not relevant after the release of Atmosphere 0.19.3)
|
||||||
* **TurnOffScreen** - отключать или нет экран консоли при подключении её в режиме MTP
|
* **TurnOffScreen** - the option to automatically turn off the screen when MTP mode is activated
|
||||||
|
|
||||||
### [MTP Storages](#run-mtp-responder)
|
### [MTP Storages](#run-mtp-responder)
|
||||||
Show relevant items when MTP Responder is running on PC / Android, by default all items are enabled for display.
|
Show relevant items when MTP Responder is running on PC / Android, by default all items are enabled for display.
|
||||||
@ -456,23 +461,17 @@ Names and addresses are set for installing games over the network (via WiFi / LA
|
|||||||
Custom items for MTP mode for quick access to folders on your memory card. Format: `<folder display name> = <path>`, for example: `Homebrew = sdmc: / switch`.
|
Custom items for MTP mode for quick access to folders on your memory card. Format: `<folder display name> = <path>`, for example: `Homebrew = sdmc: / switch`.
|
||||||
In MTP mode, a `Homebrew` folder will appear, referring to the` switch` folder on your memory card
|
In MTP mode, a `Homebrew` folder will appear, referring to the` switch` folder on your memory card
|
||||||
|
|
||||||
## Other possibilities
|
## Other options
|
||||||
|
|
||||||
### Mounting the content of installed titles via MTP
|
### Mounting the content of installed titles via MTP
|
||||||
Go to "*Browse installed applications*" -> Choose apps you need to mount with `X` -> Press `+` -> "*Expose contents via MTP*"
|
Go to "*Browse installed applications*" -> Choose apps you need to mount with `X` -> Press `+` -> "*Expose contents via MTP*"
|
||||||
|
|
||||||
### Backup and restore saves
|
|
||||||
|
|
||||||
1. Connect the set-top box in MTP mode via DBI
|
|
||||||
2. Go to **Saves ** folder on your PC
|
|
||||||
3. You can either copy the saves to your PC or restore them by simply dragging them into this folder
|
|
||||||
|
|
||||||
### Using DBI to Install Mods:
|
### Using DBI to Install Mods:
|
||||||
1. Connect the set-top box in MTP mode via DBI
|
1. Connect to your computer via MTP mode in DBI
|
||||||
1. Go to **Installed Games**, in the folder with the name of your game
|
1. Go to **Installed Games**, in the folder with the name of your game
|
||||||
1. Go to **Mods & Cheats** folder
|
1. Go to **Mods & Cheats** folder
|
||||||
1. Place your mod in the **Mods & Cheats** folder
|
1. Place your mod in the **Mods & Cheats** folder
|
||||||
* **Be careful**, you need to put not the folder with the titleID of the game, but its contents! For example, you have downloaded the translation for the game Cadence of Hyrule, in the form of the archive `Cadence of Hyrule.rar`. Inside this archive you see a folder with the TitleID of the game - `01000B900D8B0000`. You need to unpack the archive, go to the folder `01000B900D8B0000` and copy the entire contents of the folder to **Mods & Cheats**! Not the folder `01000B900D8B0000` itself, but everything that is in it! In this example, the `romfs` folder
|
* **Be careful**, you need to make sure to not put the folder with the titleID of the game, but its contents! For example, you have downloaded the translation for the game Cadence of Hyrule, in the form of the archive `Cadence of Hyrule.rar`. Inside this archive you see a folder with the TitleID of the game - `01000B900D8B0000`. You need to unpack the archive, go to the folder `01000B900D8B0000` and copy the entire contents of the folder to **Mods & Cheats**! Not the folder `01000B900D8B0000` itself, but everything inside it! In this example (and in most cases), the `romfs` folder
|
||||||
|
|
||||||
### USB 3.0
|
### USB 3.0
|
||||||
|
|
||||||
@ -483,5 +482,7 @@ DBI supports USB 3.0. If you are using kefir, then USB 3.0 is active by default.
|
|||||||
usb30_force_enabled = u8!0x1
|
usb30_force_enabled = u8!0x1
|
||||||
```
|
```
|
||||||
|
|
||||||
|
**Important** - activiating USB 3.0 can interfere with bluetooth and 2.4GHz wifi connections. If you experience any connection issues with your wireless controllers or 2.4GHz wifi networks then you should not activate USB 3.0. 5GHz wifi connections should be generally unaffacted.
|
||||||
|
|
||||||
## Acknowledgements
|
## Acknowledgements
|
||||||
Thanks to [SciresM](https://github.com/SciresM) for [hactool](https://github.com/SciresM/hactool) (licensed under [ISC](https://en.wikipedia.org/wiki/ISC_license)) - DBI uses some data struct definitions from there
|
Thanks to [SciresM](https://github.com/SciresM) for [hactool](https://github.com/SciresM/hactool) (licensed under [ISC](https://en.wikipedia.org/wiki/ISC_license)) - DBI uses some data struct definitions from there
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user