search

rashevskyv / dbi

Author is duckbill
2.17k stars 92 forks source link

readme

DBI

Github latest downloads

ENGLISH GUIDE

Инструкция базируется на работе Брикачу

Ультимативное решение для установки NSP, NSZ, XCI и XCZ и работы с Nintendo Switch. Поддержка установки по MTP, USB, http (с вашего личного сервера), внешнего USB и многое другое. Поддержка просмотра картинок в формате jpg, png и psd. Поддержка работы с архивами zip и rar, а так же с контейнерами cbr/cbz. Поддержка текстовых файлов, просмотр в режиме обычного текста и в режиме hex-просмотра. Может быть использован в качестве файлового менеджера (копирование, перемещение, удаление файлов и папок, создание папок). Работа с сохранениями (в том числе резервное копирование и восстановление) и многое другое.

Содержание:

  1. Установка
  2. Использование
    1. Интерфейс
    2. Управление
    3. Browse SD Card / Просмотр SD карты и Browse USB0 Drive / Просмотр USB0 диска
    4. Install title from DBIbackend / Установка через DBIbackend
    5. Home server / Подключение к серверу
    6. Browse installed applications / Просмотр установленных игр
    7. Browse tickets / Просмотр тикетов
    8. Tools / Инструменты
    9. Browse saves / Просмотр сохранений
    10. Run MTP responder / Запустить MTP соединение
    11. Activity Log / Настройки активности
    12. Configuration / Настройки DBI и параметры файла dbi.config
    13. Exit / Выход
  3. Уведомления и коды ошибок
    1. Уведомления
    2. Ошибки
    3. Цветовые кода
  4. dbi.config
  5. Другие возможности
  6. Благодарности

Установка

Поместите dbi.nro и dbi.config в папку sdmc:/switch/DBI/ на вашей каре памяти. Запускайте из режима апплета с помощью Homebrew Launcher (через альбомы)

В режиме апплета программа запускается с синим фоном. В режиме тайла - с чёрным

Использование

Интерфейс

2021041010520200

В самом левом нижнем углу (SD) написано про занятый размер данных на карте/общий размер карты. В правом нижнем углу (NAND) написан занятый размер данных во встроенной памяти Switch/общий встроенной памяти Switch. Внизу по центру (dbi: XXX) написан номер версии dbi — старайтесь всегда использовать самую последнюю версию программы

Управление

Browse SD Card / Просмотр SD карты и Browse USB0 Drive / Просмотр USB0 диска

Выберите этот пункт, если хотите установить игры/обновления/DLC из уже имеющихся файлов на карте памяти/внешнем USB. Кнопка (A) открывает папку, кнопка (B) возвращает назад, после открытия папки с файлами для установки, кнопкой (X) можно выделить только необходимые файлы, кнопокй (Y) инвертировать выбор. При этом цвет названия выделенных файлов изменится с белого на светло-синий.

После этого нажмите кнопку (А) для подтверждения. Возникнет окно с опциями установки:

2021041011441100

В программе имеется встроенная автоматическая функция удаления старых апдейтов при установке нового обновления к игре, поэтому за лишнее занимаемое место ими можно не беспокоиться.

Вы можете запускать .NRO-файлы кнопкой (A)

Install title from DBIbackend / Установка через DBIbackend

Через "Install title from DBIbackend / Установка через DBIbackend" очень удобно устанавливать игры, обновления и DLC к ним сразу напрямую по USB-проводу с ПК на Switch, минуя необходимость вынимать карту и тратить двойное время, закачивая дистрибутивы (NSP/NSZ/XCI/XCZ-файлы) на карту памяти и устанавливая их оттуда. Горячая клавиша для вызова этой опции из главного меню: кнопка (Y).

Для работы сперва нужно скачать на ПК dbibackend (dbibackend.exe для Windows или dbibackend для всех ОС), запустить его, выбрать игры для установки, нажать Start server, затем подключить USB-C кабель к ПК и Switch, выбрать пункт Install title from DBIbackend в dbi и установить все необходимые игры.

