----------------------------------------------------------------------
README: Installation du Freeplayer sous Linux
----------------------------------------------------------------------

Introduction
============

Ce  fichier   contient  principalement  des   informations  techniques
dcrivant  le fonctionnement  du  Freeplayer. Vous  trouverez un  mode
d'emploi plus complet sur le site www.free.fr, rubrique Freeplayer.


Principe
========

Freeplayer utilise  VideoLan VLC Media  Player (www.videolan.org).  Ce
logiciel  est un  lecteur multimdia  multi-plateforme  supportant une
large varit de formats.

Il  est possible  de paramtrer  VLC pour  qu'il diffuse  des fichiers
multimdia vers  la Freebox.  VLC  peut galement tre  configur pour
tre control   distance, via une interface HTTP.   Le navigateur Web
de  la  Freebox est  utilis   cet  effet.   Ce  package contient  un
ensemble  d'utilitaires facilitant  la configuration  de VLC  pour son
utilisation avec la Freebox.

Lors de  l'utilisation du Freeplayer, toutes  les communications entre
votre ordinateur et la Freebox  se font via l'adresse IP 212.27.38.253
ou l'adresse freeplayer.freebox.fr.

Si  vous  utilisez  le  mode  routeur de  la  Freebox,  celle-ci  doit
connatre l'adresse  IP de l'ordinateur  sur lequel le  Freeplayer est
install.   Elle  tentera  donc  de  se  connecter  sur  l'adresse  du
Freeplayer que  vous avez configure  sur la page de  configuration du
mode routeur.

Si  vous  tes  en  mode  bridge,  elle  utilisera  votre  adresse  IP
publique. Si vous avez un  pare-feu, pensez  autoriser les connexions
venant de 212.27.38.253.

Lorsque vous tentez d'entrer dans le bouquet Freeplayer, la Freebox se
connecte sur le port 8080 de votre ordinateur pour rcuprer les pages
Web qu'elle  doit afficher. Ces  pages sont fournies dans  ce package.
Elles  contiennent des  balises spciales,  qui sont  interprtes par
VLC, rendant leur  contenu dynamique.  C'est ainsi que  la playlist de
VLC apparat sur votre cran de tlvision. L'appui sur Play ordonnera
 VLC de commencer la lecture du flux.

Les diffrents  scripts contenus dans ce package  configurent VLC pour
diffuser  les  flux  sur  le  rseau   destination  de  l'adresse  IP
212.27.38.253. La Freebox accepte les  flux MPEG-2 TS uniquement. Ceux
ci doivent tre encapsuls dans de  l'UDP (avec ou sans RTP) avec pour
port de destination 1234.

Pour  diffuser  tout autre  type  de mdia  vers  la  Freebox, il  est
ncessaire de  raliser une  conversion (transcodage) en  MPEG-2.  VLC
peut tre paramtr  pour raliser cette tche   la vole. Ce package
contient un diteur de playlist, qui inclue pour chaque lment ajout
les paramtres  de transcodage ncessaires  pour sa diffusion  vers la
Freebox.

La Freebox n'est pas capable de dcoder les contenus Dolby Digital sur
la sortie pritel. Par dfaut, l'diteur de playlist fait en sorte que
ces  contenus soient  convertis en  stro.  Il  existe  toutefois une
option sur l'diteur  de playlist pour laisser le  son dans son format
d'origine.   Vous pourrez ainsi  bnficier du  son Dolby  Digital sur
votre chane hifi relie  la sortie optique de la Freebox.


Compilation et installation de VLC
==================================

Une  version  rcente du  logiciel  VLC  Media  Player (VideoLan)  est
ncessaire pour utiliser le Freeplayer. La dernire version officielle
en  date (0.8.2) n'est  pas suffisante  car il  n'est pas  possible de
restreindre l'accs  au serveur HTTP   certaines adresses  IPs. Cette
fonctionnalit est disponible dans la version SVN.

Toutes les  informations ncessaires pour compiler une  version SVN de
VLC sont disponibles sur http://developers.videolan.org.


Contenu du package Freeplayer Linux
===================================

Ce package contient les lments suivants:

 => bin/fbx-playlist (sources, et binaire)

	L'diteur de playlist dans sa version graphique (en Qt4)

 => bin/fbx-playlist.pl

	Un gnrateur de playlist en ligne de commande.

 => share/http-fbx/

	Les pages HTML affiches par la Freebox.

 => bin/vlc-fbx.sh

	Script  permettant  de  dmarrer  VLC  avec  la  configuration
	ncessaire  pour l'utilisation du  Freeplayer. Il  accepte une
	playlist en argument.

 => share/doc/html-rs.pdf

	Spcifications du navigateur HTML de la Freebox.

 => share/doc/options-playlist.txt

	Liste  des  options   rajouter  dans  une  playlist VLC  pour
	diffuser les flux pour le Freeplayer.


Installation du package Freeplayer Linux
========================================

 - dcompressez l'archive

 - lancez  install.sh  avec  les   droits  suffisants  et  suivez  les
   instructions.
