498
edits
Changes
From SME Server
Jump to navigationJump to searchNew page: {{Languages|KPlaylist}} =Maintainer= Sylvain Gomez<br/> mailto:sylvaingomez@free.fr =kPlaylist Description= [http://www.kplaylist.net/ kPlaylist] is a free PHP system ...
{{Languages|KPlaylist}}
=Maintainer=
[[User:Cool34000|Sylvain Gomez]]<br/>
mailto:sylvaingomez@free.fr
=kPlaylist Description=
[http://www.kplaylist.net/ kPlaylist] is a free PHP system that makes your music collection available via the Internet.
[http://www.kplaylist.net/ 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 [http://www.kplaylist.net/index.php?readmore=true more] about kPlaylist and check the [http://www.kplaylist.net/index.php?features=true features].
=kPlaylist RPM=
==Download==
You can download this package ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/kplaylist/smeserver-kplaylist-1.7.426-1.noarch.rpm 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 box|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!
==Upload==
Registered users can upload files (16M max by default). These files will be stored in '''''/opt/kplaylist/files'''''
This folder is also the default MP3 folder!
==Samba Access==
For faster 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).
==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
=Additional information=
*[http://www.kplaylist.net/ Homepage]
*[http://www.kplaylist.net/index.php?documentation=true Documentation]
*[http://www.kplaylist.net/forum/ Forums]
*[http://www.kplaylist.net/index.php?download=true Download section]
''Sylvain Gomez (Cool34000)''
----
[[Category: Contrib]]
[[Category: Webapps]]
=Maintainer=
[[User:Cool34000|Sylvain Gomez]]<br/>
mailto:sylvaingomez@free.fr
=kPlaylist Description=
[http://www.kplaylist.net/ kPlaylist] is a free PHP system that makes your music collection available via the Internet.
[http://www.kplaylist.net/ 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 [http://www.kplaylist.net/index.php?readmore=true more] about kPlaylist and check the [http://www.kplaylist.net/index.php?features=true features].
=kPlaylist RPM=
==Download==
You can download this package ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/kplaylist/smeserver-kplaylist-1.7.426-1.noarch.rpm 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 box|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!
==Upload==
Registered users can upload files (16M max by default). These files will be stored in '''''/opt/kplaylist/files'''''
This folder is also the default MP3 folder!
==Samba Access==
For faster 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).
==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
=Additional information=
*[http://www.kplaylist.net/ Homepage]
*[http://www.kplaylist.net/index.php?documentation=true Documentation]
*[http://www.kplaylist.net/forum/ Forums]
*[http://www.kplaylist.net/index.php?download=true Download section]
''Sylvain Gomez (Cool34000)''
----
[[Category: Contrib]]
[[Category: Webapps]]
