# Transmute

> Transmute is a free, open-source, self-hosted file converter and compressor. Convert and compress images, video, audio, data, documents, 3D models, and more on your own hardware with Docker. No file size limits, no watermarks, no third-party uploads — full privacy.

Transmute is a self-hosted alternative to cloud-based file converters like CloudConvert, FreeConvert, and Convertio. It runs entirely on your own hardware via Docker, keeping all files private. It supports converting between hundreds of formats across images (PNG, JPG, WebP, SVG, BMP, HEIC), video (MKV, MP4, MOV, AVI, WebM), audio (MP3, WAV, FLAC, AAC, OGG), documents (PDF, DOCX, TXT, Markdown, HTML), data (CSV, JSON, YAML, Parquet), 3D models (STL, OBJ, PLY, GLB, 3MF, DXF), diagrams (draw.io), fonts, subtitles, and more. It also compresses images, PDFs, audio, video, and GIFs to reduce file size while keeping the same format, with simple compression levels to balance quality and size. It has a clean web UI, a full REST API, built-in authentication with per-user data isolation, and seven built-in themes.

- License: MIT
- Source Code: https://github.com/transmute-app/transmute
- Docker Image: ghcr.io/transmute-app/transmute:main

## Documentation

- [Getting Started](https://transmute.sh/docs/getting-started/): How to install and run Transmute for the first time.
- [Authentication & Users](https://transmute.sh/docs/authentication/): How Transmute handles accounts, roles, API keys, and authentication.
- [OIDC / SSO Integration](https://transmute.sh/docs/oidc/): Allow login and user account creation via OIDC providers such as Authentik and Authelia
- [Themes](https://transmute.sh/docs/themes/): Browse all available Transmute themes with side-by-side screenshots.
- [Settings Reference](https://transmute.sh/docs/settings-reference/): A complete reference for every option on the Transmute Settings page.
- [Quality Reference](https://transmute.sh/docs/quality-reference/): Detailed reference for what low, medium, and high mean for each converter and output format that supports quality settings.
- [API Reference](https://transmute.sh/docs/api-reference/): Interact with Transmute programmatically — upload files, convert formats, and download results via a simple REST API.
- [From URL](https://transmute.sh/docs/from-url/): Download a file from a URL and convert it without uploading from your local device first.
- [Environment Variables](https://transmute.sh/docs/environment-variables/): Configure Transmute's default behaviour using environment variables in your Docker Compose file.
- [UI Translations](https://transmute.sh/docs/translations/): Translations of the Transmute UI provided by other users.
- [Reverse Proxy & Sub-path](https://transmute.sh/docs/reverse-proxy/): Serve Transmute behind a reverse proxy, either at a domain root or under a sub-path.

## Pages

- [Home](https://transmute.sh/): Overview of the self-hosted file converter and compressor.
- [Supported Conversions](https://transmute.sh/conversions/): Browse every file format conversion supported by Transmute.

## Optional

- [Full Documentation for LLMs](https://transmute.sh/llms-full.txt): Complete documentation content in a single file.