Base de documentation Wiki GeeXboX ...
Booter sur Mac ...
Activer les effets de traitement d'image (Post-Processing) ...
Construire la GeeXboX ...
Documentation de MPlayer ...
Utilisation de l'installator ...
GeeXboX installé en dual boot avec un autre Linux ...
Modifier la configuration TV ...
Modifier la configuration du réseau ...
Modifier la configuration WiFi ...
Utiliser une passerelle pour accéder à Internet et lire du contenu streaming en direct ...
Booting depuis le réseau via PXE en utilisant les partages NFS ...
Chargement des firmwares ...
Partage de fichiers via UPnP ...
Support des cartes DVB ...
Menus de Navigation DVD ...
Streaming réseau ...

L'équipe GeeXboX met à disposition de ses utilisateurs un Wiki (espace web collaboratif de documentation) dans le but de les aider à utiliser la distribution GeeXboX. Le but premier de ce Wiki est de fournir aux nouveaux utilisateurs toute l'aide dont ils pourraient avoir besoin pour débuter avec la GeeXboX. Vous y trouverez donc de nombreux conseils et astuces vous permettant d'optimiser votre système ou encore des informations de configuration permettant de faire fonctionner du matériel capricieux.

Le Wiki GeeXboX propose également une section pour dévelppeurs qui a pour but d'aider ceux qui désireraient ajouter de nouvelles fonctionnalités à leur système, expliquant également la procédure de création de patchs ainsi que la meilleure manière d'aider l'équipe de développement.

Comme tout Wiki sur Internet, son contenu ne dépend que des utilisateurs qui voudront bien le remplir. Stockez-y et partagez-y votre savoir.

Booter depuis un CD sur un Mac est particulièrement simple: il suffit de tenir la touche 'c' enfoncée pendant le boot. Cela marche aussi pour le boot réseau avec la touche 'n'.

Mais si vous souhaitez utiliser un Mac uniquement avec la GeeXboX, c'est gênant de devoir tenir une touche enfoncée à chaque boot. La solution est alors de configurer la variable boot-device de l'open-firmware. Il y a au moins deux manière de le faire :

* depuis un shell MacOSX, vous pouvez utiliser la commande suivante :
sudo nvram boot-device='cd:,\\:tbxi'
vous pouvez aussi afficher le contenu des variables avec :
nvram -p

* directement depuis le prompt de l' open-firmware (en pressant command-option-O-F au boot) :
setenv boot-device cd:,\\:tbxi
vous pouvez aussi afficher le contenu des variables avec :
printenv

Quelques-un des périphériques de boot possibles :
* cd:,\\:tbxi pour un boot sur CDROM
* hd:,\\:tbxi pour un boot sur disque dur
* enet:, pour un boot depuis le réseau

Le Post-Processing est un moyen logiciel pour affiner une image, en la rendant plus nette et plus précise. Cela a par contre l'inconvénient de consommer une partie du temps processeur afin de rendre l'image plus belle. Via l'utilisation des filtres internes à MPlayer, la GeeXboX vous permet de minimiser les effets de blocs horizontaux et verticaux, les effets d'anneaux de dégradés et de corriger automatiquement la luminosité de votre film. Par défaut, le Post-Processing est désactivé, pour éviter de saccader sur de petites configurations matérielles. Il vous est possible de l'activer très simplement en éditant le fichier /etc/mplayer/mplayer.conf :

# Set Post Processing (h deblock, v deblock, dering, auto luminance)
# Consumes CPU power, disabled for low configs, uncomment to enable it.
#vf=pp=hb:a/vb:a/dr:a/al:a

Avant tout, vous devez être root (les scripts de construction nécessitent de monter l'image d'amorçage en loopback).

Ensuite, il est possible de construire l'image au moyen de :
make
Ou de directement la graver, via :
make burn

Une fois terminé, vous pouvez économiser de l'espace disque en effaçant l'arbre de construction :
make clean
ou en procédant à un nettoyage complet, supprimant même les sources des programmes téléchargés :
make distclean

