Version 1.0.0 is Here!

Using Transmute? Share feedback in the 2-minute user survey!

Jobs / Queue

This is the first official release of Transmute, and brings with it a feature I have been wanting to add since the beginning: JOBS!

Conversions are no longer tied to individual HTTP requests but are instead ran in a queue, meaning you can leave the converter page and come back to the Jobs tab at any time (previously History) without losing any progress. No more losing your long running conversion just because you accidentally close a tab or refresh your page!

"From URL" Authentication Options

Want to upload files directly from your OwnCloud instance? Maybe from a private GitHub repo? Follow this documentation to specify authentication for various domains! Supports basic, bearer auth, and custom header authentication.

Other Additions

• French translations (courtesy of @bastiengrignon)
• PDF <-> Image conversions (Fixes #139)

Changes

• chore: update Calibre version to 9.8.0 (fixes #141) (11e6a09)
• feat: implement PDF <-> image conversions with zip output (#139) (3f7adce)
• feat: add descriptions for the different conversion qualities (#136) (9378ad0)
• feat: add proper job queue to retain running job status (574b791)
• feat: implement domain-based authentication for "from url" downloads (68f8ab6)
• feat: Add French translations (e078606)

Version Information

• Full version: v1.0.0
• Minor version tag: v1.0
• Major version tag: v1

Updated Tags

• v1.0 → v1.0.0 (created)
• v1 → v1.0.0 (created)

Changes

• feat: add link to usage survey in footer (non-invasive) (4cecb4f)
• feat: Italian Translation (4643aaa)
• chore: update drawio version to 29.7.9 and postcss to 8.5.10 (07d5a91)

Version Information

• Full version: v0.12.2
• Minor version tag: v0.12
• Major version tag: v0

Updated Tags

• v0.12 → v0.12.2 (updated)
• v0 → v0.12.2 (updated)

Fixes an issue that prevented media downloaded by yt-dlp from being converted to mp4 or m4a. Also adds support for yt-dlp supported playlists.

Changes

• feat: support yt-dlp playlists (#130) (262f108)
• chore(deps): bump lxml from 6.0.2 to 6.1.0 (aa7e218)
• fix: allow converting yt-dlp downloaded media to mp4 (#130) (f7143b2)

Version Information

• Full version: v0.12.1
• Minor version tag: v0.12
• Major version tag: v0

Updated Tags

• v0.12 → v0.12.1 (updated)
• v0 → v0.12.1 (updated)

Adds a "From URL" option for uploading files, now instead of just uploading files directly from your computer you can add add links and Transmute will download them for you. Fixes #127.

This release also includes yt-dlp so you can download videos from sites such as YouTube or Vimeo (anything supported by yt-dlp) and jump straight into converting them, who needs flv-to-mp3 anymore? Fixes #105. Currently this does not work for entire playlists, only individual videos. Tracked in #130.

This update also includes some minor UI/UX improvements to phrasing for clarity, as well as the introduction of Spanish and Polish translations (shoutout @Fuan200 and @Icikowski)

Changes

• chore: bump Draw.io version to 29.7.8 in Dockerfile (fixes #129) (b899179)
• feat: add YtDlpDownloader for YouTube media downloads (#105) (d990c2a)
• feat(i18n): add Polish translation (058e960)
• chore: add GitHub Actions workflow to monitor Dockerfile upstream releases (5d38802)
• feat: implement generic "from url" feature which allows uploading a file to transmute via URL instead of direct file upload (#127) (98d660f)
• fix: add URL normalization for OIDC and app settings (#125) (fd1697e)
• add spanish translation (33761a1)
• fix(stats): update stat labels for clarity and consistency (e8784f9)
• fix(converter): replace seperate "unsupported" section with a simple notice of ignored files (f923fbb)
• chore(deps): bump authlib from 1.6.9 to 1.6.11 (d81d2c4)
• fix(stats): add snapshot notice to stats display for clarity (#121) (219dbef)
• chore(deps): bump python-multipart from 0.0.22 to 0.0.26 (1198f29)

Version Information

• Full version: v0.12.0
• Minor version tag: v0.12
• Major version tag: v0

Updated Tags

• v0.12 → v0.12.0 (created)
• v0 → v0.12.0 (updated)

Various UI / UX enhancements around authentication:

• reduces some confusion with OIDC accounts allowing password resets
• properly marks required vs optional fields on account creation
• fixes a bug where OIDC users with OIDC_AUTO_LAUNCH=true could never actually log out.

Adds a visual separation for uploaded files which have no supported conversions.

Introduces localization support for future translations and added German translations with the help of @AnguTom. New translations are more than welcome, please see: https://transmute.sh/docs/translations/

Changes

• fix: fixed optional fields visibility (4109dfe)
• feat(converter): add RenameConverter for file extension rename conversions (zip to cbz, etc.) #99 (9e9e03d)
• feat(users): prevent oidc managed users & guest accounts from having their non-existent passwords set or overridden (47a7331)
• chore(deps): bump pytest from 9.0.2 to 9.0.3 (cf8809f)
• chore(deps): bump pillow from 12.1.1 to 12.2.0 (cd2d7fd)
• feat(converter): seperate unsupported files to prevent confusion (#116) (f88533b)
• fix(pkcs7): improve error handling for base64 decoding in PKCS7Converter (010f238)
• fix(auth): allow for a one time display of the auth screen when logging out while OIDC_AUTO_LAUNCH is enabled (#112) (fa3d6ba)
• feat: add German translations for the application (#107) (AI assisted) (a324bfe)
• feat: add i18next and react-i18next for internationalization support (#107) (AI assisted) (9fbdf48)
• chore: enhanced required field readability (353fb88)

Version Information

• Full version: v0.11.0
• Minor version tag: v0.11
• Major version tag: v0

Updated Tags

• v0.11 → v0.11.0 (created)
• v0 → v0.11.0 (updated)

Main reason for relase is to fix #108 which was a bug in the cbr -> cbz converter caused by a missing dependency. Also fixes #106, adding a P7M converter to unwrap signed PDFs, XMLs, or any other file stored in a P7M container.

Changes

• fix: add missing unrar dependency (bbced13)
• fix: update Calibre version to 9.7.0 in Dockerfile (b5c715c)
• feat: add PKCS7Converter for handling PKCS#7/CMS signed containers (#106) (4660ec6)
• chore(deps-dev): bump vite from 7.3.1 to 7.3.2 in /frontend (1995206)
• chore: add tests for core, background, and registry modules (AI assisted) (d13b8c9)

Version Information

• Full version: v0.10.1
• Minor version tag: v0.10
• Major version tag: v0

Updated Tags

• v0.10 → v0.10.1 (updated)
• v0 → v0.10.1 (updated)

Introduces bulk setting of formats and qualities for conversions (fixes #101). Also adds conversions for popular comic formats (CBR, CB7, CBZ, PDF) (fixes #102). Big shoutout to @Morethanevil for the help testing both of these.

An additional note for any Unraid users, Transmute is now available as an Unraid template on the Community app store, please open an issue if you experience any problems or limitations with it.

Changes

• feat: add CBZConverter for comic book formats (cbz, cbr, cb7, pdf) (b8fdfd2)
• feat: add bulk format and quality selection in Converter (#101) (2052827)

Version Information

• Full version: v0.10.0
• Minor version tag: v0.10
• Major version tag: v0

Updated Tags

• v0.10 → v0.10.0 (created)
• v0 → v0.10.0 (updated)

Lots of improvements with this one.

Qualities

Introduces qualities for certain supported conversions, specifically certain image, audio, and video formats. The quality setting been being used on the backend but the control is now available for the user. You can set default values through the settings same as you can with default formats.

OIDC

Improves the UX for OIDC enabled instances, making it more obvious that users should log in with SSO, but still providing an option for a local account. If you want to automatically redirect to SSO login you can use the environment variable OIDC_AUTO_LAUNCH=true. Thanks @SamTanna for the help testing this one.

Conversions

Adds vector-to-vector (svg <-> eps) support through Inkscape, thanks to @Frost-4X for the feedback.

All Changes

• feat: add auto launch option for OIDC login (5ba16a7)
• feat: add quality support for additional formats in PillowConverter (dff9f30)
• feat: enhance FFmpegConverter with quality settings for additional video and audio formats (3a6a7ea)
• feat: when OIDC is enabled, make it the prominent login option (64488c4)
• feat: default quality management for output formats (a04906b)
• feat: display quality attribute in the completed conversions (Converter.tsx and History.tsx) (49a1b5d)
• feat: add quality attribute to conversion database (10bad02)
• feat: make converters support quality options and update related interfaces (fc548c0)
• feat: add optional quality attribute to ConversionRequest and update converter to use it (ceb794d)
• feat: add optional 'qualities' attribute for converters (2aba18f)
• feat: add VectorConverter for SVG <-> EPS format conversions using Inkscape (fae5fb3)

Version Information

• Full version: v0.9.0
• Minor version tag: v0.9
• Major version tag: v0

Updated Tags

• v0.9 → v0.9.0 (created)
• v0 → v0.9.0 (updated)

Introduces a stats page to view current number of uploaded & converted files per user, as well as current amount of space used per user. Data reflects what is currently on your server (i.e. has not been deleted manually or through the TTL).

Also includes a small UX fix for API key creation.

On top of these user facing improvements we have introduced a frontend testing suite that we will continue to expand to improve stability.

Thanks @Fuan200 & @ashrafulislambd!

Changes

• fix: update Pandoc and Draw.io versions in Dockerfile (e109b59)
• fix: update Calibre version to 9.6.0 and enhance wget commands with retries (3bc1e66)
• security: resolve npm audit vulnerabilities in eslint dependency tree (a74f7b2)
• fix: API key length validation error in frontend (cd3ba4c)
• chore(deps): bump picomatch in /frontend (60d82d2)
• refactor: simplify account and user management headers by removing subtitles (76b3cc9)
• feat: add Stats page to utilize the statistics API (b0d5493)
• feat: add stats endpoint and response schemas for user statistics (dbe69dd)

Version Information

• Full version: v0.8.0
• Minor version tag: v0.8
• Major version tag: v0

Updated Tags

• v0.8 → v0.8.0 (created)
• v0 → v0.8.0 (updated)

Introduces a Guest role (optional, disabled by default) that allows for unauthenticated conversions. Data is still linked to a psuedo user account, so guests cannot see each other's uploads or conversions. An admin account is still required to be set up before this can be used. Fixes #88

If you would like to use please add the environment variable ALLOW_UNAUTHENTICATED=true.

[!WARNING]
This allows unauthenticated file uploads to your server. Please do not enable if your Transmute instance is exposed to the public WAN

Changes

• feat: implement guest user functionality (a97fcb8)
• fix: adjust layout of user management screen to prevent overflow (a71a789)

Version Information

• Full version: v0.7.0
• Minor version tag: v0.7
• Major version tag: v0

Updated Tags

• v0.7 → v0.7.0 (created)
• v0 → v0.7.0 (updated)

Fixes an issue with OIDC behind a reverse proxy by adding an APP_URL environment variable (Fixes #89).

Not required for all users, but helpful when using a reverse proxy. Also used to set the displayed URL in the API docs. Big thanks to @Horstage for the testing / validation on this one!

Changes

• feat: add app_url setting for explicit callback URL configuration (543497b)
• feat: extend supported PDF formats for previewing to include pdf subtypes (pdf/a, etc.) (1282042)

Version Information

• Full version: v0.6.1
• Minor version tag: v0.6
• Major version tag: v0

Updated Tags

• v0.6 → v0.6.1 (updated)
• v0 → v0.6.1 (updated)

Minor UI improvement using the custom format selection dropdown in the default formats settings, adds SSO support via OIDC (fixes #85), adds PDF -> PDF/A conversion (fixes #87)

OIDC integration instructions: https://transmute.sh/docs/oidc/

Changes

• feat: add OCRmyPDF converter for PDF to PDF/A conversion (5d607b4)
• feat: add PDF type detection (pdf/a, pdf/x, etc.) based on XMP metadata (9f4d385)
• feat: allow for conversion to various formats with the same extension (prep for pdf, pdf/a, etc.) (b3621e5)
• feat: add internal OIDC URL configuration for same machine docker setups (f3a13c9)
• feat: implement OIDC authentication flow with user identity management (97ce1cf)
• feat: integrate FormatDropdown component into default format selection on Settings page (55980a2)

Version Information

• Full version: v0.6.0
• Minor version tag: v0.6
• Major version tag: v0

Updated Tags

• v0.6 → v0.6.0 (created)
• v0 → v0.6.0 (updated)

This release brings some minor UI improvements: Better mobile responsiveness, a custom format selector dropdown with search capabilities, and improved accesability (aria labels) on the file list headers.

We also welcome our first contribution from @Fuan200!

Changes

• feat(accessibility) add button / aria labels to th tags on file table (6ca664d)
• feat: make UI more responsive / less crowded on small screens (9328a7a)
• feat: add FormatDropdown component and implement custom dropdown styling (e71ea72)
• chore(deps-dev): bump flatted from 3.3.3 to 3.4.2 in /frontend (e035904)

Version Information

• Full version: v0.5.0
• Minor version tag: v0.5
• Major version tag: v0

Updated Tags

• v0.5 → v0.5.0 (created)
• v0 → v0.5.0 (updated)

Fixes the few remaining bugs identified by (e180974), expands the support for FLI and FLC files, and adds UI hints for some hotkeys that were previously implemented in (b85bb7f)

Changes

• feat: update FFmpegConverter to support FLI and FLC formats (f65364d)
• feat: add hotkey hints to the Converter component (bb53527)

• fix: replace xml.etree.ElementTree with defusedxml.ElementTree for safer decoding (e85e6e9)
• fix: normalize image modes in PillowConverter and fix image link handling in PyPandocConverter (c0f2cec)
• fix: sanitize FB2 embedded resource extraction (d45a140)
• fix: add content sanitization methods for RST, Org, and Muse formats in PyPandocConverter (1a90725)
• fix: add new helper methods to PandasConverter to fix some incompatibility edge cases between formats (5d7209b)

Version Information

• Full version: v0.4.5
• Minor version tag: v0.4
• Major version tag: v0

Updated Tags

• v0.4 → v0.4.5 (updated)
• v0 → v0.4.5 (updated)

The introduction of backend/tests/converters/test_all_conversions.py, a dynamic testing suite that makes use of the files in assets/samples has identified mutiple bugs. This release fixes the most pressing of them, but expect more fixes in the near future

Changes

• feat: backend tests dynamically pull all sample files for testing (VERY SLOW) (e180974)
• feat: Add support for apng, eps, mpo, pfm, pnm (4deea05)

• fix: improve BLP format handling by capping image size (651c203)
• fix: Scale stitched images to prevent exceeding libjpeg dimension limits (6bfa571)
• fix: Ensure RGBA input is handled correctly by forcing yuv420p pixel format for non-transparent video outputs (1506c79)
• fix: Update supported output formats and handle 1-bit pixel conversion for MSP and XBM (1abc266)
• fix: FFmpegConverter should not try to extract audio from gif/apng (fbdd29f)

Version Information

• Full version: v0.4.4
• Minor version tag: v0.4
• Major version tag: v0

Updated Tags

• v0.4 → v0.4.4 (updated)
• v0 → v0.4.4 (updated)

Adds PWA icon for iPhone / Android psuedo install (i.e. adding the bookmark to your home screen)

Changes

• feat: add favicon and web app manifest for iphone / android pwa install (aaf34f7)

Version Information

• Full version: v0.4.3
• Minor version tag: v0.4
• Major version tag: v0

Updated Tags

• v0.4 → v0.4.3 (updated)
• v0 → v0.4.3 (updated)

Update Draw.io to latest version, and remove unused jira file format

Changes

• deps: update draw.io version (6c658a0)
• docs: update README with documentation links (d16e51c)
• fix: remove unsupported 'jira' format from input and output format lists (7927a9a)

Version Information

• Full version: v0.4.2
• Minor version tag: v0.4
• Major version tag: v0

Updated Tags

• v0.4 → v0.4.2 (updated)
• v0 → v0.4.2 (updated)

Adds support for EBook conversions (lrf, azw3, epub, fb2, mobi, pdb, snb) and reworked the multiarchitecture build pipeline to DRASTICALLY improve run time (40 minutes -> 10 minutes)

Changes

• security: zizmor fixes (2452628)
• feat: speed up docker build workflow by seperating multi-arch build into matrix (df2ff86)
• feat: add Calibre converter for support for additional ebook formats, also includes sample files (13dcc51)

Version Information

• Full version: v0.4.1
• Minor version tag: v0.4
• Major version tag: v0

Updated Tags

• v0.4 → v0.4.1 (updated)
• v0 → v0.4.1 (updated)

Adds support for vCard - Virtual Contact File (vcf), as well as various archive formats (zip, 7z, rar, tar, tar.gz, tar.bz2, tar.xz, tar.zst)

Changes

• security: safe extraction for archives (prevent zipslip) (7176966) and (d77a159)
• feat: add support for 7z format conversions in ArchiveConverter (901fd53)
• feat: add RAR support for conversion to TAR and ZIP formats (b5be257)
• feat: add sample archive files for testing various compression formats (0230d19)
• feat: implement ArchiveConverter with TAR to ZIP and ZIP to TAR conversion support (ae03183)
• feat: add support for 'jsonl' file preview / syntax highlighting (c64159f)
• feat: Add support for reading vCard (VCF) files in PandasConverter (229ee09)
• docs: update README 'status' to beta (e74cd33)

Version Information

• Full version: v0.4.0
• Minor version tag: v0.4
• Major version tag: v0

Updated Tags

• v0.4 → v0.4.0 (created)
• v0 → v0.4.0 (updated)

This release focuses on reliability, fixing some uncommon errors and inconsistencies between the development environment and the Docker container

Changes

• fix: install upstream Pandoc to fix inconsistent read/write between dev and docker environment (f385f11)
• fix: set default fps for MicroDVD format if none supplied (7944eb2)
• fix: txt files used the wrong reader (cd2fd4d)
• fix: handle broken sequence state in PSD files by saving a detached raster copy - caused an issue with psd -> avif conversions (11bbe1f)
• fix: suppress warnings for unsupported extensions in XLSX reading - no effect on the output, confusing for users (d4cf576)
• fix: wrong name table keys caused failed woff conversions - bug in the code, my fault (b8601aa)
• fix: remove duplicate 'tif' (tiff) format (8379288)
• fix: remove duplicate 'mpg' from supported video formats (0f84872)
• fix: replace 'latex' with 'tex' in supported input formats and media type aliases (62ae268)
• fix: update 'asciidoc' to 'adoc' in supported formats and media type aliases (71a7a1b)
• chore(deps): bump pyjwt from 2.11.0 to 2.12.0 (149989e)
• chore(deps): bump cairosvg from 2.8.2 to 2.9.0 (be257f1)

Version Information

• Full version: v0.3.1
• Minor version tag: v0.3
• Major version tag: v0

Updated Tags

• v0.3 → v0.3.1 (updated)
• v0 → v0.3.1 (updated)

Adds support for email files (.eml, .msg), plus removes an unused vulnerable package

Changes

• feat: Add EmailConverter for handling email formats (.eml, .msg) along with samples and tests (92ae903)
• security: enhance security by purging unnecessary packages (03b9a0f)

Version Information

• Full version: v0.3.0
• Minor version tag: v0.3
• Major version tag: v0

Updated Tags

• v0.3 → v0.3.0 (created)
• v0 → v0.3.0 (updated)

Adds support for TOON, INI, TOML, FWF, JSONL, ENV files, SQLite dbs, SAV, and XPT

Changes

• docs: add link to website for contributions Fixes #80 (877d5d8)
• security: imagemagick vuln, fixes CVE-2026-28690 (036490d)
• fix: Updated docs schema for files endpoint (f81c9c0)
• feat: enhance pre-merge checks with frontend and backend build and test steps (23fa8ea)
• chore: update PyMuPDF and pymupdf4llm versions in requirements.txt (d6fc28a)
• feat: add support for .toon format (Token-Oriented Object Notation) (ca96d1a)
• feat: enhance PandasConverter to support additional input/output formats including JSONL, SQLite, TOML, INI, and ENV (7184818)

Version Information

• Full version: v0.2.0
• Minor version tag: v0.2
• Major version tag: v0

Updated Tags

• v0.2 → v0.2.0 (created)
• v0 → v0.2.0 (updated)

Added keyboard shortcuts, fixed a bug with zipped download files, and made some minor QOL improvements to the UI

Changes

• fix: ZIP entry naming for converted files was not using proper extension (15e38ec)
• feat: implement PasswordField component to hide / show secret input (56c908b)
• feat: add update notice functionality to footer component (868d9e5)
• feat: dynamically load versioning from build context (f22967b)
• feat: Implemented keyboard shortcuts for opening files, clearning pending files and converting all (b85bb7f)
• feat: implement logging configuration and integrate into main application (06163ea)
• fix: exclude backend/tests from bandit scan to reduce alert noise (3aaeb1b)
• chore: implemented pytest framework for automated backend testing (892dc15) & (7b54727)

Version Information

• Full version: v0.1.2
• Minor version tag: v0.1
• Major version tag: v0

Updated Tags

• v0.1 → v0.1.2 (updated)
• v0 → v0.1.2 (updated)

Changes

• feat: add 'argentum' theme with corresponding screenshot and update README (f184a21)
• feat: enhance API documentation with detailed authentication instructions (79ab95c)
• fix: remove unused Redis configuration from settings (784100e)
• fix: update application version from 0.0.1 to 0.1.1 in settings (4d57b01)
• feat: add 'argentum' theme with corresponding styles and settings (d81fd79)
• fix: update Docker image tag from 'main' to 'latest' in docker-compose.yml (99ee7a2)

Version Information

• Full version: v0.1.1
• Minor version tag: v0.1
• Major version tag: v0

Updated Tags

• v0.1 → v0.1.1 (updated)
• v0 → v0.1.1 (updated)

Transmute now supports users, passwords, and API tokens, making self-hosted deployments easier to secure and manage. This update lays the groundwork for multi-user access and safer automation without giving up the local-first, privacy-focused approach.

Changes

• fix: enable credential persistence during repository checkout in release workflow (73d9fb8)
• feat: update README with security warnings and built-in authentication details (fd4bb63)
• feat: add frontend authentication UI and protected routing (e2be5e2)
• feat: add API key authentication system (dd22b4e)
• feat: add per-user data scoping, ownership checks, and migrations (0447b04)
• feat: add JWT authentication, user management, and auth infrastructure (a4af2e7)
• feat: add user management functionality with UserDB and UserRole classes (1314047)
• feat: implement password hashing and verification functions using bcrypt (bf48a6b)
• security: zizmor findings (d1d7550)

Version Information

• Full version: v0.1.0
• Minor version tag: v0.1
• Major version tag: v0

Updated Tags

• v0.1 → v0.1.0 (created)
• v0 → v0.1.0 (updated)

Changes

Initial release

Version Information

• Full version: v0.0.1
• Minor version tag: v0.0
• Major version tag: v0

Updated Tags

• v0.0 → v0.0.1 (updated)
• v0 → v0.0.1 (updated)