You must already have established an account with Amazon.com and provided a credit card for one-click purchases. If this is the first time you're setting up your Amazon.com account, we suggest you order your first video from Amazon Unbox online to ensure you've got everything configured properly. Once that works, this application should be able to work, too.

You must:

• have one-click enabled on Amazon.com
• have an active credit card set in the default one-click profile
• configure your Amazon.com email address and password in the configuration file

Windows (2000/XP/2003 Server/Vista)

Standalone Installation Instructions

• Ensure you have the latest version of Sun Java installed on your computer. At least version 1.5.0 is required.
• Unzip the unboxOnDemand-<version>.zip file into a new directory, such as "c:\Program Files\UnboxOnDemand\" for Windows users.
• Edit the file "conf/unboxOnDemand.properties" file using a text editor and set the email address and password for your Amazon.com account.
• Run the bin/run.bat batch file to start the server. To install the app as a service, run bin/install.bat. To uninstall the service, run bin/uninstall.bat.
• Go to your TiVo and select "Music, Photos, Products, and More" from the Main Menu. Scroll down to "Amazon Unbox On Demand" and press SELECT.
• Welcome to On Demand content from Amazon Unbox on your TiVo receiver!

Upgrade instructions

• You only need to replace the file "UnboxOnDemand.jar" in your existing installation with the new one included in this version. It's located in the "lib" subdirectory wherever you installed the application.
• As of version 0.05 a new JAR library was added. If you last installed the full version of 0.04 or earlier, you should also copy the file "dom4j-1.6.1.jar" to the lib subdirectory.

Mac OS X

Standalone Installation Instructions

• Ensure you have the latest version of Sun Java installed on your computer. At least version 1.5.0 is required.
• Edit the file "/Applications/UnboxOnDemand/conf/unboxOnDemand.properties" with Text Edit and set the email address and password for your Amazon.com account.
• Open Terminal, which is in the Utilities folder in Applications, and enter the following command to start the server:
  cd /Applications/UnboxOnDemand/bin
  ./run.sh start
  If you get the error message "-bash: run.sh: Permission denied", enter the following command and try again:
  chmod 755 run.sh
  Quit Terminal if you'd like.
• If you use the built-in firewall, open the port for UnboxOnDemand. To do so: Select Sharing in System Preferences, then Firewall, then "New...". For "Port Name" select Other. For "TCP Port Number(s)" enter 7288. Leave "UDP Port Number(s)" blank. For "Description" enter TiVo-UnboxOnDemand. Click "OK". Click "Stop" and then "Start".
• Go to your TiVo and select "Music, Photos, Products, and More" from the Main Menu. Scroll down to "Amazon Unbox On Demand" and press SELECT.
• Welcome to On Demand content from Amazon Unbox on your TiVo receiver!

Upgrade instructions

• You only need to replace the file "UnboxOnDemand.jar" in your existing installation with the new one included in this version. It's located in the "lib" subdirectory wherever you installed the application.
• As of version 0.05 a new JAR library was added. If you last installed the full version of 0.04 or earlier, you should also copy the file "dom4j-1.6.1.jar" to the lib subdirectory.

Other Helpful Suggestions

Dennis Wilkinson has made available a double-clickable icon to start UnboxOnDemand for Mac OS X users. You'll find it available at http://www.tivocommunity.com/tivo-vb/showthread.php?p=5007122&&#post5007122 as well as additional discussion about running this application.
 

---

Linux

The instructions for Linux should be similar to Mac OS X. If you're a Linux user and would like to contribute specific instructions, we'd appreciate it!

 

Click here for more information about Amazon Unbox!