Chapter 4.  Utilisation de la ligne de commande

Table of Contents

Introduction
Ouvrir un flux
Sélection des modules
Stream Output
Autres options

Introduction

Un certain nombre d'options ne sont disponibles qu'en utilisant la ligne de commande. Elles sont détaillées ici .

Ouvrir un flux

Les commandes suivantes lancent VLC et ajoutent un élément à la liste de lecture .

Ouvrir un fichier

Démarrez VLC :

% vlc -vvv my_file.mpg

Dans la grande majorité des cas, VLC reconnaitra automatiquement le type de fichier, mais vous pouvez également lui spécifier quel codec utiliser, avec l'option --codec. Par exemple, pour lire my_file.mpg à l'aide du codec audio/vidéo "ffmpeg", utilisez :

% vlc -vvv --codec ffmpeg my_file.mpg 

Une liste de tous les codecs audio et vidéo supportés par VLC est disponible sur la page des fonctionnalités de VLC .

Ouvrir un DVD, un VCD, ou un CD audio

Lancez VLC :

% vlc -vvv dvd://[peripherique][@peripherique_raw][@[titre][,[chapitre][,angle]]]

ou (VCD):

% vlc -vvv vcd://[peripherique][@{E|P|S|T}[titre]]

ou (Audio CD):

% vlc -vvv cdda://[peripherique][@[piste]]

où périphérique est le chemin complet à votre lecteur de DVD ou de CD .

Recevoir un flux réseau

Pour recevoir un flux unicast UDP (envoyé par VLC ou par le stream output de VLC), lancez VLC avec :

% vlc -vvv udp:[@:port_UDP]

Pour recevoir un flux multicast UDP (envoyé par VLC ou par le stream output de VLC), lancez VLC avec :

% vlc -vvv udp:@multicast_address[:port_UDP]

Pour recevoir un flux HTTP, lancez VLC avec :

% vlc -vvv http://www.example.org/your_file.mpg

Pour recevoir un flux RTSP, lancez VLC avec :

% vlc -vvv rtsp://www.example.org/your_stream

Sélection des modules

VLC essaie de sélectionner l'interface, et les modules d'entrée/sortie les plus adaptés parmi ceux qui sont disponibles sur votre système, selon le flux à lire. Toutefois, vous pouvez également forcer l'utilisation d'un module particulier, avec les options suivantes (pour une liste complète des modules, voir la Modules et options de VLC section modules) :

  • --intf <module> vous permet de choisir le module d'interface .

  • --extraintf <module> vous permet de sélectionner des interfaces supplémentaires qui seront lancées en plus de l'interface principale .

  • --aout <module> vous permet de choisir la sortie audio .

  • --vout <module> vous permet de choisir la sortie vidéo .

  • --filter <module> vous permet d'ajouter un filtre vidéo .

  • --memcpy <module> vous permet de choisir un module de copie de mémoire .

Stream Output

Description du stream output

Le stream output du VLC permet à ce dernier de servir de serveur de streaming et non de client, et possède des fonctionnalités très étendues :

  • envoi en unicast et en multicast, en IPv4 ou en IPv6, tout ce que VLC est capable de lire, par UDP, RTP, ou HTTP ;

  • sauvegarde du flux d'entrée vers un fichier AVI, PS, TS ou OGG ;

  • transcodage du flux d'entrée et envoi .

Pour connaître toutes les possibilités du stream output, merci de regarder la page de fonctionnalités de streaming .

Architecture et syntaxe

le stream output possède une puissante architecture qui utilise des modules. Chaque module apporte des fonctionnalités, et il est possible de chaîner les modules pour combiner ces possibilités .

Voici la liste des modules disponibles :

  • standard "envoie" le flux grâce à un module de sortie: par exemple, UDP, fichier, HTTP, ... vous utiliserez probablement ce module à la fin de vos chaînes .

  • transcode vous permet de transcoder à la volée l'audio et la vidéo de votre flux d'entrée (si votre ordinateur dispose de suffisament de puissance) .

  • duplicate vous permet de créer une seconde chaîne dans laquelle le flux sera traité séparément .

  • display vous permet d'afficher le flux d'entrée, comme VLC le ferait normalement. Utilisé avec le module duplicate, il vous permet de voir le flux en même temps que vous l'envoyez .

  • rtp envoie en RTP (un port UDP par flux ÈlÈmentaire) .

  • es vous permet de séparer les flux élémentaires (ES) d'un flux d'entrée .

