The ultimate tool for seamless image conversion right inside your VS Code workspace. This extension is powered by a high-performance, multi-threaded C++ backend and the legendary FFmpeg to give you blazing-fast and reliable conversions without ever leaving your editor.
Features
🚀 Blazing Fast Conversion: Utilizes a multi-threaded C++ core to process multiple images in parallel, taking full advantage of your CPU.
🎬 Powered by FFmpeg: Supports a vast range of image formats for both input and output. If FFmpeg can handle it, so can this extension.
📂 Watch & Convert: Enable automatic conversion mode to instantly process any new images added to your source directory. Perfect for automated workflows in development.
💻 Cross-Platform: Works seamlessly on Windows, macOS, and Linux. The extension automatically uses the correct binary for your system.
Requirements
This extension is a powerful wrapper around the FFmpeg command-line tool. For it to work, you must have FFmpeg installed on your system.
Reload VS Code: After installation, it is highly recommended to reload VS Code to ensure all features, especially the automatic file watcher.
Install FFmpeg: Follow the official instructions for your operating system at ffmpeg.org.
Add to PATH: Ensure the ffmpeg executable is available in your system's PATH environment variable.
Settings
image-converter.sourcePath: (Required) The full, absolute path to the folder containing images you want to convert.
image-converter.destinationPath: (Required) The full, absolute path to the folder where converted images will be saved.
image-converter.targetFormat: (Required) The target image format without a dot.
image-converter.autoConvert: If checked, automatically starts conversion when new files are added to the source path. (Default: true)
How to Use
Manual Conversion (On-Demand)
This is the best way to convert a batch of existing images.
Place all your images in the folder specified in sourcePath.
Open the Command Palette (Ctrl+Shift+P).
Type Image Converter and select the command Image Converter: Convert All Images in Source Folder.
The conversion will start, and a progress notification will appear in the bottom-right corner.
Automatic Conversion (Watch Mode)
This mode is ideal for development workflows where you are frequently saving or generating new assets.
Ensure the autoConvert setting is enabled (checked).
Simply save, copy, or move a new image file into the sourcePath directory.
After a short delay, the extension will automatically detect the new file and start the conversion process.