Для правильной работы dbibackend на Windows, необходимо поставить драйвера "libusbK (v3.1.0.0)". Их можно установить через программу Zadig, введя DBI в режим "Install title from DBIbackend" и выбрав в программе появившееся устройство.

Выделение файлов, а так же их установка происходит способом идентичным способу из пункта Browse SD Card/Browse USB0 Drive

Для быстрой отправки файлов или папок с играми на установку, нажмите на них правой клавишей мыши, выберите Отправить > dbibackend, установочные файлы сразу помещаются в очередь dbibackend. Для того, чтобы это настроить в Windows, нажмите Win+R, введите shell:sendto, положите в папку ярлык для dbibackend.exe

Существуют альтернативные клиенты для работы с DBIbackend, например headless-реализация, NSW-DBI 2.0.0 на nodegui (требуется установка драйвера libusb для Linux или WinUSB (libusb) для Windows через Zadig).

Вы можете передавать команды скрипту путем запуска его из командной строки с последующим указанием пути к необходимой для установки игры или игр. Например: 

python ~/dbi/dbibackend ~/Switch/File1.nsp ~/Switch/File2.nsp ~/Switch/File3.nsp
dbibackend.exe "e:\Switch\Games\File1.nsp" "e:\Switch\Games\File2.nsp" "e:\Switch\Games\File3.nsp"

Зависимости, которые могут потребоваться для работы в MacOS или Linux

brew install python-tk
pip3 install pyusb

Home server / Подключение к серверу

Пункт "Home server / Подключение к серверу" появляется при наличии настроенного раздела Network install sources в dbi.config (подробнее про этот файл ниже). Причём название этого пункта будет меняться в зависимости от названия указанного в конфигурационном файле

Для установки игр по сети, отредактируйте файл dbi.config, находящийся в папке sdmc:/switch/DBI/, согласно примеру

; Network install sources
[Network sources]
; <display name>=<type>|<URL>
Home server=ApacheHTTP|http://192.168.1.47/Nintendo/Switch/

Установите на ПК любой другой HTTP-сервер c включённым DirectoryListing: Apache, Mongoose, Python SimpleHTTP, sheret, rclone и т. д.,

Пример для nginx на Windows: отредактируйте файл /nginx/conf/nginx.conf, прописав в location адрес вашего Switch, вместо указанного в примере 127.0.0.1 (или всю свою подсеть вида 192.168.1.1/24 или 192.168.0.0/16); его можно узнать на Switch в Системных настройках > Интернет:

location/{
root html;
index index.html index.htm;
}
location /Nintendo/Switch/ {
allow 127.0.0.1;
deny all;
autoindex on;
}

Сохраните конфиг, запустите nginx.exe, разрешив программе доступ в сеть, затем скопируйте нужную игру в локальную папку /nginx/html/Nintendo/Switch/ на ПК, а на Switch выберите строку «Home server». Получаем обычный интерфейс инсталляции файлов, и можно начать устанавливать все игры по сети, после чего, при желании веб-сервер можно остановить через nginx -s stop.

В качестве адреса сервера, можно использовать и доменное имя в интернете, например, своего удалённого VPS — лучше с HTTP Basic-аутентификацией вида http://user:password@host:port/Nintendo/Switch/

Например:

ApacheHTTP|Network repo|http://127.0.0.1/Nintendo/Switch/
ApacheHTTP|WWW VPS repo|http://www.myveryownswitchvpsdomain.su/Nintendo/Switch/

Сгенерировать файл htpasswd, положить в /nginx/conf/, затем в nginx.conf изменить в блоке (пример):

  location /Nintendo/Switch/ {
               satisfy all;
               allow 127.0.0.1;
               deny all;
               auth_basic "Password Protected Area";
               auth_basic_user_file htpasswd; 
   autoindex on;
  }

Логин «switch», пароль «pwd»:

