Difference between revisions of "PyWiiLoad"

From WiiBrew
Jump to: navigation, search
(Changelog)
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). 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 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
 
| title    = PyWiiLoad
 
| title    = PyWiiLoad
 
| type    = pc utility
 
| type    = pc utility
| author  = dniMretsaM
+
| author  = {{u|dniMretsaM}}
 
| license  = GPLv3+
 
| license  = GPLv3+
 
| download = https://www.dropbox.com/sh/ys6dvs41pgfp7ys/je8qeS-dx7
 
| download = https://www.dropbox.com/sh/ys6dvs41pgfp7ys/je8qeS-dx7
Line 27: Line 27:
  
 
== Obtaining PyWiiLoad ==
 
== Obtaining PyWiiLoad ==
NOTICE: At the moment, you'll need to use the "Git" method below. An extra line of code worked it's way into 1.1 and is causing an PyWiiLoad to crash. I'll put 1.1.1 up A.S.A.P.
 
 
=== 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.
Line 62: Line 61:
  
 
= Changelog =
 
= Changelog =
=== 1.1.1 (Git Only) ===
+
=== 1.1.1 (Current Release) ===
* Fixed the crashing bug in 1.1 (removed the line of code that gotadded accidentally).
+
* Fixed the crashing bug in 1.1 (removed the line of code that got added accidentally).
=== 1.1 (Current Release) ===
+
=== 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.

Revision as of 19:05, 11 December 2012

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.py, but now shares very little in common with it. It runs under both Python 2 and Python 3.

PyWiiLoad
General
Author(s)dniMretsaM
TypePC utility
LicenseGPLv3+
Links
Download
Source


Features

  • Send executables and apps directly to the Homebrew Channel.
  • Automatically zip directories.
  • Set the IP address temporarily if $WIILOAD isn't set.
  • Visual progress feedback when sending data.
  • Smooth error handling.
  • Supports both Python 2 and 3.

Instructions

Dependencies

  1. A Wii that's connected to the Internet with the Homebrew Channel installed
  2. 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.
  3. Python - Tested on version 2.7.3 and 3.2.3.
  4. The environment variable $WIILOAD set to "tcp:[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 $WIILOAD is not set.
  5. 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.

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).

  1. Open up terminal emulator on your computer.
    1. If you downloaded a release or snapshot, extract it:
      tar -xJf /path/to/PyWiiLoad-*.tar.xz
  2. Change into the PyWiiLoad directory:
    cd /path/to/PyWiiLoad/
  3. Send an executable like this:
    1. ./wiiload.py /path/to/executable.dol
    2. ./wiiload.py /path/to/exectuable.elf
  4. Send an app to be installed on the SD card like this:
    1. ./wiiload.py /path/to/app.zip
    2. ./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.1.1 (Current Release)

  • 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.