Getting Started

Install uniconv and run your first conversions in minutes.

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/uniconv/uniconv/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/uniconv/uniconv/main/install.ps1 | iex

Or from cmd: powershell -c "irm https://raw.githubusercontent.com/uniconv/uniconv/main/install.ps1 | iex"

Or build from source.

Install plugins

uniconv’s functionality comes from plugins. Start with the essentials collection:

uniconv plugin install +essentials

This installs converters for common image, video, and document formats.

Your first conversions

# Convert an image
uniconv photo.heic "jpg --quality 85"

# Convert a video to GIF
uniconv video.mp4 "gif --width 320 --fps 15"

# Convert a document
uniconv document.docx "pdf"

Chain conversions

Use | to chain multiple transformations:

# Convert video audio to AAC
uniconv video.mp4 "wav | aac"

# Convert and apply a filter
uniconv photo.heic "jpg | grayscale"

Output to multiple formats

Use tee to branch into parallel outputs:

uniconv photo.heic "tee | jpg --quality 80, webp --quality 75, png"

Get file info

uniconv info photo.heic

Keep up to date

# Update uniconv
uniconv update

# Update plugins
uniconv plugin update

Next steps