📖 Overview

MuXolotl-Converter is a modern, blazing-fast desktop application for converting audio and video files. Built with Tauri, Svelte 5, and Rust, it leverages FFmpeg for professional-grade media processing while providing a beautiful, intuitive interface with GPU acceleration support.

Status: 🚧 Active development | Production testing in progress

Why MuXolotl-Converter?

• 🚀 Hardware Acceleration - NVIDIA NVENC, Intel QSV, AMD AMF, Apple VideoToolbox
• 🎯 40+ Formats - Comprehensive audio and video format support
• ⚡ Parallel Processing - Convert up to 4 files simultaneously
• 💾 Queue Persistence - Resume your work after closing the app
• 🎨 Modern UI - Sleek glass-morphism design with smooth transitions
• 🔧 Advanced Controls - Fine-tune bitrate, resolution, FPS, sample rate, channels
• 📊 Real-time Progress - Live FPS, speed, and ETA tracking
• 🔔 Desktop Notifications - Get notified when conversions complete
• 🎛️ Batch Operations - Apply settings to all files, clear completed, cancel all, clear All

📸 Screenshots

🖼️ Screenshots will be added soon

✨ Features

Core Functionality

User Experience

• Drag & Drop - Intuitive file dropping from file explorer
• Compact View - Toggle between detailed and compact queue views
• Live Progress - Real-time FPS, speed, ETA, and completion percentage
• Batch Actions - Apply settings to all files, clear completed conversions
• Desktop Notifications - System notifications for completed/failed conversions
• Session Persistence - Queue and output folder saved automatically (auto-save every 2s)

Advanced Settings

• Audio: Sample rate (8-96 kHz), channels (mono/stereo/surround), bitrate
• Video: Resolution (480p-4K), frame rate (24-60 FPS), quality presets
• Audio Extraction - Extract audio from video files with one click
• Custom Quality - Low, Medium, High, Ultra, or Custom bitrate settings

🎵 Supported Formats

Audio Formats (20+)

Video Formats (20+)

Legend:

• ✅ Stable - Fully supported, production-ready
• ⚠️ Setup Required - May need additional libraries or specific FFmpeg builds
• 🔧 Experimental - Limited testing, use with caution
• ⛔ Problematic - Known issues, legacy support only

💻 System Requirements

Minimum Requirements

Recommended for GPU Acceleration

Platform-Specific Notes

• Windows: Tested on Windows 10 (Build 19045+)
• macOS: Built for macOS 10.15+ (Catalina and newer)
• Linux: Tested on Ubuntu 20.04+, Debian 11+, Arch Linux

📥 Installation

Option 1: Download Pre-built Binaries (Recommended)

🚧 Coming Soon - Pre-built releases will be available at:

Releases Page

Available Installers:

• Windows: .msi (installer) / .exe (portable)
• macOS: .dmg (Intel x64) / .dmg (Apple Silicon ARM64)
• Linux: .AppImage / .deb / .rpm

Option 2: Build from Source

See Building from Source section below.

🚀 Usage

Quick Start

1. Launch the application
2. Select output folder (optional but recommended for batch processing)
3. Add files:
   • Drag & drop media files into the drop zone
   • Click "Browse Files" to select manually
4. Choose output format for each file
5. Adjust quality settings (Low/Medium/High/Ultra/Custom)
6. Click "Convert All" to start processing

Advanced Usage

Audio Extraction from Video

1. Add a video file to the queue
2. Check "Video → Audio" checkbox
3. Select desired audio format (MP3, FLAC, AAC, etc.)
4. Click "Convert All"

Batch Operations

• Apply to All - Copy format and settings from first file to all pending files
• Clear Completed - Remove successfully converted files from queue
• Cancel All - Stop all active conversions
• Clear All - Remove all files from queue

Advanced Settings

Click the ⚙️ Settings icon next to quality dropdown to access:

Audio:

• Sample Rate: 8 kHz - 96 kHz
• Channels: Mono, Stereo, 5.1, 7.1 Surround
• Custom Bitrate: 64-320 kbps (for lossy formats)

Video:

• Resolution: 480p, 720p, 1080p, 4K, or keep original
• Frame Rate: 24, 30, 60 FPS, or keep original

Queue Persistence

• Queue auto-saves every 2 seconds
• Files in queue persist when you close and reopen the app
• Files older than 7 days are automatically cleared
• Processing files reset to "pending" on app restart

🎮 GPU Acceleration

Automatic Detection

MuXolotl-Converter automatically detects and uses available GPU encoders:

Supported GPU Codecs

NVIDIA NVENC:

• H.264 (h264_nvenc)
• HEVC/H.265 (hevc_nvenc)
• VP9 (vp9_nvenc) - RTX 30xx+

Intel Quick Sync:

• H.264 (h264_qsv)
• HEVC/H.265 (hevc_qsv)
• VP9 (vp9_qsv) - 11th gen+

AMD AMF:

• H.264 (h264_amf)
• HEVC/H.265 (hevc_amf)

Apple VideoToolbox:

• H.264 (h264_videotoolbox)
• HEVC/H.265 (hevc_videotoolbox)

Fallback Behavior

If GPU encoding is unavailable:

• Software encoders are used automatically (libx264, libx265, libvpx)
• Conversion continues without hardware acceleration
• CPU-only mode indicator shown in UI

🔧 Configuration

Output Path Behavior

• No output folder selected: Dialog opens for each file
• Output folder selected: Files saved automatically as {filename}.{format}
• Output folder preference persists between sessions

Parallel Conversion

Toggle "Parallel conversion" to process up to 4 files simultaneously:

• ✅ Enabled: Faster batch processing, higher CPU/GPU usage
• ❌ Disabled: Sequential processing, lower resource usage

Desktop Notifications

The app requests notification permissions on first launch to notify you about:

• ✅ Individual file completion
• ❌ Conversion failures
• 🎉 Queue completion summary

⚠️ Known Limitations

🛠️ Building from Source

Prerequisites

Required:

• Node.js v18+ and npm
• Rust v1.70+ (install via rustup)
• Tauri Prerequisites (platform-specific)

FFmpeg Binaries:

Download and place FFmpeg binaries in src-tauri/binaries/:

Windows:

# Download from https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-win64-gpl.zip
# Extract ffmpeg.exe and ffprobe.exe
# Rename to:
# - ffmpeg-x86_64-pc-windows-msvc.exe
# - ffprobe-x86_64-pc-windows-msvc.exe

Linux:

# Download from https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz
# Extract ffmpeg and ffprobe
# Rename to:
# - ffmpeg-x86_64-unknown-linux-gnu
# - ffprobe-x86_64-unknown-linux-gnu
# Make executable: chmod +x ffmpeg* ffprobe*

macOS (Intel x64):

# Download from:
# - https://evermeet.cx/ffmpeg/getrelease/ffmpeg/zip
# - https://evermeet.cx/ffmpeg/getrelease/ffprobe/zip
# Rename to:
# - ffmpeg-x86_64-apple-darwin
# - ffprobe-x86_64-apple-darwin
# Make executable: chmod +x ffmpeg* ffprobe*

macOS (Apple Silicon ARM64):

# Download from:
# - https://evermeet.cx/ffmpeg/getrelease/ffmpeg/zip?arch=arm64
# - https://evermeet.cx/ffmpeg/getrelease/ffprobe/zip?arch=arm64
# Rename to:
# - ffmpeg-aarch64-apple-darwin
# - ffprobe-aarch64-apple-darwin
# Make executable: chmod +x ffmpeg* ffprobe*

Build Steps

# 1. Clone repository
git clone https://github.com/MuXolotl/MuXolotl-Converter.git
cd MuXolotl-Converter

# 2. Install dependencies
npm install

# 3. Development mode
npm run dev

# 4. Build for production
npm run build

# 5. Build Tauri app
npm run tauri build

Development Commands

npm run dev        # Start Vite dev server + Tauri dev window
npm run build      # Build frontend for production
npm run preview    # Preview production build
npm run check      # Run svelte-check (type checking)
npm run tauri      # Run Tauri CLI commands
npm run analyze    # Analyze bundle size

Build Artifacts

After npm run tauri build, installers will be in:

src-tauri/target/release/bundle/
├── msi/           # Windows installer
├── nsis/          # Windows NSIS installer
├── deb/           # Debian package
├── rpm/           # RPM package
├── appimage/      # Linux AppImage
└── dmg/           # macOS disk image

🗺️ Roadmap

Planned Features:

It's empty here for now.

Suggestions? Open an issue or submit a PR!

🤝 Contributing

Contributions are welcome and appreciated! Whether it's bug reports, feature requests, documentation improvements, or code contributions.

How to Contribute

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Contribution Guidelines

• Follow existing code style (TypeScript/Rust)
• Add comments for complex logic
• Test your changes on at least one platform
• Update documentation if needed
• Keep commits atomic and descriptive

Reporting Bugs

Please include:

• OS version and build number
• Steps to reproduce
• Expected vs actual behavior
• Screenshots/logs if applicable
• GPU model (if GPU-related issue)

Feature Requests

Open an issue with:

• Clear description of the feature
• Use cases and benefits
• Possible implementation approach (optional)

📄 License

This project is dual-licensed:

• GNU General Public License v2.0 - Full copyleft license
• GNU Lesser General Public License v2.1 - Library-friendly license

You may choose either license for your use case.

Third-Party Licenses

• FFmpeg - GPL v2 / LGPL v2.1
• Tauri - MIT / Apache 2.0
• Svelte - MIT

🙏 Acknowledgments

Built With

• Tauri - Lightweight desktop framework
• Svelte 5 - UI framework with runes
• TypeScript - Type-safe JavaScript
• Rust - Systems programming language
• FFmpeg - Multimedia processing engine
• Vite - Frontend build tool
• Tailwind CSS - Utility-first CSS framework
• Lucide Icons - Icon library

FFmpeg Builds

• Windows: BtbN/FFmpeg-Builds
• Linux: John Van Sickle's FFmpeg Builds
• macOS: evermeet.cx FFmpeg

📞 Support

• Issues: GitHub Issues
• Mail: muxolotl@gmail.com