KPlaylist/fr
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
Téléchargement
Vous pouvez télécharger ce paquetage ici.
Si vous souhaitez le sauvegarder directement sur votre serveur SME, lancez la commande suivante au prompt :
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/kplaylist/smeserver-kplaylist-1.7.426-1.noarch.rpm
Installation
Pour installer kPlaylist, tapez la commande suivante :
yum localinstall smeserver-kplaylist-1.7.426-1.noarch.rpm
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
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), 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.
Les prochaines version du RPM versions seront bien entendu capable de mettre à jour une installation existante. Un nouveau RPM sortira dès qu'une nouvelle version stable sera disponible.
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
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.
Les utilisateur SME existants peuvent parcourir ce dossier partagé après l'installation du RPM.
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 ! 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) 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://yourserver/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)
