Reading the repo

Opening the box…

How to install ConvertX on macOS (C4illin/ConvertX) · gitmanual

How to install on macOS

C4illin/ConvertX

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

Node.js#bun#conversion#convert#converter

Difficulty: Easy
Time: about 5 min
Stars: ★ 19,491
Activity: Updated this month
License: AGPL-3.0
Open issues: 120
Got it running: 1 person
Looked up: 7 h ago

Saved setup from 7 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

macOS Windows Linux

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?

On macOS: 1 got it running, 1 got stuck.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

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

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/C4illin/ConvertX/badge.svg)](https://gitmanual.com/C4illin/ConvertX)

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