Il existe également des commandes plus avancées; si vous désirez procéder à des modifications internes à la GeeXboX :
scripts/get package # télécharge le paquetage
scripts/unpack package # décompresse et prépare le paquetage
scripts/build package # construit le paquetage
scripts/install package # installe le paquetage avec le préfixe $INSTALL
scripts/clean package # nettoie l'arbre de construction du paquetage

Si vous avez réalisé une modification interne à la GeeXboX, vous pouvez simplement construire un petit tar.gz au moyen de :
make dist
ou un tar complet (incluant toutes les sources) via :
make fulldist
ou encore, créer l'archive du générateur d'ISO grâce à :
make generator
et enfin, pour générer l'installator ;
make installator

La seule chose dont vous ayez à vous soucier reste alors le fichier de configuration de la GeeXboX.

La GeeXboX est principalement basée sur l'utilisation de MPlayer. Comme ce lecteur est l'un des lecteurs multimédia les plus performant, il accepte de nombreuses options de configuration et de lancement. Dans la GeeXboX, 2 fichiers sont utilisés pour gérer les options de MPlayer :

* ./packages/MPlayer/menu_lang.conf
* ./packages/MPlayer/mplayer.conf

Le fichier menu_lang.conf est utilisé pour générer le menu OSD. Vous pouvez le modifier si vous décider d'ajouter ou supprimer des options au menu actuel, ou encore pour le traduire dans votre langue favorite.
Le fichier mplayer.conf est directement lié au mode de lancement de MPlayer. La configuration proposée par défaut contient les lignes suivantes :

vo=vesa:vidix,vesa # Pilote de sortie Vidéo (Utilise le mode VidiX si disponible, le mode VESA sinon)
ao=alsa # Pilote de sortie Audio
alang=en,fr # Piste audio par défaut pour les DVD : passe à la suivante, si la précédente n'est pas disponible et ainsid e suite ...
mixer-channel=Master # Périphérique contrôlé par les contrôles internes de volume
framedrop=yes # Lorsqu'il est activé, MPlayer peut 'sauter' le décodage de certaines images si la vidéo apparaît trop lentement
vsync=yes # Active ou non la synchronisation verticale de l'image
fs=yes # Active le mode Plein-Ecran (nécessite davantage de puissance CPU)
zoom=yes #Active le Zoom - modifie le rapport largeur/hauteur (nécessite davantage de puissance CPU)
menu=yes # Affiche le Menu OSD
double=yes # Utilise un double tampon pour l'affichage des images
fixed-vo=yes # Utilise un rapport d'image de taille fixe
nocolorkey=yes # Désactive la couleur clé
cache=1500 # Taille du Cache (en ko)
idx=yes # Permet de reconstruire l'entête du fichier si elle est endommagée
lircconf=/etc/lirc # Emplacement du fichier de configuration de LIRC
subfont-text-scale=3 # Taille des fontes sur l'OSD
screenw=800 # Largeur de l'écran
screeh=600 # Hauteur de l'écran

Davantage de documentation concernant MPlayer et ses fichiers de configuration peut être trouvée sur le site officiel de Documentation de MPlayer.

