3COM Audrey - The Unofficial Hack FAQ
Hosted by Chris Russo, aka cokeguy, kneebiter, etc.
v1.20, Last Updated 11/18/2001 at 06:30 PM

This site is under construction in a very big way.  Please be patient with me, and feel free to send me any comments.  For more information on specific things I am looking for, please see the section on Contributing to this Site.

Changes: added eight or so new sections (), updated some old sections with some new information ( updated), organized all sections by category, added some actual files to download in certain sections.

To do: create a downloads section

Table of Contents


  1. What is the FAQ?
  2. Legal Statement
  3. Thanks
  4. Contributing to this Site
  5. What is an Audrey? 
  6. How can I help the Audrey community? 
  7. Where can I get more information?
  8. Where can I get an Audrey?

  9. Are Audrey's discontinued?
  10. What operating system does Audrey use? 

For UNIX Newbies

  1. What is all this vi stuff?  How do I edit using vi?
  2. Ok, I hate vi.  Is there an alternative editor

Initial Setup

  1. How do I reset my Audrey?
  2. How can I update my Audrey's software?   (updated)
  3. I can't seem to get the last update with the shell!  Help?
  4. How do I trigger a serial port update on my Audrey?
  5. My Audrey is D.O.A.!  Now what?!


  1. Where can I get Audrey main screen images without all the text?    
  2. Can you give me some tips on adding my own icons?


  1. How can I bring up a shell using only the browser?
  2. This browser shell does not seem to allow me administrative access.  What's up?
  3. Can I control the green LEDs on Audrey?
  4. Is there an on-screen keyboard available for Audrey? 
  5. How do I change the keyboard mappings on my Audrey?
  6. How can I add buttons to the action palette in my Audrey?
    (also: How can I add shutdown and shell buttons to my Audrey's palette?)
  7. How can I add mouse support to my Audrey?

The Wheel

  1. How do I re-enable channel content and the Audrey wheel?

Backup and Restore, Images

  1. How can I create a backup CF image?
  2. How do I backup and restore a CF image?
  3. Is there an Audrey image on-line?

Remote Control

  1. How can I access my Audrey remotely from my PC?
  2. Can I remotely control my Audrey from my PC? (and vise-versa)
  3. How can I access my Audrey via a browser on another machine? 


  1. How do I change the timeout or disable the screen saver on my Audrey?
  2. How do I turn the Audrey screen on and off?
  3. How can I increase the Audrey screen color depth?
  4. How do I get screenshots on an Audrey?


  1. How can I increase the Audrey image cache size?
  2. How can I enable/disable browser pop-ups on my Audrey?


  1. How can I change the frequency of e-mail checking on my Audrey?


  1. Where can I put this keyboard to get it out of the way?

MP3 and Sound

  1. Can I play MP3s on my Audrey?
  2. How can I improve MP3 playback quality? 
  3. Are there any web based radio stations that will work on my Audrey?

Ethernet and Peripherals

  1. Can I use Ethernet with my Audrey instead of the modem? 
  2. Can I use USB Ethernet adapters other than the 3Com certified model?
  3. Can I put a USB keyboard on my Audrey? 
  4. What kind of printers can I use with Audrey?

Services & Advanced

  1. How can I create my own Marimba server?
  2. What do I need to know to spoof the Audrey update servers DNS entries? 


  1. Where can I get a QNX ISO Image? 
  2. Why are people using two different versions of QNX with the Audrey? 

Still to be answered...

  1. How much memory does Audrey have, and is it upgradable?
  2. How do you mount NFS drives from an Audrey?
  3. Help!  I can't seem to send mail through my ISP.
  4. Are there any Audrey accessories?
  5. Can I sync my Palm using the Audrey IR port?
  6. Can I use ethernet with my Audrey?
  7. How can I upgrade my Audrey's software?
  8. What are the reasons for and against updating my Audrey's software?
  9. How can I open HTML attachments in mail?

Legal Statement

The author claims no responsibility for the information contained within this FAQ.  Anyone using this information assumes the total responsibility for the results of their actions when doing so, and the responsibility for any effects so caused.  The author gives no warranty, explicit or implied, as to the accuracy of this information and the safety of using same.

In other words- please be careful.  If you hack your Audrey, please make sure you understand what you are doing.  If you manage to break it, you may very well be lost without support from anyone.  I put this site up to be helpful and hopefully make people happy- don't embark on things that you are uncomfortable with.


A word of thanks to all the people out there who are going crazy hacking this thing.  It is my honest goal to give you all credit for your work, so if you see something up here that you wrote, please contact me and give me your information so I can give you due credit.

I would also like to give specific thanks to:

David Chen, for his very thorough compilation of a great many of the articles listed below.
Eric Faulkner, for running into my office and telling me that Audrey's were on sale for cheap.
Marcia Russo, for tolerating me putting one in the kitchen... oh and one in the bedroom.

Contributing to this Site

All I am trying to achieve with this site is a single and complete repository of compiled information about Audrey, so if you can send me information, it would be greatly appreciated and helpful.  I give credit to anyone submitting the information wherever possible.  (Sometimes I don't know who is responsible for the information.)

Specific things I am looking for, in order of preference:

  • Step by step instructions on how to perform a specific Audrey hack.
  • Basic descriptions on how to perform a specific Audrey hack.
  • Links to other resources of a specific Audrey hack.
  • Whatever you got!

Additional help I am always in the need of:

  • Step by step versions of any instructions already described.  (I always prefer the step by step instructions, so if there is a FAQ item which is here, but lacks step by step instructions and you feel like writing them, that would be awesome!)
  • Corrections to any content on this site which needs adjustments.
  • Messages of "I tested this, it worked!" or "I tested this, I had some problems!"
  • If you see an un-linked item in the Table of Contents, that means that someone asked me the question, but I don't have the answer yet.  If you have the answer, please send it!

In all cases when contributing, please let me know the following:

  • Is this original work, or did you get it from another web site or source?
  • If from another site or source, can you tell me who was responsible for the effort?
  • Would you like credit for your work? (either in sending to me, doing the research, documentation, etc.)
  • If you would like credit, would you like me to link to your email address?  Please provide it to me if so.
  • How would you like your name listed.  My name is Chris Russo, but I may want to be known as cokeguy.

Send all information to me at cokeguy@3rdmoon.com.

What is an Audrey?

Or, more to the point, what in the bloody blue blazes is an Audrey?!

An Audrey, or simply "Audrey" as we call here her at the Russo household, is what is commonly known as an "internet appliance".  Since you are using the internet, I'll assume you know what that is, but what does it mean to be an internet appliance?  Well, the theory is that an appliance is a simple item in your home which has a single purpose, or a very small number of purposes.  It is easy to use, accessible to anyone, plugs in and away you go.

Clearly, your toaster is an appliance that browns bread.  Your refrigerator is an appliance that keeps your beer (juice, milk, film, dead bodies) cold.  Your Audrey allows you to browse the web, send and receive e-mail, and keep a schedule handy for all members of the household.

Audrey is relatively small- about 14" wide by 10" tall.  She has a ~640x480 pixel touch screen that allows you to select items and change cursor position via use of a stylus (a pen like device sticking out of the top of her like an antennae).  The stylus is clear, but blinks a cool glowing green whenever she has mail for you or needs your attention.  She has a small wireless keyboard which can be conveniently hung on the back of her.  She has a couple small speakers in a metal bezel at the top, which can play whatever sounds you encounter, and can even be used to play music.  Finally, Audrey comes in several cute colors- Linen (white), Meadow (green), Ocean (blue), Slate (gray) and Sunshine (yellow).

Here are some pictures: 1 2 3 4 5

Common uses for an Audrey are:

  • leaving it on your kitchen counter so you and your guests can check e-mail, search the web for recipes, etc.
  • leaving it in a child's room so that they can have access to the 'net without the complication and maintenance requirements of a full-blown PC
  • giving it to people who are afraid of the internet, because it is so cute and cuddly that what have they to fear?

There is also the hacker element.  (When I say hacker, I mean a bunch of geeks like myself who love getting toys like this and digging into their insides to play, which is basically what this FAQ is dedicated to.)  Hackers like to use the Audrey to do some pretty wild stuff.  For example:

  • using it as a ever-changing picture frame
  • using it to control lights and appliances in the house in conjunction with home automation equipment from places like X10 and SmartHome
  • using it as a baby monitor
  • using it as a remote control for an MP3 jukebox
  • using it as a remote control for other computers in the house
  • completely replacing the operating system with a whole new one with better functionality
  • planning to take over the world!

Ok, I was kidding about that last one...

...They're Pinky... Pinky and The Brain, brain, brain, brain...

You can read some more articles on the Audrey at the following locations: Information Week, ZDnet, TechTV, About.com

It's also important to note that Audrey has been discontinued.  You should read more about this before deciding to buy one.

How can I help the Audrey community?

The people who use and play with Audrey's are like any community of crazy people.  They need help. :)

In all seriousness, to keep Audrey's alive and well, there are many things that the community is pretty commonly asking for.  I am going to do my best to list these here.  If you are interested in contributing any of these things, please post a message to the  I-Appliance BBS and also be sure to let me know so I can add your contribution information here on this FAQ.

  • Additional DNS spoofing servers for 3com.marimba.net and marimba.3com.com.
  • On-line repository of all files that come on an Audrey so people can replace them when they mess up.
  • Additional Audrey Update servers.
  • More ways to hack the thing!

What is this FAQ?

This FAQ is a compilation of information pertaining to the Audrey.  I am putting it together for two reasons.  1. I'm a helpful guy and I noticed how difficult it was to glean information from all the lists and web pages and want to make it easier for everyone else.  2. It makes it easier for me when I need to or want to do any of these things for my two Audreys... and my Mom's.

It is very unlikely that anything listed here is a representation of my own original work.  In fact, the only work I am doing is compiling it, and in some cases testing it.  It is my goal to give credit to each and every clever person out there who has tested and posted this information so willingly.  If you see something that is yours, please tell me so I can give you credit.

It is also very unlikely that I will be able to (or want to) test each and every piece of information on this page.  For that reason, I will list everything as follows:

  • Items listed with a next to them have been checked by myself or an associate of mine and are considered accurate by this site.
  • Items listed with a next to them have been checked and confirmed by a person who I am not personally familiar with.
  • All other items have not been checked or confirmed to the best of my knowledge.

Please understand that this is really only a gauge of my comfort level with the information, and no indication of it's accuracy or viability.

Where can I get more information?

Audrey Sites:

Beginner's Audrey Page http://www.delphi.com/audreyapps
Hacking the Audrey http://www.audreyhacking.com/
Audrey Buttons http://www.demark.org/audrey/btns/
QNX ISO Image http://www.blight.com/~tony/audry_qnx.html
Sowbug's Audrey Page http://www.sowbug.com/audrey/
Co-Developers of the Audrey http://www.sterling1.com/
JLang's Audrey Filesystem listing http://www.ece.utexas.edu/~jlang/audrey/
3Com's Final Audrey FAQ *link concatenated to save space
SourceForge's Audrey/Linux Project http://sourceforge.net/projects/audrey-linux/
Robert's Audrey Page http://www.canoma.com/audrey/
Complete Listing of Audrey Dir Structure http://www.ece.utexas.edu/~jlang/audrey/

QNX Sites

Are Audreys discontinued?

Yes.  After a very short lifespan, 3Com Discontinued the Audrey in mid/late 2001.

For more information on 3Com's official position on this issue, please see their corpoarate Audrey FAQ at http://www.3com.com/products/en_US/discontinued/audreyqa.html.

In short, if you purchase an Audrey, you are largely on your own.  There is a community of Audrey fans and hackers which is developing rather quickly, but if your Audrey breaks you may very well be unable to replace it through any standard corporate support methods.

Where can I get an Audrey?

Presently, Audreys can be purchased at TigerDirect (search for the word Audrey).  At last check, they had an exclusive with Compaq and were selling them new and in-box for $89.99, and the USB ethernet adapter for $29.99.

You can also purchase Audreys through auction on ebay and other auction websites.  Needless to say, prices and conditions will vary.

What operating system does Audrey use?

Thanks to Keith Benoit for providing the information.
Thanks to sowbug
on I-Appliance BBS for the research.

QNX 6.0 embedded, with Neutrino kernel and Photo GUI manager. The current version of QNX is 6.1, but Audrey was developed with and uses QNX 6.0. Running selected QNX 6.1 binaries on Audrey is possible, provided you have downloaded and linked in the required QNX 6.1 shared object library (.so) files.

How do I trigger a serial port update on my Audrey?

If you hold down the mail and datebook buttons while plugging in the Audrey, it comes up saying "Ready to load image from serial port".

How do I reset my Audrey?

Thanks to tdemark on I-Appliance BBS.

Press the Action button and select "Audrey Options".
Using the "Password" feature, set a password for the device and put her to sleep.
Wake her up and enter the *wrong* password three times. 

* WARNING * This will blow all your data away
* WARNING #2 * This is *a* way of reseting Audrey - but I will not vouch that it is *the* way you are looking for. (Ex: You've upgraded to the most recent OS with the shell hack, does this affect the OS in any way -- I don't know. If you modify a file via the shell and do this, will the directory revert -- I don't know.) All I can say for sure is that doing this with the original OS removed all data that I entered via the GUI.

How do I change the keyboard mappings on my Audrey?

Okay, so I took a break from looking into writing a block device driver for the compact flash and worked on getting a better keyboard file for the Audrey. After writing a photon app to capture the scan codes and a little reverse engineering of what was actually being sent I finally came up with a useful keyboard file.

I changed the mapping of the following keys:
'Snapshot' -> 'Esc' (it was a fluke that it was working as Esc)
'Copy' -> 'Ctrl'
'Paste' -> 'Alt'

This will make it a little easier for some of those cut and paste shortcuts not to mention sending a ^C.

While I was working on this I found that they somehow have the buttons sending F# key symbols to photon independent of the keyboard file. The other bad thing is that they appear not to accept Ctrl or Alt modifiers which would make them more useful. The scan codes the buttons produce are pretty screwy.

Now for the installation instructions:

Get the audrey.kbd file from (?) and copy it to /nto/photon/keyboard/en_US_101.kbd.

Now do one of the following...

Option 1. Run ps | grep devi-k (or ps | more and look for the devi-kojak process). Then run "kill <pid> ; /kojak/devi-kojak -b touch ir", where <pid> is the devi-kojak process id, all on one command line. Your pterms should now be using the new keyboard layout.

Option 2. Run 'shutdown' or reboot the Audrey in your favorite manner.

My Audrey is D.O.A.!  Now what?!

Assuming that you purchased your Audrey from TigerDirect.com, you are probably aware that they have a "no returns" policy on discontinued items like the Audrey, and you are probably now panicking.

Don't worry!  Lonny Paul, the Director of e-Commerce at Tiger Direct, has said that he will be happy to help you if you are experiencing problems getting the Audrey swapped out.  (You should probably try calling TigerDirect first so as not to bog the poor guy down with return requests- if you have a problem then contact him.) 

Please treat this responsibly.  Lonny is a great guy and has been very supportive of the Audrey community, but he is a business man and has better things to do with his time than listen to somebody whining about the fact that they hacked the hell out of their Audrey and it doesn't work anymore.  Tiger's willing to swap out DOAs- not Audreys that you have broken.

Needless to say, I'm certain that his ability to assist will be based upon availability and certain other conditions.

Where can I get Audrey main screen images without all the text?

Thanks to cokeguy! :)

I have taken the main Audrey images and removed the text.  On one of the images, I have left the "Welcome", on the other, I have completely cleared it off.  You can use these as you like to create your own backgrounds.

This is with the "Welcome" graphic:        This is without it:    

Can you give me some tips on creating my own icons?

Thanks to tdemark on I-Appliance BBS.

The font is "Helvetica Bold" - the work was done in Photoshop with the following settings:

Text Tool -
Font: Helvetica
Style: Bold
Size: 12 pixels
Tracking: 50

Add Effect:Drop Shadow -
White Shadow
Opacity: 100%
Angle: 150 deg
Distance: 1 pixel
Blur: 0 pixel
Intensity: 100%

How can I add buttons to the action palette of my Audrey?
(also: How do I add shutdown and shell buttons to my Audrey's Palette)

Thanks to tdemark and mr32 on I-Appliance BBS.
Thanks to Chick Web for the note on administrative control.

Note: This is one way to set up Audrey so that you can get a shell with administrative rights. The other way is to set the set-UID bit on the pterm program itself. (If you don't know what a set-UID bit is, then you're probably better off using this procedure. If you do, pterm is in /nto/photon/bin :-)

Before performing this action, you must have already obtained all the latest software updates, including the one that will give you a shell.  For more information on how to do this, see the section on updating your Audrey's software.

This particular example will show you how to add a button for shutdown and a button for bringing up a shell.

  1. Get New Button Files
    The button graphics are at http://www.demark.org/audrey/btns . Go there and download them. They are:


  2. Start a Shell
    Fire up the browser and go to "http://localhost/shell.shtml?pterm"
  1. In the shell, type "cd /kojak/img/eng/config" (without quotes)
  2. From there FTP to your box and download the four files:


  1. Then, type "vi /kojak/SystemPanel.init" to edit the System Panel config.

To disable any buttons you would prefer not to have in the palette, comment out the config lines must be commented out with a '#' character. Use the cursor keys to go to the lines that begin:

For each line, hit the following keys in order:

<i> # Puts you into insert mode
<shift>-<3> # Adds the '#' character to where the cursor is
<snap shot> # Takes you out of insert mode

  1. Then, go to the line that reads:

#end of list

And type the following:

<O> # That capital letter 'O' - enter Open Mode in a new line above current line
<snap shot> # Exit open mode
<:> # Preface to command.
<w> # will tell vi to write the buffer.
<q> # will tell vi to quit.
<enter> # will have vi actually execute the two previous commands.

Note: The words "Shutdown" and "Terminal" at the beginning of the lines above are lines of text that will be placed under each icon in the palette.  Leaving a space here will leave the comment blank.

Now, if you hit the "Action" button and select "Audrey Options", you should have two new buttons.

How can I update my Audrey's Software?

Thanks to tdemark on I-Appliance BBS.
Thanks to Jason Roysdon for the update and the new update server.

Audrey was originally designed to update herself via 3Com servers that have since been taken offline.  However, some very nice person (whose name I have not yet determined) has setup a DNS spoof for the original 3Com servers, and made the updates available on his machines.  If you follow the directions below, you will get the most recent software updates, along with a hack that will give you shell access.  This last update which enables shell access will allow you to make other modifications to your Audrey.

This update was done on a home network and using the USB/Ethernet adapter.  

IMPORTANT!  There are actually two ways to do this, the method documented here will actually destroy all your settings, mail, calendar information and so on.  Editor's Note: I've basically described how to avoid this, but I have not done it in great detail so unless you basically know what you are doing, you may need to follow the more destructive route.

The software rev at this point is

Editor's Note: This is the section that will kill all your settings.  You can simply go into the ISP information screen and change this information there without forcing Audrey to fail out.  This should work just fine. (It's what I did.)

(1) In the Action Palette, select "Password"
(2) Set the password to something, say "foo"
(3) Once the password is set, put Audrey to sleep by hitting the Sleep button
(4) Wake Audrey up, and type the *WRONG* password in three times.
(5) Let Audrey reset herself
(6) Configure Audrey with the proper information for your home LAN, but make the primary and secondary DNS servers:

(Yes, they are both the same)

(7) Allow Audrey to go out and get the correct time (should be just after she starts up)
(8) Click the "Datebook" button and verify the current time
(9) Go into the "Download Options" section of the Actions palette and set the first time to the current time plus 5 minutes (make sure you set AM/PM correctly)
(10) Hit "done" and then press the Sleep button.
(11) Between 5 and 7 minutes from then, the "Activity" light on the USB connector should start flashing occassionally (coming on for about 5 seconds, then going off for a few, coming on for a few seconds, etc, etc). About 90 seconds after that, the screen will light up and a box stating that Audrey's software is being updated. (9 files in update)

After the update, I had software revision RC24 2/5/2001

(12) Press and hold for a few seconds the Mail, Action, and Browser buttons (here-to-fore known as the "Three Finger Salute", TFS)
(13) A yellow box comes up saying "Checking for software update"
(14) Audrey updates herself with 7 files.
(15) She reboots herself.

After this update, I am running software version RC26 3/29/2001

(16) TFS
(17) A yellow box comes up saying "Checking for software update"
(18) Audrey updates herself (fairly quickly)

After this update, I am running software version FINAL 4/23/2001

(19) TFS
(20) A yellow box comes up saying "Checking for software update"
(21) Audrey updates herself with 3 files.

After this update, I am running software version FINAL 4/23/2001 + SHELL (I think)

(22) TFS
(23) A yellow box comes up saying "Checking for software update"
(24) A yellow box comes up saying "Software is up to date"
(25) Update the DNS/network info to point to the right servers and restart Audrey.

I can't seem to get the last update with the shell!  Help?

If you are using dial-up to get your updates, you may find that the final update with the shell may not come over.  This is normal.  You will need to find and connect your Audrey to an actual network connected to the internet to get this to work.

How do I re-enable channel content and the Audrey wheel?

Go into /data/XML/Channels. You'll see the names of the channels you currently have assigned to positions. Go into any one of them, then into the .template directory, and you'll see an index.shtml. 

Then, create an index.shtml to send you to the URL of your choice!

cd /data/XML/Channels/ABCNews
rm .template
mkdir .template
cd .template

Then make an index.shtml that redirects to www.abcnews.com 

To create the "index.shtml" file (comments in parenthesis - don't type those!):

vi index.shtml (create the file)
O (get into insert line (and overall insert) mode using a capital O (not zero))
(type in all this)

<html><head><meta HTTP-EQUIV="refresh" CONTENT="0;URL=http://www.abcnews.com"></head>
<body>Transferring to <a "href=http://www.abcnews.com">ABCNews</body>

(the body stuff with the href is helpful if you mistype the meta refresh line)
(get out of insert/edit mode by hitting the snapshot key)
snapshot (don't type this, hit the snapshot key!)
:wq (write out changes and quit editor)
exit (exit the shell)

The images and suplimental files for the channels are located at /data/XML/Channels/.Channelxx/. Replace the xx with a two digit number starting with 00.

The Channel bar images are located at /data/XML/Channels/.Channel(xx)/Graphics/Graphic.gif. Each folder is set up the same and with the same filenames. Replace these images with 120 x 60 gifs.

The images located at /data/XML/Channels/.Channel(xx)/Icon/Icon.gif

The Icon directory with the Icon.gif in it is used for the user interface when selecting channels for the channel bar. I copied the single one that I had working(mkdir Icon;cp ....) into my user-defined channel, and that icon did appear in the "Select Channels" screen. So, the Graphic is for the channel bar, and the Icon is for the Selection screen.

A really interesting directory to look at is the /data/XML/Channels/.Channel(xx)/URLs/Package/ direcotry. Looking through there, I was able to find a reference to yet another site that the Audrey gets it content. It is contained in the .attributes file. It refers to a URL at www.vs.aparato.net. When I tried this url on my PC and Audrey, both displayed a bunch of XML data that looked like a DTD. I am assuming this is where the channel is updated.... Yet another interesting directory is the ..../URLs/UpdateTable.

If you set a shell access via channels, you can get permissions for running utilities by:

pterm using Audrey Options
cd /bin
chmod a+x rm mkdir ln cat cp tar

Voila, now when you pterm from Channels, you still have full file operation!

In /kojak there are two files, boot.sh and configure.sh Inside boot.sh, there are a couple "ln" lines that create the links for the 6 core channels to point back to /data/XML/Channels/.waitingForUpdate/Template folder. If you modify this file, then whenever Audrey boots up, have the create the link for .template to the /Template folder, you can reboot and not lose the custom configured channel to your hearts desire.


For unix newbies, once you get a shell, you can create a redirected link by doing the following:

1) type: cd /data/XML/Channels/ABCNews/Template
2) type: rm .template
3) type: ln -s /data/XML/Channels/ABCNews/Template /data/XML/Channels/ABCNews/.template

This will create a link to the current directory's Template folder. This will make it easier if you want to create customized channels. What did I do? I turned my ABCNews channel into a calculator. 

How to do it:

### STEP 1 ###

I downloaded a Macromedia Flash calculator (http://www.flashkit.com/movies/Applications/Scientif-Digital_-89/index.shtml) This one's a pretty cool one...does binary, hex, oct, as well as a bunch of other functions that aren't available in other flash calculators I've seen. 

### STEP 2 ###

Store the .SWF file on some web hosting service like Geocities, Xoom. (If you have an FTP client, you can probably FTP it to the Audrey and store it in the Templates folder)

### STEP 3 ###

Delete /data/XML/Channels/ABCNews/Template/index.shtml

Using VI, create a new index.shtml file and put the following:

<BODY bgcolor="#FFFFFF">
<!-- URL's used in the movie-->
<!-- text used in the movie-->
<OBJECT classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
ID=intro WIDTH=640 HEIGHT=480>
<PARAM NAME=movie VALUE="intro.swf"> <PARAM NAME=loop VALUE=false>
<PARAM NAME=menu VALUE=false> <PARAM NAME=quality VALUE=high>
<EMBED src="http://www.geocities.com/MYWEBPAGE/CALCULATOR.SWF" loop=false menu=false quality=high bgcolor=#FFFFF WIDTH=640 HEIGHT=480 TYPE="application/x-shockwave-flash" PLUGINSPAGE="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash">

Now, make a note of the "<EMBED Src=" line. Put in the URL for where you're storing the .SWF file. If it's local (ie: Template folder) then just put CALCULATOR.SWF.

This should work with any ShockWaveFlash file, so just think of the possibilities here....games, To-Do list (hey, anyone good enough to create one that links to Yahoo Notepad or Yahoo Calendar)? Hey, maybe someone would like to make a YahooMessenger.SWF? 

Some other cool Flash files from www.flashkit.com:
Picture Frame/Image Slider

Connection Speed

NoticeBoard (don't know if this will work, it writes to a file)

Guitar Tuner

Flash Chatster (???)

PaintBox (for the kids)


Google Search Interface

ICQ Instant Message

DJ Mixer

Talking Clock

Mickey's Duck Hunt

How can I add mouse support to my Audrey?

To use a USB mouse:

devu-ohci &
devu-mouse &
devi-hirun msoft fd -d/dev/usbmouse0 &

To use a serial mouse:

devi-hirun msoft fd -d /dev/ser1 &

Note, you won't have a visible on screen mouse cursor.

How can I create a backup CF Image?
This procedure was certified by David Chen.

For a normal image (ie, doesn't touch the IPL), you would get fs0p0 and fs0p1 from the Audrey shell. You would concatenate these (copy /b fs0p0+fs0p1 /b cf-image.bin or cat fs0p0 fs0p1 > cf-image.bin ). Then, get Sowbug's mkcf utility from his 'hack' page, and follow the instructions there. 

To put the image on a CF card, I'm using a Sandisk ImageMate CF Reader/Write (SDDR-31), with a Sandisk 32MB flash card. I'm using this under Windows 2000 since USB support under Linux for these devices just isn't working too well. So I have modification of the 'ntrw' utility at http://www.audreyhacking.com/~scythic which will read/write to a raw disk.

For my case, it's H: so I did: ntrw read size.img H:
This gives me a file size of 32112640 (ignore any errors that NTRW produces)  Now, run the mkcf to get a correct checksum mkcf cf-image.bin cf-image.cf 32112640 Finally, write it to disk ntrw write cf-image.cf H:

Now, take the CF to the Audrey, power it off, stick it in (label facing towards the back), power the Audrey on while holding BOTH date-book and sleep.

How do I backup and restore a CF Image?

Thanks to suicidal on I-Appliance BBS.
This procedure was certified by David Chen.

This is assuming that you have an Audrey updated to the Final version w/ Shell activated and Pterm active. CF card was straight out of the box, no formatting or alteration performed.

CF Backup:

1. Started a pterm via the Actions Palette.
2. Insert my generic 64Mb compact flash, it said 'CF inserted: 31493616 bytes (30755 kB, 30 MB)'
3. Typed: devb-cf
4. Typed: cd /dev
5. Typed: cat fs0p0 fs0p1 fs0p2 > /dev/cf

Backing up takes about 2-3 minutes.

CF Restore:

1) Unplugged the Audrey
2) Inserted the CF Card I made earlier
3) Made sure at least 1 min had elapsed from the time I first unplugged
4) Held down the Datebook AND Power buttons
5) Plugged the sucker back in....After a message indicating that the Flash Loader was being read and a short Flash Erase/Flash Write sequence (is the Flash Loader module re-flashing itself from the CF to the Audrey Flash ROM at this point?), it then cleared the screen and started a second longer Flash Erase followed by a Flash Write sequence. After which it cleared the screen again and instructed me to remove the CF Card. After which I was instructed to Unplug the Audrey.
6) Wait at least 30 sec, and then plugged in again and everything should be restored to previous flashed state.

BTW, the CF card I used is labled on the front as: SanDisk 32 MB CompactFlash

On the back: SanDisk CE SDCFB 99 SanDisk

Barcode: SDCFB-32-455 (top of Barcode), 6...19659 01155...0 (Bottom of Barcode), 80-56-00317-32 (Below that).

What is all this vi stuff?  How do I edit using vi?

vi is a simple, yet powerful, text editor which is included with pretty much any UNIX-style operating system.  It is modal, which can be a little confusing for some people, but you can learn the basics and get by reasonably well when hacking your Audrey.

When you first start vi, you will be in navigation only mode.  This means you can move your cursor around the file to view it or position it for when you are ready to make changes.

"i" will put you in insert mode.  This will allow you to insert characters wherever your cursor is.
"o" will insert a new line, then put you in insert mode.
the snapshot key will get you out of insert mode.
"x" will delete a single character.
"dd" will delete an entire line.
":wq" will write and quit out.
"q!" will quit without saving.

Go to http://www.cec.mtu.edu/newuserdoc/node9.html for more vi commands.

Ok, I hate vi.  Is there an alternative editor?

Thanks to David Chen.

Well, just put ped into the /nto/photon/bin directory and ran it, it runs just fine from the hacked Audrey. Cool, it is much easier to use than vi, kinda like wordpad in window$ and allows for auto indent, block formatting, fonts and font sizes, text formatting, etc.

