KPlaylist

From SME Server
Jump to navigationJump to search


Maintainer

Sylvain Gomez
mailto:sylvaingomez@free.fr

kPlaylist Description

kPlaylist is a free PHP system that makes your music collection available via the Internet.

kPlaylist is a music database that you manage via the web. With kPlaylist you can stream your music (ogg, mp3, wav, wma, etc.), you can upload, make playlists, share, search, download and a lot more.

Read more about kPlaylist and check the features.

kPlaylist RPM

Download

You can download this package here.

If you want to save it directly on your SME Server, you can give these commands at the prompt:

wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/kplaylist/smeserver-kplaylist-1.7.426-1.noarch.rpm

Install

To install kPlaylist, issue the following command:

yum localinstall smeserver-kplaylist-1.7.426-1.noarch.rpm

You can ignore the yum-comments signal event post-upgrade and signal-event reboot.

Special commands

To view kPlaylist's configuration, you can type the following at the prompt:

config show kplaylist

You can change a few parameters:

   DB parameter   |    Options   | Default | Explanation
# HTTPS           | on/off       | off     | Enable/Disable forced https mode of web interfaces
# PublicAccess    | local/global | local   | Accessibility of web interfaces
# MaxUpload       | xM           | 16M     | Max uploadable file size
# URL             | new alias    |         | Optionnal alias for kPlaylist

After any change to kPlaylist configuration, you should apply modifications by typing the following at the prompt:

expand-template /etc/httpd/conf/httpd.conf
/etc/rc7.d/S86httpd-e-smith sigusr1

Update

The RPM installs the latest stable version (1.7.426). If you want to try the development release (1.7.464), simply upload the new file in /opt/kplaylist/html/.

Then edit this file and change MySQL password at line #71

'pass' => 'kplaylist', # MySql password

You can retrieve your existing MySQL password with the following command:

config getprop kplaylist DbPassword

Then rename the file into index.php and apply security:

mv -f /opt/kplaylist/hmtl/kplaylist.1.7.464.php /opt/kplaylist/hmtl/index.php
chown root:www /opt/kplaylist/hmtl/index.php
chmod 660      /opt/kplaylist/hmtl/index.php

Then you need to update the database, this extra step will be done at your first login.

Future RPM versions will of course be able to update an existing installation. A new RPM version will be released each time a stable version comes out.

Uninstall

To uninstall kPlaylist, just hit the following command:

yum remove smeserver-kplaylist

You can ignore the yum-comments signal event post-upgrade and signal-event reboot.

To completly remove kPlaylist (installation files ; MySQL user+database) you will need the following command:

sh /root/KPlaylist-Full-Uninstall.sh
Warning.png Warning:
Default MP3 folder will be deleted by this script! Move your files before launching this script!


kPlaylist Usage

Web Access

kPlaylist web interface is LAN ONLY by default (without HTTPS)

You can access the web interface at http://yourserver/kplaylist

login : admin
pass  : admin

Please change admin password first!

Getting started

kPlaylist's concept is pretty easy to understand:

1) Upload your music in /opt/kplaylist/files(see the 3 following sections for more details)
2) Update your database using Administration console Update
3) Enjoy!

Upload

Registered users can upload files. These files will be stored in /opt/kplaylist/files by default.

The default maximum uploadable file size is 16M (could be enough for most needs). You can modify this default value with following commands:

config setprop kplaylist MaxUpload xxM
expand-template /etc/httpd/conf/httpd.conf
/etc/rc7.d/S86httpd-e-smith sigusr1

where xx is your needed size (don't forget the M!)

Samba Access

For faster local downloading/uploading you can use Samba to access /opt/kplaylist/files.

Simply browse your SME server shares and you will see a folder named kplaylist.

Existing SME accounts will be able to browse this new shared folder after the RPM install.

Adding more sources folders

kPlaylist Supports multiple music sources (drives, directories, nmb, smbfs, nfs, etc).

Option FollowSymLinks is also available which means that you can use symbolic links inside /opt/kplaylist/files.

Just remember that kPlaylist is restricted to /opt/kplaylist by default, you should override the existing template with a custom-template to allow access to the needed folder.

Reminder: Correct procedure to create a custom-template
# Create the folder if not exist
mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf

# Copy original template
cp /etc/e-smith/templates/etc/httpd/conf/httpd.conf/98kplaylist /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/

# Edit /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/98kplaylist
# Replace line #34 with your needed settings
php_admin_value open_basedir /opt/kplaylist:/tmp:/usr/share/pear:/home/e-smith/files/ibays/mp3_ibay/files   (just an example)

# Apply your changes
expand-template /etc/httpd/conf/httpd.conf
/etc/rc7.d/S86httpd-e-smith sigusr1

Now go to kPlaylist web interface and login with the admin account. Clic on Admin control Settings. Then clic on Filehandling and manually add your new path to the list (or create a symbolic link).

Multiple Download

If you want to allow multiple download, edit /opt/kplaylist/html/index.php and modify the following value to true:

$cfg['archivemode'] = true;

Now you will have more download options!

mp3mail

kPlaylist can send mail. If you want to use this feature, you need to tweak MySQL max_allowed_packet (else you will see an error page when trying to send mails).

Create the file /etc/e-smith/templates/etc/my.cnf/011max-allowed-packet if it doesn't exist and paste the following code in it:

max_allowed_packet=32M   (you may need to higher this value)

Then apply new modifications:

expand-template /etc/my.cnf
service mysqld restart
expand-template /etc/httpd/conf/httpd.conf
/etc/rc7.d/S86httpd-e-smith sigusr1

ID3v2 support

getid3 v1.7.x is the default recommended tag reader for kPlaylist. If you want to add this feature to your kPlaylist, just follow this quick howto.

First, Check the latest version here.

wget http://surfnet.dl.sourceforge.net/sourceforge/getid3/getid3-1.7.7.zip
unzip getid3-1.7.7.zip -d /opt/kplaylist/
rm -f getid3-1.7.7.zip

Now edit /opt/kplaylist/html/index.php and modify following lines:

  • Line #95, enable getid3
$cfg['enablegetid3'] = 1;
  • Line #98, provide path to getid3.php
$cfg['getid3include'] = '/opt/kplaylist/getid3/getid3/getid3.php';

Save the file and check if it's working: log in as a admin to kPlaylist, click on Settings and then on 'Filehandling'. If 'Write id3v2 with stream' is not disabled, getid3 should be working. You should also see the version number in the right.

Additional information


Sylvain Gomez (Cool34000)