La GeeXboX a beau être un LiveCD, elle peut également être installée sur disque (seulement sur x86_32 pour l'instant). Il est ainsi possible de très rapidement et facilement installer le système sur n'importe quel disque dur IDE/SATA, carte mémoire SD Card et Compact Flash ou clé/disque USB (prennez soin de vérifier que le BIOS de votre carte mère supporte le démarrage à partir de périphériques USB-HDD). Vous pouvez installer la GeeXboX sur un disque vierge (partition unique dédiée) ou sur une partition libre existante sur votre disque actuel. Tout ce dont vous avez besoin, c'est d'une partition vide contenant au moins 128 Mo d'espace disque.

L'installation est accessible à tous très facilement depuis le CDROM GeeXboX. Lors de l'amorçage d'IsoLinux, choisissez simplement le menu d'installation. La GeeXboX va alors charger un menu permettant l'installation sur disque.

Suivez les instructions et choisissez le disque sur lequel vous désirez installer la GeeXboX. Une fois cela fait, vous arriverez à l'écran de l'application cfdisk qui va vous permettre de partitionner votre disque. Utilisez les flèches directionnelles pour choisir la partition vide représentée par le terme Free Space et choisissez le bouton New. Une fois cela fait, choisissez le type de partition que vous souhaitez créer. Plusieurs systèmes de fichiers sont actuellement supportés : FAT 16/32 et EXT2/3 (il est recommandé de choisir un système FAT uniquement si vous désirez voir et éditer les fichiers de cette partition plus tard depuis un système Windows). Pensez également à activer le paramètre boot via le menu Flags si vous souhaitez utiliser cette partition pour démarrer votre système. Terminez par la commande Commit et enfin Quit.

Choisissez ensuite si vous désirez (ou non) formatter votre partition (recommandé). L'installateur GeeXboX va détecter automatiquement le type de système de fichier que vous avez choisi et formater votre partition en fonction de ce choix. Si vous avez décidé d'utiliser le système EXT, il est recommandé de choisir un formatage en EXT3.

L'installateur vous demandera alors si vous désirez ou non qu'il installe pour vous un amorçeur (bootloader). Dans le cas de périphériques amoviables, cette installation sera forcée. Un bootloader est un logiciel qui vous permet de démarrer une partition depuis le BIOS. GeeXboX utilise GRUB comme amorçeur.

Si vous disposez déjà d'un bootloader sur votre disque, il n'y a pas besoin d'en installer un nouveau, mais il vous sera alors nécessaire de rajouter manuellement les options nécessaires à ce dernier pour démarrer sur votre partition GeeXboX. Dans le cas contraire, si vous ne disposez pas d'autres systèmes d'exploitation sur votre disque ou si vous n'avez qu'un OS de type Microsoft Windows, qui ne permet pas le démarrage de plusieurs systèmes (multiboot), il est recommandé d'accepter que l'installateur rajoute son propre bootloader. L'installateur GeeXboX va ainsi scanner votre disque à la recherche d'autres systèmes d'exploitation et les rajouter automatiquement à la liste des systèmes afin de créer pour vous un multiboot de démarrage, vous permettant de démarrer indifféremment depuis votre ancien système ou depuis la GeeXboX. Une fois terminé, vous devriez être en mesure de démarrer la GeeXboX depuis votre disque comme s'il s'agissait de n'importe quel autre système.

Les étapes suivantes sont facultatives. L'installateur de la GeeXboX vous propose alors de configurer le système, un peu à la manière du générateur d'ISO, au travers d'un outil de post-installation (également disponible par option de démarrage, après installation), appelée configurator, qui vous permet de modifier un grand nombres de paramètres de votre système.

Si vous aimez la GeeXboX et l'utilisez régulièrement, cela peut être une bonne idée de l'installer sur disque dur. En effet, le système sera vu comme un nouveau lecteur sous Windows ou Linux et ainsi, il sera très facilement possible de le modifier pour qu'il corresponde au mieux à vos besoins (en modifiant la configuration de MPlayer, la télécommande supportée, la configuration du réseau ...) sans avoir à regénérer l'ISO et graver un CD.

Si vous disposze déjà d'un système Linux installé sur votre ordinateur, il est possible de simplement rajouter une entrée pour la GeeXboX sur votre menu de démarrage actuel. Cela vous permet ainsi d'installer la GeeXboX très facilement.
A partir du CD GeeXboX CD, copiez simplement le répertoire GEEXBOX vers la partition / de votre Linux courant (nous supposerons qu'il s'agit ici de /dev/sda1). Modifiez ensuite le fichier /boot/grub/menu.lst pour y ajouter les lignes suivantes :

title GeeXboX
root (hd0,1)
kernel /GEEXBOX/boot/vmlinuz root=/dev/ram0 rw rdinit=linuxrc boot=UUID=$mon_uuid lang=en keymap=qwerty splash ...
initrd /GEEXBOX/boot/initrd.gz
quiet

Prenez garde à 2 paramètres:
- le champ root (hd0,1) devra être adapté en fonction de sa valeur actuelle dans votre fichier de configuration GRUB.
- le valeur $mon_uuid correspond à l'identifiant unique de votre partition. Vérifiez au sein de votre fichier de configuration GRUB, quelle est la valeur utilisée pour les autres systèmes d'exploitation utilisant la même partition, ou utilisze la commande ls -l /dev/disk/by-uuid/ afin de voir quelle valeur à été attribuée à la partition désirée.

La GeeXboX supporte désormais les entrées et tuners de cartes TV. Malheureusement, toutes les cartes ne sont pas supportées. Pour celles qui sont supportées, le système essaie avec peine de détecter automatiquement le type de carte et de tuners utilisés. Dans certains cas, la détection automatique peut échouer, ayant pour résultat une horrible image déformée. C'est pourquoi, vous pouvez forcer les paramètres et ainsi éviter la tentative de détection automatique. Veuillez modifier le fichier /etc/tvsettings tel qu'il suit :

# TV CARD/TUNER Model (AUTO for autodetection or look at the following urls)
# http://www.linuxhq.com/kernel/v2.6/2/Documentation/video4linux/CARDLIST.bttv
# http://www.linuxhq.com/kernel/v2.6/2/Documentation/video4linux/CARDLIST.tuner
* TV_CARD=AUTO
* TV_TUNER=AUTO

Laissez le paramètre AUTO si vous souhaitez conserver la détection automatique, ou remplacez le par le numéro de la carte et du tuner, comme décrit dans les URL précédentes. Soyez attentifs : pour forcer les types de cartes et de tuners, vous devez connaître les REFERENCES EXACTES de votre matériel.

Une fois cela fait, vous devriez être en mesure d'utiliser les entrées TV (Composite et S-VHS) de votre carte TV. De la même manière, vous pouvez utiliser le tuner pour regarder la TV. Pour cela, vous devrez définir votre région ainsi que les fréquences des chaînes que vous souhaitez visionner. Encore une fois, éditez simplement le fichier /etc/tvsettings :

# TV Channels
# Syntax : CHAN="Channel Frequency:Channel Title"
# Example:
* #CHAN="29:France 2"
* #CHAN="K08:Canal +"

# TV Channels List
# Available : france, europe-east, europe-west, us-bcast, us-cable
* CHANLIST=france

Faites attention lors de l'édition des canaux TV et veuillez à utiliser la même syntaxe que décrit ci-dessus et les canaux TV devraient apparaître dans le menu principal.

Les versions 0.90-4 et supérieures de la GeeXboX rajoutent le support réseau pour la plupart des cartes Ethernet (malheureusement pas toutes) ainsi qu'un support du protocole Samba (i.e. les partages Windows). La GeeXboX possède un client DHCP permettant de configurer automatiquement votre carte réseau. Dans le cas où votre réseau ne possède pas de serveur DHCP, vous aurez à modifier le fichier /etc/network, contenant les lignes suivantes :

* HOST="" # GeeXboX IP ("" for DHCP)
* SMB_USER="SHARE" # User Login ("" for none)
* SMB_PWD="" # User Password ("" for none)

Vous pouvez très facilement modifier l'IP ainsi que le login et mot de passe des partages Samba. Au démarrage, la GeeXboX cherche la présence d'ordinateurs distants sur un même domaine et essaie de monter automatiquement tous les partages Windows disponibles. Prenez garde à ce que tous les ordinateurs soient bien configurés avec le même nom de domaine si vous désirez que tous les partages soient reconnus.

Si vous êtes l'heureux possesseur d'une carte WiFi compatible avec Linux, vous serez ravi d'apprendre que cette dernière est supportée par les versions 0.97 et supérieures de la GeeXboX. Par defaut, le système tente de détecter automatiquement votre configuration réseau. Si vous disposez à la fois d'une carte réseau Ethernet classique et d'une carte WiFi, seule cette dernière sera configurée. Encore une fois, vous pourrez avoir à modifier le fichier /etc/network afin d'y configurer vos paramètres réseaux. Dans ce dernier, 4 lignes sont relatives aux cartes sans-fils :

* PHY_TYPE="auto" # Network physical type (auto|ethernet|wifi)
* WIFI_MODE="managed" # Wifi working mode (managed|ad-hoc)
* WIFI_WEP="" # Wifi WEP key
* WIFI_ESSID="any" # Wifi SSID

Ces lignes vous permettent de configurer la quasi totalité de vos besoins. Vous pouvez soit conserver la détection automatique, soit forcer l'activation du controleur Ethernet ou WiFi. De la même façon, ceci vous permettra de choisir entre le mode managed et le mode de communication dit ad-hoc et de définir à la fois votre clé WEP et le SSID de votre réseau.

Avec la version 0.97, la GeeXboX supporte désormais l'accès à Internet. Bien entendu, il n'y a pas de connexion directe avec Internet (pas de support des modems et il n'y en aura jamais). Dans le cas où vous disposez d'une connexion partagée à Internet, vous pouvez en faire profiter votre PC multimédia, en utilisant votre routeur ou votre passerelle. Pour cela, définissez simplement l'adresse IP de la passerelle dans le fichier /etc/network.

* GATEWAY="" # Gateway IP ("" for DHCP or no internet connection)

Si vous disposez d'un serveur DHCP, vous n'aurez alors même pas à vous soucier de la configuration de la passerelle :p De cette manière, la GeeXboX est désormais entièrement en mesure de lire des vidéos ou sons en direct, quelque soit le contenu. Inscrivez simplement dans une liste de lecture les URL des flux audio/vidéo que vous souhaitez lire (comme des Web-Radios par exemple ...).

Les versions 0.96 et supérieures de la GeeXboX rajoutent le support des partages NFS ainsi que la possibilité pour une station sans disque dur ni lecteur CD de démarrer depuis le réseau, selon la méthode PXE. Pour obtenir cela, il vous faudra :

* un serveur DHCP
* un serveur TFTP
* un serveur NFS
* une machine supportant le PXE :-)

Depuis un poste GNU/Linux :

Il faut tout d'abord configurer le serveur DHCP pour qu'il envoie les informations de boot PXE. Voici un exemple de configuration avec ISC DHCP :

allow booting;
allow bootp;

subnet 192.168.0.0 netmask 255.255.255.0 {
range 192.168.0.128 192.168.0.192;
option subnet-mask 255.255.255.0;
option broadcast-address 192.168.0.255;
next-server 192.168.0.1;
filename "/tftpboot/GEEXBOX/boot/pxelinux.0";
}

L'option next-server est l'adresse du server TFTP. Ensuite il faut configurer votre serveur TFTP (tel que atftpd) pour qu'il serve le répertoire /tftpboot et copier une arborescence GEEXBOX complète dans ce même répertoire. Par exemple, il est possible de copier le contenu d'un CD de GeeXboX depuis un Linux AVEC L'OPTION CDROM TRANSPARENT DECOMPRESSION ACTIVEE !! (pour vérifier cela, il suffit de regarder si le fichier sbin/init de l'arborescence GeeXboX ne contient pas de caractères totalement incohérents). Si vous avez compilé la GeeXboX vous même a partir des sources, il est aussi possible de générer l'arborescence GEEXBOX avec make pxe.

Ensuite il vous faudra éditer le fichier /tftpboot/GEEXBOX/boot/pxelinux.cfg/default pour faire correspondre le nfsroot au bon chemin NFS vers l'arborescence GeeXboX. Enfin il reste a configurer NFS pour qu'il exporte l'arborescence GEEXBOX avec un fichier /etc/exports ressemblant à ceci :

/tftpboot/GEEXBOX (ro)

et un /etc/hosts.allow ressemblant à :
ALL: ALL

Le tout devrait maintenant fonctionner. Il ne vous reste plus qu'à booter la machine PXE et a voir ce qu'il se passe.

Depuis un poste Microsoft Windows :

Pour démarrer en mode PXE depuis un système Microsoft Windows, il vous faudra les logiciels suivants :

* Un serveur TFTP et un serveur DHCP ( tftpd32 remplira cette tâche).
* Un serveur NFS (comme par exemple Allegro NFS server ).
* Une machine supportant le boot en mode PXE.

Téléchargez et décompressez (aucune installation n'est requise) le dossier tftpd32 quelque part sur votre disque, par exemple C:\tftpd32

Copiez y une arborescence GEEXBOX complète : C:\tftpd32\GEEXBOX

Lancez tftpd32 :
- Sélectionnez le dossier C:\tftpd32 pour "current directory".
- Choisissez l'interface (carte réseau) à utiliser en haut dans "server interface". Ici dans l'exemple, une carte avec l'IP 192.168.0.1
- Cliquez sur "setting" et vérifiez que "DHCP server" soit bien coché.
- Dans l'onglet "DHCP server", remplissez les champs, en suivant cet exemple (se référer à une documentation plus approfondie sur le fonctionnement d'un serveur DHCP pour plus de détails) :

* IP starting pool : 192.168.0.10
* Size of pool : 10
* Boot file : ./GEEXBOX/boot/pxelinux.0
* WINS/DNS server : 192.168.0.254
* Default router : 192.168.0.254
* Mask : 255.255.255.0
* Domain name : mydomain.net

- Faites "save" pour appliquer les modifications.

La première partie est terminée, normalement en démarrant la machine cliente (qui doit lancer la GeeXboX), on devrait apercevoir le chargement jusqu'à l'affichage du logo. Le système se bloquera alors, car le serveur NFS n'a pas encore été configuré.

Installez "Allegro NFS Server" et configurez le comme suit :

Onglet Exports :
* faites un "new name" : et nommez le "/tftpboot/GEEXBOX"
* dans "path", juste en dessous : selectionnez le répertoire "C:\tftp32\GEEXBOX"
* dans "allowed host list", selectionnez "all".
* "Read write" , et "read only user list", selectionnez "root" et "everyone" (pour avoir un log, il suffit de tout cocher dans le dernier onglet).

Faites "Appliquer".

N'oubliez pas de modifier le fichier C:\tftp32\GEEXBOX\boot\pxelinux.cfg\default et d'y changer l'adresse IP "192.168.0.2" en "192.168.0.1" (ou toute adresse que vous aurez choisie).

