-
Notifications
You must be signed in to change notification settings - Fork 11
Installation
YAMJ is not difficult to install, but there are a few manual steps. For a step-by-ste guide see Step By Step Install
Firstly you need to download a couple of required programs, these are:
- Install Sun Java Runtime Environment (JRE) 1.6
- Version 1.6 latest release is required.
- Once downloaded, install the program
- 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
- Download the !MediaInfo program (Command Line Interface version)
- 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
- This should look like
Only needed when you have attachments in your matroska files and want to use them.
- Download the MKVToolnix program
- Install MKVToolnix executables "mkvinfo" and "mkvextract" directly into the !MovieJukebox directory
- This should look like
C:\YAMJ\mkvToolnix\using the example above
- This should look like
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 Command Syntax page describes hot to run the program once your library is created.
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.
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 "$@"
When running !MovieJukebox.sh on your system then it may be, that videos could not be scraped because they contain some special characters.
This depends on the locale setting of your PC. On many systems the locale is set to POSIX so that special characters (like german umlauts) are not recognised correctly.
Following solutions could help in order to use the correct locale when running !MovieJukebox.sh,
export LC_ALL=en_US.UTF-8
So you !MovieJukebox.sh file should look something like this:
export LC_ALL=en_US.UTF-8
java -Djava.net.preferIPv4Stack=true -Xms256m -Xmx512m
-classpath .:./resources:./lib/** com.moviejukebox.MovieJukebox "$@"
You also can use other locales, i.e. de_DE.UTF-8 or fr_FR.UTF-8; just depending on how your files are named, but the locale export should end with .UTF-8.
Which locales your linux system supports can be found out if listing following (or similiar) directory: /usr/lib/locale
Also you can localize your whole computer. Therefore try to set the locale in your linux operating system.
Running the program "locale" should print out following (or similiar) result:
LANG=en_US.UTF-8
LC_CTYPE="en_US.UTF-8"
LC_NUMERIC="en_US.UTF-8"
LC_TIME="en_US.UTF-8"
LC_COLLATE="en_US.UTF-8"
LC_MONETARY="en_US.UTF-8"
LC_MESSAGES="en_US.UTF-8"
LC_PAPER="en_US.UTF-8"
LC_NAME="en_US.UTF-8"
LC_ADDRESS="en_US.UTF-8"
LC_TELEPHONE="en_US.UTF-8"
LC_MEASUREMENT="en_US.UTF-8"
LC_IDENTIFICATION="en_US.UTF-8"
LC_ALL=
If you perhaps use a samba server on a NAS or home server and transfer files from a Windows PC to them, then the samba server should be configured to use UTF-8.
Therefore in the "global" section of your smb.conf (mostly placed in /etc/samba) following to lines should be added:
display charset = UTF-8
unix charset = UTF-8
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