Chaque module prend des options. Voici la syntaxe à utiliser :

% vlc input_stream --sout '#module1{option1=...,option2=...}:#module2{option1=...,option2=...}:...'

Par exemple, pour transcoder et envoyer un flux :

% vlc input_stream --sout '#transcode{options}:#standard{options}'

Description des modules

standard (alias std)

Envoie un flux .

Options:

  • access: comment envoyer file, udp, rtp, http.

  • mux: quel multiplexeur (format) utiliser ? Doit être: avi (format AVI) ogg (format Ogg) ps (format MPEG2-PS) ts (format MPEG2-TS) .

  • url: Si vous utilisez l'access file, l'emplacement du fichier, sinon, l'adresse IP multicast ou unicast .

  • sap: si vous utilisez l'access udp ou rtp, utilisez ceci pour annoncer le flux par SAP/SDP. L'option contient le nom sous lequel le programme sera annoncé .

  • slp: comme sap, en utilisant le protocole SLP. Vous aurez besoin de libslp .

  • sap_ipv: si vous utilisez sap, utilisez ceci pour spécifier si vous désirez envoyer les annonces SAP en IPv4 -défaut- ou IPv6. La valeur à utiliser est 4 ou 6 .

Note

Si vous utilisez le multicast, vous pouvez utiliser l'option globale --ttl 12 pour régler le TTL

display

Affiche le flux .

Options:

  • noaudio: Pas d'audio .

  • novideo: Pas de vidéo .

duplicate

Duplique le flux vers une nouvelle chaîne .

Options:

  • dst: Une nouvelle chaîne de modules, comme décrit plus haut .

transcode

Change le format de compression et/ou le taux de compression d'un flux .

Options:

  • acodec: Nouveau format audio. Peut être un de mpga (MPEG audio layer 2), a52 or ac3 (son AC3) ou vorb (Vorbis)

  • ab: taux de compression audio, en Kbps .

  • vcodec: Nouveau format vidéo. Peut être un de mp4v (MPEG4), mpgv (MPEG1), DIV1, DIV2, DIV3 (DivX 1,2,3), H263 (H263), I263 (H263I), WMV1 or WMV2 (Windows Media Video 1 or 2), MJPG (MJPEG), MJPB (MJPEGB) .

  • width: largeur de la vidéo .

  • height: hauteur de la vidéo .

  • vb: taux de compression vidéo, en Kbps .

  • vt: tolérance sur le bitrate vidéo, en bps .

  • deinterlace: active le désentrelacement .

  • croptop: nombre de pixels rognés sur le haut de la vidéo .

  • cropbottom: nombre de pixels rognés sur le bas de la vidéo .

  • cropleft: nombre de pixels rognés sur la gauche de la vidéo .

  • cropright: nombre de pixels rognés sur la droite de la vidéo .

  • hq: Haute qualité (nécessite plus de puissance) .

  • qmin: FIXME

  • qmax: FIXME .

rtp

envoie un stream en RTP

Options:

  • dst: Addresse IP de destination (unicast ou multicast) .

  • port: port UDP de destination .

  • sdp: La façon d'envoyer le fichier sdp http://server_ip:server_port/path pour de l'http, ou rtsp://server_ip:server_port/path pour du rtsp, où server_ip est l'adresse d'une dezs interfaces du serveur, et path l'emplacement ou le fichier sdp sera accessible sur le serveur .

    Note

    Avec l'option sdp=rtsp, il est possible de ne pas donner d'adresse de destination. VLC envoiera le flux à tout client se connectant au serveur .

es

Sépare les flux élémentaires .

Options:

  • access_audio: Comment envouyer la piste audio : file, udp, rtp ou http .

  • access_video: Comment envouyer la piste vidéo : file, udp, rtp ou http .

  • access: si vous utilisez le même access pour l'audio et la vidéo, utilisez cette option au lieu des deux précédentes .

  • mux_audio: quel multiplexeur (format) sera employé pour la piste audio ? Peut être un de avi (format AVI) ogg (format OGG), ps (format MPEG2-PS), ts (format MPEG2-TS) .

  • mux_video: quel multiplexeur (format) sera employé pour la piste vidéo ? Peut être un de avi (format AVI) ogg (format OGG), ps (format MPEG2-PS), ts (format MPEG2-TS) .

  • mux: si vous utilisez le même format pour l'audio et la vidéo, utilisez cette option au lieu des deux précédentes .

  • url_audio: Si vous utilisez l'access file, l'emplacement du fichier de la piste audio, sinon, l'adresse IP multicast ou unicast .

  • url_video: Si vous utilisez l'access file, l'emplacement du fichier de la piste vidéo, sinon, l'adresse IP multicast ou unicast .

  • url: si vous utilisez la même addresse pour l'audio et la vidéo, utilisez cette option au lieu des deux précédentes .

