Toggle menu
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
No edit summary
No edit summary
Line 20: Line 20:
* Convert an image file to a .tpl, 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.
* 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==
==User guide==
<pre>
Start up the command prompt, navigate to the folder containing Sharpii:
Sharpii 1.7.3 - A tool by person66, using libWiiSharp.dll by leathl
*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)


  Usage:
===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.


      Sharpii [function] [parameters] [-quiet | -q | -lots]
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 [http://wiibrew.org/wiki/Title_database here] for more details.


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


      BNS            Convert a wav to bns, or vice versa
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.
      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,
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)
            use 'Sharpii [function] -h'


===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'


  Other Functions:
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)


      Install        Install Sharpii to your computer so you can run
==Screenshots==
                      it from anywhere without needing the exe
sharpiiwii3.png
      Uninstall      Uninstall Sharpii from your computer


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


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


      -quiet | -q    Try not to display any output
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.
      -lots          Display lots of output
</pre>


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


==External links==
==External links==
* GitHub - https://github.com/mogzol/sharpii
* GitHub - https://github.com/mogzol/sharpii
* GBAtemp - https://gbatemp.net/threads/sharpii.309756/
* GBAtemp - https://gbatemp.net/threads/sharpii.309756/

Revision as of 09:12, 31 March 2023

Sharpii
File:Sharpiiwii2.png
General
Authorleathl, person66
TypePC Utilities
Version1.7.3
LicenseGPL-3.0
Last Updated2016/06/24
Links
Download
Website
Source

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

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

Advertising: