WiiStream Installation Guide

Introduction

This guide details the steps for installing WiiStream on your Nintendo Wii. Follow each step closely for a successful setup.

Prerequisites

A Nintendo Wii matching one of the model numbers here
An SD card
A PC with internet access (here I'll be using Windows but macOS and Linux will work too)
A USB keyboard

Installation Steps

1. Homebrew Your Wii

Follow the steps outlined in these guides to homebrew your Wii:
- Letterbomb Guide
- Homebrew Channel Installation (Install BootMii as boot2. Note: If 'install as boot2' is not available, your Wii is incompatible)
- BootMii Guide

2. Prepare the SD Card

Download Wii-Linux-ngx from this link and extract the file.
Insert the SD card into your PC.

On Windows:

Open Rufus available here.
- Select your SD card under 'Device'.
- Under 'Boot selection', click 'SELECT' and choose the extracted "wii-jessie-sd.img" file.
- Click 'START' and accept the warning prompt.
- Click 'CLOSE' when it shows 'READY'.
Open Paragon Partition Manager.
- Select the partition named "WII-LINUX-NGX" (usually the middle partition).
- Click 'Expand', follow the prompts, select 'Expand Now', and wait for completion.
  - Ignore the prompt about 'reinit your bootloader'.
- Remove the SD card from your PC.

3. Wii Setup

Connect a USB keyboard to the back of the Wii, using the USB port at the bottom when the Wii is horizontal.
Insert the SD card into the Wii and turn it on.
Wait for the Gumboot menu to boot into the first option (wii-linux-ngx) after 30 seconds.
Wait for wii-linux-ngx to boot up.
Log in with 'root' as both the username and password.

4. Configure Network on Wii

At the prompt, enter ./whiite-ez-wifi-config and follow the instructions for WiFi setup.
- Ensure you use 'WPA-PSK' as your WLAN Security Mode.
- Select 'Yes' when prompted to bring up your WiFi connection.
- Select 'No' after it fails to bring the connection up.
Edit network interfaces with nano /etc/network/interfaces.
- Change all instances of 'wlan0' to 'wlan1'.
- Save and exit (Ctrl-X, Y, Enter).
Activate the new interface by typing ifup wlan1.
Type in nano /etc/apt/sources.list and change the first line to 'archive.debian.org...' instead of 'httpredir.debian.org...'

5. Remote Access Setup

Modify SSH settings with nano /etc/ssh/sshd_config.
- In the file, change 'PermitRootLogin without-password' to 'PermitRootLogin yes'.
Reboot the Wii by typing reboot, then log back in.
Type ifconfig to find the Wii's IP address (noted under 'wlan1 inet addr').

6. Access Wii from Another Computer

On another computer, access the Wii via a terminal:
- Type in ssh root@<Wii's IP address>.
- The password is 'root' (input is invisible).

7. Create Swap File

Execute the following commands to create a swap file. The first command may take a while:
```
dd if=/dev/zero of=/swapfile bs=1M count=5120
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
nano /etc/fstab
```
- Add /swapfile none swap sw 0 0 to the end of the file and save.

8. Install Mopidy and Dependencies

Run apt update.

Install required packages:

apt-get install python curl python-dev python-pip gstreamer0.10-alsa gstreamer0.10-pulseaudio python-gst0.10 gstreamer0.10-plugins-good gstreamer0.10-plugins-ugly gstreamer0.10-tools pulseaudio python-pykka python-gi

Install Mopidy and related components:

curl https://bootstrap.pypa.io/pip/2.7/get-pip.py -o get-pip.py
python get-pip.py
pip install Mopidy==0.19.0
pip install Mopidy-MusicBox-Webclient==2.0.0 Mopidy-TuneIn==0.1.3 Mopidy-Podcast-iTunes==1.0.0 --no-deps

9. Configure Mopidy

Create and configure the Mopidy service file with nano /etc/init.d/c_mopidy.

Paste the provided script, save and exit.

#!/bin/sh

### BEGIN INIT INFO
# Provides:          mopidy
# Required-Start:    $network $remote_fs
# Required-Stop:     $network $remote_fs
# Should-Start:      $named alsa-utils avahi dbus
# Should-Stop:       $named alsa-utils avahi dbus
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Mopidy music server
### END INIT INFO

PATH=/sbin:/usr/sbin:/bin:/usr/bin:/usr/local/bin:/var/log
DESC="Mopidy music server"
NAME=mopidy
DAEMON=/usr/local/bin/mopidy
DAEMON_USER=mopidy
DAEMON_GROUP=audio
CONFIG_FILES="/usr/share/mopidy/conf.d:/etc/mopidy/mopidy.conf"
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME

# Load the VERBOSE setting and other rcS variables
. /lib/init/vars.sh

# Define LSB log_* functions.
. /lib/lsb/init-functions

start_pulseaudio() {
      # Start pulseaudio in system-wide mode
      /usr/bin/pulseaudio --system --daemonize >> /var$
      sleep 5  # Give pulseaudio 5 seconds to initialize
}

do_start()
{
    start_pulseaudio # Ensure pulseaudio is running before starting mopidy

    start-stop-daemon --start --quiet --name $NAME --pidfile $PIDFILE \
        --startas $DAEMON --test > /dev/null \
        || return 1
    start-stop-daemon --start --quiet --name $NAME --pidfile $PIDFILE \
        --chuid $DAEMON_USER:$DAEMON_GROUP --background --make-pidfile \
        --startas $DAEMON -- --quiet --config $CONFIG_FILES \
        >> /var/log/mopidy.log 2>&1 \
        || return 2
    sleep 5
}

do_stop()
{
    start-stop-daemon --stop --quiet --name $NAME --pidfile $PIDFILE \
        --retry=TERM/30/KILL/5
    RETVAL="$?"
    [ "$RETVAL" = 2 ] && return 2
    # Wait for children to finish too if this is a daemon that forks
    # and if the daemon is only ever run from this initscript.
    # This typically happens with pulseaudio.
    start-stop-daemon --stop --quiet --oknodo --user $DAEMON_USER \
        --retry=TERM/30/KILL/5
    [ "$?" = 2 ] && return 2
    rm -f $PIDFILE
    return "$RETVAL"
}

# Remove the action from $@ before it is used by the run action
action=$1
[ "$action" != "" ] && shift

case "$action" in
    start)
        [ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC " "$NAME"
        do_start
        case "$?" in
            0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
            2)   [ "$VERBOSE" != no ] && log_end_msg 1 ;;
        esac
        ;;
    stop)
        [ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
        do_stop
        case "$?" in
            0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
            2)   [ "$VERBOSE" != no ] && log_end_msg 1 ;;
        esac
        ;;
    status)
        status_of_proc "$DAEMON" "$NAME" && exit 0 || exit $?
        ;;
    restart|force-reload)
        log_daemon_msg "Restarting $DESC" "$NAME"
        do_stop
        case "$?" in
            0|1)
                do_start
                case "$?" in
                    0) log_end_msg 0 ;;
                    1) log_end_msg 1 ;; # Old process is still running
                    *) log_end_msg 1 ;; # Failed to start
                esac
                ;;
            *)
                # Failed to stop
                log_end_msg 1
                ;;
        esac
        ;;
    run)
        echo -n "\"service mopidy run\" is deprecated. " 1>&2
        echo "Use \"mopidyctl\" instead." 1>&2
        /usr/sbin/mopidyctl $@
        ;;
    *)
        echo "Usage: $SCRIPTNAME {start|stop|status|restart|force-reload|run}" >&2
        exit 3
        ;;
