Build Instructions

Collapse

• 1

  Step 1

  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
    

    to

      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
  

View all instructions