# Installation These docs require version 2.0.0-rc6 or later. The version constraints below allow version 2 prereleases. Already using 1.x? See {doc}`upgrading` for what changed in version 2. ## Prebuilt Executable Download the ZIP archive for your platform and `SHA256SUMS` from the same [GitHub release](https://github.com/vega/vl-convert/releases). 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 `` with the downloaded filename: | Platform | Command | | --- | --- | | Linux | `sha256sum ` | | macOS | `shasum -a 256 ` | | Windows PowerShell | `Get-FileHash -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: ```console $ vl-convert --version ``` ## Build from Source To build the executable yourself, install a Rust toolchain and run: ```console $ cargo install vl-convert --version '^2.0.0-rc6' --locked ``` `vl-convert --help` lists the conversion commands.