Tuesday, April 13, 2010

Jinzora 3 Tutorial - Setup and Configuration on Linux

Jinzora requires the following programs:
A web server, I recommend Apache2
PHP (PHP 5 is the latest).
MySQL (or some other version of a database) - Free and easy to download and setup.

Obtaining the files:
Download the lastest Jinzora3 at http://github.com/jinzora/jinzora3
untar the file to the directory you wish to install it in.. /var/www/ for instance
tar -zxvf jinzora*
Rename the folder as you desire.. since I have a jinzora2 installation I name mine Jinzora3.
sudo mv jinzora* jinzora3
I change the permissions and ownership of jinzora
sudo chown -R www-data jinzora3
If you want to make things easier run the command below...sometimes causes permission issues!
sudo chmod -R 700 jinzora3 **
Or, if you want...
sudo chmod -R 755 jinzora3 **
I would recommend locking this down further than 755..... not nearly as safe!

Web Based Installer

Visit jinzora3 in your browser: http://localhost/jinzora3.  You should see the below page

Choose your language and select "Proceed to Requirements"

Here Jinzora will check your computer for requirements.. you may need to change permissions, just change the permissions for each of the files/folders listed, and recheck requirements, you shouldn't have any difficulty with that.

PDF support is used for album art, and is not required.
 Your default PHP installation will most likely not meet requirements... you will need to edit your php.ini file to meet these requirements (just searching for those terms (such as "memory_limit" and "max_execution_time") should find the setting in the php.ini file).
Locate php.ini (mine is located at /etc/php5/apache2/php.ini) and make the necessary changes.

Once you are all set.. "Proceed to License". Accept...

For Installation type, choose defaults unless you know what you are doing. Main settings is a very important section:

Choose your username and password for the admin account Choose the default access that non-authenticated users have - tooltips explain the options. Choose your front-end...there is a small thumbnail to assist you... Import settings are also very important, and depend on your media. My media is all organized into folders, so I choose "Filesystem" for the data structure, and I dont read the tag data, since I don't necesarrily keep that updated. The Media layout is another setting that needs to be carefully configured. The default is Genre which means the folder structure is "Genre/Artist/Album/Songs". I am not that detailed, I have mine laid out as "Artist/Album/Songs".  After you have that all set up, continue to "Backend Setup".

Setup database, this is quite self-explanatory, it is just for setting up the MySQL backend for Jinzora.

Next, you will need to import your media.  Using the web-based file browser select the directory to import music from.  Depending on what you selected before, and how much music you have, this may take some time.  After that, proceed to "Save Config" and then launch Jinzora.  Once you launch Jinzora, you will be greeted with the following error message:

 Remove /var/www/jinzora3/install (if that is your directory)
 sudo rm -r /var/www/jinzora3/install
You will now be able to log onto Jinzora3 by visiting http://localhost/jinzora3 (or whatever IP and naming scheme you used).

After Install Setup

If you immediately receive a long amount of errors when you log on that are PHP errors you need to change to following line in your php.ini (if you can...it is useful for debugging)

display_errors = on TO display_errors = off

And.. technically that is it.  The interface should be easy to navigate.  You can start building playlists, or play a random selection of songs.  When you select "Play"  your browser will download (by default) a m3u playlist file... just open the file in your player of choice and you should be good to go!
There are, however, a few troubles you may run into.  Jinzora is able to convert different file types on the fly.. however, this option usually needs to be setup correctly to do this.  To set this up, we need to edit the settings.php file, which  is located in the root folder. (We can also edit this from the Jinzora interface... however I find the interface to be rather clunkly... however, if you wish to do so, click on the little hammer icon "Admin Tools" then  to system tools -- settings manager -- main settings -- resampling). Lets go ahead and open the file:
nano /var/www/jinzora3/settings.php
There are a few settings we need to check to make sure they are set correctly.

$allow_resample = "false";  -- Change from false to true
$path_to_flac = "/usr/local/bin/flac"; --change to /usr/bin/flac
(on my distro at least, try "whereis flac" to locate flac on your distro)
$path_to_faad = "c:pubfaad";  --change to   $path_to_faad = "/usr/bin/faad";   (again, double check)
$path_to_mplayer = "/usr/bin/mplayer"; --change to $path_to_mplayer = "/usr/bin/faad";
$mplayer_opts = "-ao pcm -aofile /dev/stdout";  --change to $mplayer_opts = "-f 1 -o /dev/stdout";
$always_resample = "flac|mpc|wv|wav|shn|m4a|ape|ofr|ogg|wma|m4a"; --add m4a if you need to
As a person preference I like to add:
$allow send email = true

You should be all set up for resampling! For grins, here is a chunk of my settings.php

Playing Music in the Web Browser

Next, we can setup your in-browser player.  Once again, that can be changed from the web interface.  Go to Admin Tools -- system tools -- settings manager -- main settings -- playlist, and at the bottom there is a setting for "embedded_player".  This can be set to many different kinds of players... the official list of players listed for jinzora is:

A player I really enjoy is xspf.  Just enter xspf into the embedded player field, and next time you play a song, the player will open up start playing the file.

For mobile phone integration, there is a free app for Jinzora3 on the android operating system for playing your tunes on the go!

That finishes the basic overview of how to get Jinzora3 up and running... enjoy your music anywhere you go!


  1. Thanks for the tutorial. Nicely described.

  2. Driving me crazy. It's like everyone connected with this project has DIED or something, and I have constant problems trying just to start the web-based configuration.

    I briefly get a flash-view of the configuration screen, then it dumps me to one of those ISP-hosted "can't find the web-page you're looking for" screen. I can't figure what's happening, except that apparently "wbi.jinzora.org" doesn't exist any longer, and that's somehow hard-wired into the installation script.

    Anyone have the SLIGHTEST CLUE how to get around that?

  3. Okay, I finally found the culprit. As I suspected, the install depends on a "Web Based Installer" (hence WBI) which USED TO BE lodged at jinzorahelp.com - which is NO LONGER FUNCTIONING!

    In other words, Jinzora is apparently TOTAL abandonware and unless someone has taken the liberty of stashing the WBI code SOMEWHERE, and would like to resurrect it and let me (and anyone else) know where that is, it is now IMPOSSIBLE to install Jinzora!!!


    1. OH, and FYI, the reference is to wbi.jinzora.com, in ../install/step1.php

    2. Sorry :( I have switched to Google Music for now, since it seems to stream better to my phone than the other solutions I've used, so I've stopped using Jinzora for a while, but I DO have a (most likely old) install on my server...if you need files from it, let me konw!

  4. Stuff at this link. Not sure if it's what you're looking for.


  5. Anyway once its been installed and everything is set up to get back to the initial startup screen to make changes?