----------------------------------------------------------------------
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 (version 4 et infrieures) 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
 la  date d'criture de ce  document est la 0.8.6b,  et elle convient
parfaitement  l'usage du Freeplayer.

Vous  pouvez donc  utiliser la  version de  VLC distribue  pour votre
systme d'exploitation, ou en compiler une vous-mme (les instructions
sont disponibles sur http://developers.videolan.org/).


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

Ce package contient les lments suivants:

 => 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.

 => share/fbx-playlist-x.tar.gz

	Code source du gnrateur de playlist (ncessite Qt4).

 => share/vlc-x.tar.bz2

	Code source de VLC media player.


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

 - tlchargez  la version de  VLC correspondant   votre distribution
   sur http://www.videolan.org/

 - dcompressez l'archive

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

 - optionnellement, compilez l'application fbx-playlist (elle requiert
   l'installation de Qt version 4).
