Installation#

These docs require version 2.0.0-rc6 or later. The version constraints below allow version 2 prereleases.

Already using 1.x? See Upgrading from 1.x for what changed in version 2.

Prebuilt Executable#

Download the ZIP archive for your platform and SHA256SUMS from the same GitHub release. Choose version 2.0.0-rc6 or later.

Platform

Archive

Linux x86-64

vl-convert_linux-64.zip

Linux ARM64

vl-convert_linux-aarch64.zip

macOS Intel

vl-convert_osx-64.zip

macOS Apple Silicon

vl-convert_osx-arm64.zip

Windows x86-64

vl-convert_win-64.zip

Calculate the archive’s SHA-256 checksum with the command for your platform. Replace <ARCHIVE> with the downloaded filename:

Platform

Command

Linux

sha256sum <ARCHIVE>

macOS

shasum -a 256 <ARCHIVE>

Windows PowerShell

Get-FileHash <ARCHIVE> -Algorithm SHA256

Compare the result with the matching filename in SHA256SUMS. Do not use the archive if the checksums differ.

Extract the archive into a new directory, then add its bin subdirectory to your PATH. Confirm the installation:

$ vl-convert --version

Build from Source#

To build the executable yourself, install a Rust toolchain and run:

$ cargo install vl-convert --version '^2.0.0-rc6' --locked

vl-convert --help lists the conversion commands.