1 +++++++++++++++++++++++++ +++++++++++++++++++++++++ 2 XINE: Un lecteur video libre 3 +++++++++++++++++++++++++ +++++++++++++++++++++++++ 4 5 6 INDEX 7 -===- 8 9 1 LA DOCUMENTATION 10 1.1 But de ce document 11 12 2 A PROPOS DE XINE 13 2.1 Plateformes supportées et pré requis 14 2.2 Logiciels utilisés 15 2.3 Les développeurs de Xine 16 2.4 Utilisation 17 2.4.1 Raccourcis clavier 18 2.4.2 Selection des canaux audio 19 2.4.3 Sélection des sous titres 20 21 3 QUE RESTE T'IL A DIRE ? 22 3.1 Liberté, DVD et autres choses... 23 24 4 Contacter le projet Xine 25 26 27 28 29 30 31 321 LA DOCUMENTATION 33 341.1 But de ce document 35 36 Il s'agit de la documentation destinée à l'utilisateur final de xine-lib 37 et xine-ui. Vous pourrez trouver plus de documentation dans le répertoire 38 doc/ de chacun des packages. 39 40 Merci également de regarder de plus près les questions fréquentes (le FAQ), 41 inclus dans le package xine-ui, qui pourrais également contenir des 42 réponses à vos questions. 43 442 A PROPOS DE XINE 45 46 xine est un lecteur vidéo libre, pour systèmes de type UNIX, fonctionnant 47 sous licence GPL. 48 Il supporte les systèmes (vidéo et son multiplexés) de flux MPEG-2 & MPEG-1, 49 des flux MPEG élémentaires (audio/vidéo seulement, c.f. fichiers MP3), les 50 fichiers AVI avec de nombreux formats vidéo (certain utilisant des DLLs 51 win32) et les flux OGG Vorbis. Il existe un support pour certains flux 52 Quicktime (mais la plupart des codecs vidéo et audio de Quicktime sont 53 hautement propriétaires, et de ce fait non supportés). 54 55 Xine lit les données vidéo et audio dans les flux et synchronise leur 56 lecture. En fonction des propriétés des flux, la lecture necessitera plus 57 ou moins de charge processeur, la taux de rafraichissement maximal pour du 58 MPEG-2 a été signalé sur un P-II 400. 59 60 Xine peut lire des Video CDs, SVCDs, et des DVDs directement. Malheureu- 61 sement, le statut légal des DVD encryptés/bloqués est incertain dans 62 plusieurs pays, ainsi Xine ne contient pas le code de décryptage/débloquage. 63 Pour lire de tels DVDs, vous aurez besoin de programmes externes tels que 64 un xine_dvd_plugin qui peut controler l'authentification/décryptage. 65 66 L'équipe du projet Xine dénigre toute responsabilité pour un tel usage de 67 Xine. 68 69 Puisque l'architecture 0.5 de xine permet l'utilisation de plugins 70 flexibles, des formats de flux divers et variés, ainsi que des nouveaux 71 périphériques de sortie pourront être supportés dans le futur. 72 732.1 Plate-formes supportées et pré-requis 74 75 - Xine a besoin d'un serveur X11 pour la sortie vidéo 76 (8, 15, 16, 24 ou 32 bits de profondeur de couleur) 77 78 - Xine peut détecter et utiliser les extensions 'MIT X video' et la mémoire 79 partagée X ('X shared memory') pour de meilleures performance de lecture. 80 81 - Si vous ne pouvez pas utiliser Xv pour fonctionner sur votre plate forme, 82 vous devriez utiliser du 16 bit de profondeur de couleur pour la vitesse. 83 Xv semble fonctionner correctement pour tout les modes de couleur. 84 85 - Si vous possédez une carte vidéo Matrox G200/G400/G450, vous pouvez 86 optionnellement utiliser le driver de sortie vidéo sybcfb/teletux. 87 Reportez vous au fichier README.syncfb pour les détails. 88 89 - Pour la lecture audio, OSS, ALSA, ESD, ARTSD son supportés. 90 - aaxine utilises aalib pour la sortie vidéo, et peut être lancé sur 91 presque tout les terminaux. 92 - Pour compiler Xine, des versions de make, gcc et binutils assez récentes 93 sont requises. 94 95 Xine devrait fonctionner sur n'importe quel compatible PC récent (Pentium 96 et plus) utilisant GNU/Linux ou FreeBSD. 97 Dépendant directement du type de flux que vous voulez visionner, vous aurez 98 besoin de plus ou moins de puissance processeur pour une lecture fluide. 99 A titre de comparaison, les DVDs commenceront a être lu correctement à 100 partir d'un système Pentium II 400 (ou équivalent). Il y a plusieurs 101 facteurs dans l'équation, votre résultat peut donc varier. 102 103 Les cartes vidéo testées avec succès (utilisant Xv) pour les PCs sont : 104 nVidia Riva TNT (Drivers nvidia protégés), nVidia Riva TNT 2, Matrox G400, 105 ATI AIW Rage 128-16 MB, 3dfx Voodoo 3 2000 PCI 16 MB 106 107 Les cartes suivantes ont étés rapportées comme fonctionnelles, cependant il 108 n'est pas clair de savoir si elles fonctionnent avec Xv ou seulement avec 109 XShl (Merci de consulter la mailing list 'xine-user') : 110 111 Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB. 112 113 Xine devrait être capable de montrer de la vidéo sur n'importe quel type de 114 serveur X fonctionnant avec n'importe quelle carte graphique, cependant 115 avec de plus mauvaise performance comparativement à Xv. 116 117 De plus, Xine fonctionne sur Solaris pour i386, machines SPARC sous Linux 118 ou Solaris (le framebuffer CREATOR-3D est connu pour fonctionner), voir 119 README.solaris pour plus d'information. Egalement supportés : certains 120 systèmes basés sur le powerpc (sous Linux), et IRIX sur les MIPS. 121 122 Et le dernier mais non le moindre, Xine est également rapporté comme 123 fonctionnant sur Alpha, IA-64 et S/390. 124 1252.2 Logiciel utilisés 126 127 Xine utilises du code des projets libres suivant : 128 129 - liba52 par Aaron Holtzman et Michel Lespinasse 130 - libmpeg2 par Aaron Holtzman et Michel Lespinasse 131 - libmad par Robert Leslie 132 - libffmpeg par Gerard Lantau 133 134 Sans ces grandes parties de code, Xine ne serait évidemment par ou il en 135 est maintenant. 136 137 De nouveau, de nombreux remerciements au projet Linux Video et DVD "LiViD", 138 d'ou sont venus les idées originelles pour le lecteur vidéo Xine. 139 140 => http://www.linuxvideo.org/ 141 1422.3 Les développeurs de Xine 143 144 Programmation principale de Xine 145 146 Guenter Bartsch <guenter@users.sourceforge.net> 147 148 Suggestions diverses, correctifs de compilation et de programmation, 149 plugin Alsa, interface utilisateur 150 151 Daniel Caujolle-Bert <f1rmb@users.sourceforge.net> 152 153 Plusieurs correctifs de bugs et de crash, détection du taux d'échantillo- 154 nage, désentrelacement logiciel, mises à jour massives de libwin32 155 156 Miguel Freitas <miguel@cetuc.puc-rio.br> 157 158 Routine de sortie vidéo teletux/syncfb, corrections de bugs/tests variés, 159 Alsa 160 161 Joachim Koenig <Joachim.Koenig@gmx.net> 162 163 Développement liba52/libmpeg2 164 165 Michel Lespinasse <walken@zoy.org> 166 167 Package Debian, support utilisateur 168 169 Siegfried Langauf <siggi@users.sourceforge.net> 170 171 Ajoutons à cela diverses autres contributions, voir le fichier 172 xine-lib/AUTHORS 173 1742.4 Utilisation 175 176 Vous pouvez faire fonctionner Xine sans paramètre de ligne de commande, 177 ou vous pouvez spécifier, un ou plus, flux d'entrée directement. Xine 178 tentera de détecter si il peut utiliser l'extension Xv, ou retourner à XShm, 179 mais cette détection peut échouer. 180 Vous pouvez spécifier la sortie vidéo en utilisant l'option "-V", par 181 exemple : 182 183 xine -V XShm 184 185 forcera Xine à utiliser XShm ou seulement X11. 186 187 Si vous voulez envoyer le son sur un réseau avec ESD, placer la variable 188 ESPEAKER avant de démarrer Xine. 189 190 Le flux d'entrée peut être un nom de fichier ou quelque chose que nous 191 appelons "MediaResourceLocator" (ou MRL), qui ressemble à une URL. Tout 192 d'abord, vous spécifiez une source suivie de "://" et un identificateur 193 spécifique de source d'entrée. Les sources utilisables dépendent des 194 plugins d'entrée possédés (pour de simples fichiers, vous pouvez omettre 195 l'identificateur de source d'entrée). 196 197 Essayez : 198 199 xine --help 200 201 pour obtenir une information plus complète sur les options.. 202 203 Xine supporte le protocol xdnd (Version 3), donc si vous avez un 204 gestionnaire de fichiers supportant ce protocole (par ex. gmc) vous pouvez 205 déplacer des fichiers vidéo dans Xine pour lecture. 206 207 Lecture de la piste 3 d'un VCD : 208 209 xine vcd://3 210 211 Exemple pour un accès direct au DVD : 212 213 xine dvd://VTS_01_1.VOB 214 215 2162.4.1 Raccourcis claviers 217 218 Touche Action 219 220 [ENTREE] Lecture 221 [ESPACE] Pause 222 [Haut]/[Bas] Avance rapide / ralenti 223 224 0 Cherche le début du flux courant 225 1-9 Cherche 10-90 % du flux courant 226 [Gauche]/[Droite] Cherche +/- 15 sec(+CTRL : 60 sec) 227 [PgUp]/[Précedent] Saut à l'entrée de playlist précédente 228 [PgDown]/[Suivant] Saut à l'entrée de playlist suivante 229 230 f Passage en plein écran 231 a Changement du ratio d'aspect (AUTO/16:9/4:3/DVB) 232 i Changement du mode d'entrelacement 233 234 z / Shift-Z Zoom in / out de la vidéo 235 Ajouter CTRL pour zoomer horizontalement ou meta pour 236 zoomer verticalement 237 238 "<", ">" Modification de la taille de la sortie vidéo 239 + - Changement du canal audio 240 , . Changement du canal de sous-titrage 241 n m Ajustement de la synchronisation audio/vidéo 242 [HOME] Remise à zéro de la synchro audio/vidéo 243 244 [INSERT] Activation de l'affichage du curseur de la souris dans 245 la fenetre de sortie video 246 247 q Quitter 248 249 h Cacher la fenetre video (utile pour la lecture MP3) 250 251 252 Plus a venir. :-) 253 254 Clic droit (ou touche 'g') dans la fenetre de sortie video pour activer 255 l'affichage du panneau de controle. 256 257 Changement des raccourcis : 258 Vous pouvez également changer un/plusieurs/tout les raccourcis. Pour 259 cela, vous devrez avoir un fichier .xine_keymap dans votre répertoire 260 $HOME. La syntaxe d'entrée d'un raccourci est : 261 262 WindowReduce { 263 key = less 264 modifier = none 265 } 266 267 La touche doit correspondre avec les codes de touche X11. Le modifica- 268 teur peut être : 269 - 'none' quand il n'y a aucun modificateur, 270 - 'control' (ou 'ctrl') pour la touche control, 271 - 'meta' (ou 'alt' sur PC) pour la touche meta, 272 - 'mod3' ou 'mod4' ou 'mod5' disponible seulement sur certaines 273 plate-formes. 274 275 Les modidicateurs peuvent être mixés, séparés par des virgules : 276 277 WindowReduce { 278 key = less 279 modifier = control, alt 280 } 281 282 Si vous ne spécifiez pas de ligne de modificateur, alors ce dernier est 283 équivalent à 'none'. 284 285 Vous pouvez également ajouter des alias de raccourcis, tels que : 286 287 Alias { 288 entry = Pause 289 key = p 290 } 291 292 Ce qui signifie que vous avez ajouté un autre raccourci à l'entrée 293 'Pause', en appuyant sur 'p', vous pouvez également ajouter une section 294 modificateur (voir ci-dessus). Si vous ne le spécifiez pas, le modifi- 295 cateur sera le même que dans la section originale ('Pause' dans le cas 296 présent). 297 298 Recherche de nom de touches sous X11 : 299 Pour connaitre la chaine d'une touche X11, vous pouvez utiliser 'xev', 300 qui est fourni avec votre package X11. 301 Démarrez 'xev' d'un terminal (comme 'xterm'), donnez la main à la 302 petite fenêtre affichée, et appuyez sur la touche que vous désirez 303 spécifier. 304 305 A ce moment, vous verrez quelque chose comme : 306 ... 307 KeyRelease event, serial 27, synthetic NO, window 0x3200001, 308 root 0x3c, subw 0x0, time 4144050914, (259,265), root:(272,319), 309 state 0x0, keycode 81 (keysym 0xff9a, KP_Prior), same_screen YES, 310 ^^^^^^^^ 311 C'est ce que vous cherchez. 312 313 Afficher les raccourcis courants ou créés : 314 Vous pouvez utiliser 'xine --keymap' ou 'xine --keymap=default' pour 315 afficher les raccourcis par défaut. 316 Vous pouvez rediriger les résultats vers un fichier, qui peut devenir 317 un .xine_keymap. 318 319 Pour voir les résultats du remappage, utiliser simplement 320 'xine --keymap=remapped' 321 3222.4.2 Sélection des canaux audio 323 324 Ajouter l'option -a pour sélectionner la piste audio désirée : 325 326 xine -a 3 test.mpg 327 328 Lit la troisième piste audio disponible (et la vidéo, bien sur). 329 330 L'interface utilisateur permet également pour sélectionner une piste 331 audio. 332 3332.4.3 Selection des sous-titres 334 335 Les sous-titres sont stockés dans des pistes différentes comme l'audio. 336 En général, la piste 0 est le sous-titre de la langue par défaut. 337 Utilisez l'option -u pour sélectionner la piste de sous-titrage désirée : 338 339 xine -u 0 test.vob 340 341 Affiche les sous-titre du flux 0. 342 343 Il est également possible de changer le sous-titrage via l'interface 344 utilisateur. 345 3462.4.4 LIRC 347 348 Xine peut être controlé à distance par infrarouges. Pour cela, vous 349 devrez avoir LIRC d'installé (http://www.lirc.org). 350 351 Vous pouvez ajouter des entrées dans votre fichier ~/.lircrc, comme : 352 353 begin 354 remote = SAMSUNG 355 button = Button_Play 356 prog = xine 357 repeat = 0 358 config = Play 359 end 360 begin 361 remote = SAMSUNG 362 button = Button_1 363 prog = xine 364 repeat = 0 365 config = SetPosition10% 366 end 367 368 xine peut auto-générer un modèle d'entrées lirc, en utilisant 369 'xine --keymap=lirc', il est alors possible de rediriger la sortie vers 370 un fichier pour affiner les réglages. 371 372 Toute entrée ressemblera à ça : 373 374 # Reduce the output window size. 375 begin 376 remote = xxxxx 377 button = xxxxx 378 prog = xine 379 repeat = 0 380 config = WindowReduce 381 end 382 383 C'est à vous de spécifier le nom de la télécommande, et à assigner le 384 bouton. 385 386 3873 QUE RESTE T'IL A DIRE ? 388 3893.1 Liberté, DVDs et autre choses 390 391 Xine est un logiciel libre. "Logiciel libre" est relatif au fait d'être 392 "open-source". 393 Cependant, la signification de "logiciel libre" dépasse ce cadre : cela 394 exprime la liberté des utilisateurs des logiciels. Si vous avez le temps, 395 merci de lire ce que la Free software foundation écrit à propos de la 396 liberté et des logiciels : 397 398 => http://www.gnu.org/philosophy/free-sw.html 399 400 Il y a une réelle menace à la liberté quant on en vient aux DVDs : 401 l'industrie cinématographique fait d'immenses efforts pour restreindre la 402 lecture des DVDs dans des machines controllées. La plupart des DVDs 403 actuellement vendus le sont de manière propriétaire - et dans certains pays 404 (notamment aux USA), il peut être illégal de les décrypter - même dans le 405 cadre d'une lecture privée. 406 Heureusement une majorité de gens conviendront que c'est une manière 407 très discutable de traiter les consommateurs. L'équipe du projet Xine 408 condamne ces efforts de l'industrie du cinéma, dans leur essai d'enrayement 409 de la perte de ventes par le démonstration d'un manque de respect vis à vis 410 de tous les clients honnêtes. 411 Cependant, l'équipe du projet Xine est contre le fait de briser les lois 412 existantes. 413 Personne ne sait exactement si il est effectivement illegal quelque part 414 d'écrire, de posséder et d'utiliser des logiciels pour la lecture de DVDs 415 encryptés. Mais comme c'est un point obscur (qui semble potentiellement 416 très dangereux), Xine ne contient aucun code susceptible de décrypter les 417 DVDs. Il semble, cependant, que des parties tierces travaillent sur de 418 telles extensions. Peut-être dans des endroits ou il est légal d'utiliser 419 ces programmes. Quoi qu'il en soit, vous serez incapable de lire des DVDs 420 encryptés avec Xine tel-quel. Merci de noter que ce n'est ni un bug, ni 421 une fonctionnalité manquante, mais bien un problème légal original. Il 422 serait bienvenue de résoudre le problème (par exemple en convaincant 423 l'Amérique et/ou l'industrie cinématographique qu'ils sont vraiment gênants 424 et injustes envers les clients, aussi bien qu'envers les utilisateurs et 425 les développeurs de logiciels libres, mais l'inclusion du code de 426 décryptage de DVDs dans Xine ne résoudra pas le problème. 427 428 4294 Contacter le projet Xine 430 431 Le site web du projet Xine est : 432 433 => http://xine.sourceforge.net 434 435 Les retours ou offres d'aide sont grandement appréciés, merci de contacter : 436 437 La mailing list des utilisateurs Xine <xine-user@lists.sourceforge.net> 438 439