Note

Dans les options url, si vous utilisez l'access file, vous pouvez utiliser ces macros dans le nom de fichier:

  • %n = numéro de flux ;

  • %c = FOURCC ;

  • %m = format

  • %a = access.

Divers

Voici quelques options globales supplémentaires

  • --no-sout-audio désactive le stream output audio .

  • --no-sout-video désactive le stream output vidéo .

Le stream output offre également une syntaxe simplifiée, qui ne vous permet que d'utiliser les options principales du module standard :

% vlc input_stream --sout access/mux:url

access, mux et url sont telles que définies plus haut dans les options du module standard .

Exemples

Pour comprendre pleinement la complexe syntaxe du stream output du VLC, veuillez voir les exemples d'utilisation, dans le VideoLAN Howto VideoLAN HOWTO .

Autres options

Options audio

  • --noaudio désactive le son .

  • --mono force le mode audio mono .

  • --volume <entier> règle le volume audio .

  • --aout-rate <entier> règle la fréquence de la sortie audio en Hz .

  • --desync <entier> compense la désynchronisation audio (ms) .

  • --headphone active l'effet de spatialisation virtuelle du casque .

  • --headphone-dim règle la dimension caractéristique du casque .

Options vidéo

  • --novideo désactive la vidéo .

  • --greyscale passe en nuances de gris la vidéo .

  • --fullscreen active le mode plein écran .

  • --nooverlay désactive l'accélération matérielle de la sortie vidéo .

  • --width, --height <entier> règle la taille de la fenêtre vidéo .

  • --zoom <nombre flottant> ajoute un facteur de zoom .

  • --aspect-ratio <mode> force le ratio d'aspect .

  • --spumargin <entier> force la position des sous-titres .

Options de liste de lecture

  • --playlist lance la liste de lecture au démarrage .

  • --random les fichiers sont lus indéfiniment et aléatoirement .

  • --enqueue met les items à la queue .

  • --loop la liste de lecture boucle .

Options réseaux

  • --server-port <entier> règle le port UDP .

  • --iface <chaîne> spécifie l'interface réseau à utiliser .

  • --iface-addr <chaîne> spécifie l'adresse IP de l'interface réseau .

  • --mtu <entier> spécifie le MTU de l'interface réseau .

  • --ipv6 force l'utilisation d'IPv6 .

  • --ipv4 force l'utilisation d'IPv4 .

Options de processeur

  • --nommx empêche l'utilisation des extensions MMX du CPU .

  • --no3dn empêche l'utilisation des extensions 3D Now! du CPU .

  • --nommxext empêche l'utilisation des extensions MMX Ext du CPU .

  • --nosse empêche l'utilisation des extensions SSE du CPU .

Options diverses

  • --quiet pas de messages dans la console .

  • --color affiche des messages en couleur .

  • --search-path <chaîne> spécifie le chemin de recherche .

  • --plugin-path <chaîne> spécifie le chemin de recherche des plugins .

  • --dvd <chaîne> spécifie le périphérique DVD par défaut .

  • --vcd <chaîne> spécifie le périphérique VCD par défaut .

  • --program <;entier> spécifie le programme (SID) (pour les flux multi-programmes, tels les flux satellites) .

  • --audio-type <entier> spécifie le type audio par défaut pour les DVDs .

  • --audio-channel <entier> spécifie le canal audio par défaut pour les DVDs .

  • --spu-channel <entier> spécifie le canal de sous-titre par défaut pour les DVDs .

Options d'aide

  • --verbose <verbosité> spécifie le niveau de verbosité .

  • --help vous donne toutes les options disponibles .

  • --longhelp affiche l'aide détaillée .

  • --version affiche les informations de version du VLC .

  • --list affiche la liste des modules disponibles .

  • --module <module> affiche l'aide du module spécifié .