xawtvrc -- fichier de configuration d’applications de TV

/etc/X11/xawtvrc
$HOME/.xawtv

xawtvrc est le fichier de configuration utilisé au départ seulement par xawtv (d’où son nom xawtvrc). Actuellement un certain nombre d’autres applications/utilitaires TV le lisent aussi afin de se configurer.

Les applications utilisent à la fois la version globale (/etc/X11/xawtvrc) et la version personnelle ($HOME/.xawtv) du fichier de configuration. Les réglages de la version personnelle écrasent ceux de la version globale.

Applications

Les applications suivantes utilisent ces fichiers de configuration :

xawtv

La classique application X11 de TV.

motv

Une meilleure interface, basée sur motif pour xawtv...

fbtv

Une application de TV pour les modes VESA de la console linux.

ttv

Une application de TV basée sur aalib pour tout terminal.

v4lctl

outil en ligne de commande pour contrôler des périphériques video4linux.

Créer un fichier de configuration

xawtv et motv permettent tous les deux d’éditer les émetteurs et de sauver la configuration. La fonction de sauvegarde ne va pas préserver les éventuels commentaires que vous aurez mis dans le fichier de configuration.

Vous pouvez aussi utiliser votre éditeur de texte favori et modifier directement le fichier de configuration.

Vous pouvez utiliser l’utilitaire en ligne de commande scantv pour créer un fichier de configuration initial. scantv va automatiquement rechercher tous les émetteurs disponibles et les écrire dans le fichier de configuration.

xawtvrc utilise la même syntaxe que smb.conf : les sections commencent par [nom], suivies par des lignes constituées de paires option=valeur.

Il y a quatre sections spéciales : [global], [launch], [eventmap] et [default]. Toutes les autres sections décrivent un émetteur.

Options pour les émetteurs TV.

Les options suivantes sont acceptées pour les émetteurs TV et pour la section [default]. Les options de la section [default] sont utilisées - comme le nom l’indique - comme valeurs par défaut pour tous les autres émetteurs. Vous pouvez y mettre tout ce qui est commun à tous les émetteurs (comme la norme TV qui est utilisée dans votre pays), afin de ne pas avoir à le spécifier pour chaque émetteur.

Avec une section [defaults] correctement remplie, vous n’aurez normalement besoin que de spécifier la fréquence pour chaque émetteur, comme ceci :

[ORB]
channel = 27

Les autres options sont :

fine = n

syntonisation fine (ce que les touches gauche et droite font dans xawtv), 0 par défaut.

norm = pal | ntsc | secam

la norme de TV, pal par défaut

key = touche

Raccourci clavier pour l’émetteur, toutes les combinaisons de X11 sont acceptées ici. Vous pouvez préfixer un raccourci avec Modificateur+, "Ctrl+F" par exemple.

capture = off | overlay | grabdisplay

Mode de capture : aucun, overlay (par défaut, TV card => video, 0% processeur) ou grabdisplay (TV card => main memory => X-Server => video, le taux d’images par seconde dépend alors de la charge et de la taille de l’image). C’est overlay par défaut. Si celui-ci n’est pas disponible (affichage distant, non support par le matériel, etc.) les applications vont automatiquement basculer en grabdisplay.

input = Television | Composite1 | Composite2 | SVHS

source video. Les choix valides dépendent du pilote et du matériel, les valeurs ci-dessus ne sont que des exemples. vous pouvez utiliser "v4lctl list" pour obtenir une liste des choix disponibles.

color = n

bright = n

hue = n

contrast = n

Les valeurs possibles sont 0-65535, 32768 par défaut. L’ajout du symbole de pourcentage change les valeurs possibles pour 0-100, par exemple "50 %" équivaut à "32768".

audio = mono | stereo | lang1 | lang2

Définit le mode audio pour l’émetteur donné.

freq = n

Définit la fréquence de l’émetteur (MHz, canal video). Vous ne devriez pas avoir besoin de ceci en temps normal, tous vos émetteurs étant listés dans la table de fréquences de votre zone (si ce n’est pas le cas, envoyez-moi un correctif). Peut-être seulement si vous vivez près d’une frontière et si le pays voisin utilise une autre table de fréquences.

midi = note

Utilise l’événement midi note jouée pour la <note> comme raccourci clavier pour l’émetteur.

Options globales

Un certain nombre de réglages qui ne sont pas relatifs aux émetteurs vont dans la section "[global]" :

fullscreen = largeur x hauteur

définit le mode vidéo à utiliser pour le plein écran. Ne fonctionne qu’avec XFree, et bien entendu vous avez besoin d’une modeline valide pour ce mode dans votre fichier XF86Config. Vous devez aussi autoriser l’extension VidMode (option -vm, voir ci-dessous) pour que ceci fonctionne.

wm-off-by = [+-]x[+-]y

Certains gestionnaires de fenêtres ne gèrent pas la gravité statique correctement (je connais mwm et kwm). Ceci est parfois ennuyeux en mode plein écran. Avec cette option vous pouvez corriger ceci par un déplacement pour les fenêtres décalées. Par exemple, wm-off-by = -4-24 est optimal pour kwm (le gestionnaire de fenêtres de KDE1).

freqtab =

sélectionne un mappage de canaux vers fréquences. La fenêtre d’options permet (dans xawtv) sous "Frequency table" de lister un menu avec toutes les entrées valides (et permet de changer de mappage en cours d’exécution).

pixsize = largeur x hauteur

taille des vignettes des émetteurs (dans la fenêtre des émetteurs). 0x0 désactive cette fonction.

pixcols = n

nombre de colonnes que la fenêtre des émetteurs doit utiliser. 1 par défaut.

mixer = ctl | device:ctl

Ceci permet de régler le volume en utilisant le mixage de la carte son. ctl est le contrôle du mixer, ex. "vol" pour le réglage maître. "line1" est un bon choix pour la carte TV. device est le périphérique de mixage (/dev/mixer si non spécifié). Le contrôle du volume se fait par le pavé numérique : + l’augmente, - le diminue, Entrée le met en muet.

jpeg-quality = n

définit la qualité pour les images/videos (M)JPEG. Comme toujours le choix possible est [0 .. 100] avec 75 par défaut.

keypad-ntsc = on | off

Active ou pas le mode pavé numérique, désactivé par défaut. Quand il est actif, les chiffres saisis sur le pavé numérique sont interprétés comme numéros de canal (c’est ainsi que la norme NTSC fonctionne). Sinon ils sont compris comme un émetteur prédéfini, ainsi 1 est le premier émetteur défini dans $HOME/.xawtv,...

keypad-partial = on | off

Une autre configuration de mode du pavé numérique, active par défaut. Quand elle est inactive, la saisie d’un chiffre dans le pavé numérique ne change pas l’émetteur si il y a des émetteurs numérotés avec deux chiffres qui commencent par celui-ci.

osd = on | off

Active/désactive l’affichage en surimpression en mode plein écran. Actif par défaut.

ratio = x:y

Défini une proportion pour l’image TV. Par défaut vaut 4:3. Utilisez 0:0 si vous ne voulez pas une proportion fixe.

mov-driver = files | raw | avi | mov

mov-video = ppm | pgm | jpeg | rgb | gray | 422 | 422p | rgb15 | rgb24 | mjpeg | jpeg | raw | mjpa | png

mov-fps = fps

mov-audio = mono8 | mono16 | stereo

mov-rate = rate

Réglages par défaut pour l’enregistrement vidéo. Toutes les combinaisons possibles ne sont pas valides. "streamer -h" affichera une jolie liste.

midi = port

Vous pouvez définir un port ALSA depuis lequel xawtv recevra des évènements midi. Ainsi configuré, vous pouvez programmer les touches de votre clavier midi comme raccourcis clavier et utiliser les évènements du contrôleur midi pour changer des réglages comme le volume, la luminosité etc. Regardez la section [eventmap] ci-dessous pour plus de détails.

La section [launch]

Vous pouvez lancer d’autres programmes depuis xawtv. Ceci est défini par des entrées dans la section "[launch]" :

label = touche, ligne de commande

La touche spécifiée lancera le programme donné. Appeler l’action "Launch(label)" fonctionne aussi. Si vous voulez vous amuser avec les tables de traduction Xt, allez-y. Mais ne venez pas pleurer si vous avez cassé quelque chose ce faisant...

La section [eventmap]

Cette section a tout simplement un certain nombre de lignes "événement = action". "action" peut être n’importe quelle commande que xawtv comprend (lisez la page man de xawtv-remote pour une liste). "événement" est quelque évènement généré par un périphérique d’entrée que xawtv est en train d’écouter. Un événement peut avoir un paramètre, les événements du contrôleur midi par exemple en ont un. S’il existe, le paramètre est ajouté à l’action.

Il y a des mappages d’événements par défaut pour les télécommandes et les joysticks, vous n’avez donc pas besoin d’en créer pour les utiliser. Mais si vous n’aimez pas ces réglages par défaut, vous pouvez les changer aisément.

Voici une liste des évènements valides :

lirc-key-<nom>

La touche <nom> a été appuyée sur la télécommande.

joy-button-<n>

Le bouton de joystick <n> a été enfoncé.

joy-axis-<left|right|up|down>

Le joystick a été déplacé dans la direction donnée.

midi-note-<n>

Un événement note pour la note <n> a été reçu (c.-à -d. que vous avez probablement appuyé sur une touche du clavier midi).

midi-ctrl-<n>

Un message du contrôleur midi pour le contrôle <n> a été reçu. Cet événement a un paramètre (la valeur courante du contrôle).

kbd-key-<nom>

La touche <nom> a été enfoncée au clavier. Seul fbtv accepte celui-ci.

Exemple : Fichier de Configuration

# ceci est un commantaire
# les lignes vides aussi sont ignorées

[global]
freqtab = europe-west
#mixer   = line
jpeg-quality = 75
midi = 64:0
fullscreen = 768x576

# pour /etc/XF86Config
# Modeline  "pal"  50.00  768 832 856 1000  576 590 595 630  -hsync -vsync

[launch]
mixer = M, gtkaumix
AleVT = Ctrl+A, alevt

[eventmap]
midi-ctrl-7 = volume

[defaults]
input = television
norm  = pal

[aRTE]
channel=33
key=F5

[La Sept]
channel = 27
key = F7

# les autres stations continuent ici

[Caméra]
input = Composite1
key = K

scantv(1), xawtv(1), motv(1), fbtv(1), ttv(1), v4lctl(1)

José Jorge <jose.jorge@oreka.com>