WBFS Win Wii: Difference between revisions

From GameBrew
No edit summary
No edit summary
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{#seo:
|title=Wii Homebrew PC Tools (PC Utilities) - GameBrew
|title_mode=append
|image=wii-logo.jpg
|image_alt=WBFS Win
}}
{{Infobox Wii Homebrews
{{Infobox Wii Homebrews
|title=WBFS Win
|title=WBFS Win
|image=wii-logo.jpg
|image=wbfswinwii2.png
|description=wbfs tool to windows (cygwin is nasty). The download provided is wbfs built using MSVC 2008.
|description=WBFS tool port for Windows built using MSVC 2008.
|author=Gibbed
|author=Gibbed
|lastupdated=2009/03/31
|lastupdated=2009/03/31
|type=PC Utilities
|type=WBFS Managers
|version=delta
|version=delta
|license=Mixed
|license=Mixed
|download=https://dlhb.gamebrew.org/wiihomebrews/wbfswinwii.7z
|download=https://dlhb.gamebrew.org/wiihomebrews/wbfswinwii.7z?k33p0fil35
|website=https://gbatemp.net/threads/a-real-wbfs-windows-port.144475/
|website=https://gbatemp.net/threads/a-real-wbfs-windows-port.144475/
|source=
}}
}}
'''WBFS Win''' is a Windows version of the WBFS tool, which was previously only available for Linux. The "delta" version allows users to format their hard drives (USB 2.0) through the command line. However, it's important to be cautious when using this tool as it requires the use of the command line and any mistake made can cause data loss or other issues.
[https://github.com/kwiirk/wbfs Wii Backup File System (WBFS)] is a simple file system to store Wii backup in an efficient way on a harddrive created by Kwiirk.
 
The "delta" version allows you to format the hard drives (USB 2.0) through the command line.  
 
'''Note:''' WBFS is a filesystem tool that may damage you disc partition if you don't know what you are doing. Please make sure you keep a backup of your important data before using. The authors of the software decline all responsabilities on damage that can been done by the use of this software.


== Usage ==
== User guide ==
Before using wbfs tool, you must initialize the drive. Preferably pre-format your USB drive to FAT32.
"X" in the following examples represents your drive letter, for example, G.
<pre>
'X' in the following examples represents your drive letter, for example, G.


*init the partition:
Init the partition:
  wbfs_win.exe X init
  wbfs_win.exe X init


*estimate the size of the iso on the USB drive
Estimate the size of the iso on the USB drive:
  wbfs_win.exe X estimate <your_wiidisc.iso>
  wbfs_win.exe X estimate <your_wiidisc.iso>


*add an iso to your partition
Add an iso to your partition:
  wbfs_win.exe X add <your_wiidisc.iso>
  wbfs_win.exe X add <your_wiidisc.iso>


*list the wiidisc that are on the wbfs, you will get the DISCID, game name, number of wide sectors used, and number of GB used.
List the wiidisc that are on the wbfs, you will get the DISCID, game name, number of wide sectors used, and number of GB used:
  wbfs_win.exe X list
  wbfs_win.exe X list


*count the number of wide sectors / GB available on your partition
Count the number of wide sectors / GB available on your partition:
  wbfs_win.exe X info
  wbfs_win.exe X info


*build Homebrew Channel directories for all the games in your partition
Build Homebrew Channel directories for all the games in your partition (this will actually make a directory for each game with the DISCID of the game, copy the icon.png and boot.dol of the current directory, and make a meta.xml with the name of the game; then copy all the directories in the apps directory of your sdcard):
This will actually make a directory for each game with the DISCID of the game,  
 
copy the icon.png and boot.dol of the current directory, and make a meta.xml with the name of the game
  wbfs_win.exe X makehbc
  wbfs_win.exe X makehbc
Then copy all the directories in the apps directory of your sdcard.


*remove a disc from wbfs
Remove a disc from wbfs:
  wbfs_win.exe X remove DISCID
  wbfs_win.exe X remove DISCID


*extract an iso from wbfs
Extract an iso from wbfs:
  wbfs_win.exe X extract DISCID
  wbfs_win.exe X extract DISCID
</pre>


=== Programmers Usage ===
=== Programmers usage ===
* wbfs is based on libwbfs, a library to handle wbfs discs.
* wbfs is based on libwbfs, a library to handle wbfs discs.
* Its usage is documented inside the header file libwbfs/libwbfs.h
* Its usage is documented inside the header file libwbfs/libwbfs.h
* The idea is that you only have to give libwbfs some function pointers that allow access to your partition, and original wii discs, and you can then manage a wbfs partition.
* The idea is that you only have to give libwbfs some function pointers that allow access to your partition, and original Wii discs, and you can then manage a wbfs partition.
* Some basic access to wiidiscs are provided by wiidisc.(h|c), allowing to extract files from the wii dvd filesystem, to change the partition table, and to find out which part of the wii dvd is used.
* Some basic access to wiidiscs are provided by wiidisc.(h|c), allowing to extract files from the Wii DVD filesystem, to change the partition table, and to find out which part of the Wii DVD is used.


== Wii Filesystem ==
=== Wii filesystem ===
*All Wii Games do not take advantage of the whole 4.7GB DVD.  
*All Wii Games do not take advantage of the whole 4.7GB DVD.  
*A lot of WII dvd sectors are in fact never used, even if there is random encrypted garbage in it.
*A lot of WII dvd sectors are in fact never used, even if there is random encrypted garbage in it.
*WBFS knows about the wiidisc filesystem, and will copy on the wbfs partition only the part that are really useful.
*WBFS knows about the wiidisc filesystem, and will copy on the wbfs partition only the part that are really useful.
8The idea of ignoring unused wiidisc sectors is not new, and is implemented in the WiiScrubber tool.
*The idea of ignoring unused wiidisc sectors is not new, and is implemented in the WiiScrubber tool.
 
===Other version===
[https://gbatemp.net/threads/possible-fix-for-the-wbfs-corruption.147969/ Possible fix for the WBFS corruption] by AllWiidUp (2009/04/12).


==Changelog==
==Changelog==
Line 74: Line 69:
* init command has a 'nice' warning on it so people don't break partitions on accident (at least I hope).
* init command has a 'nice' warning on it so people don't break partitions on accident (at least I hope).
* Minor fixes & changes to the code to improve it (the linux version seems to leak quite a few resources, not really noticable though).
* Minor fixes & changes to the code to improve it (the linux version seems to leak quite a few resources, not really noticable though).
* Notes:
** makehbc, extract commands very untested. May not work (yet).
** I've had several people test this port and it appears to be working good, for init/adding at least.


'''Notes'''
== Credits ==
*makehbc, extract commands very untested. May not work (yet).
wbfs is based on negentig, a tool from segher, that allows to verify and decrypt wii discs. a modified version is included, that allows to open discs on a wbfs filesystem.
*I've had several people test this port and it appears to be working good, for init/adding at least.
 
== Aknowledgement ==
wbfs is based on negentig, a tool from segher, that allows to verify and decrypt wii discs. a modified version  
is included, that allows to open discs on a wbfs filesystem.
 
== Disclaimer ==
* WBFS is a filesystem tool that may damage you disc partition if you dont know what you are doing.
* WBFS is in a early beta stage, a number of safety checks are not done, that may cause bugs.
* Please save your data, and report bugs (please be productive, and explain exactly the problem)
* The authors of the software decline all responsabilities on damage that can been done by the use of this software.
* This tool is not made to encourage piracy, only use your own backups from your own games.


==External Links==
==External links==
* Gbatemp - https://gbatemp.net/threads/a-real-wbfs-windows-port.144475/
* GBAtemp - https://gbatemp.net/threads/a-real-wbfs-windows-port.144475/
* GBAtemp - https://gbatemp.net/threads/a-real-wbfs-windows-port.144475/post-1900669

Latest revision as of 10:32, 28 January 2024

WBFS Win
Wbfswinwii2.png
General
AuthorGibbed
TypeWBFS Managers
Versiondelta
LicenseMixed
Last Updated2009/03/31
Links
Download
Website

Wii Backup File System (WBFS) is a simple file system to store Wii backup in an efficient way on a harddrive created by Kwiirk.

The "delta" version allows you to format the hard drives (USB 2.0) through the command line.

Note: WBFS is a filesystem tool that may damage you disc partition if you don't know what you are doing. Please make sure you keep a backup of your important data before using. The authors of the software decline all responsabilities on damage that can been done by the use of this software.

User guide

"X" in the following examples represents your drive letter, for example, G.

Init the partition: 

wbfs_win.exe X init

Estimate the size of the iso on the USB drive: 

wbfs_win.exe X estimate <your_wiidisc.iso>

Add an iso to your partition: 

wbfs_win.exe X add <your_wiidisc.iso>

List the wiidisc that are on the wbfs, you will get the DISCID, game name, number of wide sectors used, and number of GB used: 

wbfs_win.exe X list

Count the number of wide sectors / GB available on your partition: 

wbfs_win.exe X info

Build Homebrew Channel directories for all the games in your partition (this will actually make a directory for each game with the DISCID of the game, copy the icon.png and boot.dol of the current directory, and make a meta.xml with the name of the game; then copy all the directories in the apps directory of your sdcard): 

wbfs_win.exe X makehbc

Remove a disc from wbfs: 

wbfs_win.exe X remove DISCID

Extract an iso from wbfs: 

wbfs_win.exe X extract DISCID

Programmers usage

  • wbfs is based on libwbfs, a library to handle wbfs discs.
  • Its usage is documented inside the header file libwbfs/libwbfs.h
  • The idea is that you only have to give libwbfs some function pointers that allow access to your partition, and original Wii discs, and you can then manage a wbfs partition.
  • Some basic access to wiidiscs are provided by wiidisc.(h|c), allowing to extract files from the Wii DVD filesystem, to change the partition table, and to find out which part of the Wii DVD is used.

Wii filesystem

  • All Wii Games do not take advantage of the whole 4.7GB DVD.
  • A lot of WII dvd sectors are in fact never used, even if there is random encrypted garbage in it.
  • WBFS knows about the wiidisc filesystem, and will copy on the wbfs partition only the part that are really useful.
  • The idea of ignoring unused wiidisc sectors is not new, and is implemented in the WiiScrubber tool.

Other version

Possible fix for the WBFS corruption by AllWiidUp (2009/04/12).

Changelog

Delta

  • Fixed a makehbc crash.
  • Rewrote all linux-specific stuff to use win32-specific stuff.
  • Drive letter is now required for usage (wbfs_win.exe [argument]).
  • Commands have more user-friendly names instead of their linux counterparts.
  • Added an 'estimate' command so you can estimate the size that an iso image will take up on a usb drive.
  • init command has a 'nice' warning on it so people don't break partitions on accident (at least I hope).
  • Minor fixes & changes to the code to improve it (the linux version seems to leak quite a few resources, not really noticable though).
  • Notes:
    • makehbc, extract commands very untested. May not work (yet).
    • I've had several people test this port and it appears to be working good, for init/adding at least.

Credits

wbfs is based on negentig, a tool from segher, that allows to verify and decrypt wii discs. a modified version is included, that allows to open discs on a wbfs filesystem.

External links

Retrieved from ‘https://www.gamebrew.org/index.php?title=WBFS_Win_Wii&oldid=141906’

Advertising: