Installation Instructions

YAMJ is not difficult to install, but there are a few manual steps. For a step-by-ste guide see THIS PAGE

Firstly you need to download a couple of required programs, these are:

Java Runtime

• Install Sun Java Runtime Environment (JRE) 1.6
• Version 1.6 latest release is required.
• Once downloaded, install the program

MovieJukebox

• Download the latest version from Google Code: http://code.google.com/p/moviejukebox/downloads/list
• Unpack the code to a directory on your hard-drive, e.g. C:\YAMJ\
• Open the zip file using a program such as 7zip, Winzip, Winrar, etc.
• Drag the files out of the winrar window, onto a folder on your hard-drive, e.g. C:\YAMJ

MediaInfo

• Download the MediaInfo program (Command Line Interface version)
• Windows: http://mediainfo.sourceforge.net/en/Download/Windows
• Macintosh: http://mediainfo.sourceforge.net/en/Download/Mac_OS
• Others: http://mediainfo.sourceforge.net/en/Download
• Ensure you get a version that has an EXE file.
• Install MediaInfo directly into the MovieJukebox directory
• This should look like C:\YAMJ\MediaInfo\ using the example above

First Run

NOTE: This is a command line program, and as such you will need to access it through a command window (Start -> Run -> CMD).

Before you can run the jukebox for the first time, you will need to edit the library.xml file (or create your own). It is suggested that you create your own file as this will make upgrading easier later.

The LibraryXMLInfo page describes how to set-up a library file.

The CommandSyntax page describes hot to run the program once your library is created.

Linux Installation Notes

Headless Running

Thanks to miklos.klaar for this tip: If you are running YAMJ on a linux server with no X11 or monitor (headless) installed you have to add:

-Djava.awt.headless=true

to the java command line after the java command in MovieJukebox.sh. This will tell java not connect to the X11 server and allow the process to finish.

IP v6 Issues

There may be some issues if you have a new installation of Linux that only uses IPv6 networking, such as Debian. A workaround is to use this in your MovieJukebox.sh file

-Djava.net.preferIPv4Stack=true

So you MovieJukebox.sh file should look something like this:

java -Djava.net.preferIPv4Stack=true -Djava.awt.headless=true -Xms256m -Xmx512m
-classpath .:./resources:./lib/* com.moviejukebox.MovieJukebox "$@"

Other Issues

There is an issue with the Popcorn Hour that allows only one SMB/NFS share to be mounted at one time. Please ensure that you have browsed to the share at least once since the last time you rebooted the PCH.

For this reason, you should have the Jukebox on the same share as your video files, one the hard disk of the PCH or via a HTTP server.

See MultipleNetworkShares for more information