Les utilisateurs Debian peuvent construire un paquet .deb pour leur propre usage, c'est très simple. Exécutez fakeroot debian/rules binary dans le répertoire racine de MPlayer. Voir Création de paquets Debian pour de plus amples instructions.

Regardez attentivement le listing généré par ./configure, ainsi que le fichier configure.log, ils contiennent des informations sur ce qui sera compilé, et ce qui ne le sera pas. Vous pouvez également consulter les fichiers config.h et config.mak.
Si vous avez quelques librairies installées, mais pas détectées par ./configure, alors vérifiez que vous avez les fichiers d'en-tête (généralement les paquets -dev) et que leur version correspond. Le fichier configure.log vous dit généralement ce qui manque.

Bien que n'étant pas indispensables, les polices peuvent être installées pour l'affichage de l'OSD, et le support des sous-titres. La méthode recommandée est d'installer un fichier de police TTF et de dire à MPlayer de l'utiliser. Voir la section Sous-titres et OSDpour les détails

1.3 A propos de l'interface graphique ?

La GUI à besoin de GTK 1.2.x (elle n'est pas entièrement basée dessus, mais les menus le sont). Les skins sont stockées au format PNG, donc gtk, libpng (ainsi que leurs paquets devel, généralement gtk-dev et libpng-dev) doivent être installés. Vous pouver la compiler en spécifiant l'option --enable-gui durant l'étape ./configure. Ensuite, pour activer le mode GUI, vous devrez lancer le programme gmplayer.

Actuellement vous ne pouvez pas utiliser l'option -gui en ligne de commande, ceci pour des raisons techniques.

MPlayer n'ayant pas de skin par défaut, vous devrez la télécharger si vous voulez utiliser la GUI. Voir la page des téléchargements. Elles pourront se placer dans le répertoire commun($PREFIX/share/mplayer/Skin), ou dans $HOME/.mplayer/Skin. Par défaut, MPlayer consulte ces répertoires à la recherche d'un répertoire nommé default, mais vous pouvez utiliser l'option -skin newskin, ou placer skin=newskin dans votre fichier de configuration pour utiliser la skin dans le répertoire */Skin/newskin.

1.4 Sous-titres et OSD

MPlayer peut afficher des sous-titres durant le film. les formats suivants sont supportés:

• VobSub
• OGM
• CC (closed caption)
• Microdvd
• SubRip
• SubViewer
• Sami
• VPlayer
• RT
• SSA
• MPsub
• AQTitle
• JACOsub

MPlayer peut convertir les formats précédemment listés (excepté les trois premiers) dans dans les formats de destination suivants, avec les options associées:

• MPsub: -dumpmpsub
• SubRip: -dumpsrtsub
• Microdvd: -dumpmicrodvdsub
• JACOsub: -dumpjacosub
• Sami: -dumpsami

Les options en ligne de commande diffèrent légèrement suivant les différents formats:

Sous-titres VobSub

Les sous-titres VobSub consistent en un gros (plusieurs méga-octets) fichier .SUB, et d'éventuels fichiers .IDX et/ou .IFO.
Utilisation: si vous avez des fichiers tels que sample.sub, sample.ifo(optionnel), sample.idx - vous devrez passer les options -vobsub sample [-vobsubid <id>] (éventuellement avec le chemin complet). L'option -vobsubid est comme l'option -sid pour les DVDs, vous pouvez choisir les pistes de sous-titres (langues) avec. Au cas où -vobsubid est omis, MPlayer essaiera d'utiliser les langues indiqués par l'option -slang et se rabattra sur l'objet langidx du fichier .IDX pour définir la langue de sous-titres. Si cela échoue, il n'y aura pas de sous-titres.

Autres sous-titres

Les autres formats consistent en un seul fichier texte contenant le timing, l'emplacement et autres infos du texte.
Utilisation: si vous avez un fichier tel que sample.txt,vous devrez passer l'option -sub sample.txt (éventuellement avec le chemin complet).

Réglage du timing et de l'emplacement des sous-titres:

-subdelay <sec>

Décale les sous-titres de <sec> secondes. Peut être négatif.

-subfps <rate>

Spécifie le rapport trame/sec du fichier de sous-titres (nombre à virgule).

-subpos <0 - 100>

Spécifie la position des sous-titres sur l'écran.

Si vous constatez un décalage progressif entre le film et les sous-titres en utilisant un fichier de sous-titres MicroDVD, il est probable que la vitesse du film et celle des sous-titres sont différentes.
Veuillez noter que le format de sous-titres MicroDVD utilise des numéros de trames absolus pour sa synchronisation, et de plus l'option -subfps ne peut pas être utilisée avec ce format. MPlayer n'a pas la possibilité de deviner la vitesse du fichier de sous-titres, vous devrez donc convertir manuellement la vitesse. Il y a un petit script perl dans le répertoire contrib du serveur FTP de MPlayer qui fera la conversion pour vous.

MPlayer essaiera de deviner les fichiers de sous-titres que vous voulez utiliser pour lire un film. Si, comme dans la plupart des cas, le fichier de sous-titres et celui du film ont le même nom et sont au même endroit, vous n'avez pas besoin de définir les options de sous-titres. Jouez simplement le film, MPlayer gérera les sous-titres automatiquement.

A propos des sous-titres DVD, voir la section DVD.

1.4.1 Format de sous-titres propre à MPlayer (MPsub)

MPlayer introduit un nouveau format de sous-titres appelé MPsub. Il a été conçu par Gabucino. Son principal avantage est de se baser dynamiquement sur la durée (bien qu'il possède également un mode basé sur les frames). Exemple(de DOCS/tech/mpsub.sub):

# premier nombre : attends cette durée après la disparition du dernier sous-titre
# second nombre : affiche le sous-titre en cours pour tant de secondes

15 3
A long long, time ago...

0 3
in a galaxy far away...

0 3
Naboo was under an attack.


Comme vous pouvez le constater, l'objectif ici est de faciliter l'édition la synchronisation, la jointure et le découpagedes sous-titres. Si vous avez un sous-titre SSA mal synchronisé avec votre version de la vidéo, faites simplement un mplayer dummy.avi -sub source.ssa -dumpmpsub. Un fichier dump.mpsubsera crée dans le répertoire courant, contenant le texte du sous-titre au format MPsub. Vous pourrez alors aisément ajouter/soustraire du temps entre les sous-titres.

Les sous-titres sont affichés par la technique de l''OSD', On Screen Display. OSD est utilisé pour afficher le temps de lecture, la barre de volume, d'avance/retour rapide, le contraste, etc.

1.4.2 Installer l'OSD et les sous-titres

Vous aurez besoin d'un paquetages de polices pour MPlayer afin d'utiliser les fonctions d'OSD/SUB. Plusieurs manières de les obtenir :

• téléchargez des paquetages de polices prêtes à l'emploi depuis le site de MPlayer. Note: Les polices actuellement disponibles sont limitées a l'iso 8859-1/2, mais il y en a quelques autres (coréen, russe, 8859-8, etc) dans la section contrib/font du FTP, créées par les utilisateurs.
  
  Les polices devront disposer du fichier font.desc approprié qui associe les positions maps unicode au code actuel du texte sous-titré. Une autre solution est d'avoir des sous-titres encodés en utf8 et d'utiliser l'option -utf8 ou de renommer le fichier des sous-titres en <video_name>.utf et de le placer dans le même répertoire que le film. Enregistrer de codepages différents en utf8 peut se faire en utilisant les programmes konwert (debian) ou iconv (RedHat).
  Quelques liens:
  • ftp://ftp.mplayerhq.hu/MPlayer/releases/fonts/ - polices ISO
  • ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/ - contributions d'utilisateurs
  • http://realtime.ssu.ac.kr/~lethean/mplayer - polices coréeenes & plugin RAW
• utilisez le générateur de polices TOOLS/subfont-c. C'est un outil complet pour convertir les polices TTF/Type1/etc vers des paquetages de polices mplayer. (lisez TOOLS/subfont-c/README pour plus de détails)
• Utilisez le plugin générateur de polices de GIMP situé dans TOOLS/subfont-GIMP (note: vous devez également avoir le plugin HSI RAW, voir url plus bas)
• utiliser une fonte TrueType (TTF), selon la librairie freetype. La version 2.0.9 ou supérieur est obligatoire! Ensuite vous avez deux méthodes:
  • utilisez l'option -font /chemin/de/arial.ttf pour spécifier un fichier de polices TrueType pour chaque occasion
  • créez un lien symbolique: ln -s /chemin/de/arial.ttf ~/.mplayer/subfont.ttf

Si vous avez choisi des polices non-TTF, dézippez le fichier vers ~/.mplayer ou $PREFIX/share/mplayer. Ensuite renommez ou faite un lien symbolique de l'un d'eux sur font (par ex: ln -s ~/.mplayer/arial-24 ~/.mplayer/font). Vous pouvez maintenant voir un compteur dans le coin supérieur gauche du film. (Faites les apparaître/disparaître avec la touche 'o').

L'OSD possède 4 états: (interchangeable avec 'o')

(les sous-titres sont toujours activés, pour les désactiver merci de lire la page de man)

• barre de volume + barre d'avancement (par défaut)
• barre de volume + barre d'avancement + compteur + position en pourcentages quand déplacement
• barre de volume + barre d'avancement + compteur + durée totale du média
• uniquement les sous-titres

Vous pouvez en modifier le comportement par défaut en spécifiant la variable osdlevel= dans le fichier config, ou en précisant l'option -osdlevel en ligne de commande.

1.4.3 Menu OSD

MPlayer possède une interface de menu OSD complètement modulable.

NOTE: le menu des préférences n'est PAS IMPLÉMENTÉ pour l'instant !

Installation

1. compilez MPlayer en passant le paramètre --enable-menu à ./configure
2. assurez-vous que les polices OSD sont installées
3. copiez etc/menu.conf dans votre répertoire .mplayer
4. copiez etc/input.conf dans votre répertoire .mplayer, ou dans le fichier de config globale de MPlayer (par défaut: /usr/local/etc/mplayer)
5. trouvez et éditez input.conf pour activer les touches correspondant aux mouvements dans le menu (c'est décrit sur place).
6. lancez MPlayer avec par exemple:
   $ mplayer -menu file.avi
7. pressez n'importe laquelle des touches menu que vous avez défini

1.5 RTC

• Pour utiliser l'ancienne méthode, vous n'avez rien à faire. Elle utilise usleep() pour régler la synchro A/V, avec une précision de +/- 10ms. Cependant parfois la synchro doit être réglé encore plus finement.
• Le nouveau code de synchro utilise la RTC (Real Time Clock) du PC pour cette tâche, car elle à des timers précis à 1ms près. Il est automatiquement activé si disponible, mais requiert des droits root, un binaire MPlayer setuid root ou un noyau configuré dans ce but.
  Si vous utilisez un noyau 2.4.19pre8 ou plus récent, vous pouvez ajouter la fréquence maxi de la RTC pour les utilisateurs normaux au travers du système de fichier /proc Utilisez cette commande pour activer la RTC pour les utilisateurs normaux:

  echo 1024 > /proc/sys/dev/rtc/max-user-freq

  Si vous n'avez pas un noyau si récent, vous pouvez aussi changer une ligne du fichier drivers/char/rtc.c et recompiler votre noyau. Trouvez la section suivante

         * We don't really want Joe User enabling more
         * than 64Hz of interrupts on a multi-user machine.
         */
        if ((rtc_freq > 64) && (!capable(CAP_SYS_RESOURCE)))
      

  et changez le 64 en 1024. Cependant, vous devriez savoir ce que vous faites.
  Vous pouvez voir l'efficacité du nouveau timer sur la ligne d'état.
  Les fonctions d'économie d'énergie du BIOS de certains portables qui contrôlent la vitesse des processeurs interfèrent avec la RTC. L'audio et la vidéo peuvent alors se désynchroniser. Brancher l'alimentation sur secteur avant de démarrer le portable semble aider. Vous pouvez toujours désactiver le support RTC avec l'option -nortc. Dans certaines configurations matérielles (confirmé durant l'utilisation d'un lecteur DVD sans DMA sur une carte ALi1541), l'utilisation de la RTC peut causer une image qui "e;saute"e;. Dans ce cas, il est recommandé d'utiliser la troisième méthode.
• Le troisième code de synchro est activé avec l'option -softsleep. Il à la précision de la RTC, mais n'utilise pas la RTC. D'un autre côté, il nécessite plus de CPU.

2. Fonctionnalités

2.1 Formats supportés

2.2 Codecs supportés

2.3 Périphériques de sortie Video & Audio

2.4 Entrée TV

Cette section concerne l'activation de la lecture/enregistrement à partir d'un tuner TV compatible V4L. Voir la page de man pour une description des options TV et des contrôles clavier.

2.4.1 Compilation

1. D'abord, vous devez recompiler. ./configure autodétectera les entêtes v4l du noyau et l'existence des entrées /dev/video*. Si elles existent, le support TV sera activé (voir le résultat de ./configure).
2. Assurez-vous que votre tuner fonctionne avec d'autres logiciels TV pour Linux. par exemple xawtv.

2.4.2 Astuces d'utilisation

• Utilisez l'option channels. Un exemple:
  -tv channels=26-MTV1,23-TV2 tv://
  Explication: en utilisant cette option, seuls les canaux 26 et 23 seront utilisables, et il y a un joli texte OSD lors des changements de canal affichant le nom du nouveau. Les espaces dans le nom du canal doivent être remplacés par le caractère "_".
• Choisissez des dimensions d'image sensées. La dimension de l'image de destination devrait être divisible par 16.
• Si vous capturez la vidéo avec une résolution verticale supérieure à la moitié de la pleine résolution (c-a-d. 288 pour PAL ou 240 pour NTSC, assurez-vous d'avoir désactivé l'entrelacement. Sinon votre film sera distordu pendant les scènes fast-motion et le contrôleur de bitrate ne sera probablement même pas capable de garder le bitrate demandé car l'artefact de désentrelacement produit un grand taux de détails et donc consomme plus de bande passante. Vous pouvez désactiver l'entrelacement avec -vf pp=DEINT_TYPE. Généralement pp=lb peut faire un bon travail, m'est c'est une histoire de préférence personnelle. Voyez les autres algorithmes de désentrelacement dans le manuel et essayez-les.
• Coupez les espaces morts. Quand vous capturez la vidéo, les bords sont généralement noirs ou contiennent du "e;bruit"e;. De nouveau cela consomme de la bande passante inutilement. Plus précisément ce ne sont pas les zones noires elles-mêmes mais les transitions nettes entre le noir et la vidéo plus claire qui jouent, mais ce n'est pas très important pour le moment. Avant que vous commenciez la capture, ajustez les arguments de l'option crop pour que toutes les saletés des bords soient coupées. De nouveau, n'oubliez pas de garder des dimensions sensées.
• Regardez la charge CPU. Elle ne devrait pas dépasser la limite des 90% la plupart du temps. Si vous avez un gros tampon, MEncoder peut survivre à une surcharge pendant quelques secondes mais pas plus. Il vaut mieux désactiver l'économiseur d'écran OpenGL et les trucs similaires.
• Ne jouez pas avec l'horloge système. MEncoder l'utilise pour la synchro A/V. Si vous réglez l'horloge système (surtout en arrière dans le temps), MEncoder va se sentir perdu et va perdre des trames. C'est un problème important lorsque vous êtes en réseau et que vous utilisez certains logiciels de synchronisation comme NTP. Vous devrez désactiver NTP pendant le processus de capture si vous voulez capturer correctement.
• Ne changez pas le outfmt à moins que vous sachiez ce que vous faites ou votre si votre carte/pilote ne supporte pas la valeur par défaut (palette YV12) Dans les versions précédentes de MPlayer/MEncoder il était nécessaire de spécifier le format de sortie. Ce problème devrait être résolue dans la version actuelle et outfmt n'est plus requis, et la valeur par défaut convient dans la plupart des cas. Par exemple, si vous capturez en DivX en utilisant libavcodec et que vous spécifiez outfmt=RGB24 de façon à augmenter la qualité de l'image capturée, l'image capturée sera reconverti plus tard en YV12; donc la seule chose que vous obtiendrez est un gaspillage massif de puissance CPU.

Pour spécifier la palette I420 (outfmt=i420), vous devez ajouter une option -vc rawi420 à cause d'un conflit entre fourcc et un codec vidéo Intel Indeo.

• Il y a plusieurs façons de capturer l'audio. Vous pouvez attraper le son soit avec votre carte son via un cable externe entre la carte vidéo et l'entrée-ligne, soit en utilisant le DAC intégré au chip bt878. Dans ce dernier cas, vous devrez charger le pilote btaudio. Lisez le fichier linux/Documentation/sound/btaudio (dans l'arborescence du noyau, pas celle de MPlayer) pour les instructions d'utilisations de ce pilote
• Si MEncoder ne peut pas ouvrir le périphérique audio, assurez-vous qu'il soit réellement disponible. Il peut y avoir des ennuis avec certains serveurs de son comme arts(KDE) ou esd (GNOME). Si vous avez une carte son full duplex (presques toutes les cartes descentes le supportent aujourd'hui), et que vous utilisez KDE, essayez d'activer l'otpion "full duplex" dans le menu des préférences du serveur de son.

2.4.3 Exemples

Sortie muette, vers AAlib :)
    mplayer -tv driver=dummy:width=640:height=480 -vo aa tv://

Entrée depuis V4L standard
    mplayer -tv driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv tv://

Un exemple plus élaboré. MEncoder capture l'image PAL entière, coupe les marges, et désentrelace l'image en utilisant un algorithme de mélange linéaire. L'audio est compressé à un bitrate constant de 64kbps, en utilisant le codec LAME. Cette combinaison est adaptée pour capturer des films.
    mencoder -tv driver=v4l:width=768:height=576 \
    -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=900 \
    -oac mp3lame -lameopts cbr:br=64 \
    -vf crop=720:544:24:16,pp=lb -o sortie.avi tv://

Cela dimensionne également l'image en 384x288 et compresse la vidéo avec un bitrate de 350kbps en mode haute qualité. L'option vqmax perd le quantizer et permet au compresseur vidéo d'atteindre un bitrate plus bas au détriment de la qualité. Cela peut être utilisé pour capturer des longues séries TV, quand la qualité n'est pas très importante.
    mencoder -tv driver=v4l:width=768:height=576 \
    -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=350:vhq:vqmax=31:keyint=300 \
    -oac mp3lame -lameopts cbr:br=48 \
    -vf crop=720:540:24:18,pp=tn/lb,scale=384:288 -sws 1 -o sortie.avi tv://
Il est également possible de spécifier des dimensions d'image plus petites dans l'option -tv et d'omettre le zoom logiciel mais cette approche utilise le maximum d'informations disponibles et est un peut plus résistant au bruit. Les chips bt8x8 peuvent faire une moyenne de pixels uniquement dans la direction horizontale à cause d'une limitation matérielle.

2.5 Listes d'Edition de Décision (EDL)

Le système de liste d'édition de décision (EDL) vous permet de sauter ou rendre muet des sections de vidéos pendant la lecture, basé sur un fichier de configuration EDL spécifique au film.

Ceci est utile pour ceux qui veulent voir un film en mode "tout public". Vous pouvez couper toutes violence, profanation, Jar-Jar Binks .. d'un film suivant vos propres préférences personnelles. A part ça, il y a d'autres utilisations, comme sauter automatiquement les pubs dans les fichiers vidéos que vous regardez.

Le format de fichier EDL est plutôt rudimentaire. Une fois que le système EDL aura atteint un certain niveau de maturité, un format de fichier basé sur XML sera probablement implémenté (en gardant une compatibilité descendante avec les précédents formats EDL).

Le nombre maximum d'entrées EDL pour l'incarnation actuelle de EDL est 1000. Si vous avez besoin de plus, changez le #define MAX_EDL_ENTRIES dans le fichier edl.h.

2.5.1 Utiliser un fichier EDL

Incluez l'option -edl <nomfichier> quand vous lancez MPlayer, avec le nom du fichier EDL que vous voulez appliquer à la video.

2.5.2 Faire un fichier EDL

Le format de fichier actuel EDL est:

Où les secondes sont des nombres à virgule et l'action est soit 0 pour sauter, soit 1 pour couper le son. Exemple:

5.3   7.1    0
15    16.7   1
420   422    0

Cela va sauter de la seconde 5.3 à la seconde 7.1 de la vidéo, puis va couper le son à 15 secondes, le remettre à 16.7 secondes et sauter de la seconde 420 à la seconde 422 de la vidéo. Ces actions seront appliqués quand le temps de lecture atteint le temps indiqué dans le fichier.

Pour créer un fichier EDL à partir duquel travailler, utilisez l'option -edlout <nomfichier>. Durant la lecture, quand vous voulez marquer les deux secondes précédentes à sauter, tapez i. Une entrée correspondante sera écrite dans le fichier. Vous pouvez ensuite revenir et affiner le fichier EDL généré.

3. Utilisation

3.1 Ligne de commande

MPlayer utilise un ordre de lecture complexe. Il consiste en les options globales écrites en premier (par exemple mplayer -vfm 5), et les options écrites après les noms de fichier, qui s'appliquent uniquement au nom de fichier/URL/autre donné (par exemple mplayer -vfm 5 movie1.avi movie2.avi -vfm 4).
Vous pouvez regrouper les noms de fichiers/URLs en utilisant { et }. C'est utile avec l'option -loop: mplayer { 1.avi -loop 2 2.avi } -loop 3 jouera les fichiers dans cet ordre: 1 1 2 1 1 2 1 1 2

Les dernières versions de MPlayer acceptent également les pistes VCD et DVD en style URL, comme xine en fait: mplayer dvd://1 ou mplayer vcd://1

  mplayer -vo x11 /mnt/Films/Contact/contact2.mpg
  mplayer vcd://2
  mplayer -afm 3 /mnt/DVDtrailers/alien4.vob
  mplayer dvd://1 -dvd-device /dev/hdc
  mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi

3.2 Contrôles

MPlayer dispose d'une couche de contrôle pleinement configurable, qui vous permet de contrôler MPlayer avec le clavier, la souris, le joystick ou une télécommande (en utilisant LIRC). Voir la page de man pour une liste complète des contrôles clavier.

3.2.1 Configuration des contrôles

MPlayer vous permet d'associer n'importe quel touche/bouton à n'importe quelle commande MPlayer en utilisant un simple fichier de config. La syntaxe consiste un nom de touche suivi d'une commande. Le fichier de config par défaut est $HOME/.mplayer/input.conf mais cela peut être outrepassé en utilisant l'option -input (les chemins relatifs le sont par rapport à $HOME/.mplayer).

Exemple:

##
## MPlayer input control file
##

RIGHT seek +10
LEFT seek -10
- audio_delay 0.100
+ audio_delay -0.100
q quit
> pt_step 1
< pt_step -1
ENTER pt_step 1 1

3.2.1.1 Noms des touches

Vous pouvez obtenir la liste complète en exécutant mplayer -input keylist

Clavier:

• N'importe quel caractère imprimable
• SPACE
• ENTER
• TAB
• CTRL
• BS
• DEL
• INS
• HOME
• END
• PGUP
• PGDWN
• ESC
• RIGHT
• LEFT
• UP
• DOWN

Souris (uniquement sous X):

• MOUSE_BTN0 (bouton gauche)
• MOUSE_BTN1 (bouton droit)
• MOUSE_BTN2 (bouton du milieu)
• MOUSE_BTN3 (Molette)
• MOUSE_BTN4 (Molette)
• ...
• MOUSE_BTN9

Joystick (son support doit avoir été activé à la compilation):

• JOY_RIGHT ou JOY_AXIS0_PLUS
• JOY_LEFT ou JOY_AXIS0_MINUS
• JOY_UP ou JOY_AXIS1_MINUS
• JOY_DOWN ou JOY_AXIS1_PLUS
• JOY_AXIS2_PLUS
• JOY_AXIS2_MINUS
• ...
• JOY_AXIS9_PLUS
• JOY_AXIS9_MINUS

3.2.1.2 Commandes

Vous pouvez obtenir la liste complète des commandes en exécutant "mplayer -input cmdlist"

• seek (int) val [(int) type=0]

  Saute à une position donnée.
  Le type 0 est un déplacement relatif de +/- val secondes.
  Le type 1 se déplace à val% du film.

• audio_delay (float) val

  Ajuste le décalage audio de val secondes

• quit

  Quitte MPlayer

• pause

  Pause/dépause la lecture

• grap_frames

  Quelqu'un sait ?

• pt_step (int) val [(int) force=0]

  Va vers l'entrée précédente/suivante de l'ordre de lecture. Le signe de val indique la direction.
  Si aucune entrée n'est disponible dans la direction demandée, cela ne fera rien à moins que force ne soit pas égal à 0.

• pt_up_step (int) val [(int) force=0]

  Comme pt_step mais il saute au prochain/précédent dans la liste parente. Il est utilisé pour casser les boucles internes dans le playtree.

• alt_src_step (int) val

  Quand plusieurs sources sont disponibles cela sélectionne la prochaine/précédente (pas supporté par les playlists asx).

• sub_delay (float) val [(int) abs=0]

  Ajuste le décalage des sous-titres de +/- val secondes or ou le fixe à val secondes quand abs est différent de zéro.

• osd [(int) level=-1]

  Active le mode osd ou change le niveau quand level > 0.

• volume (int) dir

  Augmente/diminue le volume

• contrast (int) val [(int) abs=0]
• brightness (int) val [(int) abs=0]
• hue (int) val [(int) abs=0]
• saturation (int) val [(int) abs=0]

  Fixe/Ajuste les paramètres vidéo. L'intervalle de Val va de -100 à 100.

• frame_drop [(int) type=-1]

  Bascule/Fixe le mode saut de trames.

• sub_visibility

  Bascule l'affichage des sous-titres.

• sub_pos (int) val

  Ajuste la position des sous-titres.

• vobsub_lang

  Change la langue des sous-titres VobSub.

• vo_fullscreen

  Active le plein-écran.

• tv_step_channel (entier) dir

  Sélectionne le prochain/précédent canal tv.

• tv_step_norm

  Change la norme TV.

• tv_step_chanlist

  Change la liste des canaux.

• gui_loadfile
• gui_loadsubtitle
• gui_about
• gui_play
• gui_stop
• gui_playlist
• gui_preferences
• gui_skinbrowser

  actions GUI

3.2.2 Contrôle avec LIRC

Linux Infrared Remote Control - utilisez un récepteur infrarouge fait maison, une télécommande, et contrôlez votre linux à distance ! Plus d'infos sur www.lirc.org.

Si vous avez installé le paquetage lirc, configure l'autodétectera. Si tout c'est bien passé, MPlayer affichera un message du genre "Setting up lirc support..." au démarrage. Si une erreur se produit il vous le dira. Si il ne vous dis rient à propos de LIRC c'est que son support n'est pas compilé. C'est tout :-)

Le nom de l'application a lancer avec MPlayer est - oh surprise - 'mplayer'. Vous pouvez utiliser n'importe quel commande mplayer et même passer plus d'une commande en les séparant avec \n. N'oubliez pas d'activer le flag repeat dans .lircrc quand cela est approprié (déplacement, volume, etc). Voici un extrait de mon .lircrc:

begin
     button = VOLUME_PLUS
     prog = mplayer
     config = volume 1
     repeat = 1
end

begin
    button = VOLUME_MINUS
    prog = mplayer
    config = volume -1
    repeat = 1
end

begin
    button = CD_PLAY
    prog = mplayer
    config = pause
end

begin
    button = CD_STOP
    prog = mplayer
    config = seek 0 1\npause
end

Si vous n'aimez pas l'emplacement standard du fichier de config de lirc(~/.lircrc) utilisez -lircconf <nomfichier> pour spécifier un autre fichier.

3.2.3 Mode esclave

Le mode esclave vous permet de construire un frontend à MPlayer. Quand il est activé (avec -slave MPlayer lit les commandes séparées par un saut de ligne (\n) depuis l'entrée par défaut (stdin).

3.3 Streaming depuis le réseau ou les pipes

MPlayer peut lire des fichiers depuis le réseau, en utilisant les protocoles HTTP, FTP, MMS ou RTSP/RTP.

La lecture se fait juste en ajoutant l'URL à la ligne de commande. MPlayer utilise la variable d'environnement http_proxy, et utilise le proxy si disponible. L'utilisation du Proxy peut aussi être forcée:

mplayer http_proxy://proxy.micorsops.com:3128/http://micorsops.com:80/flux.asf

MPlayer peut lire depuis stdin (Pas depuis les pipes nommés). Cela peut être utilisé par exemple pour lire depuis le FTP:

  wget ftp://micorsops.com/quelquechose.avi -O - | mplayer -

Note: il est également recommandé d'activer le CACHE pour une lecture depuis le réseau:

  wget ftp://micorsops.com/quelquechose.avi -O - | mplayer -cache 8192 -

4. Section FAQ

5. Section CD/DVD

6. Ports

6.1 Linux

La plateforme principale de développement est Linux sur x86, bien que MPlayer fonctionne sur de nombreux autres ports Linux. Des binaires de MPlayer sont disponibles depuis de nombreuses sources. Par contre, aucun de ces paquets n'est supporté. Rapportez les problèmes à leurs auteurs, pas à nous.

6.1.1 Paquets Debian

Pour construire le paquet Debian, lancez la commande suivante dans le répertoire source de MPlayer:

    fakeroot debian/rules binary

En tant que root installez le paquet .deb comme d'habitude:

    dpkg -i ../mplayer_<version>.deb

Christian Marillat a construit des paquets Debian non-officiels pour MPlayer, MEncoder et les polices pendant un certain temps, vous pouvez les obtenir (apt-get) depuis sa page web.

6.1.2 Paquets RPM

Dominik Mierzejewski a créé et maintient des paquets Red Hat RPM officiels de MPlayer. Ils sont disponibles sur sa page web.

Les paquets Mandrake de MPlayer sont disponibles sur le P.L.F), SuSE inclus une version limitée de MPlayer dans sa distribution. Vous pouvez obtenir des RPMs fonctionnels sur links2linux.de.

6.1.3 ARM

MPlayer fonctionne sur les PDAs Linux avec un CPU ARM c-a-d Sharp Zaurus, Compaq Ipaq. La manière la plus facile d'obtenir MPlayer est de récupérer un des paquets OpenZaurus. Si vous voulez le compiler vous-même, vous devriez regarder les répertoires mplayer et libavcodec du répertoire raçine de la distribution OpenZaurus. Ils ont toujours les derniers Makefile et patches utilisés pour contruire un MPlayer CVS avec libavcodec.
Si vous avez besoin d'une GUI, vous pouvez utiliser xmms-embedded.

6.2 *BSD

MPlayer fonctionne sur FreeBSD, OpenBSD, NetBSD, BSD/OS et Darwin. Il y a des versions ports/pkgsrc/fink/etc de MPlayer disponibles qui sont probablement plus faciles à utiliser que nos sources brutes.

Pour construire MPlayer vous aurez besoin de GNU make (gmake - le make natif de BSD ne fonctionnera pas) et une version récente des binutils.

Si MPlayer se plaint de ne pas trouver /dev/cdrom ou /dev/dvd, créez le lien symbolique approprié:
ln -s /dev/(votre_périphérique_cdrom) /dev/cdrom.

Pour utiliser les DLLs Win32 avec MPlayer vous devrez recompiler le noyau avec "option USER_LDT" (à moins d'utiliser FreeBSD -CURRENT, où c'est le cas par défaut).

6.2.1 FreeBSD

Si votre CPU à SSE, recompilez votre noyau avec "options CPU_ENABLE_SSE" pour l'utiliser (FreeBSD-STABLE ou patches noyau requis).

6.2.2 OpenBSD

A cause des limitations dans les différentes versions de gas (relocation vs MMX), vous aurez besoin de compiler en deux étapes: D'abord assurez-vous que le non-natif est en premier dans votre $PATH et faites un gmake -k, ensuite assurez-vous que la version native est utilisée et faite gmake.

6.3 Solaris

MPlayer devrait fonctionner sous Solaris 2.6 ou plus récent.

Sur UltraSPARCs, MPlayer profite des avantages de leurs extensions VIS (équivalentes au MMX), actuellement uniquement dans libmpeg2, libvo et libavcodec, mais pas dans mp3lib. Vous pouvez regarder un fichier VOB sur un CPU à 400MHz. Vous aurez besoin d'avoir mLib installé.

Pour construire ce paquetage vous aurez besoin de GNU make (gmake, /opt/sfw/gmake), Le make natif de Solaris ne fonctionnera pas. Message d'erreur typique si vous utilisez le make de Solaris au lieu de celui de GNU:

   % /usr/ccs/bin/make
   make: Fatal error in reader: Makefile, line 25: Unexpected end of line seen

Sur Solaris SPARC, vous aurez besoin du compilateur C/C++ GNU; cela n'a pas d'importance que le compilateur C/C++ GNU soit configuré avec ou sans l'assembleur GNU.

Sur Solaris x86,vous aurez besoin de l'assembleur GNU et du compilateur C/C++ GNU, configuré pour l'utilisation de l'assembleur GNU! Le code de mplayer sur la plateforme x86 fait un usage intensif des instructions MMX, SSE et 3DNOW! qui ne peuvent pas être assemblées en utilisant l'assembleur de Sun /usr/ccs/bin/as.

Le script configure essaie de trouver quel assembleur est utilisé par votre commande "gcc" (au cas ou l'autodétection échoue, utilisez l'option --as=/endroit/ou/vous/avez/installe/gnu-as pour indiquer au script configure où il peut trouver GNU "as" sur votre système).

Message d'erreur de configure sur un système Solaris x86 en utilisant GCC sans assembleur GNU:

   % configure
   ...
   Checking assembler (/usr/ccs/bin/as) ... , failed
   Please upgrade(downgrade) binutils to 2.10.1...

(Solution: Installez et utilisez un gcc configuré avec "--with-as=gas")

Erreur typique obtenue en construisant avec un compilateur C GNU qui n'utilise pas GNU as:

   % gmake
   ...
   gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math
	-fomit-frame-pointer  -I/usr/local/include   -o mplayer.o mplayer.c
   Assembler: mplayer.c
   "(stdin)", line 3567 : Illegal mnemonic
   "(stdin)", line 3567 : Syntax error
   ... more "Illegal mnemonic" and "Syntax error" errors ...

Pour le support DVD vous devez avoir libcss patché installé. Patch: http://www.tools.de/solaris/mplayer/.

A cause de bogues dans Solaris 8, il se peut que vous ne pouviez pas lire de disques DVD plus gros que 4 Go:

• Le pilote sd(7D) de Solaris 8 x86 a un bogue quand on accède à un bloc disque >4Go sur un périphérique en utilisant une taille de bloc logique != DEV_BSIZE (c-a-d. CD-ROM et DVD). A cause d'un dépassement des entiers 32Bit, on accède à une adresse disque modulo 4 Go. (http://groups.yahoo.com/group/solarisonintel/message/22516). Ce problème n'existe pas sur la version SPARC de Solaris 8.
• Un bogue similaire est présent dans le code du système de fichier hsfs(7FS) (aka ISO9660), il se peut que hsfs ne supporte pas les partitions/disques plus gros(ses) que 4GB, toutes les donnés sont accédés modulo 4Go. (http://groups.yahoo.com/group/solarisonintel/message/22592).

  Le problème hsfs peut être résolu en installant le patch 109764-04 (sparc) / 109765-04 (x86).

Sur Solaris avec un CPU UltraSPARC, vous pouvez obtenir de la vitesse supplémentaire en utilisant les instructions VIS du CPU pour certaines opérations couteuses en temps machine. L'accélération VIS peut être utilisé dans MPlayer en appelant les fonctions de la mediaLib de Sun.

les opérations accélérées par VIS à partir de mediaLib sont utilisées pour le décodage vidéo mpeg2 et pour la conversion de palette dans les pilotes de sortie vidéo.

6.4 Silicon Graphics / IRIX

Vous pouvez soit essayer d'installer le programme d'installation GNU, et (si vous ne l'avez pas mis dans votre chemin par défaut) précisez ensuite l'endroit où il est:

  ./configure --install-path=CHEMIN

Soit vous pouvez utilisez l'installation par défaut livrée avec IRIX 6.5, auquel cas vous devrez éditer le Makefile manuellement. Changez la ligne suivante:

  $(INSTALL) -c -m 644 DOCS/mplayer.1 $(MANDIR)/man1/mplayer.1

par:

  $(INSTALL) -m 644 mplayer.1 $(MANDIR)/man1/

Et ensuite faites (depuis le rép. source de MPlayer):

  cp DOCS/mplayer.1 .

finalement lancez la construction et l'installation.

6.5 QNX

Fonctionne. Vous devrez télécharger SDL pour QNX, et l'installer. Ensuite lancez MPlayer avec les options -vo sdl:photon et -ao sdl:nto, et ça devrait être rapide.

La sortie -vo x11 fonctionne encore plus lentement que sous Linux, car QNX n'a que émulation X qui est TRÈS lente. Utilisez SDL.

6.6. Windows

Yes, MPlayer tourne sous Windows sous Cygwin et MinGW. Il n'a pas encore de GUI, mais la version en ligne de commande est presque complètement opérationelle. Les Patches sont toujours les bienvenus. Vous devriez jeter un oeil à la liste de diffusion mplayer-cygwin pour obtenir de l'aide et les dernières informations.

Les meilleurs résultats sont obtenus avec le codec vidéo DirectX natif (-vo directx) et le pilote waveout natif de Windows (-ao win32) car OpenGL ne fonctionne pas et SDL est connu pour distordre le son et l'image et planter sur certains systèmes. Vous pouvez afficher la fenêtre par dessus les autres applications avec -vo directx:ontop. Si l'image est distordue, essayez de désactiver l'accélération matérielle avec -vo directx:noaccel. Téléchargez les fichiers d'entête DirectX 7 pour compiler le pilote de sortie vidéo DirectX.

Les codecs Win32, les DLLs QuickTime et les codecs Real Win32 (pas les codecs Real Linux) fonctionnent également. Placez les codecs quelque part dans votre path ou passez --with-codecsdir=c:/chemin/de/vos/codecs (éventuellement --with-codecsdir=/chemin/de/vos/codecs uniquement sous Cygwin) à configure. Nous avons eu quelques retours indiquant que les DLLs Real doivent être accessibles en écriture pour l'utilisateur, mais seulement sur certains systèmes. Essayez de les rendre accessibles en écriture si vous avez des problèmes.

La console Cygwin/MinGW est plutôt lente. Il semble que rediriger la sortie ou utiliser l'option -quiet amèliore les performances. Le rendu direct (-dr) peut également aider. Vous pouvez éviter le tremblement de L'OSD en utilisant le double buffering avec l'option -double. Si la lecture est sale, essayez -autosync 100. Si certaines de ces options vous sont utiles, vous pouvez les placer dans votre fichier de config.

Il existe des versions précompilées créées par Sascha Sommer disponibles sur notre page web. Joey Parrish à réalisé des paquets Windows non-officiels complets avec installeur.

6.6.1 Cygwin

Les versions de Cygwin antérieures à 1.5.0 n'incluent pas inttypes.h. Vous devez copier ou lier etc/cygwin_inttypes.h depuis le répertoire source de MPlayer vers /usr/include/inttypes.h pour que MPlayer compile.

Les fichiers d'entête DirectX doivent être décompressés dans /usr/include/ ou /usr/local/include/.

Les instructions et les fichiers pour faire tourner SDL sous Cygwin peuvent être trouvés sur le site de libsdl.

Vous pouvez jouer des VCDs en lisant les fichiers .DAT ou .MPG que Windows fait apparaître sur les VCDs. Cela fonctionne comme ça (changez la lettre de votre lecteur CD-ROM):

mplayer d:/mpegav/avseq01.dat

mplayer /cygdrive/d/MPEG2/AVSEQ01.MPG

Les DVDs fonctionnent également, définissez juste votre périphérique DVD pour qu'il corresponde à votre périphérique CD-ROM:

mplayer dvd://<titre> -dvd-device '\\.\d:'

6.6.2 MinGW

Installer une version de MinGW qui puisse compiler MPlayer est considéré comme compliqué, mais ne consiste en fait qu'en trois étapes simples et devrait bientôt fonctionner sans modifications.

1. Installez MinGW 3.0.0 ou plus rescent.
2. Installez MSYS 1.0.9 ou plus rescent et indiquez au postinstall de MSYS que MinGW est installé.
3. Remplacez /mingw/include/sys/types.h par types.h.

Décompressez les fichiers d'entête de DirectX dans /mingw/include/.

Les VCDs et DVDs fonctionnent comme avec Cygwin (ajustez la lettre de votre lecteur de CD-ROM):

mplayer d:/mpegav/avseq01.dat

mplayer /d/MPEG2/AVSEQ01.MPG

mplayer dvd://<titre> -dvd-device /d/

7. Encodage avec MEncoder

Appendice A - Listes de diffusion

Il y a des listes de diffusion publiques sur MPlayer. A moins que cela soit explicitement précisé la langue utilisée sur ces listes est l'Anglais. S'il vous plaît, n'envoyez pas de messages dans d'autres langues ou des mails HTML! La taille limite des message est 80k. Si vous avez quelque chose de plus gros, mettez le en téléchargement quelque part. Sur les listes de diffusion, les règles d'écriture et de citation sont les même que sur usenet. Suivez-les SVP, elles simplifient énormément la vie de ceux qui lisent vos mails. Si vous ne connaissez pas ces règles, lisez le HOWTO edit messages ou (si vous êtes pressé) Quoting HOWTO.

• Liste d'annonces de MPlayer: http://mplayerhq.hu/mailman/listinfo/mplayer-announce
  Liste pour les annonces MPlayer. Inscrivez-vous si vous voulez obtenir les annonces de nouvelles fonctionalités.
• Liste des développeurs de MPlayer: http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng
  Cette liste est à propos du développement de MPlayer! Parler des changements d'interface/API, des nouvelles librairies, des optimisations de code, des changements de configuration est à-propos ici. Envoyez des patches mais PAS de rapports de bogue, de questions d'utilisateur, de suggestions ou d'insultes ici, pour garder un trafic raisonnable.
• Liste des utilisateurs de MPlayer: http://mplayerhq.hu/mailman/listinfo/mplayer-users
  • Envoyez vos rapports de bogue après avoir lu les sections Bogues connus et Rapport de bogue).
  • Envoyez vos suggestions ici (après avoir entiérement lu la documentation).
  • Envoyez vos questions d'utilisateur ici (après avoir entièrement lu la documentation).
• Liste des utilisateurs hongrois de MPlayer: http://mplayerhq.hu/mailman/listinfo/mplayer-felhasznalok
  • Liste en langue hongroise
  • Sujet? Eh bien regardez par vous-même... que des insultes ou des questions à la RTFM maintenant :(
• Utilisateurs de MPlayer & Matrox G200/G400/G450/G550: http://mplayerhq.hu/mailman/listinfo/mplayer-matrox
  Questions relatives à Matrox comme
  • choses à propos de mga_vid
  • les pilotes béta Matrox officiels (pour X 4.x.x)
  • trucs matroxfb-TVout
• Utilisateurs de MPlayer & carte DVB: http://mplayerhq.hu/mailman/listinfo/mplayer-dvb
  Choses relatives à la carte de décodage matériel appelé DVB (pas DXR3!).
• MPlayer CVS-log: http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog
  Tous les changements de code dans MPlayer sont automatiquement envoyés sur cette liste. Seules les questions à propos de ses changements sont autorisées ici (si vous ne comprenez pas pourquoi un changement est requis ou si vous en avez un meilleur ou si vous avez remarquer un bogue/problème possible dans l'envoi).
• Liste du portage Cygwin de MPlayer: http://mplayerhq.hu/mailman/listinfo/mplayer-cygwin
  Liste pour la discussion à propos du port MPlayer sur Cygwin.
• Liste de portage OS/2 de MPlayer: http://mplayerhq.hu/mailman/listinfo/mplayer-os2
  Liste pour les discussions sur le portage OS/2 de MPlayer.
• Liste des éditeurs et traducteurs des MPlayer Weekly News (Nouvelles Hebdomadaires de MPlayer): http://mplayerhq.hu/mailman/listinfo/mplayer-mwn
  Liste pour les discussions sur les Weekly News.

Note: Vous pouvez obtenir les archives avec recherche possible à http://www.mplayerhq.hu/cgi-bin/htsearch.

Appendice B - Comment reporter un bogue

Appendice C - Bogues connus

Special system/CPU-specific bugs/problems:

• SIGILL (signal 4) sur P3 en utilisant un noyau 2.2.x:
  Problème: le noyau 2.2.x n'a pas un support natif (fonctionnel) du SSE
  Solution: upgradez le noyau en 2.4.x
  Contournement: ./configure --disable-sse
• SIGILL (signal 4) général:
  Problème: vous avez compilé et utilisez mplayer sur des machines différentes (par exemple compilé sur P3 et tournant sur Celeron)
  Solution: compilez MPlayer sur la machine sur laquelle vous l'utiliserez!
  Contournement: ./configure --disable-sse etc. options
• "Internal buffer inconsistency" pendant l'exécution de MEncoder:
  Problème: problème connu quand lame < 3.90 à été compilé avec gcc 2.96 ou 3.x.
  Solution: utilisez lame >=3.90.
  Contournement: compilez lame avec gcc 2.95.x et retirez les paquetages lame éventuellement installés, ils peuvent avoir été compilé avec gcc 2.96.
• Son MP2/MP3 sale sur PPC:
  Problème: bogue de GCC sur les plateformes PPC, pas encore de réparation.
  Contournement: utilisez le décodeur MP1/MP2/MP3 de FFmpeg (lent) (-ac ffmpeg)
• sig11 dans libmpeg2, pendant le redimensionnement+encodage:
  Problème: bogue MMX connu du GCC 2.95.2, upgradez en 2.95.3.

Problèmes de synchro A-V et d'audio:

• le plus commun: pilote audio bogué! - Essayez d'utiliser différent pilotes, essayez l'émulation OSS ALSA 0.9 avec -ao oss, essayez aussi -ao sdl, des fois ça aide. Si votre fichier est lu correctement avec -nosound, alors vous pouvez être certain qu'il s'agit d'un problème de carte son(pilote).
• problèmes de buffer audio (taille de buffer mal détectée)
  Contournement: option mplayer -abs
• problèmes de taux d'échantillonage - peut être que votre carte ne supporte pas le taux d'échantillonage utilisé dans vos fichiers - essayez le plugin resampling(-aop)
• machine lente (CPU ou VGA)
  essayez avec -vo null, si la lecture fonctionne bien, alors vous avez un(e) carte/pilote VGA lent(e).
  Contournement: achetez une carte plus rapide ou lisez cette documentation pour augmenter la vitesse.
  Essayez aussi -framedrop

• mauvais fichier
  Contournement:
  • option -ni ou -nobps (pour les fichiers non-entrelacés ou mauvais)
    et/ou
  • -mc 0 (requis pour les fichiers avec de l'audio VBR mal entrelacé)
    et/ou
  • option -delay ou les touches +/- pendant l'exécution pour régler le décalage
  Si rien de tous ça n'aide, uploadez le fichier SVP, nous regarderons (et réparerons).
• votre carte son ne supporte pas la lecture à 48kHz
  Contournement: achetez une meilleur carte son... ou essayez de décrémenter les fps de 10% (utilisez -fps 27 pour un film à 30fps) ou utilisez le plugin resampler
• machine lente
  (si A-V n'est pas proche de 0, et que le dernier nombre de la ligne d'état augmente)
  Contournement: -framedrop

• votre fichier utilise un codec audio non-supporté
  Contournement: lisez la documentation et aidez-nous à en ajouter le support

• votre fichier utilise un codec vidéo non-supporté
  Contournement: lisez la documentation et aidez-nous à en ajouter le support
• le codec auto-sélectionné ne peut décoder le fichier, essayez avec un autre en utilisant les options -vc ou -vfm
• vous essayez de lire un fichier DivX 3.x avec le décodeur OpenDivX ou XviD (-vc odivx) - installez Divx4Linux et recompilez MPlayer

Problèmes de sortie vidéo:

Première note: les options -fs -vm et -zoom sont juste des recommandations, pas (encore) supporté par tous les pilotes. Donc ce n'est pas un bogue si ça ne marche pas. Seuls quelques pilotes supportent le redimensionnement/zoom, ne l'espérez pas de x11 ou dga.

OSD/sub papillotant:
- pilote x11: désolé, cela ne peut être réparé maintenant
- pilote xv: utilisez l'option -double

Image verte en utilisant mga_vid (-vo mga / -vo xmga):
- mga_vid a mal détecté la quantité de RAM de votre carte, rechargez-le en utilisant l'option mga_ram_size

Appendice D - Format de skin de MPlayer

Appendice E - Lamentations du Développeur