KPlaylist/fr

From SME Server


Maintaineur

Sylvain Gomez
mailto:sylvaingomez@free.fr

Description de kPlaylist

kPlaylist est un système PHP gratuit qui créé votre collection de musique via Internet.

kPlaylist est une base de données musicale que vous pouvez gérer via le web. Avec kPlaylist vous pouvez diffuser votre musique (ogg, mp3, wav, wma, etc.), vous pouvez uploader, créer des playlists, partager, effectuer des recherches, télécharger et bien plus encore.

Plus d'informations sur kPlaylist et liste des fonctionnalités.

RPM kPlaylist

Installation

Pour installer kPlaylist, tapez la commande suivante :

yum install smeserver-kplaylist --enablerepo=smecontribs

Vous pouvez ignorer les messages YUM signal event post-upgrade et signal-event reboot.

Commandes spéciales

Pour voir la configuration de kPlaylist, tapez la commande suivante au prompt :

config show kplaylist

Vous pouvez changer quelques paramètres :

   Paramètre DB   |    Options   | Défaut  | Explication
# HTTPS           | on/off       | off     | Active/Désactive le mode https forcé
# PublicAccess    | local/global | local   | Accessibilité de l'interface web
# MaxUpload       | xM           | 16M     | Taille maxi des fichiers à envoyer
# URL             | nouvel alias |         | Alias optionnel pour kPlaylist

Après toute modification de la configuration de kPlaylist, vous devez appliquez vos changements avec les commandes suivantes :

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

Exemple: Vous désirez changer l'accessibilité de l'interface web à "global"

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

Mise à jour

Le RPM installe la dernière version stable (1.7.426). Si vous souhaitez essayer la version de développement (1.7.464) ou effectuer une installation personnalisée, uploadez simplement le nouveau fichier dans /opt/kplaylist/html/.

Puis éditez ce fichier et changez le mot de passe MySQL password à la ligne #71

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

Vous pouvez retrouver votre mot de passe existant en tapant la commande suivante :

config getprop kplaylist DbPassword

Puis renommez ce fichier en index.php et appliquez la sécurité :

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

Pour terminer, vous aurez besoin de mettre à jour la base de données. Cette étape sera réalisée à votre 1ère connexion.

Désinstallation

Pour désinstaller kPlaylist, tapez simplement la commande suivante :

yum remove smeserver-kplaylist

Vous pouvez ignorer les messages YUM signal event post-upgrade et signal-event reboot.

Pour supprimer complètement kPlaylist (fichiers d'installation + utilisateur/base de données MySQL) vous devrez lancez la commande suivante :

sh /root/KPlaylist-Full-Uninstall.sh
Warning.png Warning:
Le répertoire de MP3 par défaut sera supprimé durant cette opération par le script ! Déplacez vos fichiers avant de lancer ce script !


Utilisation de kPlaylist

Accès Web

L'interface web de kPlaylist est disponible sur le LAN UNIQUEMENT par défaut (sans HTTPS)

Vous pouvez accéder à l'interface à l'adresse http://yourserver/kplaylist

login : admin
pass  : admin

Veuillez changer le mot de passe admin en 1er !

Premiers pas

Le concept de kPlaylist est assez simple à comprendre :

1) Uploadez votre musique dans /opt/kplaylist/files (voir les 3 sections suivantes pour plus de détails)
2) Mettez à jour la base de données en utilisation la console d'administration (bouton Actualiser)
3) Enjoy!

Upload

Les utilisateurs enregistrés peuvent uploader des fichiers (16M maxi par défaut). Ces fichiers seront stockés dans /opt/kplaylist/files par défaut.

Ce dossier est également le dossier de MP3 par défaut !

Accès Samba

Pour un téléchargement/envoi plus rapide, vous pouvez utiliser Samba pour accéder à /opt/kplaylist/files.

Parcourez simplement les partages de votre serveur SME server, vous devriez voir un dossier nommé kplaylist.

Seul l'administrateur SME peut parcourir ce dossier partagé après l'installation du RPM.

Si vous souhaitez autoriser tous les utilisateurs SME à parcourir ce dossier, tapez la commande suivante :

chown -R root:shared /opt/kplaylist/files

Pour revenir aux réglages par défaut, tapez la commande suivante :

chown -R www:www /opt/kplaylist/files


Par défaut, les utilisateurs francophone pourrait rencontrer des problèmes de noms lors des transferts via Samba. Pour régler ce problème de jeu de caractères, appliquez le paramétrage suivant :

db configuration setprop smb UnixCharSet ISO8859-1
expand-template /etc/smb.conf
/etc/init.d/smb restart

Les nouveaux dossiers/fichiers envoyés utiliseront le bon jeux de caractères ! Attention, ceci est également valable pour le reste de vos ibays !

Ajouter plus de dossiers source

kPlaylist est compatible avec plusieurs sources musicales (lecteurs, répertoires, nmb, smbfs, nfs, etc).

