Difference between revisions of "Jinzora"

From ArchWiki
Jump to: navigation, search
Line 1: Line 1:
 
[[Category:Multimedia]]  
 
[[Category:Multimedia]]  
 
  
  
 
'''Step 0'''
 
'''Step 0'''
  
If you haven't installed MPD already, follow the wiki guide found [[MPD_-_Music_Player_Daemon]].
+
If you haven't installed MPD already, follow the wiki guide: [[MPD_-_Music_Player_Daemon]]
 +
 
  
 
'''Step 1'''
 
'''Step 1'''
 +
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).
  
Follow the tutorial [[LAMP]] for installing Apache, PHP and MySQL (Note: Installing phpMyAdmin from this 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).
 
  
 
'''Step 2'''
 
'''Step 2'''
  
 
Install the image library Jinzora needs
 
Install the image library Jinzora needs
Code:
+
<pre>
 
+
pacman -S gd
pacman -S gd
+
</pre>
  
  
 
'''Step 3'''
 
'''Step 3'''
  
Uncomment the following line in /etc/php.ini (by deleting the semicolon in front of it Wink)
+
Uncomment the following line in '''/etc/php.ini''' (by deleting the semicolon in front of it ;))
Code:
+
<pre>
 
+
extension=gd.so
extension=gd.so
+
</pre>
  
  
 
'''Step 4'''
 
'''Step 4'''
  
Download the latest version of Jinzora2 from HERE
+
Download the latest version of Jinzora2 from http://www.jinzora.org/pages.php?pn=downloads .
 +
 
  
 
'''Step 5'''
 
'''Step 5'''
  
Copy the downloaded file to ~/httpd/html (i.e. [your user's home directory]/httpd/html) and then extract it with
+
Copy the downloaded file to ~/httpd/html (i.e. ''your user's home directory''/httpd/html) and then extract it with  
Code:
+
<pre>tar -zxvf [filename]</pre>
 
+
tar -zxvf [filename]
+
  
  
 
'''Step 6'''
 
'''Step 6'''
  
In the jinzora2 directory you've now got in ~/httpd/html, run configure.sh
+
In the jinzora2 directory you've now got in ~/httpd/html, run configure.sh
Code:
+
<pre>
 
+
sh configure.sh
sh configure.sh
+
</pre>
  
  
 
'''Step 7'''
 
'''Step 7'''
  
Open up your webbrowser and go to http://localhost/jinzora2/index.php
+
Open up your webbrowser and go to http://localhost/jinzora2/index.php , then follow the installation guide.
  
The only things you'll have to change are
+
* The only things you'll have to change are:
 +
** '''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 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[/u], unless your music is organized on your filesystem exactly the way you want it to be :P
 +
** '''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 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. You can also import more files from the '''Settings''' interface when Jinzora is up and running.
  
''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 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 Razz
+
('''Note :''' While Jinzora was importing my music collection, I had the following error appear twice on the page:
 
+
'''
''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'.
+
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'''
 
+
''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. You can also import more files from the Settings interface when Jinzora is up and running.
+
 
+
(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, don't worry!)
 
This seemed to have no adverse effect on the installation though, so if something similar happens to you, don't worry!)
 +
  
 
'''Step 8'''
 
'''Step 8'''
  
When you've finished importing your music, click Proceed to save config, then Proceed to launch Jinzora. You will now get an error message - to resolve this, you must go into your ~/httpd/html/jinzora2 directory and delete the 'install' directory.
+
When you've finished importing your music, click '''Proceed to save config''', then '''Proceed to launch Jinzora'''. You will now get an error message - to resolve this, you must go into your ~/httpd/html/jinzora2 directory and delete the 'install' directory.
 +
 
  
 
'''Step 9'''
 
'''Step 9'''
Line 79: Line 78:
  
 
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 .
 
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 .
 +
  
 
'''Step 10'''
 
'''Step 10'''
Line 84: Line 84:
 
If you wish to use Jinzora's streaming functionality, you will need to edit /etc/hosts.allow and add
 
If you wish to use Jinzora's streaming functionality, you will need to edit /etc/hosts.allow and add
  
Code:
+
<pre>
 +
mpd:ALL
 +
</pre>
  
mpd:ALL
+
(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 !
  
(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 and Voila! Your own working copy of Jinzora !
+
----
 +
 
 +
 
 +
'''Troubleshooting'''
 +
 
 +
* 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 [b]pacman -S glurp[/b], 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'.
  
Enjoy ;-)
+
* 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.

Revision as of 14:56, 28 December 2005


Step 0

If you haven't installed MPD already, follow the wiki guide: MPD_-_Music_Player_Daemon


Step 1 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).


Step 2

Install the image library Jinzora needs

pacman -S gd


Step 3

Uncomment the following line in /etc/php.ini (by deleting the semicolon in front of it ;))

extension=gd.so


Step 4

Download the latest version of Jinzora2 from http://www.jinzora.org/pages.php?pn=downloads .


Step 5

Copy the downloaded file to ~/httpd/html (i.e. your user's home directory/httpd/html) and then extract it with

tar -zxvf [filename]


Step 6

In the jinzora2 directory you've now got in ~/httpd/html, run configure.sh

sh configure.sh


Step 7

Open up your webbrowser and go to http://localhost/jinzora2/index.php , then follow the installation guide.

  • The only things you'll have to change are:
    • 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 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[/u], unless your music is organized on your filesystem exactly the way you want it to be :P
    • 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 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. You can also import more files from the Settings interface when Jinzora is up and running.


(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, don't worry!)


Step 8

When you've finished importing your music, click Proceed to save config, then Proceed to launch Jinzora. You will now get an error message - to resolve this, you must go into your ~/httpd/html/jinzora2 directory and delete the 'install' directory.


Step 9

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've set in /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 .


Step 10

If you wish to use Jinzora's streaming functionality, you will need to edit /etc/hosts.allow and add

mpd:ALL

(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

  • 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 [b]pacman -S glurp[/b], 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 haven't changed the 'Playback To' option to 'Music Player Daemon.