mirror of
https://github.com/rashevskyv/dbi.git
synced 2025-02-07 14:02:49 +08:00
Updated for DBI 300 functions
This commit is contained in:
parent
1599a273e2
commit
9f32118fb4
181
README.md
181
README.md
@ -12,12 +12,19 @@
|
||||
1. [Установка](#установка)
|
||||
1. [Использование](#использование)
|
||||
1. [Интерфейс](#интерфейс)
|
||||
1. [Управление](#управление)
|
||||
1. [Browse SD Card / Browse USB0 Drive](#browse-sd-card--browse-usb0-drive)
|
||||
1. [Install title from USB](#install-title-from-usb)
|
||||
1. [Home server](#home-server)
|
||||
1. [Browse installed applications](#browse-installed-applications)
|
||||
* [Контекстное меню тайтла](#контекстное-меню-тайтла)
|
||||
* [Детальное меню игры](#детальное-меню-игры)
|
||||
* [Контекстное меню записи](#контекстное-меню-записи)
|
||||
1. [Cleanup orphaned files](#cleanup-orphaned-files)
|
||||
1. [Browse tickets](#browse-tickets)
|
||||
* [Контекстное меню тикетов](#контекстное-меню-тикетов)
|
||||
1. [Browse saves](#browse-saves)
|
||||
* [Контекстное меню сохранений](#контекстное-меню-сохранений)
|
||||
1. [Run MTP responder](#run-mtp-responder)
|
||||
1. [Exit](#exit)
|
||||
1. [Уведомления и коды ошибок](#уведомления-и-коды-ошибок)
|
||||
@ -51,12 +58,28 @@
|
||||
В самом левом нижнем углу (SD) написано про занятый размер данных на карте / общий размер карты. В правом нижнем углу (NAND) написан занятый размер данных во встроенной памяти Switch / общий встроенной памяти Switch.
|
||||
Внизу по центру (dbi: XXX) написан номер версии dbi — старайтесь всегда использовать самую последнюю версию программы
|
||||
|
||||
### Управление
|
||||
|
||||
* **(А)** - выбор, подтверждение
|
||||
|
||||
* **(B)** - отмена. **На главном экране** - выход из программы
|
||||
|
||||
* **(X)** - выделение файла. **На главном экране** - горячая клавиша для монтирования MTP (пункт меню "**Run MTP responder**")
|
||||
|
||||
* **(Y)** - инвертировать выделение, выделить всё, если ничего не выделено. **На главном экране** - установка по USB с помощью dbibackend (пункт меню "**Install title from USB**")
|
||||
* **(ZL)**, **(ZR)** - быстрое перемещение по меню
|
||||
* **(L)** - **на главном экране** - (пункт меню "**Browse installed applications**")
|
||||
* **(R)** - изменить порядок отображения файлов \ тайтлов
|
||||
|
||||
* **(+)** на правом джойконе - контекстное меню, которое позволяет производить контекстные операции, как-то удаление, сброс требуемой версии прошивки, монтирование по MTP и др.
|
||||
* **(-)** на левом джойконе при установке приложений отключает \ включает экран
|
||||
|
||||
### Browse SD Card / Browse USB0 Drive
|
||||
|
||||
Выберите этот пункт, если хотите установить игры / обновления / DLC из уже имеющихся файлов на карте памяти / внешнем USB.
|
||||
Кнопка **A** открывает папку, кнопка **B** возвращает назад, после открытия папки с файлами для установки, кнопкой **X** можно выделить только необходимые файлы, кнопокй **Y** инвертировать выбор. При этом цвет названия выделенных файлов изменится с белого на светло-синий
|
||||
Кнопка **(A)** открывает папку, кнопка **(B)** возвращает назад, после открытия папки с файлами для установки, кнопкой **(X)** можно выделить только необходимые файлы, кнопокй **(Y)** инвертировать выбор. При этом цвет названия выделенных файлов изменится с белого на светло-синий.
|
||||
|
||||
После этого нажмите кнопку **А** для подтверждения. Возникнет окно с опциями установки:
|
||||
После этого нажмите кнопку **(А)** для подтверждения. Возникнет окно с опциями установки:
|
||||
|
||||
![2021041011441100](https://user-images.githubusercontent.com/18294541/114264183-18138580-99f2-11eb-8c7b-536b4b831195.jpg)
|
||||
|
||||
@ -139,28 +162,101 @@ switch:{SHA}N/omUzCtg+qoee+x4ttjgIls9jk=
|
||||
```
|
||||
### Browse installed applications
|
||||
|
||||
В **Browse installed applications** можно посмотреть список установленных программ, обновлений, DLC к ним, по отдельности их занимаемый объём и версию, порядковую и в HEX-формате, их titleID, посмотреть общее время игры и количество запусков, наличие установленного LayeredFS-мода к игре (для Atmosphére). *Горячая клавиша для вызова этой опции из главного меню*: кнопка **L**:
|
||||
В **Browse installed applications** можно посмотреть список установленных программ, обновлений, DLC к ним, по отдельности их занимаемый объём и версию, порядковую и в HEX-формате, их titleID, посмотреть общее время игры и количество запусков, наличие установленного LayeredFS-мода к игре (для Atmosphére).
|
||||
|
||||
![2021041012101400](https://user-images.githubusercontent.com/18294541/114264832-e3093200-99f5-11eb-9e7a-acc7b0f7444c.jpg)
|
||||
*Горячая клавиша для вызова этой опции из главного меню*: кнопка **L**:
|
||||
|
||||
Сверху в центре написано общее количество установленных игр; можно перенести любые установленные игровые данные между встроенной памятью, картой памяти microSD и обратно, имеется возможность выборочного (или потокового) удаления игр **(b)** / обновлений **(u)** / DLC **(d)** вместе с прилагаемыми LayeredFS-модами **(l)** к игре в` /atmosphere/contents/` или только его отдельно; здесь можно вручную удалить ненужные вам DLC / обновления к игре; есть функция **Reset Required version** для сброса системной проверки обновления выбранной игры (она также автоматически активируется пои установке, удалении игровых обновлений):
|
||||
Сверху в центре написано общее количество установленных игр и тип сортировки
|
||||
|
||||
![2021041012102700](https://user-images.githubusercontent.com/18294541/114264843-f74d2f00-99f5-11eb-8cf0-a3fc383ac322.jpg)
|
||||
![2021062719353200](https://user-images.githubusercontent.com/18294541/123554546-32efcd80-d789-11eb-8d3f-3124448624e0.jpg)
|
||||
|
||||
Кнопкой **R** можно выбирать нужную сортировку игр — по алфавиту (по умолчанию), или по их последнему использованию.
|
||||
Кнопкой **А** войти в меню выбранной игры, кнопка **—** удаляет игру и её (неперсонализированный) тикет, D-pad'ом выбираются игры, левым стиком прокручивается список игр, кнопками **ZR** и **ZL** можно листать список игр поэкранно.
|
||||
В квадратных скобках перед названием игры написана базовая информация о месте установки, составе и наличии мода игры. Отображается только то, что установлено. То есть, если буквы b в квадратных скобках нет, значит у игры не установлена сама базовая часть (в таком случае строка будет окрашена красным)
|
||||
|
||||
Также можно проверить (верифицировать) игры на их целостность, выбрав её и затем пункт **Check integrity**
|
||||
* **N / S / M** - NAND / SD / Mixed - означает место, где установлена игра. В случае, если части игры находятся на разных носителях, отображается Mixed
|
||||
* **b** - BASE - сама игра
|
||||
* **u** - Update - обновление игры
|
||||
* **d** - DLC - DLC игры
|
||||
* **l** - LayeredFS mod - наличие модификаций, читов или перевода
|
||||
|
||||
**Обратите внимание!** Если игра выделена **красным**, значит не установлена её базовая часть, а установлено только обновление или DLC
|
||||
|
||||
#### Контекстное меню тайтла
|
||||
|
||||
![2021062719354100](https://user-images.githubusercontent.com/18294541/123554557-3b480880-d789-11eb-9235-d547f2c588bd.jpg)
|
||||
|
||||
Отображается при нажатии на **(+)** на выбранных тайтлах (или тайтле)
|
||||
|
||||
В верху контекстного окна отображается количество выбранных тайтлов и их размер
|
||||
|
||||
* **Delete title** - удалить выбранные тайтлы
|
||||
* **Move title to MicroSD \ NAND** - переместить выбранные тайтлы в NAND или на карту памяти, в зависимости от того, где тайтл сейчас находится. Если части тайтла находятся и там и там, будут отображены оба варианта
|
||||
* **Reset required version** - сбросить проверку требуемой для запуска тайтла версии системы (должен быть включен дебаг в Atmosphere)
|
||||
* **Check integrity** - проверка целостности данных выбранных тайтлов
|
||||
* **Expose contents via MTP** - смонтировать содержимое выбранных тайтлов по MTP
|
||||
|
||||
Если нажать на тайтле кнопку **(A)**, то откроется детальное меню игры
|
||||
|
||||
### Детальное меню игры
|
||||
|
||||
![2021062719353600](https://user-images.githubusercontent.com/18294541/123554561-400cbc80-d789-11eb-8d81-e3403f33b365.jpg)
|
||||
|
||||
Отображается иконка игры, **TitleID**, название (**name**), автор (**Author**), версия (**Version**), поддерживаемые языки (**Language**) и наличие LFS-мода (**LFS-mod**)
|
||||
|
||||
Так же здесь можно узнать количество времени, проведённого в игре (**Total play time**), сколько раз игра была запущена (**Total launches**), сколько она весит (в целом (**Total occupied space**), а так же сколько места занимает в NAND (**Space in NAND**) и на SD (**Space on MicroSD**)), размер сохранений (**Total saves size**) и какой язык у игры активен (**Forced Language**)
|
||||
|
||||
#### Контекстное меню записи
|
||||
|
||||
![2021062719354800](https://user-images.githubusercontent.com/18294541/123554565-41d68000-d789-11eb-9c59-621275895075.jpg)
|
||||
|
||||
Отображается при нажатии на **(+)** на выбранных записях
|
||||
|
||||
В верху контекстного окна отображается количество выбранных записей и их размер
|
||||
|
||||
* **Delete record** - удалить выбранную запись
|
||||
* **Move records to MicroSD \ NAND** - переместить выбранную запись в NAND или на карту памяти, в зависимости от того, где она сейчас находится. Если части тайтла находятся и там и там, будут отображены оба варианта
|
||||
* **Reset required version** - сбросить проверку требуемой для запуска тайтла версии системы (должен быть включен дебаг в Atmosphere)
|
||||
* **Force language** - позволяет принудительно запускать игру с выбранным языком. По-умолчанию игра запускается с тем же языком, что выбран в системе, ежели такового в игре нет, то в зависимости от региона консоли. Выбранный язык будет отображаться рядом с иконкой игры в поле **Forced Language**
|
||||
* **Check integrity** - проверка целостности данных выбранных тайтлов
|
||||
* **Expose contents via MTP** - смонтировать содержимое выбранных тайтлов по MTP
|
||||
|
||||
### Cleanup orphaned files
|
||||
**Cleanup orphaned files** автоматически чистит ненужные файлы игр, файлы от прерванных установок игр, скачанное (официально) обновление OFW прошивки и все неиспользуемые тикеты игр, если они были найдены.
|
||||
|
||||
### Browse tickets
|
||||
Просмотр и удаление ненужных тикетов игр. **Ticket (или encrypted title key)** — это специальная зашифрованная уникальная информация о правах запуска на контент игры, которая устанавливается в систему при инсталляции каждой игры (000 в конце titleID) / обновления (800 в конце titleID) / каждого DLC. + означает наличие установленной игры, **[c]** — common-тикет (установленного дампа игры либо обновления), **[p]** — personalized-тикет (купленной в eShop игры)
|
||||
Просмотр и удаление ненужных тикетов игр. **Ticket (или encrypted title key)** — это специальная зашифрованная уникальная информация о правах запуска на контент игры, которая устанавливается в систему при инсталляции каждой игры (**000** в конце titleID) / обновления (**800** в конце titleID) / каждого DLC.
|
||||
|
||||
Иногда, если возникают спец. ошибки (например), и вы точно знаете и уверены, что вы делаете, его можно удалить у конкретной игры и её обновления / DLC.
|
||||
* **+** означает наличие установленной игры
|
||||
* **[c]** — common-тикет (установленного дампа игры либо обновления)
|
||||
* **[p]** — personalized-тикет (купленной в eShop игры)
|
||||
|
||||
Иногда, если возникают специфическая ошибка, и вы точно знаете и уверены, что вы делаете, его можно удалить у конкретной игры и её обновления / DLC.
|
||||
Во всех остальных случаях лучше тут ничего не трогать, во избежание ошибок запуска игр.
|
||||
|
||||
#### Контекстное меню тикетов
|
||||
|
||||
Отображается при нажатии на **(+)** на выбранных тикетах
|
||||
|
||||
В верху контекстного окна отображается количество выбранных тикетов
|
||||
|
||||
* **Delete tickets** - удалить выбранные тикеты
|
||||
* **Select same game** - выделить все тикеты, относящиеся к выделенной игре
|
||||
|
||||
### Browse saves
|
||||
|
||||
Просмотр и удаление сохранений.
|
||||
|
||||
Жёлтым цветом выделены сохранения для удалённых игр.
|
||||
|
||||
#### Контекстное меню сохранений
|
||||
|
||||
Отображается при нажатии на **(+)** на выбранных сохранениях
|
||||
|
||||
В верху контекстного окна отображается количество выбранных сохранений
|
||||
|
||||
* **Delete saves** - удалить выбранные тикеты
|
||||
* **Select same game** - выделить все тикеты, относящиеся к выделенной игре
|
||||
* **Select all uninstalled** - выделить все сохранения для удалённых игр
|
||||
|
||||
### Run MTP responder
|
||||
**Run MTP responder** включает встроенный в dbi MTP-сервер для обмена данными с ПК либо к Android-устройству по USB-C OTG (телефон/планшет/прочие устройства). *Горячая клавиша для вызова этой опции из главного меню*: кнопка **X** (ей же выходить из MTP). После подключения USB-провода к ПК и запуска MTP-сервера в dbi, на ПК появится следующее окно:
|
||||
|
||||
@ -168,26 +264,17 @@ switch:{SHA}N/omUzCtg+qoee+x4ttjgIls9jk=
|
||||
|
||||
Где:
|
||||
1: **External SD Card**, для просмотра, копирования и удаления файлов и папок c/на ПК и с/на карту памяти microSD
|
||||
|
||||
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: **MicroSD install**
|
||||
Скопируйте в эту папку ваши **NSP** или **NSZ**. По окончанию копирования игра будет установлена на **карту памяти** вашей приставки. При установке NSZ-файлов учитывайте, что их фактический размер может сильно отличаться от размера после установки, так что если при наличии свободных 2Гб на карте памяти у вас, например, не хватает места для установки NSZ размером, скажем, в 1Гб, не удивляйтесь, поскольку контейнер NSZ - сжатый.
|
||||
|
||||
6: **NAND install**: Скопируйте в эту папку ваши **NSP** или **NSZ**. По окончанию копирования игра будет установлена во **внутреннюю память** вашей приставки. При установке 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, а также количеством игровых сохранений:
|
||||
@ -222,7 +309,6 @@ Exit — выход из программы в HOS, минуя hbmenu, либо
|
||||
* **WARNING! Extra buffers exceeded**, при установке через MTP — запустите dbi через тайтл = через любую игру, удерживая кнопку R при её запуске; альтернативно — через NSP-форвардер, и использовать более быструю microSD-карту с другим USB-кабелем/портом.
|
||||
* **No tickets found but they are required** — некорректный (неполный, без тикета но с titlerights) дамп игры, найдите другой.
|
||||
* **SOME CONTENTS ARE MISSING. APPLICATION WILL BE UNUSABLE** — контейнер неполный, проверьте целостность установочного файла игры.
|
||||
|
||||
## dbi.config
|
||||
Файл dbi.config был добавлен, начиная с версии 253. Он находится рядом с DBI.nro, и заменяет прежние файлы-флаги dbi.default.ascii и dbi.network.config, а также добавляет несколько новых опций для удобной кастомизации настроек под пользователя.
|
||||
|
||||
@ -231,12 +317,13 @@ Exit — выход из программы в HOS, минуя hbmenu, либо
|
||||
; General settings
|
||||
[General]
|
||||
; Use libnx's default font for ASCII symbols
|
||||
DefaultASCII=true
|
||||
DefaultASCII=false
|
||||
; Use libusbhsfs for access to USB mass storage drives connected to switch or dock
|
||||
UseLibUsbHsFS=true
|
||||
; Direct exit to homescreen
|
||||
ExitToHomeScreen=false
|
||||
|
||||
|
||||
; Visibility of main menu items
|
||||
[MainMenu]
|
||||
; Browse and install files from MicroSD card
|
||||
@ -254,15 +341,24 @@ BrowseApps=true
|
||||
; Clean up files left from bad installs/old updates/unused tickets and so on
|
||||
Cleanup=true
|
||||
; View where you can view or delete installed tickets
|
||||
Tickets=true
|
||||
Tickets=false
|
||||
; View where you can view or delete game saves
|
||||
Saves=true
|
||||
; MTP responder
|
||||
MTP=true
|
||||
|
||||
|
||||
[Applications]
|
||||
; Whether check or not LFS mod size
|
||||
CalculateLFSSize=true
|
||||
|
||||
|
||||
; Install options
|
||||
[Install]
|
||||
; Check NCA hash during install
|
||||
CheckHash=true
|
||||
|
||||
|
||||
; MTP options
|
||||
[MTP]
|
||||
; Log all files, id disabled transfer shows only for files >= 4M
|
||||
@ -274,13 +370,16 @@ ShowMAC=true
|
||||
; Show user defined shortcuts to MircoSD folders as separate storages
|
||||
CustomStorages=true
|
||||
; Enable NAND install if run in emunand
|
||||
EnableNANDInstallOnEmunand=true
|
||||
EnableNANDInstallOnEmunand=false
|
||||
; Turn screen off on start MTP mode
|
||||
TurnOffScreen=false
|
||||
|
||||
|
||||
; Enable or disable various MTP storages
|
||||
[MTP Storages]
|
||||
1: External SD Card=true
|
||||
2: Nand USER=true
|
||||
3: Nand SYSTEM=true
|
||||
2: Nand USER=false
|
||||
3: Nand SYSTEM=false
|
||||
4: Installed games=true
|
||||
5: MicroSD install=true
|
||||
6: NAND install=true
|
||||
@ -288,11 +387,13 @@ EnableNANDInstallOnEmunand=true
|
||||
8: Album=true
|
||||
9: Gamecard=true
|
||||
|
||||
|
||||
; Network install sources
|
||||
[Network sources]
|
||||
; <display name>=<type>|<URL>
|
||||
; Home server=ApacheHTTP|http://192.168.1.47/Nintendo/Switch/
|
||||
|
||||
|
||||
[MTP custom storages]
|
||||
; <display name>=<path>
|
||||
; Homebrew=sdmc:/switch
|
||||
@ -319,14 +420,19 @@ EnableNANDInstallOnEmunand=true
|
||||
* **MTP** - пункт "**Run MTP responder**, для запуска MTP
|
||||
|
||||
### Install
|
||||
|
||||
* **CheckHash** — при **true** проверяются хеши .nca-файлов при установке игр на Switch, при false нет.
|
||||
|
||||
### Applications
|
||||
* **CalculateLFSSize** — включает или отключает подсчёт размера установленных LFS-модов. Если включено, может повлиять на скорость открытия меню "*Browse installed applications*"
|
||||
|
||||
### MTP
|
||||
* **LogAllFiles** — **false** выключает логирование файлов меньше 4Мб при работе с MTP, при **true** логируются все файлы.
|
||||
* **ShowCombinedNSPInInstalledGames** — **false** выключает показ комбинированных (multi-title .NSP-file) тайтлов.
|
||||
* **ShowMACInInstalledGames** — **false** выключает показ виртуальной директории **«Mods & cheats»** в пункте Installed games в MTP, перенаправляющей по пути `/atmosphere/contents/%titleid_игры%` на карту памяти.
|
||||
* **CustomStorages** - отображать или спрятать кастомные пункты меню, прописанные в секции **MTP custom storages**
|
||||
* **EnableNANDInstallOnEmunand** - разрешает или запрещает установку игр в NAND файлового EmuNAND (не актуально после выхода Atmosphere 0.19.3)
|
||||
* **TurnOffScreen** - отключать или нет экран консоли при подключении её в режиме MTP
|
||||
|
||||
### [MTP Storages](#run-mtp-responder)
|
||||
Показ соответствующих элементов при работе MTP Responder с ПК/Android, по умолчанию все пункты включены для отображения.
|
||||
@ -344,16 +450,33 @@ EnableNANDInstallOnEmunand=true
|
||||
|
||||
## Другие возможности
|
||||
|
||||
### Монтирование содержимолго установленных игр по MTP
|
||||
### Монтирование содержимого установленных игр по MTP
|
||||
|
||||
Перейдите в "*Browse installed applications*" -> Выберите необходимые игры кнопкой `X` -> Нажмите `A` -> "*Mount contents via MTP*"
|
||||
Перейдите в "*Browse installed applications*" -> Выберите необходимые игры кнопкой `X` -> Нажмите `(+)` -> "*Expose contend via MTP*"
|
||||
|
||||
### Бекап и восстановление сохранений
|
||||
|
||||
1. Подключите приставку в режиме MTP по DBI
|
||||
2. Перейдите в папку **Saves** на вашем ПК
|
||||
3. Вы можете как скопировать сейвы на ПК, так и восстановить их, просто перетянув в эту папку
|
||||
|
||||
### Использование DBI для установки модификаций:
|
||||
1. Подключите приставку в режиме MTP по DBI
|
||||
1. Перейдите в **Installed Games**, в папку с названием вашей игры
|
||||
1. Перейдите в папку **Mods & Cheats**
|
||||
1. Поместите в папку **Mods & Cheats** ваш мод
|
||||
* **Будьте внимательны**, вам нужно класть не саму папку с titleID игры, а её содержимое! Например, вы скачали перевод для игры Cadence of Hyrule, в виде архиве `Cadence of Hyrule.rar`. Внутри этого архива вы видите папку с TitleID игры - `01000B900D8B0000`. Вам нужно распаковать архив, перейти в папку `01000B900D8B0000` и скопировать всё содержимое папки в **Mods & Cheats**! Не саму папку `01000B900D8B0000`, а всё то, что в ней находится! В данном примере, папку `romfs`
|
||||
1. **Будьте внимательны**, вам нужно класть не саму папку с 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
|
||||
```
|
||||
|
||||
|
||||
|
||||
## Благодарности
|
||||
Спасибо [SciresM](https://github.com/SciresM) за [hactool](https://github.com/SciresM/hactool) (лицензия [ISC](https://ru.wikipedia.org/wiki/%D0%9B%D0%B8%D1%86%D0%B5%D0%BD%D0%B7%D0%B8%D1%8F_ISC)) - DBI использует некоторые структуры данных, взятые оттуда
|
||||
|
158
README_ENG.md
158
README_ENG.md
@ -12,12 +12,19 @@ The ultimate solution for NSP/NSZ/XCI installation along with many more advanced
|
||||
1. [Installation](#installation)
|
||||
1. [Usage](#usage)
|
||||
1. [Interface](#interface)
|
||||
1. [Buttons](#buttons)
|
||||
1. [Browse SD Card / Browse USB0 Drive](#browse-sd-card--browse-usb0-drive)
|
||||
1. [Install title from USB](#install-title-from-usb)
|
||||
1. [Home server](#home-server)
|
||||
1. [Browse installed applications](#browse-installed-applications)
|
||||
* [Titles Context menu](#titles-context-menu)
|
||||
* [Detailed game menu](#detailed-game-menu)
|
||||
* [Records Context menu](#records-context-menu)
|
||||
1. [Cleanup orphaned files](#cleanup-orphaned-files)
|
||||
1. [Browse tickets](#browse-tickets)
|
||||
* [Tickets Context menu](#tickets-context-menu)
|
||||
1. [Browse saves](#browse-saves)
|
||||
* [Saves Context menu](#saves-context-menu)
|
||||
1. [Run MTP responder](#run-mtp-responder)
|
||||
1. [Exit](#exit)
|
||||
1. [Errors and warnings](#errors-and-warnings)
|
||||
@ -52,12 +59,28 @@ The bottom left corner of DBI displays the total amount of data on your currentl
|
||||
|
||||
Bottom center (dbi: XXX) is the DBI version number - you should always use the most recent version.
|
||||
|
||||
### Buttons
|
||||
|
||||
* **(А)** - select, confirm
|
||||
|
||||
* **(B)** - cancel. **On the main screen** - exit the program
|
||||
|
||||
* **(X)** - file selection. **On the main screen** - hotkey for mounting MTP (menu item "**Run MTP responder**")
|
||||
|
||||
* **(Y)** - invert selection, select everything if nothing is selected. **On the main screen** - installation via USB using dbibackend (menu item "**Install title from USB **")
|
||||
* **(ZL)**, **(ZR)** - fast movement through the menu
|
||||
* **(L)** - **on the main screen** - (menu item "**Browse installed applications**")
|
||||
* **(R)** - change the order of displaying files / 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
|
||||
|
||||
Select this option if you want to install games, updates and DLC from files that exist on your SD card or 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 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 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)
|
||||
|
||||
@ -145,30 +168,100 @@ switch:{SHA}N/omUzCtg+qoee+x4ttjgIls9jk=
|
||||
|
||||
### 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). *Main menu hotkey for this option*: **L** button:
|
||||
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).
|
||||
|
||||
![2021041012101400](https://user-images.githubusercontent.com/18294541/114264832-e3093200-99f5-11eb-9e7a-acc7b0f7444c.jpg)
|
||||
*Main menu hotkey for this option*: **L** button:Сверху в центре написано общее количество установленных игр и тип сортировки
|
||||
|
||||
The total number of installed applications (e.g. games and homebrew nsps) is displayed at the top of the screen. The first character denotes the installation location: **S** for microSD, **N** for NAND and **M** for mixed (e.g. base game installed to NAND, update installed to microSD)
|
||||
At the top in the center, the total number of installed games and the type of sorting are written
|
||||
|
||||
All installed data can be transferred between internal NAND and SD card, it is possible to individually select and uninstall multiple games **(b)** / updates **(u)** / DLC **(d)** together with their associated LayeredFS mods **(l)** (detected at `/atmosphere/contents/`) or you can individually select updates and DLC for deletion. The **Reset Required version** function will force restore the system update check for the selected game back to base (this is also done automatically with installation or removal of game updates):
|
||||
![2021062719353200](https://user-images.githubusercontent.com/18294541/123554546-32efcd80-d789-11eb-8d3f-3124448624e0.jpg)
|
||||
|
||||
![2021041012102700](https://user-images.githubusercontent.com/18294541/114264843-f74d2f00-99f5-11eb-8cf0-a3fc383ac322.jpg)
|
||||
In square brackets before the name of the game, basic information about the installation location, composition and availability of the game mod is written. Only what is installed is displayed. That is, if the letter b is not in square brackets, then the game itself does not have the base part installed (in this case, the line will be colored red)
|
||||
|
||||
By pressing the **R** button you can sort the game list as you prefer - alphabetically (default) or by last usage.
|
||||
Press the **A** button to enter the menu of the selected game, the **-** button deletes the game and its (non-personalized) ticket, the D-pad selects games, the left stick scrolls through the list of games and the **ZR** and **ZL** buttons flip through the list of games screen by screen.
|
||||
* **N / S / M** - NAND / SD / Mixed - means the place where the game is installed. If parts of the game are on different media, Mixed is displayed
|
||||
* **b** - BASE - the game itself
|
||||
* **u** - Update - update the game
|
||||
* **d** - DLC
|
||||
* **l** - LayeredFS mod - the presence of modifications, cheats or translation
|
||||
|
||||
You can also check (verify) games for their integrity by selecting the file to check and then selecting **Check integrity**
|
||||
**Please note!** If the game is **highlighted in red**, then its base part is not installed, but only an update or DLC is installed
|
||||
|
||||
#### Title context menu![2021062719354100](https://user-images.githubusercontent.com/18294541/123554557-3b480880-d789-11eb-9235-d547f2c588bd.jpg)
|
||||
|
||||
Displayed by clicking on **(+)** on the selected titles (or title)
|
||||
|
||||
* **Delete title** - delete selected titles
|
||||
* **Move title to MicroSD \ NAND** - move the selected titles to NAND or to a memory card, depending on where the title is currently located. If title parts are both there and there, both options will be displayed
|
||||
* **Reset required version** - reset the check of the system version required to run the title (debug must be enabled in Atmosphere)
|
||||
* **Check integrity** - checking the data integrity of the selected titles
|
||||
* **Expose contents via MTP** - mount the content of the selected titles by MTP
|
||||
|
||||
If you press the **(A)** button on the title, the detailed game menu will open
|
||||
|
||||
### Detailed game menu
|
||||
|
||||
![2021062719353600](https://user-images.githubusercontent.com/18294541/123554561-400cbc80-d789-11eb-8d81-e3403f33b365.jpg)
|
||||
|
||||
Game icon, **TitleID**, title (**name**), author (**Author **), version (**Version **), supported languages (**Language **) and availability of LFS- mod (**LFS-mod **)
|
||||
|
||||
Here you can also find out the amount of time spent in the game (**Total play time **), how many times the game was launched (**Total launches **), how much it weighs (in general (**Total occupied space **) , as well as how much space it takes in NAND (**Space in NAND **) and on SD (**Space on MicroSD **)), the size of the saves (**Total saves size **) and what language the game has active ( **Forced Language **)
|
||||
|
||||
#### Records context menu
|
||||
|
||||
![2021062719354800](https://user-images.githubusercontent.com/18294541/123554565-41d68000-d789-11eb-9c59-621275895075.jpg)
|
||||
|
||||
isplayed by clicking on **(+) ** on selected records
|
||||
|
||||
The top of the context window displays the number of selected records and their size
|
||||
|
||||
* **Delete record** - delete selected entry
|
||||
* **Move records to MicroSD \ NAND** - move the selected entry to NAND or to a memory card, whichever is where it is currently located. If title parts are both there and there, both options will be displayed
|
||||
* **Reset required version** - reset the check of the system version required to run the title (debug must be enabled in Atmosphere)
|
||||
* **Force language** - allows you to force the game to start in the selected language. By default, the game starts with the same language that is selected in the system, if there is none in the game, then depending on the region of the console. The selected language will be displayed next to the game icon in the **Forced Language ** field
|
||||
* **Check integrity** - checking the data integrity of the selected titles
|
||||
* **Expose contents via MTP** - mount the content of the selected titles by MTP
|
||||
|
||||
### 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.
|
||||
|
||||
### Browse tickets
|
||||
View and delete game tickets. **Ticket (or encrypted title key)** is 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 titleID) / update (800 at the end of titleID) / each DLC. + means the presence of an installed game, **[c]** - common-ticket (installed game dump or update), **[p]** - personalized-ticket (game purchased from the eShop)
|
||||
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.
|
||||
|
||||
You may be able to resolve certain errors with this for example if you know exactly what you are doing. You can remove individual tickets from a specific game and/or its update/DLC.
|
||||
* **+** means there is an installed game
|
||||
* **[c]** — common-ticket (installed game dump or update)
|
||||
* **[p]** — personalized ticket (purchased from the game eShop)
|
||||
|
||||
In most case it's better not to touch anything here in order to avoid errors in starting games.
|
||||
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.
|
||||
|
||||
In all other cases, it is better not to touch anything here, in order to avoid errors in starting games.
|
||||
|
||||
|
||||
#### Tickets context menu
|
||||
|
||||
Displayed by clicking on **(+) ** on selected tickets
|
||||
|
||||
* The number of selected tickets is displayed at the top of the context window
|
||||
|
||||
***Delete tickets** - delete selected tickets
|
||||
|
||||
* **Select same game** - highlight all tickets related to the selected game
|
||||
|
||||
### Browse saves
|
||||
|
||||
View and delete saves.
|
||||
|
||||
Saves for deleted games are highlighted in yellow.
|
||||
|
||||
#### Saves context menu
|
||||
|
||||
Displayed by clicking on **(+) ** on selected saves
|
||||
|
||||
The number of selected saves is displayed at the top of the context window
|
||||
|
||||
* **Delete saves** - delete selected tickets
|
||||
* **Select same game** - highlight all tickets related to the selected game
|
||||
* **Select all uninstalled** - select all saves for remote games
|
||||
|
||||
### 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:
|
||||
@ -229,7 +322,6 @@ Exit - closes DBI and returns to either to hbmenu or bypasses hbmenu to go direc
|
||||
* **WARNING! Extra buffers exceeded**, when installing via MTP - try to run DBI in application mode (title override) holding the R button while launching a title or alternatively via NSP forwarder and use a faster microSD card with a different USB cable / port.
|
||||
* **No tickets found but they are required** — incorrect (incomplete, no ticket but with titlerights) dump of the game, use another one.
|
||||
* **SOME CONTENTS ARE MISSING. APPLICATION WILL BE UNUSABLE** — container is incomplete, check the integrity of the game installation file.
|
||||
|
||||
## 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.
|
||||
|
||||
@ -238,7 +330,7 @@ Let's take a look at its contents:
|
||||
; General settings
|
||||
[General]
|
||||
; Use libnx's default font for ASCII symbols
|
||||
DefaultASCII=true
|
||||
DefaultASCII=false
|
||||
; Use libusbhsfs for access to USB mass storage drives connected to switch or dock
|
||||
UseLibUsbHsFS=true
|
||||
; Direct exit to homescreen
|
||||
@ -261,10 +353,18 @@ BrowseApps=true
|
||||
; Clean up files left from bad installs/old updates/unused tickets and so on
|
||||
Cleanup=true
|
||||
; View where you can view or delete installed tickets
|
||||
Tickets=true
|
||||
Tickets=false
|
||||
; View where you can view or delete game saves
|
||||
Saves=true
|
||||
; MTP responder
|
||||
MTP=true
|
||||
|
||||
|
||||
[Applications]
|
||||
; Whether check or not LFS mod size
|
||||
CalculateLFSSize=true
|
||||
|
||||
|
||||
; Install options
|
||||
[Install]
|
||||
; Check NCA hash during install
|
||||
@ -281,7 +381,9 @@ ShowMAC=true
|
||||
; Show user defined shortcuts to MircoSD folders as separate storages
|
||||
CustomStorages=true
|
||||
; Enable NAND install if run in emunand
|
||||
EnableNANDInstallOnEmunand=true
|
||||
EnableNANDInstallOnEmunand=false
|
||||
; Turn screen off on start MTP mode
|
||||
TurnOffScreen=false
|
||||
|
||||
; Enable or disable various MTP storages
|
||||
[MTP Storages]
|
||||
@ -328,12 +430,17 @@ Shows the corresponding menu items.
|
||||
### Install
|
||||
* **CheckHash** — if **true**, hashes of .nca files are checked when installing games on the Switch, if **false**, no.
|
||||
|
||||
### Applications
|
||||
|
||||
* **CalculateLFSSize** — включает или отключает подсчёт размера установленных LFS-модов. Если включено, может повлиять на скорость открытия меню "*Browse installed applications*"
|
||||
|
||||
### 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.
|
||||
* **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.
|
||||
* **CustomStorages** - show or hide storages, listed on **MTP custom storages** section
|
||||
* **EnableNANDInstallOnEmunand** - allows or denies the installation of games in NAND file EmuNAND (not relevant after the release of Atmosphere 0.19.3)
|
||||
* **TurnOffScreen** - отключать или нет экран консоли при подключении её в режиме MTP
|
||||
|
||||
### [MTP Storages](#run-mtp-responder)
|
||||
Show relevant items when MTP Responder is running on PC / Android, by default all items are enabled for display.
|
||||
@ -352,7 +459,13 @@ In MTP mode, a `Homebrew` folder will appear, referring to the` switch` folder o
|
||||
## Other possibilities
|
||||
|
||||
### Mounting the content of installed titles via MTP
|
||||
Go to "*Browse installed applications*" -> Choose apps you need to mount with `X` -> Press `A` -> "*Mount contents via MTP*"
|
||||
Go to "*Browse installed applications*" -> Choose apps you need to mount with `X` -> Press `+` -> "*Expose contents via MTP*"
|
||||
|
||||
### Backup and restore saves
|
||||
|
||||
1. Connect the set-top box in MTP mode via DBI
|
||||
2. Go to **Saves ** folder on your PC
|
||||
3. You can either copy the saves to your PC or restore them by simply dragging them into this folder
|
||||
|
||||
### Using DBI to Install Mods:
|
||||
1. Connect the set-top box in MTP mode via DBI
|
||||
@ -361,5 +474,14 @@ Go to "*Browse installed applications*" -> Choose apps you need to mount with `X
|
||||
1. Place your mod in the **Mods & Cheats** folder
|
||||
* **Be careful**, you need to put not the folder with the titleID of the game, but its contents! For example, you have downloaded the translation for the game Cadence of Hyrule, in the form of the archive `Cadence of Hyrule.rar`. Inside this archive you see a folder with the TitleID of the game - `01000B900D8B0000`. You need to unpack the archive, go to the folder `01000B900D8B0000` and copy the entire contents of the folder to **Mods & Cheats**! Not the folder `01000B900D8B0000` itself, but everything that is in it! In this example, the `romfs` folder
|
||||
|
||||
### 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`:
|
||||
|
||||
```
|
||||
[usb]
|
||||
usb30_force_enabled = u8!0x1
|
||||
```
|
||||
|
||||
## Acknowledgements
|
||||
Thanks to [SciresM](https://github.com/SciresM) for [hactool](https://github.com/SciresM/hactool) (licensed under [ISC](https://en.wikipedia.org/wiki/ISC_license)) - DBI uses some data struct definitions from there
|
||||
|
Loading…
Reference in New Issue
Block a user