OPENGIT/dbi
1
0
Fork 0
mirror of https://github.com/rashevskyv/dbi.git synced 2024-12-29 19:05:06 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #76 from FlyingBananaTree/main

Browse Source 
Document new features, English updates and improvements
This commit is contained in:
xHR 2021-11-25 14:40:02 +02:00 committed by GitHub
commit 6dd9ead516
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 233 additions and 243 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

64
README.md
View File

@ -329,14 +329,14 @@ Exit — выход из программы в HOS, минуя hbmenu, либо
Файл dbi.config был добавлен, начиная с версии 253. Он находится рядом с DBI.nro, и заменяет прежние файлы-флаги dbi.default.ascii и dbi.network.config, а также добавляет несколько новых опций для удобной кастомизации настроек под пользователя. Файл dbi.config был добавлен, начиная с версии 253. Он находится рядом с DBI.nro, и заменяет прежние файлы-флаги dbi.default.ascii и dbi.network.config, а также добавляет несколько новых опций для удобной кастомизации настроек под пользователя.
Рассмотрим его содержимое: Рассмотрим его содержимое:
```json ```
; General settings ; General settings
[General] [General]
; Use libnx's default font for ASCII symbols ; Use libnx default font for ASCII characters
DefaultASCII=false DefaultASCII=true
; Use libusbhsfs for access to USB mass storage drives connected to switch or dock ; Use libusbhsfs to access external USB drives
UseLibUsbHsFS=true UseLibUsbHsFS=true
; Direct exit to homescreen ; Direct exit to homescreen when exiting DBI
ExitToHomeScreen=false ExitToHomeScreen=false
; Folder where saves backups are stored ; Folder where saves backups are stored
SavesFolder=sdmc:/switch/DBI/saves/ SavesFolder=sdmc:/switch/DBI/saves/
@ -348,68 +348,63 @@ LogsFolder=sdmc:/switch/DBI/logs/
AppSorting=Name,LastPlayed,InstallLocation,Size AppSorting=Name,LastPlayed,InstallLocation,Size
; Sorting options for save list ; Sorting options for save list
SaveSorting=AppName,AppLastPlayed,UserUid,Size,SaveId SaveSorting=AppName,AppLastPlayed,UserUid,Size,SaveId
; Highlight files with updates to curently instaled titles in file browsers ; Highlight available updates for currently installed titles in DBI's file browser
HighlightUpdates=true HighlightUpdates=true
; Rotate screen upside down ; Rotate screen upside down
RotateScreen=false RotateScreen=false
; Rotate joycons ; Rotate joycons
RotateJoycon=false RotateJoycon=false
; Underclock CPU in menues to reduce battery usage ; Underclock CPU and GPU in menus to reduce battery usage
OptimizeClockSpeed=false OptimizeClockSpeed=false
; Visibility of main menu options
; Visibility of main menu items
[MainMenu] [MainMenu]
; Browse and install files from MicroSD card ; Browse and install files from MicroSD card
BrowseSD=true BrowseSD=true
; Browse and install files from USB flash drives and HDD ; Browse and install files from external USB drives
USBHost=true USBHost=true
; Browse and install files from PC via dbibackend ; Browse and install files from PC via dbibackend
BackendInstall=true BackendInstall=true
; Install game from inserted game cartridge ; Install game from inserted game cartridge
GameCard=true GameCard=true
; Browse and install files from configured network sources ; Browse and install files from configured network installation sources
Network=true Network=true
; Browse installed applications ; Browse installed applications
BrowseApps=true BrowseApps=true
; Clean up files left from bad installs/old updates/unused tickets and so on ; Clean up files left from bad installations/old updates/unused tickets etc
Cleanup=true Cleanup=true
; View where you can view or delete installed tickets ; View or delete installed tickets
Tickets=false Tickets=false
; View where you can view or delete game saves ; Dedicated save game management menu
Saves=true Saves=true
; MTP responder ; MTP responder
MTP=true MTP=true
[Applications] [Applications]
; Whether check or not LFS mod size ; Check LayeredFS mod size (large mods may take a long time)
CalculateLFSSize=true CalculateLFSSize=false
; Installation options
; Install options
[Install] [Install]
; Check NCA hash during install ; Check NCA hash during installation
CheckHash=true CheckHash=true
; MTP options ; MTP options
[MTP] [MTP]
; Log all files, id disabled transfer shows only for files >= 4M ; Log all transfers on the console, if disabled only transfer of files >= 2M will be displayed
LogAllFiles=false LogAllFiles=false
; Show or not NSP that includes base game, latest update and all DLC in single multi-title file ; Display combined NSPs which contain base game, latest update and all DLC in a single file
ShowCombinedNSP=true ShowCombinedNSP=true
; Show or not virtual "Mods & cheats" folder that redirects to sdmc:/atmosphere/contents/TITLEID ; Display per game "Mods & cheats" folder that redirects to sdmc:/atmosphere/contents/TITLEID/
ShowMAC=true ShowMAC=true
; Show user defined shortcuts to MircoSD folders as separate storages ; Display user defined custom virtual MTP drives
CustomStorages=true CustomStorages=true
; Enable NAND install if run in emunand ; Enable 'NAND install' when running emuMMC
EnableNANDInstallOnEmunand=false EnableNANDInstallOnEmunand=true
; Turn screen off on start MTP mode ; Turn screen off when MTP mode is activated
TurnOffScreen=false TurnOffScreen=false
; Enable or disable virtual MTP drives
; Enable or disable various MTP storages
[MTP Storages] [MTP Storages]
1: External SD Card=true 1: External SD Card=true
2: Nand USER=false 2: Nand USER=false
@ -421,20 +416,19 @@ TurnOffScreen=false
8: Album=true 8: Album=true
9: Gamecard=true 9: Gamecard=true
; Network installation sources
; Network install sources
[Network sources] [Network sources]
; <display name>=<type>|<URL> ; <display name>=<type>|<URL>
; NSP Indexer=URLList|http://192.168.1.47/nspindexer/index.php?DBI ; NSP Indexer=URLList|http://192.168.1.47/nspindexer/index.php?DBI
; Home server=ApacheHTTP|http://192.168.1.47/Nintendo/Switch/ ; Home server=ApacheHTTP|http://192.168.1.47/Nintendo/Switch/
; Custom virtual MTP drives
[MTP custom storages] [MTP custom storages]
; <display name>=<path> ; <display name>=<path>
Homebrew=sdmc:/switch Homebrew=sdmc:/switch
; Override for display name ; Override for display name in DBI and MTP mode
; <UPPERCASED TID>=<Desired name> ; <UPPERCASE TID>=<Desired name>
[Title name override] [Title name override]
; 010023901191C000=Naheulbeuk ; 010023901191C000=Naheulbeuk
``` ```

