Difference between revisions of "PyWiiLoad"
DniMretsaM (talk | contribs) |
|||
(4 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
− | PyWiiLoad is a program to send executables (.dol and .elf) to the [[Homebrew Channel]] and install homebrew apps to the SD card (.zip or a directory) over TCP. It was originally based on [[Wiiload#With_wiiload.py|wiiload.py]], but now shares very little in common with it. It runs under both Python 2 and Python 3. | + | PyWiiLoad is a program written in Python to send executables (.dol and .elf) to the [[Homebrew Channel]] and install homebrew apps to the SD card (.zip or a directory) over TCP. It was originally based on [[Wiiload#With_wiiload.py|wiiload.py]], but now shares very little in common with it. It runs under both Python 2 and Python 3. |
{{Infobox homebrew | {{Infobox homebrew | ||
Line 13: | Line 13: | ||
* Send executables and apps directly to the Homebrew Channel. | * Send executables and apps directly to the Homebrew Channel. | ||
* Automatically zip directories. | * Automatically zip directories. | ||
− | * Set the IP address temporarily if $ | + | * Set the IP address temporarily if $WII isn't set. |
* Visual progress feedback when sending data. | * Visual progress feedback when sending data. | ||
* Smooth error handling. | * Smooth error handling. | ||
Line 23: | Line 23: | ||
# A computer connected to the same LAN as the Wii. This has been tested on GNU/Linux only. I have no idea if it will work on Windows or OS X. | # A computer connected to the same LAN as the Wii. This has been tested on GNU/Linux only. I have no idea if it will work on Windows or OS X. | ||
# Python - Tested on version 2.7.3 and 3.2.3. | # Python - Tested on version 2.7.3 and 3.2.3. | ||
− | # The environment variable $ | + | # The environment variable $WII set to "[your Wii's IP]. If you don't know what you're Wii's IP address is, open up the HBC and click the HOME button. The IP will be in the upper left-hand corner. Note that PyWiiLoad will allow you to set the address temporarily if $WII is not set. |
# An executable (.dol/.elf) to run or and app to install (.zip/dir). | # An executable (.dol/.elf) to run or and app to install (.zip/dir). | ||
Line 29: | Line 29: | ||
=== Releases & Snapshots === | === Releases & Snapshots === | ||
To download the latest version or a git snapshot, click on the Download link above and download grab either PyWiiLoad-<version>.tar.xz or PyWiiLoad-git<timestamp>.tar.xz. | To download the latest version or a git snapshot, click on the Download link above and download grab either PyWiiLoad-<version>.tar.xz or PyWiiLoad-git<timestamp>.tar.xz. | ||
+ | |||
+ | Another way to grab a snapshot is to go to he GitHub page (the Source button above) and click on the ZIP button. | ||
=== Git === | === Git === | ||
Line 39: | Line 41: | ||
# Open up terminal emulator on your computer. | # Open up terminal emulator on your computer. | ||
## If you downloaded a release or snapshot, extract it: <pre>tar -xJf /path/to/PyWiiLoad-*.tar.xz</pre> | ## If you downloaded a release or snapshot, extract it: <pre>tar -xJf /path/to/PyWiiLoad-*.tar.xz</pre> | ||
− | # Change into the PyWiiLoad directory: <pre>cd /path/to/PyWiiLoad/</pre> | + | # Change into the PyWiiLoad directory:<pre>cd /path/to/PyWiiLoad/</pre> |
# Send an executable like this: | # Send an executable like this: | ||
## <pre>./wiiload.py /path/to/executable.dol</pre> | ## <pre>./wiiload.py /path/to/executable.dol</pre> | ||
Line 49: | Line 51: | ||
=== Notes === | === Notes === | ||
By default, PyWiiLoad runs with the <tt>/usr/bin/python</tt> interpreter (which is probably Python 2.x), but you can run PyWiiLoad with a specific version of Python quite easily. Examples: | By default, PyWiiLoad runs with the <tt>/usr/bin/python</tt> interpreter (which is probably Python 2.x), but you can run PyWiiLoad with a specific version of Python quite easily. Examples: | ||
− | + | <pre>python3 wiiload.py</pre> | |
− | + | <pre>/usr/local/bin/python3.4 wiiload.py</pre> | |
− | A zip archive must contain only the files you wish to extract onto the SD card. For example, if you wish to install sysCheck, the .zip would need to contain: | + | A zip archive must contain only the files you wish to extract onto the SD card. For example, if you wish to install sysCheck, the .zip would need to contain:<br/> |
− | <tt>syscheck/ | + | <tt>syscheck/<br/> |
− | syscheck/boot.dol | + | syscheck/boot.dol<br/> |
− | syscheck/icon.png | + | syscheck/icon.png<br/> |
syscheck/meta.xml</tt> | syscheck/meta.xml</tt> | ||
Line 61: | Line 63: | ||
= Changelog = | = Changelog = | ||
− | === 1. | + | === 1.2 (Current Release) === |
+ | * Now uses the environment variable $WII="[Wii's IP]". This allows you to use the same variable for programs like FTP (ftpii) since there is no "tcp:" before the IP. (PyWiiLoad will continue to support $WIILOAD="tcp:[Wii's IP]" until version 2.0. | ||
+ | === 1.1.1 === | ||
* Fixed the crashing bug in 1.1 (removed the line of code that got added accidentally). | * Fixed the crashing bug in 1.1 (removed the line of code that got added accidentally). | ||
=== 1.1 === | === 1.1 === | ||
* Versions for Python 3 and 2 have been combined into one file. | * Versions for Python 3 and 2 have been combined into one file. | ||
− | |||
=== 1.0 === | === 1.0 === | ||
* The first release that I'm satisfied with. The Python 2 and 3 versions both function correctly. | * The first release that I'm satisfied with. The Python 2 and 3 versions both function correctly. |
Latest revision as of 04:19, 12 April 2021
PyWiiLoad is a program written in Python to send executables (.dol and .elf) to the Homebrew Channel and install homebrew apps to the SD card (.zip or a directory) over TCP. It was originally based on wiiload.py, but now shares very little in common with it. It runs under both Python 2 and Python 3.
PyWiiLoad | |
General | |
---|---|
Author(s) | dniMretsaM |
Type | PC utility |
License | GPLv3+ |
Links | |
Download | |
Source |
Features
- Send executables and apps directly to the Homebrew Channel.
- Automatically zip directories.
- Set the IP address temporarily if $WII isn't set.
- Visual progress feedback when sending data.
- Smooth error handling.
- Supports both Python 2 and 3.
Instructions
Dependencies
- A Wii that's connected to the Internet with the Homebrew Channel installed
- A computer connected to the same LAN as the Wii. This has been tested on GNU/Linux only. I have no idea if it will work on Windows or OS X.
- Python - Tested on version 2.7.3 and 3.2.3.
- The environment variable $WII set to "[your Wii's IP]. If you don't know what you're Wii's IP address is, open up the HBC and click the HOME button. The IP will be in the upper left-hand corner. Note that PyWiiLoad will allow you to set the address temporarily if $WII is not set.
- An executable (.dol/.elf) to run or and app to install (.zip/dir).
Obtaining PyWiiLoad
Releases & Snapshots
To download the latest version or a git snapshot, click on the Download link above and download grab either PyWiiLoad-<version>.tar.xz or PyWiiLoad-git<timestamp>.tar.xz.
Another way to grab a snapshot is to go to he GitHub page (the Source button above) and click on the ZIP button.
Git
To clone the git repository (the Source link above), you can run this command (requires git to be installed):
git clone git://github.com/dniMretsaM/PyWiiLoad.git
Running
The Homebrew Channel must be open on your Wii for this to work. You also must have an SD card inserted with enough free space to put the file on (temporarily, in the case of a .dol/.elf file).
- Open up terminal emulator on your computer.
- If you downloaded a release or snapshot, extract it:
tar -xJf /path/to/PyWiiLoad-*.tar.xz
- If you downloaded a release or snapshot, extract it:
- Change into the PyWiiLoad directory:
cd /path/to/PyWiiLoad/
- Send an executable like this:
./wiiload.py /path/to/executable.dol
./wiiload.py /path/to/exectuable.elf
- Send an app to be installed on the SD card like this:
./wiiload.py /path/to/app.zip
./wiiload.py /path/to/app/
Notes
By default, PyWiiLoad runs with the /usr/bin/python interpreter (which is probably Python 2.x), but you can run PyWiiLoad with a specific version of Python quite easily. Examples:
python3 wiiload.py
/usr/local/bin/python3.4 wiiload.py
A zip archive must contain only the files you wish to extract onto the SD card. For example, if you wish to install sysCheck, the .zip would need to contain:
syscheck/
syscheck/boot.dol
syscheck/icon.png
syscheck/meta.xml
Since most apps come in a zip that contains apps/AppName/stuff, you'll have to unzip it and fix it manually.
Changelog
1.2 (Current Release)
- Now uses the environment variable $WII="[Wii's IP]". This allows you to use the same variable for programs like FTP (ftpii) since there is no "tcp:" before the IP. (PyWiiLoad will continue to support $WIILOAD="tcp:[Wii's IP]" until version 2.0.
1.1.1
- Fixed the crashing bug in 1.1 (removed the line of code that got added accidentally).
1.1
- Versions for Python 3 and 2 have been combined into one file.
1.0
- The first release that I'm satisfied with. The Python 2 and 3 versions both function correctly.