Virtual SD Card Guide: Difference between revisions

From Dolphin Emulator Wiki
Jump to navigation Jump to search
m (Reworked for better English grammar.)
Line 1: Line 1:
Dolphin store data to virtual SD card namely '''sd.raw''' and it's stored under ''\Documents\Dolphin Emulator\Wii\''. By default, it will be created with size 128MB.
Dolphin can store data to a virtual SD card named '''sd.raw'''. It is stored under ''"%HOMEDRIVE%%HOMEPATH%\Documents\Dolphin Emulator\Wii"'' for Windows. By default, it will be created with the size of 128MB.


==Why Virtual SD card==
The virtual SD card is very important for homebrew apps on Dolphin. Project M and [[Mario Kart Wii]] custom tracks are the best example of this, as some homebrew apps can only work using files stored on the SD card of the real hardware for which they were designed.
Virtual SD card has very important use for homebrew apps on Dolphin, Project M and Mario Kart custom tracks are the best example of this, as some homebrew apps can only work using files stored in (virtual) SD card.


==Creating and editing virtual SD card==
==Creating and Editing a Virtual SD Card==


===Easy Dolphin SDCard Maker===
===Easy Dolphin SDCard Maker===
If the '''sd.raw''' didn't exist or you prefer to start over from scratch with size more than 128MB, you can create '''sd.raw''' using ''[https://sites.google.com/site/anon4453/tools/easy-dolphin-sdcard-maker Easy Dolphin SDCard Maker]''. I recommend you create with size at least 512MB for large homebrew app, for example, Project M, and no more than 2GB for best compatibility.
If the '''sd.raw''' does not exist or you prefer to start over from scratch with size more than 128MB, you can create '''sd.raw''' using ''[https://sites.google.com/site/anon4453/tools/easy-dolphin-sdcard-maker Easy Dolphin SDCard Maker]''. It is recommend you create one with size at least 512MB for large homebrew apps, for example, Project M, and no more than 2GB for best compatibility as there are compatibility issues with some homebrew apps trying to run under an SDHC card on the real hardware.


===WinImage===
===WinImage===
'''sd.raw''' can be edited using ''[http://www.winimage.com/download.htm WinImage]''.
The '''sd.raw''' file can be edited using ''[http://www.winimage.com/download.htm WinImage]'' for Windows.
 
===Mac===
This section needs a proper Mac tutorial, if any program exists for use.


===Linux===
===Linux===
'''sd.raw''' can be edited by mounting the virtual disk
The '''sd.raw''' file can be edited by mounting it to a virtual disk:


<pre>mount -o defaults,umask=000 sd.raw /media/sdcard</pre>
<pre>mount -o defaults,umask=000 sd.raw /media/sdcard</pre>


When you are done, simply unmount it
When you are done, simply unmount it like this:


<pre>umount /media/sdcard</pre>
<pre>umount /media/sdcard</pre>


==Dolphin setting==
==Dolphin Setting==
Go to Options > Configure... > Wii > and enable '''Insert SD Card'''.
Go to Options > Configure... > Wii > and enable '''Insert SD Card'''.


==Usage with homebrew app==
==Usage with Homebrew App==
The external files used for 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 from. Project M, for example, will load from SD root ''\projectm\'' and Dolphin will need to launch Project M through ''\homebrew\apps\projectm\boot.elf'' NOT in virtual SD card. It's very ideal to have same copies paralleled between inside and outside of virtual SD card, so you will have nothing to lose.
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 ''\homebrew\apps\projectm\boot.elf'', '''NOT''' in the virtual SD card. It is very ideal to have same copies paralleled between inside and outside of the virtual SD card, so you will have nothing to lose.


The homebrew app that was programmed to hack the Wii game will not work if you haven't set particular Wii as default ISO yet! Within Dolphin game list, open context menu (right-click) on any Wii game and click '''Set as default ISO'''. Do this before loading homebrew app with Dolphin.
The homebrew app that was programmed to hack the Wii game will not work if you haven't set a particular Wii game 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.


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

Revision as of 02:43, 2 May 2015

Dolphin can store data to a virtual SD card named sd.raw. It is stored under "%HOMEDRIVE%%HOMEPATH%\Documents\Dolphin Emulator\Wii" for Windows. By default, it will be created with the size of 128MB.

The virtual SD card is very important for homebrew apps on Dolphin. Project M and Mario Kart Wii custom tracks are the best example of this, as some homebrew apps can only work using files stored on the SD card of the real hardware for which they were designed.

Creating and Editing a Virtual SD Card

Easy Dolphin SDCard Maker

If the sd.raw does not exist or you prefer to start over from scratch with size more than 128MB, you can create sd.raw using Easy Dolphin SDCard Maker. It is recommend you create one with size at least 512MB for large homebrew apps, for example, Project M, and no more than 2GB for best compatibility as there are compatibility issues with some homebrew apps trying to run under an SDHC card on the real hardware.

WinImage

The sd.raw file can be edited using WinImage for Windows.

Mac

This section needs a proper Mac tutorial, if any program exists for use.

Linux

The sd.raw file can be edited by mounting it to a virtual disk:

mount -o defaults,umask=000 sd.raw /media/sdcard

When you are done, simply unmount it like this:

umount /media/sdcard

Dolphin Setting

Go to Options > Configure... > Wii > and enable Insert SD Card.

Usage with Homebrew App

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 \homebrew\apps\projectm\boot.elf, NOT in the virtual SD card. It is very ideal to have same copies paralleled between inside and outside of the virtual SD card, so you will have nothing to lose.

The homebrew app that was programmed to hack the Wii game will not work if you haven't set a particular Wii game 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.