Chapter 4. Desktop Blogging withRadio UserLand

Radio UserLand, by UserLand Software, is a desktop blogging tool. You build your blog using the Radio UserLand software (henceforth referred to simply as Radio) that runs on your computer, and then Radio publishes it to a web server for the world to read. Because Radio is a desktop blogging tool, a writer can take it with him and blog wherever he is — the beach, a coffee shop, a plane, anywhere. For many writers, this alone is a compelling reason for using Radio over other blogging tools.

Radio can be downloaded for free, and from download to your first blog post takes only a few clicks. Your blog source text is stored on your computer, but blog pages are served from an upstream server — a server out on the Internet to which your copy of Radio can send files (upstream them). UserLand Software provides hosting space on its upstream servers for every Radio UserLand customer as part of the license. You can start to use this immediately. Alternatively, you can use any web hosting account with FTP support to serve your Radio UserLand blog. Radio provides many options for connecting to other servers, including acting as an upstream server itself; thus, Radio “power users” can control every stage of blog publishing from their own desktop.

Radio provides an integrated News Aggregator (see Chapter 1). This is a powerful tool for monitoring web sites of interest to you. Radio can automatically capture news from subscribed-to sites as it is published, add it to your blog with one mouse click, and publish your own RSS feed to which other bloggers can subscribe. Overall, Radio provides exceptionally powerful RSS capabilities both for reading blogs and publishing your own blog.

Given Radio’s powerful RSS capabilities, people tend to use Radio in two different ways for blogging. You can create original content in your blog — this is referred to as a “writer” blog. Or you can comment on existing content in your blog — this is referred to as a “router” blog, because it usually ends up sending or routing people to other places on the Web.

Because Radio can be used both online and offline, it is an ideal tool for writers — they can work wherever they are. And for people who are commenting on content, the News Aggregator is a tremendous convenience.

Although you download and run your own copy of the Radio application, you don’t have to reinstall this when Radio is enhanced (or when bugs have been fixed); you can enable a UserLand automatic software-update mechanism, which can upgrade your Radio installation while you sleep.

In this chapter, we’re going to discuss how to download, install, and configure Radio, then walk through publishing your blog and using the News Aggregator.

Some powerful features of Radio — themes, macros, and content management — will be introduced in this chapter and then described fully in Chapter 7.

Installing Radio UserLand

Installing Radio is your first step toward using it as your blogging environment. Radio can be easily downloaded and installed in about 10 minutes, using a cable modem. Your time may vary if you have a dialup connection or a slow Internet link. Directions for installing, on both Windows and Macintosh, platforms are covered in the following sections.


Radio, like many Internet applications, is not sold in stores. It is available for download directly from UserLand Software. You can download it via the download link at

Choose the right version for your computer and click the download link to begin. For convenience, you probably want to save it to your desktop. Once you download Radio, you can use it for 30 days under the evaluation license. After 30 days, your copy of Radio will stop working, and you can then either uninstall it or purchase it for full use. At the time of this writing, the cost for a copy of Radio is $39.95 per year. This covers the Radio software and hosting your blog at YourUserNum/. The YourUserNum is a unique user number that is issued to every Radio download and distinguishes your blog from that of another user. For example, a UserNum of 0103087 gives the blog a location of:

If you download Radio and start using it but decide not to purchase it, UserLand maintains the data on your blog for 30 days following the 30 day evaluation period to give you the opportunity to change your mind. After this it is deleted.


These download instructions are for Radio 8.07. There might be a slightly more advanced version available by the time that you read this. The same basic steps, however, should apply.


From your desktop, double click the Radio installer (it should be named something like RadioUserLand807Setup.exe). Your screen should look like Figure 4-1.

Radio UserLand setup screen

Figure 4-1. Radio UserLand setup screen

Click the Next button to advance to the Install program to view the license agreement. If you agree with the license agreement, click the Next button.

Choose where you want to Install Radio. Using the default C:\Program Files\Radio UserLand\ is generally best. Click the Next button two more times to start actually copying the Radio files to your computer.

When the files are done copying, click the Close button to end the installer. Radio will start for you.


Radio for the Macintosh comes as a self extracting Stuffit file. Double click the Stuffit file and follow the prompts to install Radio.

If you need to uninstall Radio, first backup your data (very specific instructions are later in Chapter 7) and then drag the Radio UserLand folder to the Trash.

To install under Mac OS X, extract the downloaded archive. Double-click the extracted disk image to mount it on your desktop then copy the Radio UserLand folder into the Applications folder. Make sure your web browser is running, and then double-click the Radio UserLand application icon. The browser will open the Radio UserLand Setup page.

To install under Mac OS 9, unstuff the archive if it hasn’t been unstuffed automatically. Launch Radio UserLand 8.0.7 Installer and follow the straightforward instructions. At the end of the installation process, the installer will offer to launch the program for you. Accept this offer. Your web browser will open the Radio UserLand Setup page.


When Radio starts up, it displays the form shown in Figure 4-2.

Successful installation of Radio UserLand

Figure 4-2. Successful installation of Radio UserLand

Before you can begin using Radio, you need to fill out this web form to finish configuring Radio. This creates an account on the UserLand server for you. Obviously, you want to make note of your password (and remember which email address you specified if you have more than one). Once you click the Submit button, you should see the page shown in Figure 4-3.

Successful creation of a UserLand account

Figure 4-3. Successful creation of a UserLand account

Click the Continue button to begin using Radio and you should see the page shown in Figure 4-4.

Installed and ready to blog

Figure 4-4. Installed and ready to blog

Congratulations! You have now installed Radio and are ready to begin blogging.

Get Essential Blogging now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.