A self-hosted online file converter. Supports over a thousand different formats. Written with TypeScript, Bun and Elysia.
- Convert files to different formats
- Process multiple files at once
- Password protection
- Multiple accounts
Converter | Use case | Converts from | Converts to |
---|---|---|---|
libjxl | JPEG XL | 11 | 11 |
resvg | SVG | 1 | 1 |
Vips | Images | 45 | 23 |
XeLaTeX | LaTeX | 1 | 1 |
Calibre | E-books | 26 | 19 |
Pandoc | Documents | 43 | 65 |
GraphicsMagick | Images | 167 | 130 |
Inkscape | Vector images | 7 | 17 |
Assimp | 3D Assets | 77 | 23 |
FFmpeg | Video | ~472 | ~199 |
Any missing converter? Open an issue or pull request!
# docker-compose.yml
services:
convertx:
image: ghcr.io/c4illin/convertx
container_name: convertx
restart: unless-stopped
ports:
- "3000:3000"
environment:
- JWT_SECRET=aLongAndSecretStringUsedToSignTheJSONWebToken1234 # will use randomUUID() if unset
volumes:
- convertx:/app/data
or
docker run -p 3000:3000 -v ./data:/app/data ghcr.io/c4illin/convertx
Then visit http://localhost:3000
in your browser and create your account. Don't leave it unconfigured and open, as anyone can register the first account.
If you get unable to open database file run chown -R $USER:$USER path
on the path you choose.
All are optional, JWT_SECRET is recommended to be set.
Name | Default | Description |
---|---|---|
JWT_SECRET | when unset it will use the value from randomUUID() | A long and secret string used to sign the JSON Web Token |
ACCOUNT_REGISTRATION | false | Allow users to register accounts |
HTTP_ALLOWED | false | Allow HTTP connections, only set this to true locally |
ALLOW_UNAUTHENTICATED | false | Allow unauthenticated users to use the service, only set this to true locally |
AUTO_DELETE_EVERY_N_HOURS | 24 | Checks every n hours for files older then n hours and deletes them, set to 0 to disable |
WEBROOT | The address to the root path setting this to "/convert" will serve the website on "example.com/convert/" | |
FFMPEG_ARGS | Arguments to pass to ffmpeg, e.g. -preset veryfast |
Warning
If you can't login, make sure you are accessing the service over https or set HTTP_ALLOWED=true
There is a :latest
tag that is updated with every release and a :main
tag that is updated with every push to the main branch. :latest
is recommended for normal use.
The image is available on GitHub Container Registry and Docker Hub.
Image | What it is |
---|---|
image: ghcr.io/c4illin/convertx |
The latest release on ghcr |
image: ghcr.io/c4illin/convertx:main |
The latest commit on ghcr |
image: c4illin/convertx |
The latest release on docker hub |
image: c4illin/convertx:main |
The latest commit on docker hub |
Tutorial in french: https://belginux.com/installer-convertx-avec-docker/
Tutorial in chinese: https://xzllll.com/24092901/
- Install Bun and Git
- Clone the repository
bun install
bun run dev
Pull requests are welcome! See below and open issues for the list of todos.
- Add messages for errors in converters
- Add searchable list of formats
- Add options for converters
- Divide index.tsx into smaller components
- Add tests
- Make the upload button nicer and more easy to drop files on. Support copy paste as well if possible.
- Make errors logs visible from the web ui
- Add more converters: