Toggle search
Toggle menu
10.3K
13.2K
1.2K
203.4K
GameBrew
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Sharpii Wii: Difference between revisions

From GameBrew
More actions
No edit summary
No edit summary
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox Wii Homebrews
{{Infobox Wii Homebrews
|title=Sharpii
|title=Sharpii
|image=sharpiiwii.png
|image=sharpiiwii02.png
|description=A command line tool based on leathl's libWiiSharp.
|description=A command line tool based on leathl libWiiSharp.
|author=leathl, person66
|author=leathl, person66
|lastupdated=2016/06/24
|lastupdated=2016/06/24
Line 11: Line 11:
|website=https://gbatemp.net/threads/sharpii.309756/
|website=https://gbatemp.net/threads/sharpii.309756/
|source=https://github.com/mogzol/sharpii
|source=https://github.com/mogzol/sharpii
|donation=https://gbatemp.net/threads/sharpii.309756/
}}
}}
{{#seo:
Sharpii is a command line application created by person66 for Windows. It utilizes leathl's libWiiSharp.dll (scooby74029's mod of libWiiSharp in version 1.2) to accomplish various tasks, such as:
|title=Wii Homebrew PC Tools (PC Utilities) - GameBrew
* Pack, unpack, or edit .wad files.
|title_mode=append
* Pack, and unpack U8 archives.
|image=sharpiiwii.png
* Patch IOS .wad files with various patches.
|image_alt=
* Download files from NUS.
}}
* Convert a .wav file to .bns, and vice versa.
* Convert an image file to a .tpl, and vice versa.
* Send a .dol or .wad to the Homebrew Channel over Wi-Fi.
 
==Installation==
Since version 1.7, you have the option to install Sharpii. This allows you to run Sharpii from anywhere without needing the exe in that directory.  
 
To install Sharpii, just use the command 'Sharpii install'. This will copy Sharpii to your My Programs directory, and create an environmental variable. To remove it, just use the command 'Sharpii uninstall' which will remove the environmental variable, then delete Sharpii from My Programs.


'''Sharpii''' is a command line application created by person66 for Windows.
==User guide==
Start up the command prompt, navigate to the folder containing Sharpii:
*To see all the commands type <code>Sharpii.exe -h</code>
*Or, if you want help with a specific function use <code>Sharpii.exe [function] -h</code>
*(where [function] would obviously be replaced with the function you want help with)


It utilizes leathl's libWiiSharp.dll (scooby74029's mod of libWiiSharp in version 1.2) to accomplish various tasks, such as packing, unpacking, or editing .wad files, packing and unpacking U8 archives, patching IOS .wad files with different patches, downloading files from NUS, converting .wav files to .bns and vice versa, converting image files to .tpl and vice versa, and sending .dol or .wad files to the Homebrew Channel over Wi-Fi.
===NUS Downloading===
When downloading single contents from NUS (using the -s argument) make sure you have both the path, and the file name when specifying the output.


==Screenshot==
For example, if the output is set to '.\hello.app' then the file will be saved as 'hello.app' in the current directory. However, if the output is set to 'hello.app' you will get an error.
https://dlhb.gamebrew.org/wiihomebrews/sharpiiwii-01.png
Also note that When Downloading single contents, it will only save the decrypted file.
 
If you wish to download the latest content, use '-v latest' instead of the actual version number.
 
If you have the output format set only to WAD, and your your output location has '.wad' at the end, or you have not specified one, then instead of being saved inside a folder, just the wad file will be saved.
===WAD Editing===
When changing the type of WAD (using the -type argument) some of the types may not work, as they have not all been tested. Here is a list of what the different types are:
* Channel - Regular channel WAD, nothing special.
* DLC - WAD for game DLC (downloaded game content).
* GameChannel - Channels such as the Wii Fit or Mario Kart channels.
* HiddenChannels - A hidden channel, it wont show up on the Wii Menu.
* SystemChannels - Channels such as the Mii or Shopping channels.
* SystemTitles - Stuff like the System Menu and boot2 (but not IOSs).