Файл htpasswd:

switch:{SHA}N/omUzCtg+qoee+x4ttjgIls9jk=

Browse installed applications / Просмотр установленных игр

В Browse installed applications можно посмотреть список установленных программ, обновлений, DLC к ним, по отдельности их занимаемый объём и версию, порядковую и в HEX-формате, их titleID, посмотреть общее время игры и количество запусков, наличие установленного LayeredFS-мода к игре (для Atmosphére).

Горячая клавиша для вызова этой опции из главного меню: кнопка (L):

Сверху в центре написано общее количество установленных игр и тип сортировки

2021062719353200

В квадратных скобках перед названием игры написана базовая информация о месте установки, составе и наличии мода игры. Отображается только то, что установлено. То есть, если буквы b в квадратных скобках нет, значит у игры не установлена сама базовая часть (в таком случае строка будет окрашена красным)

Нажав (L3) можно запустить игру прямо отсюда

Обратите внимание! Если игра выделена красным, значит не установлена её базовая часть, а установлено только обновление или DLC

Контекстное меню тайтла

2021062719354100

Отображается при нажатии на (+) на выбранных тайтлах (или тайтле)

В верху контекстного окна отображается количество выбранных тайтлов и их размер

Если нажать на тайтле кнопку (A), то откроется детальное меню игры

Детальное меню игры

Детальное меню игры открывается, если нажать на тайтле кнопку (A), находясь в меню просмотра установленных игр (Browse installed applications / Просмотр установленных игр)

2021062719353600

Отображается иконка игры, TitleID, название (Name / Имя), автор (Author / Автор), версия (Version / Версия), поддерживаемые языки (Language / Языки) и наличие LFS-мода (LFS-mod / LFS-мод.)

Так же здесь можно узнать количество времени, проведённого в игре (Total play time / Общее время игры), сколько раз игра была запущена (Total launches / Общее число запусков), сколько она весит (в целом (Total occupied space / Общее занимаемое место), а так же сколько места занимает в NAND (Space in NAND / Место в NAND) и на SD (Space on SD / Место на SD)), размер сохранений (Total saves size / **) и какой язык у игры активен (Forced Language / Форсированный язык**)

Ниже можно увидеть три вкладки, между которыми можно переключаться кнопками (L) и (R)

Content records / Контент

2021062719354800

Информация показана в следующем виде:

[Location] Type | version [version number] | Size

Location - NAND или SD, в зависимости от места, в которое установлен контент Type - Application для базовой игры, Update для обновления, Addon для DLC, причем рядом с последним будет указан номер самого DLC version [version number] - версия контента в dec и [hex] (например, 786432 это 0.12.0.0) Size - занимаемое место

При нажатии на контенте кнопкой (A), можно посмотреть его содержимое. Содержимое можно скопировать, выбрав соответствующий пункт в контекстном меню (напоминаю, открывается по нажатию кнопки (+)). Содержимое открывается в режиме "только для чтения".

При нажатии кнопки (+) на выбранном контенте, можно попасть в контекстное меню:

Tickets / Тикеты

Ticket (или encrypted title key) — это зашифрованная уникальная информация о правах запуска на контент игры, которая устанавливается в систему при инсталляции каждой игры (000 в конце titleID)/обновления (800 в конце titleID)/каждого DLC.

Отображаются установленные для контента тикеты:

Базы игр на серверах Nintendo шифрованы одним и тем же ключом, но этот ключ шифруется собственным ключом, уникальным для каждого купившего игру (этот ключ генерируется на самой приставке), поэтому получить из Personalized-тикета ключ для дешифровки игры можно только на той приставке, для которой он создан. То есть у всех купивших Personalized-тикеты разные, но содержат один и тот же ключ дешифровки игры. А в Common-тикетах нет шифрования, только подпись.

При нажатии кнопки (+) на выбранном контенте, можно попасть в контекстное меню, где можете удалить выбранные тикеты.

