mirror of
https://github.com/C4illin/ConvertX.git
synced 2026-07-01 08:25:48 +00:00
85 lines
3.8 KiB
Markdown
85 lines
3.8 KiB
Markdown
|
|
# ConvertX
|
|
[](https://github.com/C4illin/ConvertX/actions/workflows/docker-publish.yml)
|
|
[](https://github.com/C4illin/ConvertX/pkgs/container/convertx)
|
|
|
|
|
|
|
|
|
|
|
|
A self-hosted online file converter. Supports 831 different formats. Written with TypeScript, Bun and Elysia.
|
|
|
|
## Features
|
|
|
|
- Convert files to different formats
|
|
- Password protection
|
|
- Multiple accounts
|
|
|
|
## Converters supported
|
|
|
|
| Converter | Use case | Converts from | Converts to |
|
|
|------------------------------------------------------------------------------|---------------|---------------|-------------|
|
|
| [Vips](https://github.com/libvips/libvips) | Images (fast) | 45 | 23 |
|
|
| [PDFLaTeX](https://www.math.rug.nl/~trentelman/jacob/pdflatex/pdflatex.html) | Documents | 1 | 1 |
|
|
| [Pandoc](https://pandoc.org/) | Documents | 43 | 65 |
|
|
| [GraphicsMagick](http://www.graphicsmagick.org/) | Images | 166 | 133 |
|
|
| [FFmpeg](https://ffmpeg.org/) | Video | ~473 | ~280 |
|
|
|
|
<!-- many ffmpeg fileformats are duplicates -->
|
|
|
|
## Deployment
|
|
|
|
```yml
|
|
# docker-compose.yml
|
|
services:
|
|
convertx:
|
|
image: ghcr.io/c4illin/convertx
|
|
ports:
|
|
- "3000:3000"
|
|
environment: # Defaults are listed below. All are optional.
|
|
- ACCOUNT_REGISTRATION=false # true or false, doesn't matter for the first account (e.g. keep this to false if you only want one account)
|
|
- JWT_SECRET=aLongAndSecretStringUsedToSignTheJSONWebToken1234 # will use randomUUID() by default
|
|
- HTTP_ALLOWED=false # setting this to true is unsafe, only set this to true locally
|
|
volumes:
|
|
- convertx:/app/data
|
|
```
|
|
|
|
<!-- or
|
|
|
|
```bash
|
|
docker run ghcr.io/c4illin/convertx:master -p 3000:3000 -e ACCOUNT_REGISTRATION=false -v /path/you/want:/app/data
|
|
``` -->
|
|
|
|
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.
|
|
|
|
### Tutorial
|
|
|
|
Tutorial in french: https://belginux.com/installer-convertx-avec-docker/
|
|
|
|
## Todo
|
|
- [x] Add messages for errors in converters
|
|
- [ ] Add options for converters
|
|
- [ ] Add more converters
|
|
- [ ] Divide index.tsx into smaller components
|
|
- [ ] Add tests
|
|
- [ ] Add searchable list of formats
|
|
- [ ] Make the upload button nicer and more easy to drop files on. Support copy paste as well if possible.
|
|
|
|
## Contributors
|
|
|
|
<a href="https://github.com/C4illin/ConvertX/graphs/contributors">
|
|
<img src="https://contrib.rocks/image?repo=C4illin/ConvertX" />
|
|
</a>
|
|
|
|
## Star History
|
|
|
|
<a href="https://github.com/C4illin/ConvertX/stargazers">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=C4illin/ConvertX&type=Date&theme=dark" />
|
|
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=C4illin/ConvertX&type=Date" />
|
|
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=C4illin/ConvertX&type=Date" />
|
|
</picture>
|
|
</a>
|