UniversalConverter X

A powerful, native Windows file conversion application with context menu integration, supporting 1000+ format conversions.

Features

• 🖱️ Right-Click Context Menu - Convert files directly from Windows Explorer
• 📁 1000+ Formats - Video, audio, images, documents, e-books, 3D models, and more
• 🔒 Local Processing - All conversions happen on your machine
• 📊 Progress Tracking - Real-time progress with speed and ETA
• ⚡ Batch Conversion - Convert multiple files at once
• 🎨 Modern UI - WinUI 3 with dark theme and Mica effects
• 💻 CLI Support - Full command-line interface for automation

Supported Converters

Installation

Requirements

• Windows 10 21H2+ or Windows 11
• .NET 8 Runtime
• One or more converter tools (FFmpeg, ImageMagick, etc.)

Quick Start

1. Download the latest release
2. Run the installer
3. Install converter tools (or use ucx tools download)
4. Start converting!

CLI Usage

# Convert a single file
ucx convert video.mp4 -o mp3

# Convert multiple files
ucx convert *.png -o webp -q high

# List supported formats
ucx list formats

# Check installed tools
ucx tools check

# Show file info
ucx info document.pdf

Commands

Convert Options

-o, --output <FORMAT>     Output format (required)
-d, --directory <PATH>    Output directory
-q, --quality <LEVEL>     Quality: lowest, low, medium, high, highest, lossless
-f, --force               Overwrite existing files
-p, --parallel <COUNT>    Maximum parallel conversions
--converter <ID>          Force a specific converter
--hw-accel                Enable hardware acceleration

Project Structure

UniversalConverterX/
├── src/
│   ├── UniversalConverterX.Core/          # Core conversion engine
│   │   ├── Interfaces/                    # Core interfaces
│   │   ├── Models/                        # Data models
│   │   ├── Converters/                    # 13 strategy implementations
│   │   ├── Services/                      # Orchestrator, ToolManager, ToolDownloader
│   │   ├── Configuration/                 # Options
│   │   └── Detection/                     # Magic bytes format detection
│   ├── UniversalConverterX.Console/       # CLI application
│   │   └── Commands/                      # CLI commands
│   ├── UniversalConverterX.UI/            # WinUI 3 application
│   │   ├── Views/                         # XAML views
│   │   ├── ViewModels/                    # MVVM ViewModels
│   │   └── Services/                      # UI services
│   └── UniversalConverterX.ShellExtension/ # Windows Explorer integration
├── tests/
│   └── UniversalConverterX.Core.Tests/    # Unit tests
├── installer/
│   ├── msix/                              # MSIX package manifest
│   └── wix/                               # WiX MSI installer
└── tools/
    └── bin/                               # CLI tool binaries

Building from Source

Prerequisites

• .NET 8 SDK
• Windows 10 SDK (for UI project)
• Visual Studio 2022 (recommended)

Build

# Restore packages
dotnet restore

# Build all projects
dotnet build

# Build release
dotnet build -c Release

# Run tests
dotnet test

Publish

# Publish CLI
dotnet publish src/UniversalConverterX.Console -c Release -o publish/cli

# Publish UI (self-contained)
dotnet publish src/UniversalConverterX.UI -c Release -r win-x64 --self-contained -o publish/ui

Architecture

Strategy Pattern

Each converter tool implements IConverterStrategy:

public interface IConverterStrategy
{
    string Id { get; }
    string Name { get; }
    int Priority { get; }
    bool CanConvert(FileFormat source, FileFormat target);
    Task<ConversionResult> ConvertAsync(ConversionJob job, ...);
}

Orchestrator

The ConversionOrchestrator routes conversions to the best available strategy:

1. Detects input format (magic bytes + extension)
2. Finds converters supporting the conversion
3. Selects highest priority converter
4. Executes conversion with progress tracking

Configuration

Configuration is stored in %APPDATA%\UniversalConverterX\config.json:

{
  "ToolsBasePath": "C:\\Tools\\UniversalConverterX",
  "MaxConcurrentConversions": 4,
  "EnableHardwareAcceleration": true,
  "PreserveMetadata": true,
  "DefaultQuality": "High"
}

Installing Converter Tools

Windows (winget)

winget install Gyan.FFmpeg
winget install ImageMagick.ImageMagick
winget install JohnMacFarlane.Pandoc
winget install calibre.calibre
winget install TheDocumentFoundation.LibreOffice

Windows (Chocolatey)

choco install ffmpeg imagemagick pandoc calibre libreoffice

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

Acknowledgments

• FFmpeg - Video/audio processing
• ImageMagick - Image processing
• Pandoc - Document conversion
• Calibre - E-book conversion
• LibreOffice - Office documents
• Inkscape - Vector graphics
• Ghostscript - PDF processing
• libvips - High-performance image processing
• libheif - HEIC/HEIF support
• libjxl - JPEG XL support
• resvg - SVG rendering
• Potrace - Raster to vector tracing
• Assimp - 3D model import