Иногда, если возникают специфическая ошибка, и вы точно знаете и уверены, что вы делаете, его можно удалить у конкретной игры и её обновления/DLC. Во всех остальных случаях лучше тут ничего не трогать, во избежание ошибок запуска игр.

Saves / Сохранения

Просмотр и удаление сохранений. Если сохранения нет, его можно создать через контекстное меню (кнопка (+)) для выбранного аккаунта. Если оно есть, то:

Browse tickets / Просмотр тикетов

Просмотр и удаление тикетов игр. Ticket (или encrypted title key) — это специальная зашифрованная уникальная информация о правах запуска на контент игры, которая устанавливается в систему при инсталляции каждой игры (000 в конце titleID)/обновления (800 в конце titleID)/каждого DLC.

Базы игр на серверах Nintendo шифрованы одним и тем же ключом, но этот ключ шифруется собственным ключом, уникальным для каждого купившего игру (этот ключ генерируется на самой приставке), поэтому получить из Personalized-тикета ключ для дешифровки игры можно только на той приставке, для которой он создан. То есть у всех купивших Personalized-тикеты разные, но содержат один и тот же ключ дешифровки игры. А в Common-тикетах нет шифрования, только подпись.

Иногда, если возникают специфическая ошибка, и вы точно знаете и уверены, что вы делаете, его можно удалить у конкретной игры и её обновления/DLC.

Во всех остальных случаях лучше тут ничего не трогать, во избежание ошибок запуска игр.

Контекстное меню тикетов

Отображается при нажатии на (+) на выбранных тикетах

В верху контекстного окна отображается количество выбранных тикетов

Tools / Инструменты

Browse saves / Просмотр сохранений

Просмотр и удаление сохранений.

В общем виде сохранения показываются так:

[Account] Game-Name Backup-date Size

Ниже можно увидеть три вкладки, между которыми можно переключаться кнопками (L) и (R)

Контекстное меню Installed / Установленные и Uninstalled / Удалённые

Отображается при нажатии на (+) на выбранных сохранениях

Контекстное меню Backups / Бекапы

Отображается при нажатии на (+) на выбранных сохранениях

Если в списке на одну игру, одного пользователя выбрано несколько бекапов, то восстановится только самый свежий.

Run MTP responder / Запустить MTP соединение

Run MTP responder / Запустить MTP соединение включает встроенный в DBI MTP-сервер для обмена данными с ПК либо к Android-устройству по USB-C OTG (телефон/планшет/прочие устройства). Горячая клавиша для вызова этой опции из главного меню: кнопка (X) (ей же выходить из MTP). После подключения USB-провода к ПК и запуска MTP-сервера в dbi, на ПК появится следующее окно:

изображение

Где: 1: SD Card, для просмотра, копирования и удаления файлов и папок c/на ПК и с/на карту памяти SD. В случае, если размер файла превышает 4Гб, DBI автоматически разобьёт его на фрагменты специальным образом, чтобы свитч видел такой файл как цельный

2: NAND User, просмотр, копирование файлов и папок на ПК с внутренней память Switch, в его системный раздел USER (раздел доступен только для чтения).

3: NAND System, просмотр, копирование файлов и папок на ПК с внутренней памяти Switch, в его системный раздел SYSTEM (раздел доступен только для чтения).

4: Installed games, для просмотра установленных игр.

В Installed games отображаются все игры как в NAND, внутренней памяти Switch, так и установленные на карту памяти, все вместе. Чтобы сделать дамп (дистрибутив) установленный игры себе на ПК в формате .NSP, просто скопируйте папку с названием игры из Installed games на свой ПК, при этом на базе вашего personalized-тикета генерируется общий common-тикет с полностью очищенной личной информацией. Вы получите дамп этой игры в виде раздельных файлов - отдельно саму игру, отдельно обновление и DLC. Если для игры были установлены читы или моды, они будут находится в папке Mods & Cheats. Так же можно получить скомбинированный дамп, в котором в один файл будет склеяны сама игры, все её DLC и обновление. Такой файл лежит прямо в корне раздела Installed games.

