ConvertX: A Self-Hosted Online File Converter Supporting 1000+ Formats

Introduction

ConvertX is an impressive self-hosted online file converter designed to handle a vast array of file types. Built with modern web technologies like TypeScript, Bun, and Elysia, it provides a robust and efficient solution for all your conversion needs. With support for over a thousand different formats, ConvertX stands out as a comprehensive tool for individuals and teams looking for a private, powerful conversion service.

Installation

Deploying ConvertX is straightforward, primarily utilizing Docker for ease of setup. Below is a docker-compose.yml example to get you started:

# 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
      # - HTTP_ALLOWED=true # uncomment this if accessing it over a non-https connection
    volumes:
      - ./data:/app/data

Alternatively, you can run it directly with Docker:

docker run -p 3000:3000 -v ./data:/app/data ghcr.io/c4illin/convertx

After deployment, visit http://localhost:3000 in your browser to create your first account. It is highly recommended to set the JWT_SECRET environment variable for security. Remember that the first account registered becomes the administrator.

Examples

ConvertX leverages a wide array of powerful underlying converters to achieve its extensive format support. This includes tools like Inkscape for vector images, Vips and ImageMagick for general image processing, LibreOffice for documents, Pandoc for various document conversions, and FFmpeg for video and audio. This robust integration allows ConvertX to handle conversions across categories such as:

• Images (JPEG, PNG, SVG, HEIF, WebP, etc.)
• Documents (PDF, DOCX, ODT, EPUB, Markdown, LaTeX, etc.)
• E-books (EPUB, MOBI, AZW3, PDF, etc.)
• Videos and Audio (MP4, MKV, AVI, MP3, WAV, etc.)
• 3D Assets (OBJ, FBX, GLTF, etc.)

The user-friendly interface, as shown in the project's screenshot, simplifies the conversion process, allowing you to upload files, select target formats, and initiate conversions with ease.

Why Use

Choosing ConvertX offers several compelling advantages for anyone needing a reliable file conversion solution:

• Self-Hosted Control: Maintain full control over your data and conversions by hosting the service on your own infrastructure, ensuring privacy and security.
• Unparalleled Format Support: With over 1000 supported formats, ConvertX can handle almost any file conversion task you encounter, from common documents to specialized media types.
• Feature-Rich: Benefit from features like processing multiple files simultaneously, password protection for sensitive conversions, and support for multiple user accounts, making it suitable for teams.
• Modern and Maintainable: Built with TypeScript, Bun, and Elysia, ConvertX is a modern application that is actively developed and easy to maintain.

Links

Explore ConvertX further through these official links:

• GitHub Repository
• Docker Hub
• GitHub Container Registry