https://github.com/transmute-app/transmute
Self hosted file converter for images, video, audio, json, excel and more. Supports over 2,000 conversions!
https://github.com/transmute-app/transmute
audio-converter convert docker fastapi file-converter image-converter pdf-converter python react self-hosted vite
Last synced: 2 months ago
JSON representation
Self hosted file converter for images, video, audio, json, excel and more. Supports over 2,000 conversions!
- Host: GitHub
- URL: https://github.com/transmute-app/transmute
- Owner: transmute-app
- License: mit
- Created: 2026-02-17T20:26:43.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-29T16:20:51.000Z (3 months ago)
- Last Synced: 2026-03-29T18:51:48.227Z (3 months ago)
- Topics: audio-converter, convert, docker, fastapi, file-converter, image-converter, pdf-converter, python, react, self-hosted, vite
- Language: Python
- Homepage: https://transmute.sh
- Size: 395 MB
- Stars: 307
- Watchers: 3
- Forks: 23
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
Transmute
[](https://github.com/transmute-app/transmute/blob/main/LICENSE)
[](https://github.com/transmute-app/transmute/blob/main/docker-compose.yml)
**Transmute** is a **free, open source, self-hosted file converter** built for privacy and flexibility. Convert **images, video, audio, documents, spreadsheets, subtitles, and fonts** entirely locally, with no file size limits and no third-party access to your files. Deploy in seconds with Docker.
This application is under active development. Want to support us? Give us a star or jump in and contribute!
> [!NOTE]
> **This project is human-led and maintainer-reviewed.**
> AI tools may be used during development, but all code is intentionally written, reviewed, and validated by a human who understands and takes responsibility for the result. This is not an autonomously generated project, and fully AI-generated or agent-submitted contributions are not accepted. See the [contributing guide](https://github.com/transmute-app/transmute?tab=contributing-ov-file#no-autonomous-agents-or-ai-assistants) for more details
## Screenshots
| Converter / Home | Uploaded Files | Previously Converted | Settings |
| --- | --- | --- | --- |
| 
| 
| 
| 
|
## Demo
Want to see a video demo? Check out our [YouTube](https://www.youtube.com/watch?v=lod7Fze9oPY).
## Features
- **Privacy first**: Files are processed on your own server and never sent to third parties
- **No file size limits**: Convert files as large as your storage allows
- **100+ formats supported**: Images, video, audio, documents, spreadsheets, subtitles, and fonts
- **Built-in authentication**: User accounts, role-based access, and API key support out of the box
- **Docker ready**: Deploy with a single command, no complex setup required
- **REST API**: Automate and integrate file conversions via the built-in OpenAPI-documented API
- **Multiple themes**: Seven built-in light and dark UI themes
> [!WARNING]
> **Think carefully before exposing Transmute to the public internet / WAN.**
> Transmute includes built-in authentication and per-user data isolation, but is designed for trusted networks. If you expose it beyond your LAN, place it behind a reverse proxy with TLS and rate limiting. The maintainers are not responsible for security issues arising from your deployment configuration.
## Quickstart
```bash
wget "https://raw.githubusercontent.com/transmute-app/transmute/refs/heads/main/docker-compose.yml" && docker compose up -d
```
## What Does Transmute Replace?
*For the record, I love all of these services and use them all frequently. Transmute is not up to par with any of them yet. But it will be!*
| Service | Why Replace? |
| ------- | --------------- |
| [cloudconvert.com](https://cloudconvert.com/) | File size limits, API is paid only, 3rd-party gets my files |
| [freeconvert.com](https://www.freeconvert.com/) | File size limits, 3rd-party gets my files |
| [cconvertio.co](https://convertio.co/) | File size limits, 3rd-party gets my files |
## Supported Formats
| Category | Formats |
| -------- | ------- |
| Images | JPEG, PNG, WebP, AVIF, HEIC/HEIF, JXL, GIF, BMP, TIFF, SVG, ICO, PSD, and more |
| Video | MP4, MKV, MOV, WebM, AVI, FLV, WMV, TS, 3GP, and more |
| Audio | MP3, WAV, FLAC, AAC, M4A, OPUS, OGG, AIFF, WMA, and more |
| Documents | Markdown, HTML, DOCX, PDF, EPUB, ODT, RST, LaTeX, RTF, PPTX, and more |
| Data / Spreadsheets | CSV, XLSX, JSON, Parquet, YAML, TSV, XML, ODS, and more |
| Subtitles | SRT, ASS, SSA, VTT, SUB |
| Fonts | TTF, OTF, WOFF, WOFF2 |
| Diagrams | DrawIO |
## Themes
| Dark Theme | Screenshot | Light Theme | Screenshot |
| ---------------- | ---------- | ---------------- | ---------- |
| Rubedo (Default) | 
| Albedo | 
|
| Citrinitas | 
| Aurora | 
|
| Viriditas | 
| Caelum | 
|
| Nigredo | 
| | |
## API Documentation
When the app is running the API docs are available at http://TRANSMUTE_IP:3313/api/docs
## Contributing
Contributions are welcome! This project is human-driven - autonomous agents and AI assistants are not welcome contributors and such submissions will be rejected. See the [contributing guide](https://github.com/transmute-app/transmute?tab=contributing-ov-file#no-autonomous-agents-or-ai-assistants) for details.
### Our Awesome Contributors
