LJ Archive

Wireless Home Music Broadcasting—Modifying the NSLU2 to Unleash Your Music

John MacMichael

Issue #141, January 2006

Start with a storage attached network device to deliver entertainment to your home.

Like many consumers, the size of my collection of music CDs has spiraled out of control during the past few years. As hard drive prices dropped and CD ripping speeds increased, I jumped at the chance to rip my CDs into MP3 and Ogg Vorbis format; the pile of unorganized CDs became a thing of the past and were relegated to a box in the back of my closet. Although ripping the music collection to my computer eliminated the stack of CDs, it presented new problems. Several members of my family share the computer on which my music was stored; this meant I had to interrupt my son's game of WINE-powered Deus Ex if I wanted to queue up an album. Worse yet, I did not have a method of delivering the music from my computer to my stereo on the other side of the house in a low-loss and cable-free method. I cringed at the thought of listening to music blasting from my inexpensive computer speakers in our small computer room. I waited for a product that would be the solution to my problem, but none emerged. I eventually decided to string together several pieces of technology and build my perfect solution. In the end, I desired a setup that would allow me to move my music library off my computer and onto Network-Attached Storage (NAS), play my music with minimal signal loss and remove the necessity of utilizing the family computer as a middleman.

I have always been enamored with projects that extend the capability of computer hardware beyond the vision of the original product engineers. With this as a backdrop, my goal was to chain together several pieces of existing hardware and software to build the most optimal utilization of my audio collection. What I describe is a method to store my music library on a Linux-enabled Linksys NSLU2 NAS device, advertise the music library via mt-daapd, a program that acts as an iTunes (DAAP) server for Linux and other POSIX UNIXes and send the music to my stereo via a Roku Labs SoundBridge, a network music player. There are certainly several ways that this project could have been completed, substitutions could have been made—a full-size Linux server for the Linksys NSLU2, a long audio cable from the server to the home stereo—however, I found this to be the most elegant and practical solution. What surprised me was that I found a thriving community of users that were yearning for the same type of configuration.

Networked-Attached Storage, Getting to Know the Linksys NSLU2

The first order of business was to determine a method of moving my music library from my computer and onto a networked storage medium. My initial plan was to convert my aging Pentium III tower into a Linux file and media server that would enable music video across the network while being flexible enough to implement any other services. I scrapped this idea as I was concerned about the power consumption of what would be a mostly idle device, powering up a server just to hear the latest music from the Beastie Boys did not seem like a viable option. Additionally, the space in my tiny computer room is quite limited, and another machine would have added to the heat and noise levels.

I found the perfect alternative in the Linksys NSLU2 Network Link Storage Unit, a NAS device that allows the connection of two external USB 2.0 hard or Flash drives, connecting them to the network via a 10/100 Ethernet connection. The NSLU2 has a Web-enabled interface that allows configuration of file and data sharing across the network. The NSLU2 is packaged in a convenient device that is smaller than my external hard drive, weighs in at less than 6 ounces, consumes less than 9W during normal usage and is easy to stash on a bookshelf or in an unused corner of your computer space. Powered by a modest Intel IXP420 ARM CPU running at 133MHz with 32MB of internal Flash RAM, I had found a storage device but had not determined a method to serve the files.

NSLU2 and the Open Source Community

Several Linksys devices use Linux as the underlying OS; as such, the release of their source code is mandated by the GPL license. Armies of Linux programmers and developers have embraced the Linksys product line to include the NSLU2 (affectionately termed the Slug), and have extended the functionality of these devices. Several flavors or “streams” of replacement firmware have appeared that extend the functionality of the unit. My choice for firmware replacement, and by far the most user-friendly, is the Unslung stream that retains the original product functionality, retains compatibility with stock Linksys firmware, yet allows users to add programs and functionality to the NSLU2. Another popular choice is the OpenSlug firmware, a stream produced with OpenEmbedded, which contains a completely customizable Linux kernel and root filesystem. OpenSlug installs a minimal OS footprint that is enough to start the hardware and allow for the installation of additional software. This allows for a highly configurable and extendable installation and encourages functionality tailoring based upon user needs—think of it as the Slackware of the NSLU2 firmware world. Both Unslung and OpenSlug are hosted on the NSLU2 Linux Wiki Web site (see the on-line Resources) and have a throng of supporters. At the time of this writing, the latest Unslung firmware is 5.5 and is considered stable. Upgrading the NSLU2 with the Unslung functionality is done in two parts: installing the firmware to the NSLU2 and then “unslinging” the attached USB hard disk or Flash device. This process is straightforward and well documented in the README file included with the firmware. The directions should be followed strictly throughout the process to avoid “bricking” the NSLU2. Upgrading the firmware is as simple as accessing the device Web interface and utilizing the Upgrade Firmware utility. Once completed, the external disk must be unslung. During unslinging, the original root NSLU2 jffs2 filesystem is copied onto the external USB disk and additional directories are added. Each time the device boots after the firmware has been upgraded and the attached disk is unslung, it runs a script that directs the NSLU2 to load a root filesystem stored on the external drive instead of the filesystem in the NSLU2 Flash memory. This allows the user to store code for use by the NSLU2 on the hard disk instead of within the device RAM.

Although programs can be cross-compiled for the NSLU2, more than 6,500 packages have already been ported. Most users will find it much easier to install software using the ipkg system; apt users will find this familiar. The ipkg system allows for network downloads, satisfies package dependencies and manages the installation, upgrade and removal of programs. After upgrading the NSLU2, the ipkg system needs to be configured correctly and the feeds necessary to download new packages need to be updated. After telnetting into the NSLU2, the following commands are issued:

#ipkg update
#ipkg install unslung-feeds
# ipkg update

Common ipkg commands are ipkg list, ipkg status and ipkg install <package name> to install a particular program. These packages allow the NSLU2 to become a truly capable Linux device; users have reported using the NSLU2 as Web, file, mail, asterisk, media, squid and a host of other server applications.

Continuing the Project—mt-daapd

To transform the NSLU2 from a simple NAS into a powerhouse music server, the program mt-daapd, written and maintained by Ron Pedde, is utilized. mt-daapd acts as an iTunes server; it is a multithreaded implementation of Apple's DAAP protocol that advertises music libraries for use by iTunes-compatible clients. Although mt-daapd could have resided on a Linux server, I chose to use the NSLU2 to provide music on demand to my network while meeting my low-power and space-saving desires. Ron actively maintains the mt-daapd program and moderates questions and discussions regarding the program on his Web site (see Resources); there is an active contingent of users that share knowledge and help new users in the site forums.

Since I anticipate streaming media to a Roku Labs SoundBridge, I know that I am limited not by the protocols that mt-daapd supports but rather by whether the downstream client supports playing a file format via DAAP protocol. The SoundBridge will play MP3, non-fairplay lossless aac, aiff, WAV formats and Shoutcast streams advertised by mt-daapd. Had I intended to play the music via Ourtunes, an open-source, cross-platform Java iTunes client, I could have had mt-daapd serve up MP3, WAV and OGG formats via the DAAP protocol. There are also filesystem plugins (gnome-vfs-daap and kde daap ioslave) that allow Rhythmbox and JuK to play music advertised by mt-daapd. Ron noted that the most bleeding-edge “nightly version” of mt-daapd supports server-side conversion; this allows for conversion of wma, OGG and flac file types into .wav format and streaming to the downstream client and enables any client that can play a .wav file to play the converted file. One important caveat is that mt-daapd cannot broadcast aac DRM files that have been purchased from the iTunes music store and are digitally protected.

With this information in hand, we install mt-daapd on the NSLU2. If the user is content with the most recent stable release (0.2.3 at the time of this writing) installation is as simple as telnetting into the NSLU2 and issuing #ipkg install mt-daapd to download and install the program and any dependencies. To continue the process, the user navigates to the NSLU2 default network share /DISK 1/public (or /share/hdd/data/public from the console) and creates a subfolder /mp3 in which to store the music files. The server is then restarted and the music database initialized by issuing the following command #/opt/etc/init.d/S60mt-daapd. This script restarts mt-daapd if the NSLU2 is ever rebooted. The NSLU2 is now an iTunes (DAAP) server. To test this, open an iTunes client attached to the network, and you will note a new blue entry titled mt-daapd on the left-hand side between the Music Store and 90's Music. The name of your iTunes server, passwords, directories and other variables can be configured by editing /opt/etc/mt-daapd/mtdaapd.conf.

That covers the easy way, but what about the more-involved method? Less-stable nightly packages with Ron's newest feature set are available for download on the mt-daapd Web site. Ron ominously points out that the nightlies are “development code...significantly less tested than the stable code, and very likely won't work”. Ominous or not, the nightly packages have never let me down. As of this writing, the most recent nightly packet is mt-daapd_0.2.2-1_armeb.ipk. To install the nightly package, download a copy of the nightly package and copy it into a directory on the NSLU2; most users choose the $HOME directory. After telnetting into the NSLU2 and navigating back to the directory that contains the .ipk file, the command #ipkg install mt-daapd_0.2.2-1_armeb.ipk downloads any dependencies and installs mt-daapd.

That's it! Either method has resulted in configuring the NSLU2 as an iTunes (DAAP) server to any one device on the local network. Before moving on, install a few packages that will enhance your quality of life with the NSLU2. I suggest three: the Bash shell, DropBear for a lightweight secure shell access and wget for downloading files from the console. Each can be readily installed from the command line by typing ipkg install xxx and substituting bash, dropbear and wget for xxx.

Final Steps—Streaming Music on the Roku Labs SoundBridge

At this point, the NSLU2 is patiently waiting to serve music on your network. Although a Windows or Mac client could be used to access the music, the original intent was to play the music in pristine quality through my home stereo system. I could have snaked a cable from the computer to the stereo, but the more attractive solution is the Roku Labs SoundBridge. The device is configured with a standard wired Ethernet port and optional CompactFlash 802.11b adapter; I chose to connect to my network with the latter. After connecting a digital optical Toslink fibre connection from the SoundBridge to my stereo, I powered up the unit and entered my wireless network and encryption data with the handy remote (a significant downside is that the device only supports WEP encryption). A quick check to ensure that an IP addresses was issued from the DHCP server, and the SoundBridge is in business. The SoundBridge automatically detected my mt-daapd library, and I used the handy remote control to select and play music from the NSLU2. mt-daapd supports static and smart playlists and passes these to the SoundBridge after a bit of configuration of mt-daapd. The device will also play saved podcasts and Internet radio stations; my NSLU2 has been successfully serving music via the DAAP protocol to my home stereo for several months. It is an incredibly reliable and efficient method of providing music across the local network that has been made possible by an army of developers and enthusiasts in the Linux community.

Resources for this article: /article/8643.

John MacMichael (CISSP, GSEC, CWNA) is a Naval Officer and Information Professional who works in the field of Information Assurance. He considers himself a journeyman Linux user and utilizes a variety of distributions both at work and home, including Slackware, Debian, Red Hat and several live distros; he has yet to find his favorite. He invites your comments at johnny@757.org.

LJ Archive