Здесь так же хранится сгенерированный dbi InstalledApplications.csv, с таблицей списка установленных игр, их TitleID и текущей версии.

5: SD install
Скопируйте в эту папку ваши NSP/NSZ/XCI или XCZ. По окончанию копирования игра будет установлена на карту памяти вашей приставки. При установке NSZ-файлов учитывайте, что их фактический размер может сильно отличаться от размера после установки, так что если при наличии свободных 2Гб на карте памяти у вас, например, не хватает места для установки NSZ размером, скажем, в 1Гб, не удивляйтесь, поскольку контейнер NSZ - сжатый.

6: NAND install: Скопируйте в эту папку ваши NSP/NSZ/XCI или XCZ. По окончанию копирования игра будет установлена во внутреннюю память вашей приставки. При установке NSZ-файлов учитывайте, что их фактический размер может сильно отличаться от размера после установки, так что если при наличии свободных 2Гб на карте памяти у вас, например, не хватает места для установки NSZ размером, скажем, в 1Гб, не удивляйтесь, поскольку контейнер NSZ - сжатый.

7: Saves: Доступ ко всем сохранениям игр — в аккаунтах (Account), системных программ (System), в Background Content Asymmetric synchronized delivery and Transmission (BCAT, пример: ивенты в ACNH), временных (Temporary), кэш (Cache, пример: аддоны в DOOM), системных BCAT (SystemBCAT), — хранящимся во внутренней памяти Switch

В папке Installed games — сохранения для имеющихся установленных сейчас игр

Uninstalled games — сохранения от удалённых игр, которые раньше запускались. Отсюда можно сделать их бекап, скопировав их на ПК, а также удалить ненужные — для этого откройте папку с именем нужной игры, затем удалите папку с ником вашего аккаунта/Device-сохранения.

Для того, чтобы восстановить сохранения, скопируйте их в соответствующую папку с ПК. DBI не требует предварительного запуска игры для восстановления сохранения, однако это касается только обычных сохранений. BCAT или Cache сохранения требуют предварительного запуска игры перед восстановлением.

8: Album: доступ к скриншотам и видеороликам (Альбому), точно так же, как это сделано в OFW 11.0.0 Nintendo.

9: Gamecard: при вставленном в Switch игровом картридже появляется возможность скопировать его дамп в .XCI либо trimmed .XCI на ПК, вместе со встроенным в него обновлением, если оно есть, с уже убранным его персональным RSA-сертификатом; кроме того, возможно отдельно экспортировать его сертификат

Также, на дисплее Switch после включения MTP-сервера появится окно с вашим ником учётной записи и его UID, а также количеством игровых сохранений:

2021041013152900

Чтобы выключить MTP-сервер и выйти в главное меню, нажмите кнопку (X) или (B).

Activity Log / Настройки активности

Показывает графики активности в играх по датам для всех имеющихся пользователей для каждой конкретной игры.

При запуске показаны две вкладки, которыми можно переключаться кнопками (L) и (R):

Горячие клавиши:

Applications / Запускавшиеся игры

Показан список игр для которых есть статистика запуска. Вверху окна находится статусная строка следующего вида:

[игрок] период. Всего: количество часов (метод сортировки). Например, строка [Все игроки] 2023 Январь. Всего: 72 часа (по времени игры) будет означать, что на экране отображается статистика для всех игроков за январь 2023 года с сортировкой по времени игры, где наиграно 72 часа

Окно разделено на три колонки. Слева направо:

При нажатии (А) на игре вы попадаете в Диаграмму активности для текущей игры, где показана статистика по выбранной игре. При нажатии (A) на пункте, вы переместитесь глубже (год -> месяц -> день -> час)

Activity / Диаграмма активности

Показана активность в виде диаграммы для всех игор сразу. Для перехода к диаграмме по конкретной игре, перейдите во вкладку Запускавшиеся игры и выберите игру для отображения

Configuration / Настройки DBI и параметры файла dbi.config

Менеджер конфигурации программы, позволяет легко настроить программу без редактирования dbi.config.

Ниже будут описаны пункты конфигурации через GUI/ Пункты, которым они соответствуют в dbi.config будут указаны в скобках.

true в конфиге соответствует Yes / Да в настройках, false - No / Нет

General / Общие ([General])

Есть в конфиге, но нет в меню:

Main menu / Главное меню ([MainMenu])

Настройки пунктов меню, которые будут отображаться в главном меню DBI. Yes / Да в настройках, соответствует true в конфиге, No / Нет - false

Applications / Установленные игры ([Applications])

Install options / Параметры установки ([Install])

MTP options / Параметры MTP ([MTP])

Есть в конфиге, но нет в меню:

MTP storages / Хранилища MTP ([MTP Storages])

Показ соответствующих элементов при работе MTP Responder с ПК/Android, по умолчанию все пункты включены для отображения.

true - отображать в главном меню, false - нет

Названия пунктов соответствуют названиям разделов

FTP options / Параметры FTP ([FTP])

Access point / Точка доступа ([Access point])

Есть в конфиге, но нет в меню

Network sources

Задаются имена и адреса для установки игр по сети (через WiFi/LAN-адаптер)

NSP Indexer - адрес для индексации NSP (подробнее)

Local sources

Создание пунктов меню с быстрым доступом к выбранным в конфиге папкам на карте памяти («ярлыки»), например:

Homebrew Shortcut=sdmc:/switch создаст в главном меню пункт "Homebrew Shortcut", который откроет папку sdmc:/switch

MTP custom storages

Кастомные пункты для MTP-режима для быстрого доступа к папкам на вашей карте памяти. Формат: <отображаемое_имя папки>=<путь>, например: Homebrew=sdmc:/switch. В режиме MTP появится папка Homebrew, ссылающаяся на папку switch на вашей карте памяти

Title name override

Позволяет изменить имя отображаемого тайтла. Например, если указать 10023901191C000=Naheulbeuk, то в приложении вместо The Dungeon of Naheulbeuk: The Amulet of Chaos будет отображаться просто Naheulbeuk

Exit / Выход

Exit / Выход — выход из программы в HOS, минуя hbmenu, либо в hbmenu (это настраивается в dbi.config); если dbi был запущен из тайтла/форвардера, программа перезагрузится либо останется на чёрном экране.

Уведомления и коды ошибок

УВЕДОМЛЕНИЯ:

Отображаются оранжевым цветом. Это НЕ ошибки!

ОШИБКИ:

Цветовые коды:

dbi.config

Файл dbi.config отвечает за хранение настроек программы. Он находится рядом с DBI.nro.

Рассмотрим его содержимое:

; General settings
[General]
; Use libusbhsfs for access to USB mass storage drives connected to switch or dock
UseLibUsbHsFS=true
; Direct exit to homescreen
ExitToHomeScreen=false
; Folder where saves backups are stored
SavesFolder=sdmc:/switch/DBI/saves/
; Log "Install", "Check integrity" and "Cleanup" processes
LogEvents=false
; Folder where logs are stored
LogsFolder=sdmc:/switch/DBI/logs/
; Folder where game dumps are stored
DumpsFolder=sdmc:/switch/DBI/dumps/
; Sorting options for application list
AppSorting=LastPlayed,InstallLocation,Size,Name
; Sorting options for save list
SaveSorting=AppLastPlayed,AppName,UserUid,Size,SaveId
; Highlight files with updates to curently instaled titles in file browsers
HighlightUpdates=true
; Rotate screen upside down
RotateScreen=false
; Rotate joycons
RotateJoycon=false
; Underclock CPU in menues to reduce battery usage
OptimizeClockSpeed=false
; URL with title versions in format <id>|<rightsId>|[version]
VersionsURL=https://raw.githubusercontent.com/blawar/titledb/master/versions.txt
;VersionsURL=sdmc:/versions.txt
;Browse saves FS in Read-only mode
ROSaveFS=true
; Show "Update all items from here..." in context menu of file browsers
ShowUpdateFromHere=false
; Show cache warming spinner
ShowCacheWarmingIndicator=true
; Move cursor down after selection
MoveDownAfterX=true
; Screen idle timeout in seconds
ScreenIdleTimeout=0
; Auto repeat nav. buttons when holding
Autorepeat=true
; Show cursors on both panels in two-panel browsinig mode
Secondcursor=false
; Backup saves before delete
FoolproofSaveDelete=true