L'option FollowSymLinks est également disponible, ce qui signifie que vous pouvez utiliser des liens symboliques à l'intérieur du dossier /opt/kplaylist/files.

Rappellez vous simplement que l'accès de kPlaylist est restreint à /opt/kplaylist par défaut, vous devriez opérer tout changement dans un custom-template pour autoriser l'accès au dossier souhaité.

Rappel: Procédure correcte pour créer un custom-template
# Créez le dossier s'il n'existe pas déja
mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf

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

# Editez /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/98kplaylist
# Remplacez la ligne #34 avec vos changements désirés
php_admin_value open_basedir /opt/kplaylist:/tmp:/usr/share/pear:/home/e-smith/files/ibays/mp3_ibay/files   (juste un exemple)

# Appliquez vos changements
expand-template /etc/httpd/conf/httpd.conf
/etc/rc7.d/S86httpd-e-smith sigusr1

Vérifiez qu'Apache (www ou shared) puisse accéder en lecture/écriture au nouveau dossier et ses fichiers.

Maintenant rendez-vous dans l'interface web de kPlaylist et connectez vous avec le compte admin. Cliquez sur Config dans la console d'administration. Puis cliquez sur Gestion de la librairie et ajouter manuellement votre nouveau chemin à la liste (ou créez un lien symbolique).

Téléchargement Multiple

Si vous souhaitez activer le téléchargement multiple, éditez le fichier /opt/kplaylist/html/index.php et passez la valeur suivante à 'true' :

$cfg['archivemode'] = true;

Maitenant vous avez plus d'options pour le téléchargement !

mp3mail

kPlaylist est capable d'envoyer des mails. Si vous désirez utiliser cette fonctionnalité, vous devez paramétrer dans MySQL max_allowed_packet (sinon vous obtiendrez une page d'erreur lors de vos tentatives d'envoi).

Créez le fichier /etc/e-smith/templates/etc/my.cnf/011max-allowed-packet s'il n'existe pas déja et coller le code suivant dedans :

max_allowed_packet=32M   (vous pourriez avoir besoin d'augmenter cette valeur)

Puis appliquez vos modifications:

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

Support ID3v2

getid3 v1.7.x est le lecteur de tag par défaut recommandé pour kPlaylist. Si vous souhaitez ajouter cette fonctionnalité à votre kPlaylist, suivez ce guide rapide.

Pour commencer, vérifier la dernière version disponible ici.

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

Editez le fichier /opt/kplaylist/html/index.php et modifiez les lignes suivantes :

  • Ligne #95, activez getid3
$cfg['enablegetid3'] = 1;
  • Ligne #98, renseignez le chemin d'accès vers getid3.php
$cfg['getid3include'] = '/opt/kplaylist/getid3/getid3/getid3.php';

Sauvegardez le fichier et vérifiez le bon fonctionnement : connectez vous en tant qu'admin dans kPlaylist, cliquez sur Config puis sur 'Gestion de la librairie'. Si 'Ecrire les ID3v2 dans le flux' n'est pas grisé, getid3 devrait fonctionner. Vous devriez voir également le numéro de version sur la droite.

Tâche planifiée

Une tâche planifiée (cron) peut être créée pour mettre à jour la base de données de kPlaylist. Ceci a le même effet que de cliquer sur "Actualiser" dans la console d'administration.

Editez /opt/kplaylist/html/index.php et modifiez les lignes suivantes :

  • Ligne 125, activez 'autoupdate'
$cfg['autoupdate'] = 1;
  • Eventuellement, enlevez le commentaire ('//') aux lignes 8977, 8978 et 8979
$options['deleteunused'] = 1;  # Si vous désirez enlever de la base de données les fichiers qui ont étés supprimés
$options['rebuildid3'] = 1;    # Si vous souhaitez relire toutes les informations de vos fichiers musicaux (OGG/MP3).
$options['debugmode'] = 1;     # Si vous voulez le mode debug

Vous pouvez vérifier le bon fonctionnement à l'adresse http://votreserveur/kplaylist/index.php?update=5000&user=autooperate

Vous devriez voir ce message : Wrong host (VOTRE IP) or user (autooperate) for update.


Créez un template nommé kplaylist dans /etc/e-smith/templates/etc/cron.d/ et coller le code suivant dedans :

# kPlaylist database update cron job

# ___________ Minute             (de 0 à 59)
#|   ________ Heure              (de 0 à 23)
#|  |  ______ Jour               (de 1 à 31)
#|  | |  ____ Mois               (de 1 à 12)
#|  | | |  __ Jour de la semaine (de 0 à 6 - 0 est dimanche) 
#|  | | | |
#v  v v v v
30 23 * * * /usr/bin/lynx -dump "http://127.0.0.1/kplaylist/index.php?update=5000&user=autooperate"

Enregistrez le fichier et appliquez vos modifications avec la commande suivante :

expand-template /etc/cron.d/kplaylist

Maintenant, tous les jours à 23:30 le serveur effectuera une mise à jour automatique de la base de données kPlaylist.

Informations additionelles


Sylvain Gomez (Cool34000)