esac
:

Make it executable with chmod +x /etc/init.d/c_mopidy and enable defaults with update-rc.d c_mopidy defaults.

Create the 'mopidy' user and configure permissions:

Use any password. Leave the remaining fields blank during this step.

adduser mopidy

usermod -a -G audio mopidy
usermod -a -G audio pulse

Configure PulseAudio:
- Edit nano /etc/pulse/system.pa.
- Add load-module module-native-protocol-tcp auth-ip-acl=127.0.0.1 auth-anonymous=1 at the end.

10. Final Steps

Create Mopidy configuration directory and file:

mkdir /etc/mopidy
nano /etc/mopidy/mopidy.conf

Paste the provided configuration, save and exit:

[local]
enabled = true
data_dir = /var/lib/mopidy/local
media_dir = /var/lib/mopidy/media
playlists_dir = /var/lib/mopidy/playlists

[audio]
output = pulsesink server=127.0.0.1

[stream]
enabled = true
protocols =
    http
    https
    mms
    rtmp
    rtmps
    rtsp
timeout = 5000
metadata_blacklist =

[mpd]
enabled = true
hostname = 0.0.0.0
port = 6600

[http]
enabled = true
hostname = 0.0.0.0
port = 6680
[tunein]
timeout = 5000

[podcast-itunes]
enabled = true
# iTunes Store base URL
base_url = http://itunes.apple.com/

# user-friendly name for browsing the iTunes Store
root_name = iTunes Store

# format string for genre results; field names: id, name, url
genre_format = {name}

# format string for podcast results; field names: collectionId,
# collectionName, country, kind, trackCount
podcast_format = {collectionName}

# format string for episode results; field names: collectionId,
# collectionName, country, episodeContentType, episodeFileExtension,
# episodeGuid, kind, releaseDate, trackId, trackName
episode_format = {trackName} [{collectionName}]

# charts to display when browsing; possible values: "Podcasts",
# "AudioPodcasts", "VideoPodcasts"
charts = AudioPodcasts

# directory name to display for browsing charts of a genre/category
# with subgenres; field names as for 'genre_format'
charts_format = All {name}

# ISO country code for the iTunes Store you want to use
country = US

# whether you want to include explicit content in your search
# results; possible values: "Yes", "No", or store default (blank)
explicit = 

# HTTP request timeout in seconds
timeout = 10

Allow the Reset button on the Wii to shut it down.

In nano /etc/inittab:

Change the line starting with 'ca:12345:ctrlaltdel' from:

  ca:12345:ctrlaltdel:/sbin/shutdown -t1 -a -r now

  ca:12345:ctrlaltdel:/sbin/shutdown -t1 -a -h now

Reboot the Wii to apply changes by typing reboot.

Starting Mopidy

Power on the Wii to start the Mopidy music server. Connect to Mopidy in a browser on another device via the Wii's IP address over port 6680, e.g. http://192.168.30.10:6680

bradmcgo/WiiStream