I think it is in this file: http://www.audreyhacking.com/files/QNX6_misc.tar.gz
If not, look here: http://www.audreyhacking.com/files/QNX6_shell_tools.tar.gz

I have made some new icons included as an attachment.(standard and activated)

Now you even have a word processor! I'm happy b/c I was a complete klutz whenever I was using vi, guess I'm not hardcore enough.

Note that this hack needs a working "ALT" key which you can get by changing the keyboard definition. (you may need to use this specific file, someone please let me know)

You will also need to add the "mv" (move) command by installing this file into /nto/photon/bin.

How can I access my Audrey remotely from my PC?

Now, the parameter -i is used on the Audrey to limit it to talking to 127.1 (localhost). Simply remove that parameter from the slinger line in /config/rm-apps, and you can access Audrey from your PC.

cd /config
vi rm-apps
(I recommend making a backup first)
(about the 14th line is: rb,/kojak/kojak-slinger, -c -e -s -i 127.1)
(deleting the "-i 127.1" will allow it to respond to ANY request) (x under VI deletes character under cursor)
shutdown or unplug Audrey for a clean start

Voila! You can browse it using its IP address (obtainable under Audrey Options About profile)

Example using my Audrey:
yields the Audrey "home" page! (and correctly, if you shrink your window to Audrey's size.)

You can likewise run cgi from here, so:
and yields the same info you would have gotten from Audrey, using her crappy little keyboard.
(of course, type in your own IP address instead of

How can I change the frequency of e-mail checking on my Audrey?

In the /config diretory you will find a file kcrontab.  Using vi you will see a line that looks something like this:
app; min; hour; day; dweek; month

You can either change the number (in this example 54) to a * and it will update every minute, or you can add 12 lines all the same except for the minute 5 , 10 , 15 etc.... and it will update on those minutes past the hour.

Note that you will need to reboot Audrey for these changes to take effect.  Also note that if you make changes in the "Download Schedule" applet control, that these settings may be overwritten.

How can I change the timeout or disable the screen saver on my Audrey?

Using vi, change change  the value in the /config/SYSTERM_ScreenSaveSecs file to the number of seconds until you want the screen to turn off.

Setting a value of 0 will disable the screen saver function entirely.

How do I turn the Audrey screen on and off?

You can use gpio to turn the screen on and off. I'm not sure if it's going into a sleep mode of any kind though. But then again, I'm not sure if the audrey ever goes into sleep mode or just turns off the screen. 

The command is /kojak/gpio -a 0x40010004 -b6 -m3 -s opt, where opt is a number between 0 and 3. 0 turns the screen off, 1 clears the screen, 2 seems to be the same as 0, and 3 turns the screen on.

How can I increase the Audrey screen color depth?

Setting /config/BROWSER_Use256Colors to 0 (default is 1) gets rid of the gross dithering on pictures... so far I've not seen any adverse side effects. Now this thing has serious potential as a picture frame.

Note that when the browser exits, it rewrites the config file, so you need to do this immediately after booting and before running the browser, or just popup a shell. Do a "ps". Look for the process id of the process that says "Browser" in its name. Type "kill xxx" where xxx is that process id. Edit the file. Exit the shell. Hit the browser button. No need to reboot.

How do I increase the Audrey image cache size?

You can increase the value in "/config/BROWSER_ImageCacheSizeKB" to increase the image cache size.

How can I enable/disable browser pop-ups on my Audrey?

To Enable:
echo 1 > /config/BROWSER_AllowNewWindow
and reboot 

To Disable:
echo 0 > /config/BROWSER_AllowNewWindow
and reboot 

How do I get screenshots on an Audrey?

Thanks to dejab on I-Appliance BBS.

You can snapshot just about anything including a pterm screen.
Hit the action button, hit snapshot, tap and drag the area you want to capture
then send to yourself as an email or whatever. If you are in a shell screen, just
hit the browser sceen behind it and get to the action panel snapshot. 

What kind of printers can I use with my Audrey?

Thanks to madigan on I-Appliance BBS.

According to TigerDirect, supported printers are (USB):
Canon BJC-85
Canon BJC-85W
Canon BJC-2100

QNX has drivers for:

Where can I put this keyboard to get it out of the way?

I know it may seem silly for some, but oddly enough very few people are aware that you can actually hang the Audrey keyboard on the translucent cover on the back of the audrey.  (keys facing away from screen, spacebar towards the ground).

Can I play MP3s on my Audrey?

Yes, you can.  A number of people put a lot of work and research into this one.  It's a rather lengthy procedure, and therefore somewhat impractical to duplicate here.  However, you can find the information on Robert's Audrey page at: http://www.canoma.com/audrey/mp3.html

How can I improve MP3 playback quality?

Thanks to mitalium  on I-Appliance BBS.

I have been annoyed by underruns (clicks, pops etc.) while playing MP3s from a shared windows directory on my audrey with phplay. I have written a shell script which improves the playback quality by setting a 5Mb input buffer. This eliminates network related problems, however it adds a significant delay to the startup of the song. I do still occasionally get underruns, and almost always get them while moving windows on the audrey. 

Below is a copy of my shell script: Notice that I conditionally mount the windows shared directory. I thought it would be safer to do it here rather than in the boot scripts, since others have reported problems.

# Run phplay with a big input buffer
if [ ! -d /share ]
/nto/bin/fs-cifs -a \
//Tiger: /share \
guest guest
phplay &

Are there any web based radio stations that will work on my Audrey?

Thanks to davec, rmosko, tempestII on I-Appliance BBS.
Thanks to Christopher Jirka for the updates.

Yes, here are a list of some that we know of:

NPR Hourly Broadcast http://www.npr.com / http://www.pbs.org/npraudio.ram  
CarTalk http://cartalk.cars.com/show/ 
BBC Radio4 Online Live Feed: http://www.bbc.co.uk/radio4/realplayer/media/fmv5.ram
Listings from Real Audio's Web Site http://realguide.real.com/tuner/
WFMU http://www.wfmu.org
Radio Free Akron http://www.RadioFreeAkron.com/html/now_playing/
Audio Stream for PHPlay http://RadioFreeAkron.dnsalias.org:8000

Can I use Ethernet with my Audrey instead of the modem?

Thanks to Keith Benoit for providing this information.
Thanks to codeman on I-Appliance BBS for research.

Absolutely, with some limitations.

Audrey's original Ethernet adapter was a USB to 10-Base-T unit, 3COM model number 3C19250. This unit is actually a 3COM OEM version of the Kawasaki LSI KL5KUSB101 Ethernet adapter.  Similar units are: LinkSys USB10T, Netgear EA-101, and D-Link DSB-650C.  These units can be flash programmed to reset the Vendor_ID and Device_ID values as if they were the 3COM device, using Kawasaki LSI's "qttools" software.

More information is available in this thread at linux-hacker.net.

Can I use USB Ethernet adapters other than the 3Com certified model?

Thanks to codeman on I-Appliance BBS.

Ok i just did this on my Linksys usb10t but should work with other kawi usb adapters.
All you have to do is change the vender and prod id in the eeprom

So here we go...

On a Windows box goto http://www.klsi.com/drivers/index.htm and download qttools.zip.
Unzip it in Windows and edit qtprog.inf and add this line with the others (this is the vendor and prod number for linksys usb10t).
Now plug in you usb adapter and when it looks for the driver point it to the qttools dir and it will load the qtprog driver.
Then run macparse.exe and click read eeprom button.
Click the allow change mfg info box.
Then change the vid to 0506 and change the pid to 03e8 (3com id numbers).
You can change the manufacturer and prod name if you like does not matter.
Last, click write eeprom and wait for it to finish.
Click read eeprom again to make sure it did reprogram.

Plug it into you Audrey and get on the net !!

More vendor product ids and codes can be found here:


Can I control the green LEDs on Audrey?

Thanks to jklm and rseidl on I-Appliance BBS.

Turn it on: http://localhost/cgi-bin/SetLEDState?2
Make it blink: http://localhost/cgi-bin/SetLEDState?1
Turn it off: http://localhost/cgi-bin/SetLEDState?0

create /data/XML/led.shtml as:

<!--#exec cmd="SetLEDState $QUERY_STRING" -->

To test:
http://localhost/led.shtml?0 off
http://localhost/led.shtml?1 Blink
http://localhost/led.shtml?2 On

Is there an on-screen keyboard available for Audrey?

Thanks to Keith_D on I-Appliance BBS.

Note: Keith_D is credited with developing the first native Audrey application!

After digging in and learning the QNX development environment, I've completed my first audrey application. It is an onscreen keyboard that allows you to enter text into *any* application. With it you can use your Audrey without the keyboard and still enter text. It also has keys that the real keyboard does not even have like ctrl, alt, esc so you can use them without hacking your keyboard definition file.

The executable is only 27K and is built with QNX 6.0 so you don't need anything other than the executable.

More info, screen shots, and the download are at: http://www.keithandgina.com/audrey

Note, unlike my first approach using JavaScript to get a simple on screen keyboard, this is a native Audrey app.

Can I put a USB keyboard on my Audrey?

Thanks to servo on AudreyHacking.com.

You need to have the ability to run 6.1 binaries. You also need to stop usb-ohci from running as that screws up the usb connections. After that you need the 6.0 file devi-hirun and the 6.1 files devu-ohci and devu-kbd. Then run:

devu-ohci &
devu-kbd &
devi-hirun kbd -R fd -d/dev/usbkbd0 &

How can I create my own Marimba server?

Thanks to scythic on I-Appliance BBS.
Click here for complete thread, including discussion of creating packages.

Since a few people have expressed interest in running a Marimba server (thank you for helping me spare my miserable little 128kb/s link), I'm going to write up the instructions here in the hope of just typing it in one more time.  I was going to post this earlier, and others could have mirrored 3com's site, but this would have caused problems while 3com's site was up.

WARNING - these files will probably vanish off Marimba's FTP server. I won't send them to you... Maybe someone else will if you are too late. You have to change into these directories blindly - some windowing ftp clients won't work.

For Linux:
Start with ftp://ftp.marimba.com/pub/test/release.tar.gz
Install it into /opt/castanet

For Windows:
Get ftp://ftp.marimba.com/pub/installers/ and get the one that looks like you'll be able to use it.
Install it.
For the username/password/license, use this:
Username: DEMO
Password: DEMO

These are both 30 day trial versions.

You should have Transmitter and ChannelCopier either way. If not, you need to find someone willing to use ChannelCopier to upload the ChannelCopier.car to your server.

Get the additional Car's you need from ftp://ftp.marimba.com/pub/docs/documentum
If you don't have Transmitter, get Transmitter.car
If you don't have TransmitterAdministrator, get TransmitterAdministrator.car
Similarly for ChannelCopier
If you need more than 30 days, you could get the .DAT files from that directory (for Linux, they go into /opt/castanet/.marimba/ws3/licenses They go into c:\winnt\marimba\ws3\licenses or similar on Windows.

Start your Transmitter (right click on the Transmitter channel, and select start).

With channelcopier, start a new copy (New button), on the left side select the File icon (this opens a .CAR file), locate TransmitterAdministrator. On the right enter http://localhost:5282 (if that fails, try http://localhost:5283). You should now be able to add the copy, return to the main channel copier window, and copy it over.

Now, start TransmitterAdministrator and lock down your server. Set the port to 80 (required for Audrey). Do passwords, etc.
You need Transmitter Administrator to (a) change the port (though you could edit a file) and (b) to create folders (necessary for the Audrey setup!)

Look at the directory layout on http://www.sowbug.com/audrey, and replicate it on your server. In other words, you need the folders:
Add copies for all the files off my server to yours. If channelCopier is reluctant to Add, you can use the 'Edit button to fix things up.

You now have a working marimba server.

Is there an Audrey image on-line?

Thanks to jayklm on I-Appliance BBS.

Jayklm has posted a ROM image here: http://audrey.fizzlez.com

There is a danger that if you don't do it exactly as instructed, you may trash your flash loader and your Audrey will be DOA.

Where can I get a QNX ISO Image?

Thanks to Keith_D on I-Appliance BBS.
Thanks to tdthomas9 for clarification and correction on this item.
Thanks to Chris Guthrie for additional information and the link to the image for the 6.1 ISO.

The QNX image that is on the page linked below is an ISO image of the QNX 6.0 OS CDROM. getting this and burning it to a CD will allow you to install QNX on a PC. this will give you an environment to pull libraries and essential files from, in addition to having a nice development environment to program for Audrey.


Note: There have been some complaints that the ISO image above has some problems with file names being shortened and otherwise mangled.  You may have better luck trying the link below.


You may also want to investigate the QNX 6.1 ISO source on qnx.com: http://get.qnx.com/

Why are people using two different versions of QNX with the Audrey?

Thanks to Chris Guthrie.

The Audrey was shipped using QNX 6.0 as the operating system. Since then, QNX has released QNX 6.1. Since it is much easier to get 6.1 many people have hacked in programs from that release. Unfortunately, using programs from 6.1 often requires installation of additional 6.1 libraries that use up valuable memory on the Audrey. Thus for any serious development, 6.0 is the preferred release.

Can I remotely control my Audrey from my PC? (and vise-versa)

Thanks to the Audrey Hacking Website.

You can do this using VNC.

VNC stands for Virtual Network Computing. It is, in essence, a remote display system which allows you to view a computing 'desktop' environment not only on the machine where it is running, but from anywhere on the Internet and from a wide variety of machine architectures. 

The latest versions of VNC and this documentation are always available from the AT&T Labs Cambridge web site at http://www.uk.research.att.com/vnc

Adding VNC to your audrey 

First download and extract the http://www.audreyhacking.com/files/vncviewer.ph.gz file onto your audrey. 
chmod it +x: chmod 
execute it by the following command:
./vncviewer.ph xxx.xxx.xxx.xxx[:X] 
Where the xxx.xxx.xxx.xxx is your IP and the :X is the port 
waalaa a VNC terminal on your audrey. 

How can I bring up a shell using only the browser? 

In your browser window, simply type in the following URL: http://localhost/shell.shtml?pterm

Note that this shell will not allow you full administrative rights on the Audrey, but will get you far enough to allow you to create the buttons allowing you unchecked admin access to the device.

This browser shell does not seem to allow me administrative access.  What's up?

The shell will not allow you full administrative control.  The only way you can gain full administrative access is to follow the procedure on Adding Buttons to the Action Applet.

How can I access my Audrey via a browser on another machine?

(Just so everyone understands exactly what we're talking about here, this allows another PC to send HTTP requests to the Audrey's built-in web server, meaning that the PC can run the Audrey's CGI binaries and view its channel content. It's not a telnet server, VNC server, or X client, so you can't do any RPCs or open terminals on the other PC.)

The parameter -i is used on the Audrey to limit it to talking to 127.1 (localhost). Simply remove that parameter from the slinger line in /config/rm-apps, and you can access Audrey from your PC.

Step by Step Instructions:

cd /config
vi rm-apps
(I recommend making a backup first)
(about the 14th line is: rb,/kojak/kojak-slinger, -c -e -s -i 127.1)
(deleting the "-i 127.1" will allow it to respond to ANY request) (x under VI deletes character under cursor) :wq
shutdown or unplug Audrey for a clean start
Voila! You can browse it using its IP address (obtainable under Audrey Options About profile)

yields the Audrey "home" page! (and correctly, if you shrink your window to Audrey's size.)

You can likewise run cgi from here, so:
and yields the same info you would have gotten from Audrey, using her crappy little keyboard.
(of course, type in your own IP address instead of

What do I need to know to spoof the Audrey update servers DNS entries?

Thanks to madmax, scythic, kenm and a whole lot of people on I-Appliance BBS.

When updating the Audrey, you need to convince her that 3com.maribma.net is still alive and well.  That's where the Audrey updates come from.  Presently Jason Roysdon has setup a spoofing DNS server at, which when you point Audrey at it, it will tell you that 3com.maribma.net is actually at  It is actually preferable that you point this to resolve to 2-1b.artoo.net instead of the actual IP address, so that way Jason can change the IP address at will.

The problem is that some people have forgotten to change their DNS settings back to normal after completing the updates, thus causing a lot of Audreys to use poor madmax's server and bandwidth constantly.  Therefore, there is a chance that when you go to perform this function, you may find that madmax has taken down his service and you may have some problems.

If you are so nervy or technically inclined, you can setup your own DNS server and create your own spoof entries for 3com.marimba.net and marimba.3com.com and point both of them to  Then you can point your Audrey to your DNS server and you should be all set.




Hit Counter