Reading the repo

Opening the box…

Assembly instructions

C4illin/ConvertX

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

Node.js#bun#conversion#convert#converter

Difficulty: Easy
Time: about 5 min
Stars: ★ 19,461
Activity: Updated this month
License: AGPL-3.0
Open issues: 120
Got it running: Be the first
Looked up: 2 h ago

Saved setup from 2 h ago

Start here

In the browser ↗Open in GitHub CodespacesThe repo ships a dev container, so nothing to install.

Will it work on my device?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Checking for

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker run -p 3000:3000 -e PUID=1000 -e PGID=1000 -v ./data:/app/data ghcr.io/c4illin/convertx

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

Claude reads the 12 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js LTS (no version pinned)runtime
1×Bun runtime
1×bun package manager

Featured in Zain Finds

See the poster ↗Wait... 1000+ file formats and none of it leaves my machine? 😳

Share this manual

Good to know

Dockerfile available (base image: oven/bun:1.4.4-slim).
Dev Container config found — you can open it in VS Code Dev Containers or GitHub Codespaces for a zero-setup environment.
Tool versions pinned in mise.toml — mise install (or asdf install) installs them all.

package.json scripts (18)

devbun run --watch src/index.tsx
hotbun run --hot src/index.tsx
formatnpm-run-all 'format:*'
format:eslinteslint --fix .
format:prettierbun fmt
build:cssbun x @tailwindcss/cli -i ./src/main.css -o ./public/generated.css
build:jstsc
build:binbun run build:css && bun build --compile --minify --sourcemap --bytecode --format=esm --define 'process.env.NODE_ENV="production"' src/index.tsx --outfile dist/convertx
build:dockerdocker compose build
buildbun run build:css && bun run build:js
lintnpm-run-all 'lint:*'
lint:tscbun check
lint:knipknip
lint:eslinteslint .
lint:prettierbun fmt --check
lint:xssxss-scan
testbun test --path-ignore-patterns=tests/integration
test:integrationdocker build --target test -t convertx:test . && docker run --rm -t -v ./tests:/app/tests -v ./src:/app/src -v ./package.json:/app/package.json convertx:test bun test tests/integration

Files we read (12)

.devcontainer/devcontainer.json

.github/workflows/autofix.yml

.github/workflows/check-lint.yml

.github/workflows/conventional-label.yml

.github/workflows/docker-publish.yml

.github/workflows/dockerhub-description.yml

.github/workflows/run-bun-test.yml

Dockerfile

README.md

compose.yaml

mise.toml

package.json

Branch main · 150 files in the repo