Convert Media

Extension de conversion multimédia pour éditeurs basés sur VS Code. Convertissez images, audio et vidéos depuis l’explorateur ou la palette de commandes ; le fichier de sortie est créé à côté de la source. Basé sur FFmpeg.

Sommaire

• Fonctionnalités
• Formats pris en charge
• Installation et prérequis
• Mise à jour
• Utilisation
• Conversions en lot
• Configuration
• Dépannage
• Documentation (dont Confidentialité, CGU, CONTRIBUTING)

Fonctionnalités

• Images : conversion vers AVIF (AV1, qualité et vitesse configurables).
• Audio : conversion vers WAV (PCM 48 kHz) ou export « Prêt pour YouTube Audio » (AAC/MP4, couverture noire).
• Vidéo : profils YouTube 4K (3840×2160) et 1080p (H.264 + AAC, letterboxing si besoin).
• Multi-sélection : clic droit sur plusieurs fichiers du même type pour enchaîner les conversions ; progression du type « 1/N », annulation possible.
• Conflits : si le fichier de sortie existe déjà, choix Écraser, Renommer (suffixe _1) ou Annuler.
• Prévisualisation : pour YouTube 4K et YouTube Audio, résumé (chemin, paramètres) avec confirmation avant lancement.
• Panneau d’accueil : commande « Ouvrir la page Convert Media » pour une vue récapitulative, les fichiers convertibles détectés dans le workspace et des boutons d’action rapide.
• Logs : canal de sortie « Convert Media » (stderr FFmpeg, erreurs) ; option « Voir les détails » dans les notifications d’erreur.

Formats pris en charge

Les fichiers d’un type non concerné sont ignorés lors d’une sélection multiple.

Installation et prérequis

1. Installer l’extension depuis le marketplace ou depuis le dossier du projet (vsix / développement).
2. FFmpeg : doit être installé et disponible dans le PATH. En cas de message d’erreur au démarrage, installer FFmpeg puis cliquer sur Réessayer dans la notification.
3. AVIF : la conversion en AVIF nécessite le codec libaom-av1 dans FFmpeg (souvent inclus par défaut). En cas d’échec, consulter la doc de votre distribution ou FFmpeg – encodage AV1.

Compatibilité : VS Code 1.85+, Cursor, Antigravity (API d’extensions compatible).

Mise à jour

• Depuis le marketplace : les mises à jour sont proposées automatiquement selon les paramètres de l’éditeur. Ouvrir la vue Extensions (Ctrl+Shift+X), repérer Convert Media ; si une mise à jour est disponible, un bouton Mettre à jour s’affiche. Vous pouvez aussi lancer Extensions : vérifier les mises à jour des extensions depuis la palette (Ctrl+Shift+P).
• Extension installée manuellement (fichier .vsix) : télécharger la nouvelle version .vsix, puis dans la vue Extensions utiliser le menu ... → Installer à partir du VSIX... et sélectionner le fichier (l’ancienne version est remplacée).
• Version de développement : après un git pull, exécuter npm run compile (et éventuellement Développeur : recharger la fenêtre pour prendre en compte les changements).

Utilisation

Explorateur de fichiers

1. Clic droit sur un ou plusieurs fichiers (même type).
2. Choisir Convert Media puis la commande souhaitée.
3. Suivre la progression dans la notification ; possibilité d’annuler.

Palette de commandes

1. Ctrl+Shift+P (ou Cmd+Shift+P sur macOS).
2. Taper par ex. « Convertir en AVIF » ou « Easy Convert ».
3. La conversion s’applique au fichier actif (onglet ouvert) ou à la sélection si plusieurs fichiers sont concernés.

Raccourcis clavier

Avec un éditeur ayant le focus :

Sur macOS, remplacer Ctrl par Cmd. Les raccourcis sont modifiables dans Paramètres → Raccourcis clavier (rechercher « Convert Media »).

Page d’accueil de l’extension

Commande Ouvrir la page Convert Media (palette ou liste des commandes) : ouvre un panneau avec les fichiers convertibles détectés (images, audio, vidéo), les commandes et des boutons d’action (paramètres, lancement de conversion).

Conversions en lot

• Progression : titre du type « Conversion AVIF (1/5) », message final « 5 fichiers convertis » (ou équivalent).
• Parallélisme : paramètre easyConvert.parallelism (1 = série, 2 ou 3 = conversions simultanées). Par défaut : 1.
• Confirmation : option easyConvert.confirmBatch pour demander une confirmation avant de lancer un lot (ex. « Convertir 12 fichiers ? »).

Configuration

Toutes les options sont dans Paramètres → Extensions → Convert Media (ou recherche easyConvert).

Dépannage

• FFmpeg introuvable : vérifier qu’il est dans le PATH (ffmpeg -version en terminal). Utiliser Réessayer après installation.
• Erreur AVIF / libaom : FFmpeg doit être compilé avec libaom-av1. Voir FFmpeg – AV1.
• Détails d’une erreur : dans la notification d’erreur, cliquer sur Voir les détails pour ouvrir le canal de sortie « Convert Media » (stderr FFmpeg et messages parsés).

Documentation

• À quoi sert cette extension : objectif, public, cas d’usage.
• CHANGELOG : historique des versions.
• Politique de confidentialité : données, télémétrie, usage local.
• Conditions générales d’utilisation (CGU) : licence, usage, responsabilité.
• Contribuer : mise en place, conventions, comment proposer une modification.
• Contributeurs : liste des contributeurs.
• Architecture et paramètres FFmpeg : flux de l’extension, paramètres utilisés, prérequis techniques.
• Publier l’extension : génération du .vsix, publication sur le Marketplace VS Code, jeton d’accès.
• Dépôt : code source.