; Visibility of main menu items
[MainMenu]
; Browse and install files from SD card
BrowseSD=true
; Browse and copy files from SYSTEM partition
BrowseSystem=false
; Browse and copy files from USER partition
BrowseUser=false
; Browse and install files from USB flash drives and HDD
USBHost=true
; Browse and install files from PC via dbibackend
BackendInstall=true
; Install game from inserted game cartridge
GameCard=true
; Browse and install files from configured network sources
Network=true
; Browse and install files from configured sd card folders
Local=true
; Browse installed applications
BrowseApps=true
; Clean up files left from bad installs/old updates/unused tickets and so on
Cleanup=true
; Check for app updates
UpdateCheck=true
; View where you can view or delete installed tickets
Tickets=false
; View where you can view or delete game saves
Saves=true
; MTP responder
MTP=true
; FTP Server
FTP=true

[Applications]
; Whether check or not LFS mod size
CalculateLFSSize=false

; Install options
[Install]
; Check NCA hash during install
CheckHash=true
; Use chunked HTTP transfer (good in bad environments)
ChunkedTransfer=false

; MTP options
[MTP]
; Log all files, if disabled transfer shows only for files >= 2M
LogAllFiles=false
; Show or not NSP that includes base game, latest update and all DLC in single multi-title file
ShowCombinedNSP=true
; Show or not virtual "Mods & cheats" folder that redirects to sdmc:/atmosphere/contents/TITLEID
ShowMAC=true
; Use TitleID for "Mods & cheats" folder
MACasTID=true
; Show user defined shortcuts to MircoSD folders as separate storages
CustomStorages=true
; Turn screen off on start MTP mode
TurnOffScreen=false
; Report android extension (some initiators thinks that android has bugs)
ReportAndroidExtension=true

; FTP options
[FTP]
; Turn screen off on start FTP mode
TurnOffScreen=false
; Start local access point for FTP server
UseAP=false
; Read file modification time (can slow down on large dirs)
ReadMT=false

; Access point options
[Access point]
SSID=
Password=
Use5GHz=true
Hidden=false

;Enable or disable various MTP storages
[MTP Storages]
1: SD Card=true
2: Nand USER=false
3: Nand SYSTEM=false
4: Installed games=true
5: SD Card install=true
6: NAND install=true
7: Saves=true
8: Album=true
9: Gamecard=true

; Network install sources
[Network sources]
; <display name>=<type>|<URL>
; NSP Indexer=URLList|http://192.168.1.47/nspindexer/index.php?DBI
; Home server=ApacheHTTP|http://192.168.1.47/Nintendo/Switch/
; Test FTP=FTP|ftp://anonymous:password@192.168.1.24:2121/

; Main menu shortcuts to SD card locations
[Local sources]
; <display name>=<path>
Homebrew=sdmc:/switch
; Contents=sdmc:/atmosphere/contents
; DBILogs=sdmc:/switch/DBI/logs

[MTP custom storages]
; <display name>=<path>
Homebrew=sdmc:/switch/
Screenshots=sdmc:/Nintendo/Album/

; Override for display name
; <UPPERCASED TID>=<Desired name>
[Title name override]
; 010023901191C000=Naheulbeuk