Il suffit maintenant de démarrer la machine cliente pour amorçer la GeeXboX par le réseau.

La GeeXboX supporte de nombreux pilotes de périphériques mais malheureusement, certains d'entre eux requierent un firmware binaire additionnel propriétaire (i.e. non-libre et donc non-inclus dans la GeeXboX). Le firmware est un fichier binaire qui est envoyé au périphérique (PCI ou USB) lorsque le pilote se charge. Pour chaque pilote, le firmware se doit d'être un fichier spécifique avec un nom pré-déterminé.

Si vous disposez de matériel à problème qui peut nécessiter la présence d'un firmware additionnel (dans la plupart des cas, il s'agit de cartes WiFi ou DVB), vous devrez chercher sur Internet une page concernant le support de périphérique sous Linux et l'utilisation du firmware. La plupart du temps, vous tomberez sur un lien de téléchargement direct. Des fois, il vous sera nécessaire d'extraire ce firmware depuis une archive de pilotes pour Windows qui ont été fourni par le fabricant du périphérique.

Une fois que vous disposerez du fichier de firmware pour votre carte, déposez le simplement dans le répertoire /firmware. Vous pouvez y stocker autant de firmwares que vous voudrez, la GeeXboX essaiera d'elle même de les charger lorsqu'un pilote en aura besoin. La seule chose dont vous ayez à vous soucier et de disposer des bons fichiers de firmwares avec les bons noms avant de regénérer une nouvelle ISO.

Veuillez noter que vous pouvez également utiliser le générateur d'ISO de la GeeXboX qui vous permettra de récupérer les firmwares pour vous. Vous pouvez l'utiliser pour sélectionner tous les fichiers de firmware que vous souhaiter et le générateur les téléchargera et ajoutera pour vous. Assurez vous juste de disposer d'une connexion à Internet lors de l'utilisation du générateur.

UPnP est l'acronyme de Universal Plug And Play et peut se décrire comme un protocole réseau permettant l'auto-découverte de périphériques ainsi que des services qui leur sont associés au sein de votre réseau domestique. La norme UPnP A/V (pour Audio/Video) définit un certains nombre de profiles pour des périphériques permettant le partage et la lecture de fichiers multimédias au sein d'un réseau. Le profile UPnP Media Server permet regroupe tous les périphériques capables de partager des fichiers à des périphériques de type UPnP Media Player ou UPnP Media Renderer, qui sont en mesure de les restituer.

La GeeXboX embarque un logiciel de contrôle UPnP (UPnP Control Point) qui permet l'auto-découverte de tous les périphériques de type Media Server de votre réseau local et qui s'occupe de monter leur contenu en toute transparence dans un point de montage dédié (/mnt/UPnP).

De cette manière, il vous suffit de disposer d'un PC ou autre périphérique possédant un logiciel compatible avec le profile UPnP Media Server pour que son contenu soit accessible depuis la GeeXboX. Pour plus d'infos sur l'UPnP ainsi que l'utilsiation de quelques serveurs, veuillez vous référer à la page Wiki UPnP .

La GeeXboX supporte un grand nombre de cartes DVB (Terrestre i.e. TNT, Cable, ATSC et Satellite) et ce, aussi bien en PCI qu'en USB. Veuillez cependant noter qu'il n'est pour l'instant possible d'utiliser qu'un unique adaptateur DVB à la fois.

Certains péripéhriques DVB (particulièrement ceux en USB) peuvent nécessiter un firmware propriétaire additionnel pour fonctionner correctement. Il vous sera peut être utile de jeter un oeil au LinuxTV DVB Wiki pour vous assurer que votre carte nécessite un tel firmware ou non. Dans ce cas, le générateur d'ISO pourra le télécharger pour vous.

Certains firmwares peuvent être récupérés directement depuis le site Web de LinuxTV , d'autres peuvent être inclus dans l'archive de drivers Windows du constructeur de la carte. Veuillez vous référer à la documentation sur le chargement des firmwares dans la GeeXboX pour de plus amples informations.

Pour chaque carte, la liste des chaînes disponibles est disponible au sein du menu de MPlayer. Il n'est cependant pas possible d'auto-découvrir ces chaînes automatiquement.

De ce fait, la déclaration de chaînes accessibles par DVB dans la GeeXboX peut être fait de différentes manières :

- utiliser une liste de chaîne existante : MPlayer a besoin d'un fichier channels.conf valide et fonctionnel pour faire fonctionner la DVB. Ce fichier peut être généré à l'aide d'utilitaire fournis par le paquetage dvb-apps. Utilisez simplement une distribution Linux classique où votre carte DVB a déjà été configurée, téléchargez l'archive linuxtv-dvb-apps , compilez le tout et créez le fichier de configuration via l'utilitaire scan, dans le format zap (qui est le format par défaut).

Par exemple, pour une carte DVB-S (Satellite) utilisant le fournisseur d'accès Astra-19.2E :

wget http://www.linuxtv.org/download/dvb/linuxtv-dvb-apps-1.1.0.tar.bz2
tar jxvf linuxtv-dvb-apps-1.1.0.tar.bz2
cd linuxtv-dvb-apps-1.1.0/util/scan
make
./scan -x 0 dvb-s/Astra-19.2E > channels.conf

Le drapeau -x 0 indique que le scan ne tentera pas de se connecter aux chaînes cryptées (généralement payantes). Veuillez tout le temps procéder de la sorte, MPlayer ne gérant de toutes façons pas les chaînes DVB cryptées.

Selon votre type de carte DVB, choisissez un fichier de transponders (fournisseur) depuis les répertoires dvb-s, dvb-c, dvb-t ou atsc.

Ensuite, copiez simplement le fichier channels.conf que vous venez de générer au sein du répertoire /etc/mplayer de l'arborescence GeeXboX du générateur and recompilez une ISO.

- utiliser une liste de transpondeur existante : cette procédure est relativement similaire à la précédente à la différence qu'il s'agit cette fois de la GeeXboX qui va s'occuper de scanner les chaînes pour vous et ce, à chaque démarrage. Vous n'aurez ainsi plus besoin d'une autre distribution Linux pour générer le fichier channels.conf.

Pour ce faire, rendez-vous simplement sur le LinuxTV CVS .

Selon votre type de carte DVB (S/T/C/ATSC), sélectionnez le bon répertoire et choisissez le fichier de liste de fréquences de transpondeurs qui correspond à vos besoins ou votre localisation géographique. Renommez ensuite simplement ce fichier en dvb.conf et copiez le dans le répertoire /etc. Puis, reconstruisez une ISO via le générateur.

Au démarrage, si la GeeXboX détecte un fichier de transpondeur valide dans le fichier /etc/dvb.conf, elle l'utilisera pour scanner les chaînes DVB disponibles et générera le fichier /etc/mplayer/channels.conf d'elle-même.

ATTENTION : Le scan de chaînes peut être relativement lent selon le type d'émetteur et le nombre de chaînes à découvrir. Ce processus est de plus effectué à chaque démarrage de la GeeXboX si vous l'utilisez en tant que LiveCD. Il est alors hautement recommandé qu'une fois le scan effectué, vous copiez manuellement le fichier /etc/mplayer/channels.conf qui aura été généré quelque part afin de pouvoir le ré-utiliser dans le générateur d'ISO en suivant la première méthode, ou de faire une installation sur disque dur.

- utiliser l'installator : il s'agit probablement là de la méthode la plus simple mais recquiert une installation sur disque de la GeeXboX. Au cours du processus d'installation, si un périphérique compatible DVB est reconnu sur votre système, le script d'installation vous demandera de lui-même si vous souhaitez rechercher les chaînes disponibles pour votre carte DVB.

L'installator contient la liste complète des fréquences des transpondeurs du site LinuxTV. De ce fait, vous n'aurez qu'à sélectionner votre type de carte ainsi que le transpondeur à utiliser et la GeeXboX s'occupera de scanner le tout et de générer le fichier /etc/mplayer/channels.conf adéquat.

La GeeXboX propose 2 méthodes de lecture des DVD :

- Lecture directe du film (defaut).
- Lecture avec support des menus de Navigation DVD (expérimental).

La première permet une lecture quasi-assurée de la plupart des DVDs. Une fois inséré, le disque est automatiquement détecté et MPlayer va essayer de lire le chapitre qu'il jugera correspondre au film. Le principal avantage réside dans le fait que toutes les scènes de droit d'auteur, publicités ou menus seront sautées pour permettre une lecture instantannée du film. Néanmoins, dans certaines situations (comme les DVD avec des menus très sophistiqués ou encore les DVD de séries TV, contenant de multiples épisodes et donc chapitres), cette méthode n'est pas précise et vous pourriez ne pas être en mesure de lire votre film correctement.

La seconde, bien qu'encore expérimentale avec MPlayer (mais qui a néanmoins de très fortes chances de fonctionner), apporte le support des menus de navigation DVD, vous permettant donc de le lire comme vous le feriez avec n'importe quel lecteur DVD du commerce, avec les avantages et inconvénients qui en découlent.

Il vous est bien entendu possible de basculer d'un mode de lecture DVD à un autre au moyen du menu d'options de la GeeXboX, selon le DVD que vous êtes amener à visionner.

Il vous est également possible de spécifier la méthode de lecture par défaut au moyen du générateur d'ISO de la GeeXboX.

La GeeXboX permet de rajouter les listes de streams SHOUTcast Radio et TV tout autant que vos propres listes de lecture. (locales et distantes.)

L'activation de SHOUTcast se déclare dans le fichier de configuration "GEEXBOX/etc/network". SHOUTcast TV étant succeptible de diffuser des streams à caractère pornographique, une liste noire et une liste blanche peuvent être complétées afin de filtrer le contenu selon vos critères (par défaut, les mots clefs définis pour la liste noire sont "adult xxx porn ESS SWCTV SWPTV Subscription"). La liste noire et la liste blanche sont insensibles à la casse.

Vous pouvez créer vos listes de lecture locales et distantes dans le fichier de configuration "GEEXBOX/etc/netstream" (des exemples sont contenus dans ce fichier). Les listes de lecture distantes concernent uniquement les fichiers M3U Etendus.

Note aux utilisateurs (Français uniquement) :
Il est possible de receptionner un flux "FreeboxTV" grâce à ce fichier. Pour y parvenir, veuillez suivre la procédure suivante :

- dé-commentez l'entrée EXTM3U ad-hoc.