355
README_ENG.md
View File

@ -17,7 +17,7 @@ The ultimate solution for NSP, NSZ, XCI and XCZ installation along with many mor
1. [Install title from USB](#install-title-from-usb) 1. [Install title from USB](#install-title-from-usb)
1. [Home server](#home-server) 1. [Home server](#home-server)
1. [Browse installed applications](#browse-installed-applications) 1. [Browse installed applications](#browse-installed-applications)
* [Titles Context menu](#titles-context-menu) * [Titles Context menu](#title-context-menu)
* [Detailed game menu](#detailed-game-menu) * [Detailed game menu](#detailed-game-menu)
* [Records Context menu](#records-context-menu) * [Records Context menu](#records-context-menu)
1. [Cleanup orphaned files](#cleanup-orphaned-files) 1. [Cleanup orphaned files](#cleanup-orphaned-files)
@ -28,7 +28,7 @@ The ultimate solution for NSP, NSZ, XCI and XCZ installation along with many mor
1. [Run MTP responder](#run-mtp-responder) 1. [Run MTP responder](#run-mtp-responder)
1. [Exit](#exit) 1. [Exit](#exit)
1. [Errors and warnings](#errors-and-warnings) 1. [Errors and warnings](#errors-and-warnings)
1. [Notifications](#warnings) 1. [Warnings](#warnings)
1. [Errors](#errors) 1. [Errors](#errors)
1. [dbi.config](#dbiconfig) 1. [dbi.config](#dbiconfig)
1. [Other options](#other-options) 1. [Other options](#other-options)
@ -36,7 +36,7 @@ The ultimate solution for NSP, NSZ, XCI and XCZ installation along with many mor
## Installation ## Installation
Copy `dbi.nro` and `dbi.config` to your SD card at `/switch/DBI/` DBI can be then be launched in either applet mode (from Album) or application mode (title override), however it is primarily designed to be used in applet mode. Copy `dbi.nro` and `dbi.config` to your SD card at `sdmc:/switch/DBI/` DBI can be then be launched in either applet mode (from Album) or application mode (title override), however it is primarily designed to be used in applet mode.
*If you have successfully launched DBI in applet mode you will see a blue background, launching in application mode will display a black background.* *If you have successfully launched DBI in applet mode you will see a blue background, launching in application mode will display a black background.*
@ -44,73 +44,72 @@ Copy `dbi.nro` and `dbi.config` to your SD card at `/switch/DBI/` DBI can be the
### Interface ### Interface
![2021041010520200](https://user-images.githubusercontent.com/18294541/114262830-d7643e00-99ea-11eb-8dbb-c8e0996577e5.jpg) ![2021041010520200](https://user-images.githubusercontent.com/18294541/114262830-d7643e00-99ea-11eb-8dbb-c8e0996577e5.jpg)
* **Browse SD Card** - installation of .NSP / .NSZ / .XCI / .XCZ 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 / .XCZ 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 / .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 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. Launch titles directly. 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. * **Browse saves** - view, backup and 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 MTP 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
The bottom left corner of DBI displays the total amount of data on your currently on your SD card along with the full capacity. The bottom right corner gives you the same information for your NAND's usable space in HOS. The bottom left corner of DBI displays the total amount of data currently on your SD card along with the full capacity. The bottom right corner gives you the same information for your NAND's usable space in HOS.
Bottom center (dbi: XXX) is the DBI version number - you should always use the most recent version. Bottom center (dbi: XXX) is the DBI version number - you should always use the most recent version.
### Buttons ### Buttons
* **(А)** - select, confirm * **(А)** - select or confirm
* **(B)** - cancel, exits the program **from the main menu**
* **(B)** - cancel. **On the main screen** - exit the program * **(X)** - file selection, hotkey for mounting MTP **on the main menu** (menu option "**Run MTP responder**")
* **(Y)** - invert selection (selects everything if nothing is selected), hotkey for launching USB installation via dbibackend **on the main menu** (menu option "**Install title from USB**")
* **(X)** - file selection. **On the main screen** - hotkey for mounting MTP (menu item "**Run MTP responder**") * **(ZL)** and **(ZR)** - scroll pages in menus, scroll through individual games when in detailed game menu
* **(L)** - **on the main menu** the hotkey for the menu option "**Browse installed applications**"
* **(Y)** - invert selection, select everything if nothing is selected. **On the main screen** - installation via USB using dbibackend (menu item "**Install title from USB**") * **(R)** - change the displayed sort order of files/titles
* **(ZL)**, **(ZR)** - fast movement through the menu * **(L3)** - click left stick to launch games from the application list or detailed game menu
* **(L)** - **on the main screen** - (menu item "**Browse installed applications**") * **(+)** on the right joycon - display context menus to allow you to perform operations such as deleting, resetting the required firmware version, mounting via MTP and more
* **(R)** - change the order of displaying files / titles * **(-)** on the left joycon - turn the screen on/off when MTP mode is activated/when installing titles
* **(+)** on the right joycon - a context menu that allows you to perform context operations, such as deleting, resetting the required firmware version, mounting via MTP, etc.
* **(-)** on the left joycon, when installing applications, turns off / turns on the screen
### Browse SD Card / Browse USB0 Drive ### Browse SD Card / Browse USB0 Drive
Select this option if you want to install games, updates and DLC from files that exist on your SD card or external USB drive. Select these options if you want to install games, updates and DLC from files present on your SD card or from an external USB drive.
Press **(A)** to open the folder and **(B)** to go back. After opening the folder containing your installation files use the **(X)** button to select single or multiple files for installation. The **(Y)** button inverts your selections and the color of the name of the selected files will change from white to light blue. Press **(A)** to open the folder and **(B)** to return. After opening the folder containing your installation files use the **(X)** button to select single or multiple files for installation. The **(Y)** button inverts your selections and the color of the name of the selected files will change from white to light blue.
Press the **(A)** button to confirm. A window with installation options will appear: Press the **(A)** button to confirm. A window with installation options will appear:
![2021041011441100](https://user-images.githubusercontent.com/18294541/114264183-18138580-99f2-11eb-8c7b-536b4b831195.jpg) ![2021041011441100](https://user-images.githubusercontent.com/18294541/114264183-18138580-99f2-11eb-8c7b-536b4b831195.jpg)
* **Total transfer size** - the total amount of data (.NSP / .NSZ / .XCI / .XCZ 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** - select 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 / .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. * **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
*DBI will automatically and immediately remove old updates when installing a new update for a game, so you don't have to worry about the extra space they occupy.* *DBI will automatically and immediately remove old updates when installing a new update for a game, so you don't have to worry about the extra space they occupy.*
You can also navigate to your homebrew files and launch .nro files directly by highlighting them and pressing **(A)**.
### 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. 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
In order to use this option you will first require dbibackend (`dbibackend.exe` for Windows, `dbibackend` from `dbibackend.tar.xz` for all). Launch dbibackend, select the files to install, select Start server, connect a USB-C cable from your PC to your Switch and select **Install title from USB** in DBI. In order to use this option you will first require dbibackend (`dbibackend.exe` for Windows, or the `dbibackend` script for all operating systems). Launch dbibackend, select the files to install, select Start server, connect a USB-C cable from your PC to your Switch and select **Install title from USB** in DBI.
From here you will select and install your files on the Switch in the same fashion as using Browse SD Card / Browse USB0 Drive From here you can select and install your files on the Switch in the same fashion as using Browse SD Card/Browse USB0 Drive.
To quickly send files or folders with games for installation, right-click on them, select Send from dbibackend and the installation files will be immediately placed in dbibackend's queue. To configure this in Windows, press `Win + R`, enter `shell: sendto` and create a shortcut for `dbibackend.exe` in the folder. To quickly send files or folders with games for installation, right-click on them, select Send from dbibackend and the installation files will be immediately placed in dbibackend's queue. To configure this in Windows, press `Win + R`, enter `shell: sendto` and create a shortcut for `dbibackend.exe` in the folder.
### Home server ### Home server
The **"Home server"** option will appear if the **Network install sources** section has been configured in `dbi.config` (more about this file below). You can specify the name of the option as required in the configuration file The **"Home server"** option will appear if the **Network install sources** section has been configured in **[dbi.config](#dbiconfig)**. You can specify the name of the option as required in the configuration file.
To install games over your network, edit the dbi.config file located in the `/switch/DBI/` folder, following the example: To install games over your network, edit the dbi.config file located in the `sdmc:/switch/DBI/` folder as required. For example:
``` ```
; Network install sources ; Network install sources
@ -119,10 +118,10 @@ To install games over your network, edit the dbi.config file located in the `/sw
Home server=ApacheHTTP|http://192.168.1.47/Nintendo/Switch/ Home server=ApacheHTTP|http://192.168.1.47/Nintendo/Switch/
``` ```
Install any other HTTP server with DirectoryListing enabled on your PC: Apache, Mongoose, Python SimpleHTTP, sheret, rclone, etc. Install any HTTP server with DirectoryListing enabled on your PC: Apache, Mongoose, Python SimpleHTTP, sheret, rclone, etc.
Example for nginx on Windows: Example for nginx on Windows:
edit the file `/nginx/conf/nginx.conf`, registering the address of your Switch in `location`, instead of the `127.0.0.1` specified in the example (or your entire subnet like 192.168.1.1/24 or 192.168.0.0/16); it can be found on Switch in **System Preferences** > **Internet**: Edit the file `/nginx/conf/nginx.conf`, registering the address of your Switch in `location`, instead of the `127.0.0.1` specified in the example (or your entire subnet like 192.168.1.1/24 or 192.168.0.0/16); it can be found on Switch in **System Preferences** > **Internet**:
``` ```
location / { location / {
@ -139,7 +138,7 @@ autoindex on;
Save the config, run `nginx.exe`, allow the program to access the network, then copy the desired game to the local `/nginx/html/Nintendo/Switch/` folder on your PC, and on the Switch select “Home server”. Save the config, run `nginx.exe`, allow the program to access the network, then copy the desired game to the local `/nginx/html/Nintendo/Switch/` folder on your PC, and on the Switch select “Home server”.
You will now be presented with the usual interface for installing files and you can start installing files over the network. You can stop the web server via nginx -s stop. You will now be presented with the usual interface for installing files and you can start installing files over the network. You can stop the web server via nginx -s stop.
FFor the server address in `dbi.config`, you can also use a domain name, for example, your remote VPS - suggested to use with HTTP Basic authentication e.g.: `http://user:password@host:port/Nintendo/Switch/` For the server address in `dbi.config`, you can also use a domain name, for example, your remote VPS - suggested to use with HTTP Basic authentication e.g.: `http://user:password@host:port/Nintendo/Switch/`
For example: For example:
``` ```
@ -169,64 +168,70 @@ switch:{SHA}N/omUzCtg+qoee+x4ttjgIls9jk=
### Browse installed applications ### Browse installed applications
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 and 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 center, the total number of installed games and the sorting type is displayed.
![2021062719353200](https://user-images.githubusercontent.com/18294541/123554546-32efcd80-d789-11eb-8d3f-3124448624e0.jpg) ![2021062719353200](https://user-images.githubusercontent.com/18294541/123554546-32efcd80-d789-11eb-8d3f-3124448624e0.jpg)
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: 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 - Location of installed files, Mixed denotes that installed files were detected on both NAND and SD card * **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 base game itself * **b** - BASE - the base game
* **u** - Update - update installed * **u** - Update - update installed
* **d** - DLC - DLC installed * **d** - DLC - DLC installed
* **l** - LayeredFS mod - LayeredFS mods or cheats for the game were detected in atmosphere/contents/ * **l** - LayeredFS mod - LayeredFS mods or cheats for the game were detected at `sdmc:/atmosphere/contents/titleID/`
**Please note!** If the game is **highlighted in red** only an update and/or DLC is installed, the game itself is NOT installed You can quick launch a game directly from the list by highlighting it and pressing **(L3)**.
**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
![2021062719354100](https://user-images.githubusercontent.com/18294541/123554557-3b480880-d789-11eb-9235-d547f2c588bd.jpg) ![2021062719354100](https://user-images.githubusercontent.com/18294541/123554557-3b480880-d789-11eb-9235-d547f2c588bd.jpg)
Displayed by clicking on **(+)** on the selected titles (or title) Displayed by clicking on **(+)** on the selected title(s).
* **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 content is installed to both locations then both options will be displayed * **Move title to MicroSD/NAND** - move the selected titles to SD card or NAND, depending on where the title is currently located. If content is installed to both locations then both options will be displayed
* **Reset required version** - resets the system version check 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** - checks 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 via 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.
### Detailed game menu ### Detailed game menu
![2021062719353600](https://user-images.githubusercontent.com/18294541/123554561-400cbc80-d789-11eb-8d81-e3403f33b365.jpg) ![2021062719353600](https://user-images.githubusercontent.com/18294541/123554561-400cbc80-d789-11eb-8d81-e3403f33b365.jpg)
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 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 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**) 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 occupies on NAND (**Space in NAND**) and/or on SD card (**Space on MicroSD**), the size of the saves (**Total saves size**) and what language is active for the game ( **Forced Language**).
You can quick launch a game directly from here by pressing **(L3)**.
You can quickly scroll through games individually without returning to the installed applications list by using **(ZL)** and **(ZR)**.
#### Records context menu #### Records context menu
![2021062719354800](https://user-images.githubusercontent.com/18294541/123554565-41d68000-d789-11eb-9c59-621275895075.jpg) ![2021062719354800](https://user-images.githubusercontent.com/18294541/123554565-41d68000-d789-11eb-9c59-621275895075.jpg)
Displayed 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 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 * **Move records to MicroSD/NAND** - move the selected titles to SD card or NAND, 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 system version check 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 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 * **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 as per the region of the console. The selected language will be displayed next to the game icon in the **Forced Language** field
* **Check integrity** - checks the data integrity of the selected titles * **Check integrity** - checks data integrity of 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
**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 up unnecessary game files, files from interrupted/failed game installations, officially downloaded 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.
@ -235,24 +240,24 @@ View and delete unnecessary game tickets. **Ticket (or encrypted title key)** is
* **[c]** — common-ticket (installed game dump or update) * **[c]** — common-ticket (installed game dump or update)
* **[p]** — personalized ticket (purchased from the game eShop) * **[p]** — personalized ticket (purchased from the game eShop)
Sometimes, if a specific error occurs, and you know exactly and are sure what you are doing, it can be removed from a specific game and its update / DLC. Sometimes if a specific error occurs and you know exactly what you are doing, it can be removed from a specific game and its update/DLC.
In all other cases, it is better not to touch anything here, in order to avoid errors in starting games. In most cases it is better not to touch anything here, in order to avoid errors when starting games.
#### 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.
***Delete tickets** - delete selected tickets * **Delete tickets** - delete selected tickets
* **Select same game** - highlight all tickets related to the selected game * **Select same game** - highlight all tickets related to the selected game
### Browse saves ### Browse saves
View and delete saves. View, backup and delete saves.
Saves for deleted games are highlighted in yellow. Saves for deleted games are highlighted in yellow.
@ -262,71 +267,72 @@ 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
* **Backup saves** - backup selected saves
* **Delete saves** - delete selected tickets * **Delete saves** - delete selected tickets
* **Select same game** - highlight all tickets related to the selected game * **Select same game** - highlight all saves related to the selected game
* **Select all uninstalled** - select all saves for remote games * **Select all uninstalled** - select all saves for uninstalled games
### Run MTP responder ### Run MTP responder
**Run MTP responder** run the built-in DBI MTP server to connect to your PC or Android device via USB-C OTG (phone / tablet / other devices). *Main menu hotkey for this option*: **X** button (same button to exit MTP mode). After successfully connecting the USB cable to the PC and starting the MTP server in DBI, you'll see the following on your computer: **Run MTP responder** run the built-in DBI MTP server to connect to your PC or Android device via USB-C OTG (phone/tablet/other devices). *Main menu hotkey for this option*: **(X)** button (same button to exit MTP mode). After successfully connecting the USB cable to the PC and starting the MTP server in DBI, you'll see the following on your computer:
![изображение](https://user-images.githubusercontent.com/18294541/114265006-054f7f80-99f7-11eb-86c9-1a20d588e616.png) ![изображение](https://user-images.githubusercontent.com/18294541/114265006-054f7f80-99f7-11eb-86c9-1a20d588e616.png)
1: **External SD Card** - for viewing, copying and deleting files and folders from/to a PC and from/to your SD card. Drop a file larger than 4GB onto the SD card and DBI will automatically split the file into an archived folder, which allows the Switch to see it as a single file, with this you can for example very easily add a >4GB .xci for use in SX OS, or add a >4GB movie for watching in pPlay. 1: **External SD Card** - for viewing, copying and deleting files and folders from/to a PC and from/to your SD card. Drop a file larger than 4GB onto the SD card and DBI will automatically split the file into an archived folder which allows the Switch to see it as a single file, with this you can for example very easily add a >4GB .XCI for use in SX OS or add a >4GB movie for watching in NXMP or pPlay.
2: **NAND User** - viewing, copying files and folders on a PC from the Switch's internal memory to its USER system partition (this partition is read-only). 2: **NAND User** - view and copy files and folders to a PC from the Switch's internal memory USER partition (this partition is read-only).
3: **NAND System**, viewing, copying files and folders on a PC from the internal memory of the Switch to its SYSTEM system partition (the partition is read-only). 3: **NAND System** - view and copy files and folders to a PC from the Switch's internal memory SYSTEM partition (the partition is read-only).
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 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 separate files - the game itself, the update and any DLC files. 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, these files are located at the root of the **Installed games** directory.
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. 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 SD 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**/**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. 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.
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)** 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)**
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. 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. In order to restore saves, copy them to the appropriate folder from your PC. DBI does not require pre-launching the game before restoring 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** - direct access to official Album screenshots and videos per game/title, similar to the official feature added in OFW 11.0.0.
9: **Gamecard** - with a gamecard inserted into the Switch you can dump to .XCI or trimmed .XCI on the PC, along with the update built into it if it exists. The personal RSA certificate automatically removed and is dumped separately. 9: **Gamecard** - with a gamecard inserted into the Switch you can dump to .XCI or trimmed .XCI on the PC, along with the update built into it if present. The personal RSA certificate automatically removed and is dumped separately.
After activating the MTP server on the Switch a window will appear with your account nickname and its UID, as well as the number of game saves: After activating the MTP server on the Switch a window will appear with your account nickname and its UID, as well as the number of game saves:
![2021041013152900](https://user-images.githubusercontent.com/18294541/114266673-27013480-9a00-11eb-81ba-f1ff1c3c5abb.jpg) ![2021041013152900](https://user-images.githubusercontent.com/18294541/114266673-27013480-9a00-11eb-81ba-f1ff1c3c5abb.jpg)
#: **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 virtual MTP drive 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** or **B** button. To turn off the MTP server and exit to the main menu, press either 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
## Errors and warnings ## Errors and warnings
### 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. If there are problems with a file redownload it and verify it with verification tools such as NSCB before installing. If the game still does not start or starts with an error try reinstalling it, or check or replace the USB cable/SD card, or use a different 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). If the application starts and works then everything is in order
* **«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.
### 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). * **«Cannot parse content meta. Corrupted file or old firmware»** - Either the file is corrupt or your firmware is too outdated to parse the meta file. Verify the file and update to the latest cfw and latest supported firmware version
* **«Invalid PFS0 magic!»** - download the installation file of the game and check its integrity, this file is corrupt. * **«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)
* **«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. * **«Invalid PFS0 magic!»** - the file is corrupt, redownload the installation file and check its integrity
* **«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. * **«Received less data than expected»** or **Installation aborted** - data transfer error, check and if necessary replace the USB cable or use a different USB port between the Switch and the PC. Also make sure you have the most recent version of DBI installed
* **«Nothing to install»** in the file selection window - rename the file without special characters, hieroglyphs or Cyrillic in the name and path to it. * **«std::bad_alloc»** - rename the file without special characters and Cyrillic in the filename and path to the file, plus make sure that you are using the latest version of DBI and update to the latest cfw and latest supported firmware version
* **«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. * **«Nothing to install»** in the file selection window - rename the file without special characters, hieroglyphs or Cyrillic in the filename and path to the file
* **«[FAILED] Unknown error»** when installing .tik (ticket) - add the latest sigpatches for Atmosphére. * **«INVALID LENGTH»** - check the USB-C cable connection to your USB port, try with another USB-C cable, verify the integrity of the game file and check 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
* **«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. * **«[FAILED] Unknown error»** when installing .tik (ticket) - add the latest sigpatches for Atmosphére
* **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. * **«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
* **No tickets found but they are required** - incorrect (incomplete, no ticket but with titlerights) dump of the game, use another one. * **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
* **SOME CONTENTS ARE MISSING. APPLICATION WILL BE UNUSABLE** - container is incomplete, check the integrity of the game installation file. * **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
## 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.
@ -334,11 +340,11 @@ Let's take a look at its contents:
``` ```
; General settings ; General settings
[General] [General]
; Use libnx's default font for ASCII symbols ; Use libnx default font for ASCII characters
DefaultASCII=false DefaultASCII=true
; Use libusbhsfs for access to USB mass storage drives connected to switch or dock ; Use libusbhsfs to access external USB drives
UseLibUsbHsFS=true UseLibUsbHsFS=true
; Direct exit to homescreen ; Direct exit to homescreen when exiting DBI
ExitToHomeScreen=false ExitToHomeScreen=false
; Folder where saves backups are stored ; Folder where saves backups are stored
SavesFolder=sdmc:/switch/DBI/saves/ SavesFolder=sdmc:/switch/DBI/saves/
@ -350,70 +356,63 @@ LogsFolder=sdmc:/switch/DBI/logs/
AppSorting=Name,LastPlayed,InstallLocation,Size AppSorting=Name,LastPlayed,InstallLocation,Size
; Sorting options for save list ; Sorting options for save list
SaveSorting=AppName,AppLastPlayed,UserUid,Size,SaveId SaveSorting=AppName,AppLastPlayed,UserUid,Size,SaveId
; Highlight files with updates to curently instaled titles in file browsers ; Highlight available updates for currently installed titles in DBI's file browser
HighlightUpdates=true HighlightUpdates=true
; Rotate screen upside down ; Rotate screen upside down
RotateScreen=false RotateScreen=false
; Rotate joycons ; Rotate joycons
RotateJoycon=false RotateJoycon=false
; Underclock CPU in menues to reduce battery usage ; Underclock CPU and GPU in menus to reduce battery usage
OptimizeClockSpeed=false
; Underclock CPU in menues to reduce battery usage
OptimizeClockSpeed=false OptimizeClockSpeed=false
; Visibility of main menu options
; Visibility of main menu items
[MainMenu] [MainMenu]
; Browse and install files from MicroSD card ; Browse and install files from MicroSD card
BrowseSD=true BrowseSD=true
; Browse and install files from USB flash drives and HDD ; Browse and install files from external USB drives
USBHost=true USBHost=true
; Browse and install files from PC via dbibackend ; Browse and install files from PC via dbibackend
BackendInstall=true BackendInstall=true
; Install game from inserted game cartridge ; Install game from inserted game cartridge
GameCard=true GameCard=true
; Browse and install files from configured network sources ; Browse and install files from configured network installation sources
Network=true Network=true
; Browse installed applications ; Browse installed applications
BrowseApps=true BrowseApps=true
; Clean up files left from bad installs/old updates/unused tickets and so on ; Clean up files left from bad installations/old updates/unused tickets etc
Cleanup=true Cleanup=true
; View where you can view or delete installed tickets ; View or delete installed tickets
Tickets=false Tickets=false
; View where you can view or delete game saves ; Dedicated save game management menu
Saves=true Saves=true
; MTP responder ; MTP responder
MTP=true MTP=true
[Applications] [Applications]
; Whether check or not LFS mod size ; Check LayeredFS mod size (large mods may take a long time)
CalculateLFSSize=true CalculateLFSSize=false
; Installation options
; Install options
[Install] [Install]
; Check NCA hash during install ; Check NCA hash during installation
CheckHash=true CheckHash=true
; MTP options ; MTP options
[MTP] [MTP]
; Log all files, id disabled transfer shows only for files >= 4M ; Log all transfers on the console, if disabled only transfer of files >= 2M will be displayed
LogAllFiles=false LogAllFiles=false
; Show or not NSP that includes base game, latest update and all DLC in single multi-title file ; Display combined NSPs which contain base game, latest update and all DLC in a single file
ShowCombinedNSP=true ShowCombinedNSP=true
; Show or not virtual "Mods & cheats" folder that redirects to sdmc:/atmosphere/contents/TITLEID ; Display per game "Mods & cheats" folder that redirects to sdmc:/atmosphere/contents/TITLEID/
ShowMAC=true ShowMAC=true
; Show user defined shortcuts to MircoSD folders as separate storages ; Display user defined custom virtual MTP drives
CustomStorages=true CustomStorages=true
; Enable NAND install if run in emunand ; Enable 'NAND install' when running emuMMC
EnableNANDInstallOnEmunand=false EnableNANDInstallOnEmunand=true
; Turn screen off on start MTP mode ; Turn screen off when MTP mode is activated
TurnOffScreen=false TurnOffScreen=false
; Enable or disable virtual MTP drives
; Enable or disable various MTP storages
[MTP Storages] [MTP Storages]
1: External SD Card=true 1: External SD Card=true
2: Nand USER=false 2: Nand USER=false
@ -425,104 +424,104 @@ TurnOffScreen=false
8: Album=true 8: Album=true
9: Gamecard=true 9: Gamecard=true
; Network installation sources
; Network install sources
[Network sources] [Network sources]
; <display name>=<type>|<URL> ; <display name>=<type>|<URL>
; NSP Indexer=URLList|http://192.168.1.47/nspindexer/index.php?DBI ; NSP Indexer=URLList|http://192.168.1.47/nspindexer/index.php?DBI
; Home server=ApacheHTTP|http://192.168.1.47/Nintendo/Switch/ ; Home server=ApacheHTTP|http://192.168.1.47/Nintendo/Switch/
; Custom virtual MTP drives
[MTP custom storages] [MTP custom storages]
; <display name>=<path> ; <display name>=<path>
Homebrew=sdmc:/switch Homebrew=sdmc:/switch
; Override for display name ; Override for display name in DBI and MTP mode
; <UPPERCASED TID>=<Desired name> ; <UPPERCASE TID>=<Desired name>
[Title name override] [Title name override]
; 010023901191C000=Naheulbeuk ; 010023901191C000=Naheulbeuk
``` ```
### General settings ### General settings
* **DefaultASCII** - **true** includes a standard font, **false** includes an alternative font * **DefaultASCII** - **true** uses the standard font, **false** activates 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 to activate support for any connected external USB drives, **false** disables it
* **ExitToHomeScreen** - if **false**, the exit from DBI occurs in the hbmenu, if **true**, to the Switch's home menu * **ExitToHomeScreen** - when **false** DBI will exit to hbmenu, when **true** DBI will exit directly to the Switch's homescreen
* **SavesFolder** - folder for storing save dumps * **SavesFolder** - folder for storing save dumps
* **LogEvents** - whether or not to save logs for "* Install *", "* Check integrity *" and "* Cleanup *" events * **LogEvents** - enable logging for "*Install*", "*Check integrity*" and "*Cleanup*" events
* **LogsFolder** - folder for storing logs * **LogsFolder** - folder for storing logs
* **AppSorting** - options for sorting the list of applications * **AppSorting** - options for sorting the list of applications
* **SaveSorting** - options for sorting saves * **SaveSorting** - options for sorting saves
* **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** * **HighlightUpdates** - highlights available updates for currently installed titles in DBI's file browser
* **HighlightUpdates** - h ighlight files with updates to curently instaled titles in file browsers * **RotateScreen** - rotate the screen 180 degrees
* **RotateScreen** - rotate screen to 180 degrees
* **RotateJoycon** - rotate controls for rotated screen * **RotateJoycon** - rotate controls for rotated screen
* **OptimizeClockSpeed** - disables SoC frequency optimization when idle. Disabled by default, it can lead to lags on the startup device if the DBI is exited incorrectly! * **OptimizeClockSpeed** - enable or disable SoC frequency optimization when idle, disabled by default. **DO NOT** exit DBI improperly if enabled (e.g. by pressing the home button from applet mode) as default clock speeds will not be properly restored and your Switch will be laggy due to being in a low performance mode
### MainMenu ### MainMenu
Shows the corresponding menu items. **Visibility of main menu options** - customize which options will appear in DBI's main menu: **true** - display in main menu, **false** - hide from main menu.
**true** - display in main menu, **false** - hide from main menu * BrowseSD - display **Browse SD card**, to install games from SD card
* USBHost - display **Browse USB0 Drive**, to install games from a external USB drive if connected
* BrowseSD - item **Browse SD card**, to install games from Sd card * BackendInstall - display **Install title from USB**, for installing games from PC via dbibackend
* USBHost - item **Browse USB0 Drive**, to install games from an external USB * GameCard - display **Install title from Gamecard**, to install a game from an inserted gamecard to your console
* BackendInstall - item **Install title from USB**, for installing games from PC via backend * Network - display **Home server**, to install games from a configured home web server
* GameCard - item **Install title from Gamecard**, to install the contents of the cartridge in the memory of the console * BrowseApps - display **Browse installed applications**, to browse and manage installed applications
* Network - item **Home server**, to install games from a home web server * Cleanup - display **Cleanup orphaned files**, to clean up 'orphaned' files from the SD card
* BrowseApps - item **Browse installed applications**, to manage installed applications * Tickets - display **Browse tickets**, to manage tickets
* Cleanup - item **Cleanup orphaned files**, to clean up" orphaned "files from the memory card * Saves - display **Browse saves**, to manage save games
* Tickets - item **Browse tickets**, to manage tickets * MTP - display **Run MTP responder**, to start MTP mode
* MTP - item "**Run MTP responder**, to start MTP
### Install
* **CheckHash** - if **true**, hashes of .nca files are checked when installing games on the Switch, if **false**, no.
### Applications ### Applications
* **CalculateLFSSize** - enables or 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**
* **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** ### Install
* **CheckHash** - when **true**, hashes of .nca files are checked when installing games
### 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 in MTP mode, if **true** all files are logged, even those that are less than 2MB
* **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 **"Mods & cheats"** directory under `Installed games` in MTP mode, which redirects to the path `sdmc:/atmosphere/contents/TITLEID/`
* **CustomStorages** - show or hide storages, listed on **MTP custom storages** section * **CustomStorages** - display custom virtual MTP drives defined by the user under [MTP custom storages]
* **EnableNANDInstallOnEmunand** - allows or denies the installation of games in NAND file EmuNAND (not relevant after the release of Atmosphere 0.19.3) * **EnableNANDInstallOnEmunand** - enable or disable the installation of games to emuMMC's 'NAND' (not relevant after the release of Atmosphere 0.19.3)
* **TurnOffScreen** - the option to automatically turn off the screen when MTP mode is activated * **TurnOffScreen** - automatically turns 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. Define which virtual MTP drives will be displayed when MTP Responder is running on PC/Android.
**true** - display in MTP on PC, **false** - no **true** - display the virtual drive in MTP mode, **false** - disable the display of the virtual drive in MTP mode
The item names correspond to the titles of the sections
### [Network sources](#home-server) ### [Network sources](#home-server)
Names and addresses are set for installing games over the network (via WiFi / LAN adapter) Enter your network installation sources for installing games over the network (via WiFi/LAN adapter).
**NSP Indexer** - address for NSP index page ([more](https://github.com/rashevskyv/dbi/issues/44)) **NSP Indexer** - address for NSP index page ([more info here](https://github.com/rashevskyv/dbi/issues/44))
### MTP custom storages ### MTP custom storages
Define your own custom virtual MTP drives for quick access to folders on your SD card.
**MTP custom storages** Format: `<folder display name>=<path>`
Custom items for MTP mode for quick access to folders on your memory card. Format: `<folder display name> = <path>`, for example: `Homebrew = sdmc: / switch`. 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` virtual MTP drive will now be available, which will directly open the `sdmc:/switch` folder on your SD card.
**Title name override** - allows you to change the name of the displayed title. For example, if you specify `10023901191C000 = Naheulbeuk`, then the application will display just` Naheulbeuk` instead of `The Dungeon of Naheulbeuk: The Amulet of Chaos` ### Title name override
Allows you to change the name of the displayed title in DBI itself and in MTP mode (this can be particularly useful for e.g. Japanese games).
For example, if you specify `10023901191C000 = Naheulbeuk`, then the application will display just` Naheulbeuk` instead of `The Dungeon of Naheulbeuk: The Amulet of Chaos`
## Other options ## 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*"
### Using DBI to Install Mods: ### Using DBI to Install Mods
1. Connect to your computer via MTP mode in 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 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 * **Be careful**, you need to ensure that you copy the contents of the titleID folder and not the titleID folder itself! For example, you downloaded a 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 extract 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), that would be the `romfs` folder
### USB 3.0 ### USB 3.0
DBI supports USB 3.0. If you are using kefir, then USB 3.0 is active by default. Otherwise, you need to activate this function through the Atmosphere configuration files by writing in `atmosphere \ config \ system_settings.ini`: DBI supports USB 3.0. If you are using kefir, then USB 3.0 is active by default. Otherwise, you need to activate this function by uncommenting and editing the Atmosphere system settings configuration file at `sdmc:/atmosphere/config/system_settings.ini` as follows:
``` ```
[usb] [usb]

55
dbi.config
View File

@ -1,10 +1,10 @@
; General settings ; General settings
[General] [General]
; Use libnx's default font for ASCII symbols ; Use libnx default font for ASCII characters
DefaultASCII=true DefaultASCII=true
; Use libusbhsfs for access to USB mass storage drives connected to switch or dock ; Use libusbhsfs to access external USB drives
UseLibUsbHsFS=true UseLibUsbHsFS=true
; Direct exit to homescreen ; Direct exit to homescreen when exiting DBI
ExitToHomeScreen=false ExitToHomeScreen=false
; Folder where saves backups are stored ; Folder where saves backups are stored
SavesFolder=sdmc:/switch/DBI/saves/ SavesFolder=sdmc:/switch/DBI/saves/
@ -16,67 +16,63 @@ LogsFolder=sdmc:/switch/DBI/logs/
AppSorting=Name,LastPlayed,InstallLocation,Size AppSorting=Name,LastPlayed,InstallLocation,Size
; Sorting options for save list ; Sorting options for save list
SaveSorting=AppName,AppLastPlayed,UserUid,Size,SaveId SaveSorting=AppName,AppLastPlayed,UserUid,Size,SaveId
; Highlight files with updates to curently instaled titles in file browsers ; Highlight available updates for currently installed titles in DBI's file browser
HighlightUpdates=true HighlightUpdates=true
; Rotate screen upside down ; Rotate screen upside down
RotateScreen=false RotateScreen=false
; Rotate joycons ; Rotate joycons
RotateJoycon=false RotateJoycon=false
; Underclock CPU in menues to reduce battery usage ; Underclock CPU and GPU in menus to reduce battery usage
OptimizeClockSpeed=false OptimizeClockSpeed=false
; Visibility of main menu options
; Visibility of main menu items
[MainMenu] [MainMenu]
; Browse and install files from MicroSD card ; Browse and install files from MicroSD card
BrowseSD=true BrowseSD=true
; Browse and install files from USB flash drives and HDD ; Browse and install files from external USB drives
USBHost=true USBHost=true
; Browse and install files from PC via dbibackend ; Browse and install files from PC via dbibackend
BackendInstall=true BackendInstall=true
; Install game from inserted game cartridge ; Install game from inserted game cartridge
GameCard=true GameCard=true
; Browse and install files from configured network sources ; Browse and install files from configured network installation sources
Network=true Network=true
; Browse installed applications ; Browse installed applications
BrowseApps=true BrowseApps=true
; Clean up files left from bad installs/old updates/unused tickets and so on ; Clean up files left from bad installations/old updates/unused tickets etc
Cleanup=true Cleanup=true
; View where you can view or delete installed tickets ; View or delete installed tickets
Tickets=false Tickets=false
; View where you can view or delete game saves ; Dedicated save game management menu
Saves=true Saves=true
; MTP responder ; MTP responder
MTP=true MTP=true
[Applications] [Applications]
; Whether check or not LFS mod size ; Check LayeredFS mod size (large mods may take a long time)
CalculateLFSSize=true CalculateLFSSize=false
; Installation options
; Install options
[Install] [Install]
; Check NCA hash during install ; Check NCA hash during installation
CheckHash=true CheckHash=true
; MTP options ; MTP options
[MTP] [MTP]
; Log all files, if disabled transfer shows only for files >= 2M ; Log all transfers on the console, if disabled only transfer of files >= 2M will be displayed
LogAllFiles=false LogAllFiles=false
; Show or not NSP that includes base game, latest update and all DLC in single multi-title file ; Display combined NSPs which contain base game, latest update and all DLC in a single file
ShowCombinedNSP=true ShowCombinedNSP=true
; Show or not virtual "Mods & cheats" folder that redirects to sdmc:/atmosphere/contents/TITLEID ; Display per game "Mods & cheats" folder that redirects to sdmc:/atmosphere/contents/TITLEID/
ShowMAC=true ShowMAC=true
; Show user defined shortcuts to MircoSD folders as separate storages ; Display user defined custom virtual MTP drives
CustomStorages=true CustomStorages=true
; Enable NAND install if run in emunand ; Enable 'NAND install' when running emuMMC
EnableNANDInstallOnEmunand=true EnableNANDInstallOnEmunand=true
; Turn screen off on start MTP mode ; Turn screen off when MTP mode is activated
TurnOffScreen=false TurnOffScreen=false
; Enable or disable various MTP storages ; Enable or disable virtual MTP drives
[MTP Storages] [MTP Storages]
1: External SD Card=true 1: External SD Card=true
2: Nand USER=false 2: Nand USER=false
@ -88,17 +84,18 @@ TurnOffScreen=false
8: Album=true 8: Album=true
9: Gamecard=true 9: Gamecard=true
; Network install sources ; Network installation sources
[Network sources] [Network sources]
; <display name>=<type>|<URL> ; <display name>=<type>|<URL>
; NSP Indexer=URLList|http://192.168.1.47/nspindexer/index.php?DBI ; NSP Indexer=URLList|http://192.168.1.47/nspindexer/index.php?DBI
; Home server=ApacheHTTP|http://192.168.1.47/Nintendo/Switch/ ; Home server=ApacheHTTP|http://192.168.1.47/Nintendo/Switch/
; Custom virtual MTP drives
[MTP custom storages] [MTP custom storages]
; <display name>=<path> ; <display name>=<path>
Homebrew=sdmc:/switch Homebrew=sdmc:/switch
; Override for display name ; Override for display name in DBI and MTP mode
; <UPPERCASED TID>=<Desired name> ; <UPPERCASE TID>=<Desired name>
[Title name override] [Title name override]
; 010023901191C000=Naheulbeuk ; 010023901191C000=Naheulbeuk