BotW Save Manager Switch: Difference between revisions

BotW Save Manager
BotW Save Manager
General
Author	DeltaJordan
Type	Save Editors and Converters
Version	2.0-alpha
License	MIT License
Last Updated	2023/06/08
Links
	Download
	Website
	Source

Latest revision as of 04:13, 6 July 2023

The BotW Save Manager is a tool designed for managing save files for the game "The Legend of Zelda: Breath of the Wild". It allows you to convert save files between the Nintendo Switch and Wii U versions of the game, as long as they share the same update version.

The BotW Save Manager is a fork of WemI0's BOTW_SaveConv, updated to DotNET 6 with full support for Windows and Linux.

Note: This tool is not a save editor. If you are looking to edit your save, use Marc Robledo's BOTW save editor to modify the contents of your save. This works for both WiiU and Switch files.

Installation

Download and install the DotNET 6.0 Runtime for your system: Windows x64 or Linux.

Download the latest release of BotwSaveEditor.

Run BotwSaveEditor.exe and bypass the smartscreen warning (This warning is caused by the unsigned .exe. Signing applications can become expensive, so it is impractical for community project such as this).

User guide

Desktop Application

Normal Method:

To open a save, use File > Open Save Folder (Ctrl + O) or double click the UI to browse for a WiiU or Switch save folder; alternatively, drag the save folder over the UI.
Once the save has opened, click Convert and browse for an empty folder to save the converted files to.
A debug log will appear and log the converting process.
Once it has completed, and there are no errors, a prompt will appear saying the conversion was successful.

Quick Method:

Quickly convert a save by using File > Convert Save (F3) and navigating to a WiiU or Switch save folder.
In the second folder selection prompt, browse for an empty folder to save the converted files to.
A debug log will appear and log the converting process.
Once it has completed, and there are no errors, a prompt will appear saying the conversion was successful.

Console Application

Drag and drop a WiiU or Switch save folder over the console window as prompted.
Wait for the save to process, then drag an empty folder over the console window to save the converted files to.
Wait once more for the completion message.

Screenshots

Changelog

v2.0-alpha 2023/06/08

Major Update v2.0 (alpha):
- Updates the UI with the changes included in #17 (thanks @ArchLeaders).
- Note: This is a prerelease as I have not tested this in Windows yet. The linux releases have been tested and seem to work.
What's Changed:
- Full Rewrite with Linux and (theoretically) MacOS Support by @ArchLeaders in #17.
- Fix broken links by @laralove143 in #21.

v1.1.4 2020/10/09

Added the ability to skip version checking for the Wii U.
Added more logging to trace errors better.
Added a check for if the save folder is null.
Fixed Save class not saving path before passing errors.

v1.1.3 2019/03/24

Merge pull request #3 from xombiemp/master.
Fix Hero's Path file conversion.

v1.1.2.1 2019/01/18

Logs should be much more detailed during a crash that occurs when writing a save file. Alerts raised to users should be much more clear on what went wrong.

v1.1.2 2019/01/16

Fixed error stacktraces not printing in logs.

v1.1.1 2018/12/14

Added proper logging to help me fix people's issues.
- Added some neat ASCII art I generated using Picascii when the save successfully converts and writes cause I have to have some fun sometimes.
Added a help dialog to hopefully clear up a potentially unclear step of selecting the save folder.
Note that the .Net Core version hasn't been updated with these changes yet; I will work on that for a later update, especially considering that no one has yet reported any issues with that version.

v1.1.0 2018/06/05

The UI version has a more compact look to it, removed pointless tabs since save editing is not planned.
Fixed all "*.sav" files repeatedly overwriting option.sav only. This has been tested by me with v1.4 and v1.5 saves, plus DLC.
Version checking now works properly, tested with the same above save versions. Writes a list in both types of apps that corresponds to the number of the save folder.
Miscellaneous code cleanup and bug fixes.

v1.0.3 2018/05/13

Fixed Switch saves reading as invalid.

v1.0.2 2018/05/09

Prerelease, untested. Testing help would be much appreciated, I don't have BotW for the Wii U and my Switch does not currently have a method to flash/dump saves.

v1.0.1 2018/05/08

Has support for:
- Switch to Wii U conversion.
- Wii U to Switch conversion.
- Displaying versions before conversion.
Make sure both versions of BotW have the same update version.

External links

