Skip to content

💾 Self-hosted online file converter. Supports 1000+ formats ⚙️

License

Notifications You must be signed in to change notification settings

C4illin/ConvertX

Repository files navigation

ConvertX

ConvertX

Dockerghcr.io PullsDocker PullsGitHub ReleaseGitHub commits since latest releaseGitHub repo sizeDocker container size

C4illin%2FConvertX | Trendshift

A self-hosted online file converter. Supports over a thousand different formats. Written with TypeScript, Bun and Elysia.

Features

  • Convert files to different formats
  • Process multiple files at once
  • Password protection
  • Multiple accounts

Converters supported

ConverterUse caseConverts fromConverts to
InkscapeVector images717
libjxlJPEG XL1111
resvgSVG11
VipsImages4523
libheifHEIF24
XeLaTeXLaTeX11
CalibreE-books2619
LibreOfficeDocuments4122
DaselData Files54
PandocDocuments4365
msgconvertOutlook11
dvisvgmVector images42
ImageMagickImages245183
GraphicsMagickImages167130
Assimp3D Assets7723
FFmpegVideo~472~199
PotraceRaster to vector411
VTracerRaster to vector81
MarkitdownDocuments61

Any missing converter? Open an issue or pull request!

Deployment

Warning

If you can't login, make sure you are accessing the service over localhost or https otherwise set HTTP_ALLOWED=true

# docker-compose.ymlservices: convertx: image: ghcr.io/c4illin/convertxcontainer_name: convertxrestart: unless-stoppedports: - "3000:3000"environment: - JWT_SECRET=aLongAndSecretStringUsedToSignTheJSONWebToken1234 # will use randomUUID() if unset# - HTTP_ALLOWED=true # uncomment this if accessing it over a non-https connectionvolumes: - ./data:/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.

Environment variables

All are optional, JWT_SECRET is recommended to be set.

NameDefaultDescription
JWT_SECRETwhen unset it will use the value from randomUUID()A long and secret string used to sign the JSON Web Token
ACCOUNT_REGISTRATIONfalseAllow users to register accounts
HTTP_ALLOWEDfalseAllow HTTP connections, only set this to true locally
ALLOW_UNAUTHENTICATEDfalseAllow unauthenticated users to use the service, only set this to true locally
AUTO_DELETE_EVERY_N_HOURS24Checks every n hours for files older then n hours and deletes them, set to 0 to disable
WEBROOTThe address to the root path setting this to "/convert" will serve the website on "example.com/convert/"
FFMPEG_ARGSArguments to pass to the input file of ffmpeg, e.g. -hwaccel vaapi. See #190 for more info about hw-acceleration.
FFMPEG_OUTPUT_ARGSArguments to pass to the output of ffmpeg, e.g. -preset veryfast
HIDE_HISTORYfalseHide the history page
LANGUAGEenLanguage to format date strings in, specified as a BCP 47 language tag
UNAUTHENTICATED_USER_SHARINGfalseShares conversion history between all unauthenticated users
MAX_CONVERT_PROCESS0Maximum number of concurrent conversion processes allowed. Set to 0 for unlimited.

Docker images

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.

ImageWhat it is
image: ghcr.io/c4illin/convertxThe latest release on ghcr
image: ghcr.io/c4illin/convertx:mainThe latest commit on ghcr
image: c4illin/convertxThe latest release on docker hub
image: c4illin/convertx:mainThe latest commit on docker hub

Release image sizeDev image size

Tutorial

Note

These are written by other people, and may be outdated, incorrect or wrong.

Tutorial in french: https://belginux.com/installer-convertx-avec-docker/

Tutorial in chinese: https://xzllll.com/24092901/

Tutorial in polish: https://kreatywnyprogramista.pl/convertx-lokalny-konwerter-plikow

Screenshots

ConvertX Preview

Development

  1. Install Bun and Git
  2. Clone the repository
  3. bun install
  4. bun run dev

Pull requests are welcome! See open issues for the list of todos. The ones tagged with "converter request" are quite easy. Help with docs and cleaning up in issues are also very welcome!

Use conventional commits for commit messages.

Contributors

Image with all contributors

Alt

Star History

Star History Chart