Getting Started with the Alpha Test

YAMJ v3 is at the stage where it is runnable outside of the development environment.

Therefore I have set up a page at MediaPlayerSite for the development builds to be uploaded.

Database

You will need a MySQL database, others will be supported in the future, but for now this works well for what we are doing.

If you do not have a MySQL server available to you (many NAS vendors provide packages, e.g. Synology has one), you will need to download and install MySQL from HERE Once installed, during installation select "Server only", create a database. You can do this in phpmyadmin (linux OS) or MySQL Workbench (windows OS from MySQL Workbench) or from a command prompt:

mysql -u root -p
mysql> create database yamj3;
mysql> grant usage on yamj3 to yamj3@localhost identified by ‘yamj3’;
mysql> grant all privileges on yamj3.* to yamj3@localhost ;

I suggest you call it yamj3 and have a username and password the same.

Download & install the YAMJ components

1. Download the three files (Zip x 2, WAR)
2. Unpack the Jetty zip into a directory. You should have lib & config folders as well as a jetty.cmd file.
3. Move the WAR file into the lib folder of that unpacked folder
4. Configure the config/yamj.properties with your database settings. Change yamj3.database.url=jdbc:mysql://XXX.XXX.XXX.XXX:3306/yamj3 to your local IP(v4)
5. Unpack the FileScanner zip into a separate directory. You should have lib & config folders as well as a filescanner.cmd file
6. Edit the config/yamj-filescanner.properties file to point to the IP address and port (default is 8888) of the core server (as above)
7. Download the plugins (choose the one you want to use) from PLUGINS
8. In the jetty folder, create a folder called plugins. Put the plugins wanted 'by ex: thetvdb and themoviedb)' plugins inside this folder (do not unzip them).
9. If you want MediaInfo, create folder called mediaInfo in the Jetty folder. Download the CLI x64 version and unzip the files in there. MediaInfo

Running the Core

To start the YAMJ Core (database) server, you should just run the jetty.cmd file.

There are two modes available when running the Jetty server. You can use either create or update. Create will drop all the tables and data in the database and effectively start from scratch. During the alpha stage of testing, this should be done each time you update the software.

Once a create has been done on a database, you can use update to start the database with the existing data intact to continue testing.

One of these lines should be added to the yamj3-core.properties file

yamj3.database.auto=create
yamj3.database.auto=update

Scanning your jukebox

You can run the filescanner from the command line, or create a new command file to do it for you.

The basic command is

filescanner -d {dir_to_scan}

e.g.

filescanner -d T:/Films

WARING: it's not recommended to put the video storage inside the yamj3 folder or subfolder. Note: use / in place of \ on windows systems to ensure that nothing is lost as the \ can be seen as an escape character and cause issues.

EVERSION Skins

While that's going you can download eversion. This program allow to run yamj3 under PCH.

Eversion and skins could be installed where you want (in any folder under yamj3 or outside yamj3). Neverless it's usefull to install under yamj3/resources/skins

Follow instruction (with the distribution) to configure.

To start Eversion, navigate to your eversion folder and launch eversion3.phf to start.

BIKINI skins

To upgrade, modify, change status, search for a file, display the video, start to play yamj3 contents, you can use a html5 skin BIKINI, with windows, android, linux inside what browser you want.

Follow instruction (with the distribution) to configure.

Issues

There will be issues.

Please post them in the thread HERE and we will try and sort them out.