Описание каждого пункта в отдельности находятся в разделе настроек DBI

Другие возможности

Монтирование содержимого установленных игр по MTP

Перейдите в Browse installed applications / Просмотр установленных игр -> Выберите необходимые игры кнопкой (X) -> Нажмите (+) -> Expose contend via MTP

Бекап и восстановление сохранений по MTP

  1. Подключите приставку в режиме MTP по DBI
  2. Перейдите в папку Saves на вашем ПК
  3. Вы можете как скопировать сейвы на ПК, так и восстановить их, просто перетянув в эту папку

Использование DBI для установки модификаций

  1. Подключите приставку в режиме MTP по DBI
  2. Перейдите в Installed Games, в папку с названием вашей игры
  3. Перейдите в папку Mods & Cheats
  4. Поместите в папку Mods & Cheats ваш мод
  5. Будьте внимательны, вам нужно класть не саму папку с titleID игры, а её содержимое! Например, вы скачали перевод для игры Cadence of Hyrule, в виде архиве Cadence of Hyrule.rar. Внутри этого архива вы видите папку с TitleID игры - 01000B900D8B0000. Вам нужно распаковать архив, перейти в папку 01000B900D8B0000 и скопировать всё содержимое папки в Mods & Cheats! Не саму папку 01000B900D8B0000, а всё то, что в ней находится! В данном примере, папку romfs

USB 3.0

DBI поддерживает работу по USB 3.0. Если вы используете kefir, то USB 3.0 активно по-умолчанию. В ином случае, нужно активировать эту функцию через конфигурационные файлы Atmosphere, прописав в atmosphere\config\system_settings.ini: 

[usb]
usb30_force_enabled = u8!0x1

Важно - активация USB 3.0 может повлиять на работу беспроводных соединений Bluetooth и Wi-Fi на частоте 2.4 ГГц. Если у вас возникают проблемы с подключением беспроводных контроллеров или сетей Wi-Fi на частоте 2.4 ГГц, то не следует активировать USB 3.0. Связь через Wi-Fi на частоте 5 ГГц не пострадает.

Восстановление бекапа чистых пользовательских сохранений

Это нешифрованные сохранения, которые лежат в папке USER:/saves. В случае, если эмунанд поврежден, то эти сохранения можно достать через ПК или Tegra Explorer и восстановить через DBI.

Вы можете положить эти сохранения в папку с бекапами сохранений DBI (/switch/dbi/saves по умолчанию) и восстановить через стандартное меню восстановления сейвов (имя пользователя в таком случае будет взято в фигурные скобки {}), либо через контекстное меню, вызванное на файле такого сохранения.

Установка картинки в качестве аватара

Наведите курсор на нужную картинку и вызовите контекстное меню кнопкой (+). Выберите Set as avatar... / Установить как аватар. Выбранная картинка будет установлена в качестве аватара. Картинка автоматически будет сжата до квадратных пропорций и уменьшена для необходимого размера. Если хотите, чтобы картинка не деформировалась, то подготовьте её заранее.

Редактирование и просмотр файлов

Любой файл можно открыть как текстовый или в виде HEX. Не пустой файл открывапется в режиме просмотра, однако, клавиша (L3) переключит на режим режактирования. Рассмотрим оба режима отдельно.

Так же вы можете создать пустой текстовый файл из контекстного меню (вызывается кнопкой (+) > Создать новый файл...). При открытии пустого текстового файла, редактор запустится автоматически.

Режим просмотра файлов

Горячие клавиши:

Контекстнрое меню:

Режим редактирования файлов

Вы можете осуществлять редактирование текста перемещаясь по клавиатуре правым стиком и выбирая букву кнопокой (А).

Горячие клавиши:

При закрытии файла или переходе в режим просмотра, можно выбрать сохранять изменения или нет, если в файл вносились изменения

Благодарности

Спасибо SciresM за hactool (лицензия ISC) - DBI использует некоторые структуры данных, взятые оттуда.