@@ Line 1: / Line 1: @@
 {{Infobox Switch Homebrews
 |title=BotW Save Manager
-|image=botwsavemanagerswitch.png
+|image=botwsavemanagernx.png
-|description=A compilation of console savegame editors made with HTML5 technologies.
+|description=BOTW Save Manager for Switch and Wii U.
-|author=marcrobledo
+|author=DeltaJordan
 |lastupdated=2023/06/08
-|type=Save and Game Managers
+|type=Save Editors and Converters
 |version=2.0-alpha
 |license=MIT
-|download=https://dlhb.gamebrew.org/switchhomebrews/botwsavemanagerswitch.7z
+|download=https://dlhb.gamebrew.org/switchhomebrews/botwsavemanagernx.7z
 |website=https://gbatemp.net/threads/botw-save-manager-cross-platform-command-line-windows-only-ui.503222/
 |source=https://github.com/DeltaJordan/BotW-Save-Manager
 |donation=
 }}
-{{#seo:
+The BotW Save Manager is a tool designed for managing save files for the game "The Legend of Zelda: Breath of the Wild". It allows you to convert save files between the Nintendo Switch and Wii U versions of the game, as long as they share the same update version.
-|title=Switch Homebrew Apps (Save and Game Managers) - GameBrew
-|title_mode=append
+The BotW Save Manager is a fork of WemI0's [https://github.com/WemI0/BOTW_SaveConv BOTW_SaveConv], updated to DotNET 6 with full support for Windows and Linux.
-|image=botwsavemanagerswitch.png
-|image_alt=BotW Save Manager
+'''Note:''' This tool is not a save editor. If you are looking to edit your save, use Marc Robledo's [https://www.marcrobledo.com/savegame-editors/zelda-botw/ BOTW save editor] to modify the contents of your save. This works for both WiiU and Switch files.
-}}
-The BotW Save Manager is a tool designed for managing save files for the game "The Legend of Zelda: Breath of the Wild". It allows users to convert save files between the Nintendo Switch and Wii U versions of the game, as long as they share the same update version. It is important to note that this tool is not a save editor, meaning it does not allow you to modify the contents of your save files.
+==Installation==
+Download and install the DotNET 6.0 Runtime for your system: [https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-6.0.10-windows-x64-installer Windows x64] or [https://learn.microsoft.com/dotnet/core/install/linux?WT.mc_id=dotnet-35129-website Linux].
-The BotW Save Manager is a fork of WemI0's BOTW_SaveConv, updated to use the DotNET 6 framework, with full support for both Windows and Linux operating systems.
+Download the [https://github.com/DeltaJordan/BotW-Save-Manager/releases latest release] of BotwSaveEditor.
-== Setup ==
+Run <code>BotwSaveEditor.exe</code> and bypass the smartscreen warning (This warning is caused by the unsigned .exe. Signing applications can become expensive, so it is impractical for community project such as this).
-# Download and install the DotNET 6.0 Runtime for your system: [https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-6.0.10-windows-x64-installer Windows x64] or [https://learn.microsoft.com/dotnet/core/install/linux?WT.mc_id=dotnet-35129-website Linux]
-# Download the [https://github.com/DeltaJordan/BotW-Save-Manager/releases latest release] of BotwSaveEditor.
-# Run <code>BotwSaveEditor.exe</code> and bypass the smartscreen warning. ''(This warning is caused by the unsigned '''.exe'''. Signing applications can become expensive, so it is impractical for community project such as this.)''
-== Usage ==
+== User guide ==
 === Desktop Application ===
 '''Normal Method:'''
-# To open a save, use <code>File &gt; Open Save Folder (Ctrl + O)</code> or double click the UI to browse for a WiiU or Switch save folder; alternatively, drag the save folder over the UI.
+* To open a save, use <code>File &gt; Open Save Folder (Ctrl + O)</code> or double click the UI to browse for a WiiU or Switch save folder; alternatively, drag the save folder over the UI.
-# Once the save has opened, click <code>Convert</code> and browse for an empty folder to save the converted files to.
+* Once the save has opened, click <code>Convert</code> and browse for an empty folder to save the converted files to.
-# A debug log will appear and log the converting process.
+* A debug log will appear and log the converting process.
-# Once it has completed, and there are no errors, a prompt will appear saying the conversion was successful.
+* Once it has completed, and there are no errors, a prompt will appear saying the conversion was successful.
 '''Quick Method:'''
-# Quickly convert a save by using <code>File &gt; Convert Save (F3)</code> and navigating to a WiiU or Switch save folder.
+* Quickly convert a save by using <code>File &gt; Convert Save (F3)</code> and navigating to a WiiU or Switch save folder.
-# In the second folder selection prompt, browse for an empty folder to save the converted files to.
+* In the second folder selection prompt, browse for an empty folder to save the converted files to.
-# A debug log will appear and log the converting process.
+* A debug log will appear and log the converting process.
-# Once it has completed, and there are no errors, a prompt will appear saying the conversion was successful.
+* Once it has completed, and there are no errors, a prompt will appear saying the conversion was successful.
 === Console Application ===
-# Drag and drop a WiiU or Switch save folder over the console window as prompted.
+* Drag and drop a WiiU or Switch save folder over the console window as prompted.
-# Wait for the save to process, then drag an empty folder over the console window to save the converted files to.
+* Wait for the save to process, then drag an empty folder over the console window to save the converted files to.
-# Wait once more for the completion message.
+* Wait once more for the completion message.
+==Screenshots==
+https://dlhb.gamebrew.org/switchhomebrews/botwsavemanagernx4.png
+https://dlhb.gamebrew.org/switchhomebrews/botwsavemanagernx2.png
+https://dlhb.gamebrew.org/switchhomebrews/botwsavemanagernx3.png
+https://dlhb.gamebrew.org/switchhomebrews/botwsavemanagernx.png
 ==Changelog==
-'''v2.0-alpha'''
+'''v2.0-alpha 2023/06/08'''
-* Major Update v2.0 (alpha)
+* Major Update v2.0 (alpha):
-** Updates the UI with the changes included in #17 (thanks @ArchLeaders)
+** Updates the UI with the changes included in [https://github.com/DeltaJordan/BotW-Save-Manager/pull/17 #17] (thanks @ArchLeaders).
 ** Note: This is a prerelease as I have not tested this in Windows yet. The linux releases have been tested and seem to work.
-* What's Changed
+* What's Changed:
-** Full Rewrite with Linux and (theoretically) MacOS Support by @ArchLeaders in #17
+** Full Rewrite with Linux and (theoretically) MacOS Support by @ArchLeaders in [https://github.com/DeltaJordan/BotW-Save-Manager/pull/17 #17].
-** fix broken links by @laralove143 in #21
+** Fix broken links by @laralove143 in [https://github.com/DeltaJordan/BotW-Save-Manager/pull/21 #21].
-'''v1.1.4'''
+'''v1.1.4 2020/10/09'''
 * Added the ability to skip version checking for the Wii U.
 * Added more logging to trace errors better.
 * Added a check for if the save folder is null.
 * Fixed Save class not saving path before passing errors.
-'''v1.1.3'''
+'''v1.1.3 2019/03/24'''
-* Merge pull request #3 from xombiemp/master
+* Merge pull request #3 from xombiemp/master.
 * Fix Hero's Path file conversion.
-'''v1.1.2.1'''
+'''v1.1.2.1 2019/01/18'''
 *Logs should be much more detailed during a crash that occurs when writing a save file. Alerts raised to users should be much more clear on what went wrong.
-'''v1.1.2'''
+'''v1.1.2 2019/01/16'''
 *Fixed error stacktraces not printing in logs.
-'''v1.1.1'''
+'''v1.1.1 2018/12/14'''
 * Added proper logging to help me fix people's issues.
 ** Added some neat ASCII art I generated using Picascii when the save successfully converts and writes cause I have to have some fun sometimes.
 * Added a help dialog to hopefully clear up a potentially unclear step of selecting the save folder.
 * Note that the .Net Core version hasn't been updated with these changes yet; I will work on that for a later update, especially considering that no one has yet reported any issues with that version.
-'''v1.1.0'''
+'''v1.1.0 2018/06/05'''
 * The UI version has a more compact look to it, removed pointless tabs since save editing is not planned.
 * Fixed all "*.sav" files repeatedly overwriting option.sav only. This has been tested by me with v1.4 and v1.5 saves, plus DLC.
 * Version checking now works properly, tested with the same above save versions. Writes a list in both types of apps that corresponds to the number of the save folder.
-* Miscellaneous code cleanup and bug fixes
+* Miscellaneous code cleanup and bug fixes.
-'''v1.0.3'''
+'''v1.0.3 2018/05/13'''
-*Fixed Switch saves reading as invalid
+*Fixed Switch saves reading as invalid.
-'''v1.0.2'''
+'''v1.0.2 2018/05/09'''
 *Prerelease, untested. Testing help would be much appreciated, I don't have BotW for the Wii U and my Switch does not currently have a method to flash/dump saves.
-'''v1.0.1'''
+'''v1.0.1 2018/05/08'''
 * Has support for:
-** Switch to Wii U conversion
+** Switch to Wii U conversion.
-** Wii U to Switch conversion
+** Wii U to Switch conversion.
-** Displaying versions before conversion
+** Displaying versions before conversion.
-* Make sure both versions of BotW have the same update version
+* Make sure both versions of BotW have the same update version.
-'''v1.0'''
-* First Release.
 == External links ==
-* Gbatemp - https://gbatemp.net/threads/botw-save-manager-cross-platform-command-line-windows-only-ui.503222/
+* GitHub - https://github.com/DeltaJordan/BotW-Save-Manager
-* Github - https://github.com/DeltaJordan/BotW-Save-Manager
+* GBAtemp - https://gbatemp.net/threads/botw-save-manager-cross-platform-command-line-windows-only-ui.503222/