Difference between revisions of "Jinzora"

From ArchWiki
Jump to: navigation, search
(9 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[Category:Audio/Video (English)]]
+
[[Category:Audio/Video]]  
[[Category:HOWTOs (English)]]
+
  
{{Stub}}
+
[http://en.jinzora.com/ Jinzora] is a GPL web based multimedia application. It serves as a streaming server as well as a media management platform. This article will show you how to install and configure Jinzora.
  
:''Jinzora is a GPL web based multimedia application. It serves as a streaming server as well as a media mangement platform.''
+
==Installation==
:''This article will show you how to install and configure Jinzora.''
+
Jinzora can run in two modes, ''streaming'' and using ''mpd''. If you have not installed MPD already, follow the wiki guide: [[mpd]] (It is not required for the streaming mode to operate)
  
==Step 0==
+
===Setup the webserver===
Jinzora can run in two modes, ''streaming'' and using ''mpd''. If you haven't installed MPD already, follow the wiki guide: [[mpd]] (It's not required for the streaming mode to operate)
+
 
+
==Setup the webserver==
+
 
Follow the wiki tutorial for installing Apache, PHP and MySQL: [[LAMP]]
 
Follow the wiki tutorial for installing Apache, PHP and MySQL: [[LAMP]]
  
(Note: Installing phpMyAdmin from the above guide is optional; if you're ever likely to make your own website that will use PHP and MySQL, I'd suggest you install it. Otherwise you probably won't need it).
+
(Note: Installing phpMyAdmin from the above guide is optional; if you are ever likely to make your own website that will use PHP and MySQL, I would suggest you install it. Otherwise you probably will not need it).
  
==Configure PHP==
+
===Configure PHP===
 
Jinzora can make use of the GD and iconv library. It is recommend you enable these.
 
Jinzora can make use of the GD and iconv library. It is recommend you enable these.
Uncomment gd.so and iconv.so in /etc/php/php.ini.
+
Uncomment gd.so and iconv.so in {{ic|/etc/php/php.ini}}.
<pre>
+
extension=gd.so
extension=gd.so
+
extension=iconv.so
extension=iconv.so
+
 
</pre>
+
 
The PHP gd extension requires the gd library to be installed:
 
The PHP gd extension requires the gd library to be installed:
<pre>
+
# pacman -S php-gd
pacman -S gd
+
</pre>
+
  
 
Also take a look at the open_basedir setting. Your media directory should be or below the paths specified in this directory.
 
Also take a look at the open_basedir setting. Your media directory should be or below the paths specified in this directory.
  
 
+
===Download and extract Jinzora===
 
+
Download the latest version of Jinzora2 from http://en.jinzora.com/download and extract the contents using [[tar]]:
==Download and extract Jinzora==
+
 
+
Download the latest version of Jinzora2 from http://en.jinzora.com/download and extract the contents using tar.
+
 
+
 
<pre>
 
<pre>
 
# wget http://get.jinzora.com/jz2current.tar.gz
 
# wget http://get.jinzora.com/jz2current.tar.gz
Line 40: Line 29:
 
</pre>
 
</pre>
  
 +
==Configuring Jinzora==
 +
In the {{ic|~/httpd/html/jinzora2}} directory, run configure.sh
 +
# sh configure.sh
  
 
==Setting up Jinzora==
 
===Correct directory permissions===
 
In the  jinzora2 directory you've now got in '''~/httpd/html''', run configure.sh
 
<pre>
 
# sh configure.sh
 
</pre>
 
 
===Run the installer===
 
===Run the installer===
The installer will automatically configure jinzora, and create the database. Open up your webbrowser and go to http://localhost/jinzora2/index.php and follow the instructions
+
The installer will automatically configure Jinzora and create the database. Open up your web browser, go to http://localhost/jinzora2/index.php and follow the instructions
  
* Pay attentions to these setup steps:
+
* Pay attention to these setup steps:
** '''Page 4 - Installation Type :''' Change from 'Streaming' to 'Streaming & Jukebox' if you wish to listen to the music on the computer you're installing Jinzora2 on (it's primarily a streaming application to allow remote access to, and control of, a streaming server running it).
+
** '''Page 4 - Installation Type :''' Change from 'Streaming' to 'Streaming & Jukebox' if you wish to listen to the music on the computer you are installing Jinzora2 on (it is primarily a streaming application to allow remote access to, and control of, a streaming server running it).
** '''Page 5 - Main Settings :''' If you hover over the boxes here, they explain the settings, so choose whatever you want. It's best to choose 'Database' for Backend Type. I'd also suggest using the 'Tag Data' option for 'Data Structure', unless your music is organized on your filesystem exactly the way you want it to be.
+
** '''Page 5 - Main Settings :''' If you hover over the boxes here they explain the settings, so choose whatever you want. It is best to choose 'Database' for Backend Type. Also consider using the 'Tag Data' option for 'Data Structure', unless your music is organized on your filesystem exactly the way you want it to be.
** '''Page 6 - Backend Setup :''' Unless you've used Jinzora before, or for some reason wish to manually create a MySQL database for it to use, then select 'True' under 'Create Database'.
+
** '''Page 6 - Backend Setup :''' Unless you have used Jinzora before, or for some reason wish to manually create a MySQL database for it to use, then select 'True' under 'Create Database'.
** '''Page 7 - Import Media :''' This step may take a few minutes if you've got a few gigs of music; simply enter into the box the directory where your music is stored. When the installer's finished importing the music from this directory, you'll have the option to import as many other directories as you want, one after the other.  
+
** '''Page 7 - Import Media :''' This step may take a few minutes if you have got a few gigs of music; simply enter into the box the directory where your music is stored. When the installer's finished importing the music from this directory, you will have the option to import as many other directories as you want, one after the other.  
  
You can also import more files from the '''Settings''' interface when Jinzora is up and running. You don't have to do it while installing.
+
You can also import more files from the '''Settings''' interface when Jinzora is up and running. You do not have to do it while installing.
  
 
'''Note:''' While Jinzora was importing my music collection, I had the following error appear twice on the page:
 
'''Note:''' While Jinzora was importing my music collection, I had the following error appear twice on the page:
Line 64: Line 49:
 
on line 1542</pre>
 
on line 1542</pre>
  
This seemed to have no adverse effect on the installation though, so if something similar happens to you, don't worry!)
+
This seemed to have no adverse effect on the installation though, so if something similar happens to you, do not worry!
  
 
===Save the configuration===
 
===Save the configuration===
When you've finished importing your music, click '''Proceed to save config''', then '''Proceed to launch Jinzora'''.
+
When you have finished importing your music, click '''Proceed to save config''', then '''Proceed to launch Jinzora'''.
  
==Setting up MPD to play your music==
+
===Setting up MPD to play your music===
===Configure jinzora===
+
Edit {{ic|~/httpd/html/jinzora2/jukebox/settings.php}}: under 'Description', change 'Winamp Media Player' to 'Music Player Daemon' (or whatever you want), and under 'type' change 'winamp3' to 'mpd'.
  
Edit '''~/httpd/html/jinzora2/jukebox/settings.php''': under 'Description', change 'Winamp Media Player' to `Music Player Daemon` (or whatever you want), and under 'type' change 'winamp3' to 'mpd'.
+
Change 'password' to be empty (so it just reads <nowiki>''</nowiki> rather than 'jinzora'), or change this to whatever password you have set in {{ic|/etc/mpd.conf}}.
  
Change 'password' to be empty (so it just reads <nowiki>''</nowiki> rather than 'jinzora'), or change this to whatever password you've set in '''/etc/mpd.conf''' .
+
Also in this file, change the port from '4800' to '6600', or whatever port you have set MPD to accept connections on in {{ic|/etc/mpd.conf}}.
  
Also in this file, change the port from '4800' to '6600', or whatever port you've set MPD to accept connections on in '''/etc/mpd.conf''' .
+
If you wish to use Jinzora's streaming functionality, simply go back to your webbrowser, click refresh, select 'Music Player Daemon' from the 'Playback To' dropdown menu and Voila! Your own working copy of Jinzora !
 
+
 
+
==Step 10==
+
 
+
If you wish to use Jinzora's streaming functionality, you will need to edit '''/etc/hosts.allow''' and add
+
 
+
<pre>
+
mpd:ALL
+
</pre>
+
 
+
(or alternatively, simply add the ip (range) from whichever remote computer(s) you'll be accessing the stream server with.
+
 
+
Now go back to your webbrowser, click refresh, select 'Music Player Daemon' from the 'Playback To' dropdown menu and Voila! Your own working copy of Jinzora !
+
  
 
==Troubleshooting==
 
==Troubleshooting==
 +
* If you cannot get any sound despite all of the above, try testing mpd with another GUI client (Glurp is a nice simple one - do {{Ic|pacman -S glurp}}, add a track to its playlist and try to play it). If you have no sound in this either, you need to further edit {{ic|/etc/mpd.conf}}. Try uncommenting some of the ALSA settings in this file (assuming you use ALSA).
  
* If you can't get any sound despite all of the above, try testing mpd with another GUI client (Glurp is a nice simple one - do '''pacman -S glurp''', add a track to its playlist and try to play it). If you have no sound in this either, you need to further edit /etc/mpd.conf. Try uncommenting some of the ALSA settings in this file (assuming you use ALSA).
+
* If you know that MPD ''is'' working, then try to match up the settings in Jinzora as closely to those in {{ic|/etc/mpd.conf}} as possible (the settings in Jinzora are accessed from the 4th small green button on the upper left of the 'Slick' interface).
 
+
* If you know that MPD ''is'' working, then try to match up the settings in Jinzora as closely to those in /etc/mpd.conf as possible (the settings in Jinzora are accessed from the 4th small green button on the upper left of the 'Slick' interface).
+
  
 
* If changes to your playlist are ignored, go to System Tools -> Settings Manager -> Main Settings/Playlist and set 'use_ext_playlists' to 'false'.
 
* If changes to your playlist are ignored, go to System Tools -> Settings Manager -> Main Settings/Playlist and set 'use_ext_playlists' to 'false'.
  
* If when you click on the PLAY button of any song / album you are offered a 'playlist.m3u' download, then you haven't changed the 'Playback To' option to 'Music Player Daemon'.
+
* If when you click on the PLAY button of any song / album you are offered a 'playlist.m3u' download, then you have not changed the 'Playback To' option to 'Music Player Daemon'.

Revision as of 16:34, 23 April 2012


Jinzora is a GPL web based multimedia application. It serves as a streaming server as well as a media management platform. This article will show you how to install and configure Jinzora.

Installation

Jinzora can run in two modes, streaming and using mpd. If you have not installed MPD already, follow the wiki guide: mpd (It is not required for the streaming mode to operate)

Setup the webserver

Follow the wiki tutorial for installing Apache, PHP and MySQL: LAMP

(Note: Installing phpMyAdmin from the above guide is optional; if you are ever likely to make your own website that will use PHP and MySQL, I would suggest you install it. Otherwise you probably will not need it).

Configure PHP

Jinzora can make use of the GD and iconv library. It is recommend you enable these. Uncomment gd.so and iconv.so in /etc/php/php.ini.

extension=gd.so
extension=iconv.so

The PHP gd extension requires the gd library to be installed:

# pacman -S php-gd

Also take a look at the open_basedir setting. Your media directory should be or below the paths specified in this directory.

Download and extract Jinzora

Download the latest version of Jinzora2 from http://en.jinzora.com/download and extract the contents using tar:

# wget http://get.jinzora.com/jz2current.tar.gz
# tar -xvf jz2current.tar.gz

Configuring Jinzora

In the ~/httpd/html/jinzora2 directory, run configure.sh

# sh configure.sh

Run the installer

The installer will automatically configure Jinzora and create the database. Open up your web browser, go to http://localhost/jinzora2/index.php and follow the instructions

  • Pay attention to these setup steps:
    • Page 4 - Installation Type : Change from 'Streaming' to 'Streaming & Jukebox' if you wish to listen to the music on the computer you are installing Jinzora2 on (it is primarily a streaming application to allow remote access to, and control of, a streaming server running it).
    • Page 5 - Main Settings : If you hover over the boxes here they explain the settings, so choose whatever you want. It is best to choose 'Database' for Backend Type. Also consider using the 'Tag Data' option for 'Data Structure', unless your music is organized on your filesystem exactly the way you want it to be.
    • Page 6 - Backend Setup : Unless you have used Jinzora before, or for some reason wish to manually create a MySQL database for it to use, then select 'True' under 'Create Database'.
    • Page 7 - Import Media : This step may take a few minutes if you have got a few gigs of music; simply enter into the box the directory where your music is stored. When the installer's finished importing the music from this directory, you will have the option to import as many other directories as you want, one after the other.

You can also import more files from the Settings interface when Jinzora is up and running. You do not have to do it while installing.

Note: While Jinzora was importing my music collection, I had the following error appear twice on the page:

Warning: strpos() [function.strpos]: Offset not contained in string. in /home/httpd/html/jinzora2/services/services/tagdata/getid3/module.tag.id3v2.php
on line 1542

This seemed to have no adverse effect on the installation though, so if something similar happens to you, do not worry!

Save the configuration

When you have finished importing your music, click Proceed to save config, then Proceed to launch Jinzora.

Setting up MPD to play your music

Edit ~/httpd/html/jinzora2/jukebox/settings.php: under 'Description', change 'Winamp Media Player' to 'Music Player Daemon' (or whatever you want), and under 'type' change 'winamp3' to 'mpd'.

Change 'password' to be empty (so it just reads '' rather than 'jinzora'), or change this to whatever password you have set in /etc/mpd.conf.

Also in this file, change the port from '4800' to '6600', or whatever port you have set MPD to accept connections on in /etc/mpd.conf.

If you wish to use Jinzora's streaming functionality, simply go back to your webbrowser, click refresh, select 'Music Player Daemon' from the 'Playback To' dropdown menu and Voila! Your own working copy of Jinzora !

Troubleshooting

  • If you cannot get any sound despite all of the above, try testing mpd with another GUI client (Glurp is a nice simple one - do pacman -S glurp, add a track to its playlist and try to play it). If you have no sound in this either, you need to further edit /etc/mpd.conf. Try uncommenting some of the ALSA settings in this file (assuming you use ALSA).
  • If you know that MPD is working, then try to match up the settings in Jinzora as closely to those in /etc/mpd.conf as possible (the settings in Jinzora are accessed from the 4th small green button on the upper left of the 'Slick' interface).
  • If changes to your playlist are ignored, go to System Tools -> Settings Manager -> Main Settings/Playlist and set 'use_ext_playlists' to 'false'.
  • If when you click on the PLAY button of any song / album you are offered a 'playlist.m3u' download, then you have not changed the 'Playback To' option to 'Music Player Daemon'.