Virtual SD Card Guide: Difference between revisions

Improved clarity, and removed some stuff that doesn't apply anymore or was wrong
(Improved clarity, and removed some stuff that doesn't apply anymore or was wrong)
Line 4: Line 4:


== Creating a Virtual SD Card ==
== Creating a Virtual SD Card ==
It is recommend to create one with size at least 1 GB for large homebrew apps, for example, Project M, and no more than 2 GB for best compatibility as there are compatibility issues with some homebrew apps trying to run under an SDHC card on the real hardware.
It is recommend to create one with size at least 1 GB for large homebrew apps, for example, Project M, and no more than 2 GB for best compatibility as some games don't support SD cards larger than that.


As of {{revision|5.0-16891}}, Dolphin can also automatically generate SD cards if you set a specific folder, and it will automatically determine the size during this process.  This bypasses the need for third party programs.
As of {{revision|5.0-16891}}, Dolphin can automatically generate SD cards if you set a specific folder, and it will automatically determine the size during this process.  This bypasses the need for third party programs.


=== Using Dolphin's Built-in SD Card Generation ===
=== Using Dolphin's Built-in SD Card Generation ===
Line 26: Line 26:
=== Generating SD Cards with Third Party Tools ===
=== Generating SD Cards with Third Party Tools ===


If you're using older builds or simply prefer to use a Third Party tool for some reason, there are options for most operating systems.
If you're using an older version of Dolphin or simply prefer to use a Third Party tool for some reason, there are options for most operating systems.


==== Command Line and Executable Files ====
==== Command Line and Executable Files ====
Line 69: Line 69:
With Dolphin's built-in tools available in {{revision|5.0-16891}} or newer, you can simply <i>Convert File to Folder Now</i> and then change whatever you want directly in your operating system by opening that folder.  When you are done, simply <i>Convert Folder to File Now</i> to generate a new SD card.  Alternatively, you can use <i>Automatically sync with Folder on emulation start and end</i> to do this process automatically, but it will cause longer startup/closing time on Wii games.
With Dolphin's built-in tools available in {{revision|5.0-16891}} or newer, you can simply <i>Convert File to Folder Now</i> and then change whatever you want directly in your operating system by opening that folder.  When you are done, simply <i>Convert Folder to File Now</i> to generate a new SD card.  Alternatively, you can use <i>Automatically sync with Folder on emulation start and end</i> to do this process automatically, but it will cause longer startup/closing time on Wii games.


If you are stuck on older builds or simply wish to use other methods, there are ways to do this on most other operating systems.
If you're using an older version of Dolphin or simply wish to use other methods, there are ways to do this on most operating systems.


=== Linux ===
=== Linux ===
Line 100: Line 100:


== Usage ==
== Usage ==
=== With Homebrew App ===
=== With Homebrew Apps ===
The external files used for the homebrew app must be stored within '''sd.raw''' and the homebrew app itself (''boot.elf'' or ''boot.dol'') must exist outside of it for Dolphin to load. Project M, for example, will load from SD root ''\projectm\'' and Dolphin will need to launch Project M through ''\apps\projectm\boot.elf'', '''NOT''' in the virtual SD card. For convenience's sake, it is ideal to have same copies paralleled between inside and outside of the virtual SD card.
If you want to launch a homebrew app using Dolphin's game list or Open dialog, the ''boot.elf'' or ''boot.dol'' file for the homebrew app needs be stored outside of the SD card. Conversely, if you want to launch a homebrew app from the Homebrew Channel, you need to place the ''boot.elf'' or ''boot.dol'' file inside the virtual SD card [https://wiibrew.org/wiki/Homebrew_Channel#Configuring_Applications in the apps folder]. Either way, any other files used by the homebrew app must be placed inside the virtual SD card.
 
Though, it is possible to start homebrew app from virtual SD card through homebrew exploits for Wii.
 
The Wii game launcher app will only work if a particular Wii game is set as the default ISO. Within the Dolphin game list, open context menu (right-click) on any Wii game and click '''Set as default ISO'''. Do this before loading a homebrew app with Dolphin.


=== For Netplay ===
=== For Netplay ===


In {{revision|5.0-16891}} or newer, Dolphin can generate <i>deterministic</i> SD Cards for netplay!  If you have "Automatically sync with Folder on emulation start and end" enabled on all computers, and the folders have the same exact files in them (file creation dates do not matter, as they will be scrubbed during the process), the generated SD card will be identical.  Note that this <i>does not</i> sync any files - the folders on all computers must be identical.
In {{revision|5.0-16891}} or newer, Dolphin can generate <i>deterministic</i> SD Cards for netplay!  If you have "Automatically sync with Folder on emulation start and end" enabled on all computers, and the folders have the same exact files in them (file creation dates do not matter, as they will be scrubbed during the process), the generated SD card will be identical, preventing the SD card from causing desyncs.  Note that this <i>does not</i> sync any files - the folders on all computers must be identical.
 
If using an older build or not dealing with copyrighted content, we highly recommend just generating an SD card on one computer, and then copying that SD card to all other computers to ensure that things are the same.  However, if that virtual SD card was used offline or online with write block disabled, the MD5 checksum will change ("Date Accessed" of the files are what's different in virtual SD card), but will not cause immediate syncs.  If you are using a Wii game launcher app for various mods, users on all ends must have the same copies of homebrew app and the game in their game list first, then set the game as default ISO, as mentioned in previous section.
 
== Handling Virtual SD Cards on Android ==
 
Currently there is not a good way to do this.  Dolphin will generate a default SD Card that is 128 MB, but the Android GUI cannot currently change the directory, or automatically convert a folder into a SD card.  The best way to do this is to use the instructions for a Desktop build of Dolphin to generate a SD card, and if you have an Android Device that allows you to access per-app directories from "File Transfer" when connected to a desktop, accessing "\Android\data\org.dolphinemu.dolphinemu\files\Wii" and then overwrite the "sd.raw" that is was generated there.


If done successfully, Dolphin on Android will now have your newly generated SD card with whatever data you put on it.
If using an older version of Dolphin and not dealing with copyrighted content, we highly recommend just generating an SD card on one computer, and then copying that SD card to all other computers to ensure that things are the same.  However, if that virtual SD card was used offline or online with write block disabled, the MD5 checksum will change ("Date Accessed" of the files are what's different in virtual SD card), but will not cause immediate desyncs.  If you are using a Wii game launcher app for various mods, users on all ends must have the same copies of homebrew app and the game in their game list first, then set the game as default ISO.


[[Category:Tutorials]]
[[Category:Tutorials]]
211

edits