Prérequis

En premier lieu, il vous faut un serveur HTTP avec support du PHP. Vous pouvez par exemple utiliser Lighttpd comme décrit dans mon guide Installer Lighttpd et PHP 5 sur Debian 4.0 Etch.

Nous ajoutons les dépôts Debian Multimédia afin de pouvoir profiter de Lame:

/bin/echo "# Debian Multimedia Etch repository
deb http://www.debian-multimedia.org etch main" \
    | /usr/bin/tee /etc/apt/sources.list.d/etch-debian-multimedia.list

Nous téléchargeons la clef GPG signant ces dépôts:

/usr/bin/gpg --keyserver pgp.mit.edu --recv-key 07DC563D1F41B907
/usr/bin/gpg -a --export 07DC563D1F41B907 | /usr/bin/apt-key add -

Nous mettons à jour la liste des dépots disponibles:

/usr/bin/apt-get update

Nous installons en plus les modules nécessaires au bon fonctionnement de Ampache :

/usr/bin/apt-get install php5-mysql php5-xmlrpc mysql-client-5.0 flac \
                         mp3splt lame faad ffmpeg vorbis-tools

Et augmentez la limite mémoire de PHP 5:

if [ -e /etc/php5/cgi/php.ini ]; then
  /bin/sed -i -e 's/memory_limit = .*/memory_limit = 128M/' /etc/php5/cgi/php.ini
fi
if [ -e /etc/php5/apache2/php.ini ]; then
  /bin/sed -i -e 's/memory_limit = .*/memory_limit = 128M/' /etc/php5/apache2/php.ini
fi

Une fois ceci fait, n'oubliez pas de redémarrer votre serveur HTTP afin de prendre en compte le nouveau module. Par exemple, pour LigHTTPd:

/etc/init.d/lighttpd force-reload

Installation

Téléchargez la dernière version de Ampache. Pour ce faire, renseignez la version que vous souhaitez télécharger :

VERSION=3.4.3

Et lancez le téléchargement :

/usr/bin/wget http://ampache.org/downloads/ampache-$VERSION.tar.gz \
    --output-document=/tmp/ampache-$VERSION.tar.gz

Une fois le téléchargement terminé, décompressez le fichier à l'emplacement adéquat :

/bin/tar --directory=/tmp -xzf /tmp/ampache-$VERSION.tar.gz

Et renommez le dossier ainsi créé :

/bin/mv /tmp/ampache-$VERSION /opt/ampache

Et créez un lien symbolique pour le rendre disponible à votre serveur Web:

/bin/ln -s /opt/ampache /var/www/ampache

Nous déplaçons les fichiers de configuration vers un emplacement qui leur correspond mieux:

/bin/mv /opt/ampache/config /etc/ampache
/bin/ln -s /etc/ampache /opt/ampache/config

Une fois ceci fait, nous créons la base de données que va utiliser Ampache. Pour ce faire, je vous conseille de suivre mon guide MySQL sur Debian 4.0 Etch.

Attention : Si vous avez suivi mon guide, vous pouvez passer ces lignes de commandes, sinon, remplacer les informations en gras par celles correspondant à votre base de données MySQL :

MYSQL_HOST=localhost
MYSQL_DB=AMPACHE
MYSQL_USERNAME=ampache
MYSQL_USERPWD=ampache_password

Une fois la base de donnée créée, nous reprenons le court normal des choses. En premier lieu, nous plaçons une valeur par défaut pour le nom d'hôte du serveur de la base de données:

if [ -z "$MYSQL_HOST" ]; then
  MYSQL_HOST=localhost
fi

Une fois la base de donnée créée, vous devez créer les tables. Cela se fait par la commande :

/usr/bin/mysql --user=$MYSQL_USERNAME --password=$MYSQL_USERPWD --host=$MYSQL_HOST $MYSQL_DB \
    < /opt/ampache/sql/ampache.sql

Il vous faut maintenant modifier la configuration d'Ampache. Cela se fait par les lignes de commandes suivantes :

/bin/cp /etc/ampache/ampache.cfg.php.dist /etc/ampache/ampache.cfg.php
/bin/sed -i \
    -e "s/;\(web_path[^=]*=\).*/\1 \"\/ampache\"/" \
    -e "s/\(database_hostname =\).*/\1 \"$MYSQL_HOST\"/" \
    -e "s/\(database_name =\).*/\1 \"$MYSQL_DB\"/" \
    -e "s/\(database_username =\).*/\1 \"$MYSQL_USERNAME\"/" \
    -e "s/\(database_password =\).*/\1 \"$MYSQL_USERPWD\"/" \
    /etc/ampache/ampache.cfg.php

Une fois ceci fait, il ne vous reste plus qu'a créer un compte Administrateur, vous pouvez faire cela en visitant:

• http://localhost/ampache/install.php?action=show_create_account

Vous pouvez maintenant supprimer le fichier php ayant servi à l'installation:

/bin/rm /opt/ampache/install.php

Vous disposez maintenant d'une installation d'Ampache fonctionnelle, il ne vous reste plus qu'a y déposer vos fichiers musicaux, et a configurer les catalogues correspondants.

Transcodage des fichiers

Afin de pouvoir mettre à disposition la majorité de vos fichiers musicaux, nous allons configurer Ampache avec diverses options de transcodage en MP3 de vos fichiers musicaux. En premier lieu, nous désactivons les options existantes:

/bin/sed -i -e 's/^transcode_/;transcode_/g' /etc/ampache/ampache.cfg.php

Et nous mettons en place les lignes correspondant à notre configuration:

/usr/bin/wget http://howto.landure.fr/gnu-linux/debian-4-0-etch/installer-la-plateforme-de-streaming-audio-ampache-sur-debian-4-0-etch/ampache_transcode.cfg \
    --output-document=/tmp/ampache_transcode.cfg
/bin/sed -i -e '/List of filetypes to transcode/r /tmp/ampache_transcode.cfg' /etc/ampache/ampache.cfg.php

Pour aller plus loin

Music Player Daemon

Il est possible d'utiliser Ampache pour contrôler un "MPD", ce qui permet notamment d'utiliser votre serveur Ampache pour jouer une liste de lecture sur sa sortie son. C'est très utile si vous souhaitez spécialiser un de vos ordinateur en Jukebox controlé par le réseau. Je ne parlerais pas de la manière de mettre en place une telle configuration, mais je tenais à vous la notifier.

Remerciements

• Merci aux développeurs d'Ampache.
• Merci aux mainteneurs des dépôts Debian Multimédia.
• Merci à Dekkard pour son post sur les forums d'Ampache: Ampache 3.4 and Musepack transcoding.