==Usage==
See [http://wiibrew.org/wiki/Title_database here] for more details.
<pre>
Sharpii 1.7.3 - A tool by person66, using libWiiSharp.dll by leathl


  Usage:
===SendDol===
When using Sharpii's SendDol function, please note that any arguments placed after the '-dol file' argument will be sent as dol arguments.


      Sharpii [function] [parameters] [-quiet | -q | -lots]
Also note that for compression to actually work, 'zlib1.dll' must be placed in the same directory as Sharpii. This file is not included, but it can easily be found online. If you are sending a zip file instead of a dol, it wont be compressed at all, no matter what.


If you do not wish to enter an IP every time you use SendDol, then you can add the argument '-saveip' to the command. This will save the entered IP to the environmental variable 'SharpiiIP', and then, in the future, if you do not enter an ip, Sharpii will use the one saved there instead. (Also applies to SendWad)


  Functions:
===SendWad===
Since version 1.6, Sharpii has supported AHBPROT for installing WADs. This means that as long as you have HBC 1.0.7 or above, you will be able to install the WAD without a patched IOS. To use this feature, enter '-ahb' instead of '-ios IOS'


      BNS            Convert a wav to bns, or vice versa
If you do not wish to enter an IP every time you use SendDol, then you can add the argument '-saveip' to the command. This will save the entered IP to the environmental variable 'SharpiiIP', and then, in the future, if you do not enter an ip, Sharpii will use the one saved there instead. (Also applies to SendDol)
      WAD            Pack/Unpack/Edit a wad file
      TPL            Convert a image to a tpl, or vice versa
      U8            Pack/Unpack a U8 archive
      IOS            Apply various patches to an IOS
      NUSD          Download files from NUS
      SendDol        Send a dol to the HBC over wifi
      SendWad        Send a wad to the HBC over wifi


      NOTE: Too see more detailed descriptions of any of the above,
==Screenshots==
            use 'Sharpii [function] -h'
https://dlhb.gamebrew.org/wiihomebrews/sharpiiwii3.png


==Changelog==
'''1.7.3'''
*  Still not dead.
*  Updated URLs for the downloaders to use GitHub instead of Google Code.
*  WadInstaller.dll is now included in the release zip.
'''1.7.2'''
*  I am not dead! Yay.
*  Fixed a bug that would prevent you from changing a wad type.
*  Wad info now also displays the full, 16-character Title ID.
'''1.7.1.
*  Fixed a bug that prevented Sharpii from checking for SharpiiIP in the system variables.
'''1.7'''
*  Sharpii can now be installed for use without the exe.
*  SharpiiIP is now a system variable, not a user one.
*  Sharpii now looks for DLLs in the same directory as the exe.
*  Bug fixes.
'''1.6'''
*  SendWad now supports AHBPROT (use '-ahb').
*  IP can now be saved in an environmental variable (SharpiiIP) for both SendWad and SendDol (manually or with '-saveip').
*  Pointless easter eggs are fun.
*  Code cleanup/bug fixes.
'''1.5'''
*  Added the ability to send WADs to the HBC using SendWad.
*  You can now download an IOS with -ios # in NUSD.
*  Downloaded IOS wads are now named like so: IOS##-64-####.wad.
*  Under certain conditions, when downloading a wad with NUS, it will not be saved in a folder, just as the WAD (see ReadMe).
*  If missing dll's are detected (WadInstaller or libWiiSharp), Sharpii will ask to download them, if they are required.
*  You can now use a .dol file instead of a .wad with the '-dol' in the WAD editor/packer.
*  Probably a few other little things I have forgotten.
*  Even more code cleanup and bug fixes.
'''1.4'''
*  Added the ability to send arguments in the SendDol function.
*  Changed the way the SendDol function works a little.
*  More code cleanup and bug fixes.
'''1.3'''
*  Added the ability to copy parts of one WAD to a different WAD (either the banner, the icon, the sound, or the dol).
*  Added the ability to download just a single content from NUS.
*  Code cleanup and bug fixes.
*  Sharpii can now find JoostinOnline a girlfriend.
'''1.2'''
*  Added version patch support for IOS patching.
*  Switched to scooby74029's mod of libWiiSharp .
*  Bug fixes.
'''1.1'''
*  Added support for NUS downloading.
'''1.0'''
*  Initial release.


  Other Functions:
==Credits==
Sharpii uses scooby74029's mod of libWiiSharp.dll by leathl, and it borrows some code from some of the examples included with libWiiSharp.


      Install        Install Sharpii to your computer so you can run
libWiiSharp can be found at: https://code.google.com/archive/p/libwiisharp/
                      it from anywhere without needing the exe
      Uninstall      Uninstall Sharpii from your computer


SendWad uses CRAP's installer by WiiCrazy/I.R.on, with any edits that leathl may have made when adding it to CustomizeMii (which is where I got the source from). Since version 1.6, the AHBPROT code it uses is just mostly stolen from WiiMod by jskyboo.


  Global Arguments:
I would also like to thank XFlak and JoostinOnline for doing a bit of beta testing for me (and giving me many ideas). Thanks.


      -quiet | -q    Try not to display any output
==External links==
      -lots          Display lots of output
* GitHub - https://github.com/mogzol/sharpii
</pre>
* GBAtemp - https://gbatemp.net/threads/sharpii.309756/


==External Links==
[[Category:Support the author]]
* Github - https://github.com/mogzol/sharpii
* Gbatemp - https://gbatemp.net/threads/sharpii.309756/
* Wiidatabase - https://wiidatabase.de/downloads/pc-tools/sharpii/

Latest revision as of 13:05, 6 July 2024

Sharpii
Sharpiiwii02.png
General
Authorleathl, person66
TypePC Utilities
Version1.7.3
LicenseGPL-3.0
Last Updated2016/06/24
Links
Download
Website
Source
Support Author

Sharpii is a command line application created by person66 for Windows. It utilizes leathl's libWiiSharp.dll (scooby74029's mod of libWiiSharp in version 1.2) to accomplish various tasks, such as:

  • Pack, unpack, or edit .wad files.
  • Pack, and unpack U8 archives.
  • Patch IOS .wad files with various patches.
  • Download files from NUS.
  • Convert a .wav file to .bns, and vice versa.
  • Convert an image file to a .tpl, and vice versa.
  • Send a .dol or .wad to the Homebrew Channel over Wi-Fi.

Installation

Since version 1.7, you have the option to install Sharpii. This allows you to run Sharpii from anywhere without needing the exe in that directory.

To install Sharpii, just use the command 'Sharpii install'. This will copy Sharpii to your My Programs directory, and create an environmental variable. To remove it, just use the command 'Sharpii uninstall' which will remove the environmental variable, then delete Sharpii from My Programs.

User guide

Start up the command prompt, navigate to the folder containing Sharpii:

  • To see all the commands type Sharpii.exe -h
  • Or, if you want help with a specific function use Sharpii.exe [function] -h
  • (where [function] would obviously be replaced with the function you want help with)

NUS Downloading

When downloading single contents from NUS (using the -s argument) make sure you have both the path, and the file name when specifying the output.

For example, if the output is set to '.\hello.app' then the file will be saved as 'hello.app' in the current directory. However, if the output is set to 'hello.app' you will get an error.

Also note that When Downloading single contents, it will only save the decrypted file.

If you wish to download the latest content, use '-v latest' instead of the actual version number.

If you have the output format set only to WAD, and your your output location has '.wad' at the end, or you have not specified one, then instead of being saved inside a folder, just the wad file will be saved.

WAD Editing

When changing the type of WAD (using the -type argument) some of the types may not work, as they have not all been tested. Here is a list of what the different types are:

  • Channel - Regular channel WAD, nothing special.
  • DLC - WAD for game DLC (downloaded game content).
  • GameChannel - Channels such as the Wii Fit or Mario Kart channels.
  • HiddenChannels - A hidden channel, it wont show up on the Wii Menu.
  • SystemChannels - Channels such as the Mii or Shopping channels.
  • SystemTitles - Stuff like the System Menu and boot2 (but not IOSs).

See here for more details.

SendDol

When using Sharpii's SendDol function, please note that any arguments placed after the '-dol file' argument will be sent as dol arguments.

Also note that for compression to actually work, 'zlib1.dll' must be placed in the same directory as Sharpii. This file is not included, but it can easily be found online. If you are sending a zip file instead of a dol, it wont be compressed at all, no matter what.

If you do not wish to enter an IP every time you use SendDol, then you can add the argument '-saveip' to the command. This will save the entered IP to the environmental variable 'SharpiiIP', and then, in the future, if you do not enter an ip, Sharpii will use the one saved there instead. (Also applies to SendWad)

SendWad

Since version 1.6, Sharpii has supported AHBPROT for installing WADs. This means that as long as you have HBC 1.0.7 or above, you will be able to install the WAD without a patched IOS. To use this feature, enter '-ahb' instead of '-ios IOS'

If you do not wish to enter an IP every time you use SendDol, then you can add the argument '-saveip' to the command. This will save the entered IP to the environmental variable 'SharpiiIP', and then, in the future, if you do not enter an ip, Sharpii will use the one saved there instead. (Also applies to SendDol)

Screenshots

sharpiiwii3.png

Changelog

1.7.3

  • Still not dead.
  • Updated URLs for the downloaders to use GitHub instead of Google Code.
  • WadInstaller.dll is now included in the release zip.

1.7.2

  • I am not dead! Yay.
  • Fixed a bug that would prevent you from changing a wad type.
  • Wad info now also displays the full, 16-character Title ID.

1.7.1.

  • Fixed a bug that prevented Sharpii from checking for SharpiiIP in the system variables.

1.7

  • Sharpii can now be installed for use without the exe.
  • SharpiiIP is now a system variable, not a user one.
  • Sharpii now looks for DLLs in the same directory as the exe.
  • Bug fixes.

1.6

  • SendWad now supports AHBPROT (use '-ahb').
  • IP can now be saved in an environmental variable (SharpiiIP) for both SendWad and SendDol (manually or with '-saveip').
  • Pointless easter eggs are fun.
  • Code cleanup/bug fixes.

1.5

  • Added the ability to send WADs to the HBC using SendWad.
  • You can now download an IOS with -ios # in NUSD.
  • Downloaded IOS wads are now named like so: IOS##-64-####.wad.
  • Under certain conditions, when downloading a wad with NUS, it will not be saved in a folder, just as the WAD (see ReadMe).
  • If missing dll's are detected (WadInstaller or libWiiSharp), Sharpii will ask to download them, if they are required.
  • You can now use a .dol file instead of a .wad with the '-dol' in the WAD editor/packer.
  • Probably a few other little things I have forgotten.
  • Even more code cleanup and bug fixes.

1.4

  • Added the ability to send arguments in the SendDol function.
  • Changed the way the SendDol function works a little.
  • More code cleanup and bug fixes.

1.3

  • Added the ability to copy parts of one WAD to a different WAD (either the banner, the icon, the sound, or the dol).
  • Added the ability to download just a single content from NUS.
  • Code cleanup and bug fixes.
  • Sharpii can now find JoostinOnline a girlfriend.

1.2

  • Added version patch support for IOS patching.
  • Switched to scooby74029's mod of libWiiSharp .
  • Bug fixes.

1.1

  • Added support for NUS downloading.

1.0

  • Initial release.

Credits

Sharpii uses scooby74029's mod of libWiiSharp.dll by leathl, and it borrows some code from some of the examples included with libWiiSharp.

libWiiSharp can be found at: https://code.google.com/archive/p/libwiisharp/

SendWad uses CRAP's installer by WiiCrazy/I.R.on, with any edits that leathl may have made when adding it to CustomizeMii (which is where I got the source from). Since version 1.6, the AHBPROT code it uses is just mostly stolen from WiiMod by jskyboo.

I would also like to thank XFlak and JoostinOnline for doing a bit of beta testing for me (and giving me many ideas). Thanks.

External links

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

Advertising: