README.md

metadata

license: mit
title: MP3to16Flac
sdk: gradio
emoji: 😻
colorFrom: indigo
colorTo: green

🎵 MP3 to 16-bit FLAC Converter

A simple and efficient web application that converts MP3 audio files to 16-bit FLAC format. Built with Gradio for an intuitive user interface.

🌐 Live Demo

Try it live on Hugging Face Spaces!

✨ Features

• High-Quality Conversion: Convert MP3 files to 16-bit FLAC format
• Preserves Audio Quality: Maintains original sample rate and channels
• User-Friendly Interface: Clean, intuitive Gradio web interface
• Progress Tracking: Real-time conversion progress indicator
• File Statistics: Display detailed audio file information before conversion
• Fast Processing: Efficient conversion using pydub/FFmpeg backend
• No Registration Required: Completely free, no sign-up needed

🚀 Quick Usage

1. Upload your MP3 file (drag & drop or click to browse)
2. View file statistics (duration, sample rate, channels)
3. Click "Convert to FLAC" button
4. Download your converted FLAC file

Supported Files

• Input: MP3 files (.mp3)
• Output: FLAC files (.flac) at 16-bit depth
• Maximum Size: 200MB per file

🛠️ Technical Details

Audio Specifications

• Input Format: MP3 (any bitrate, 8-320 kbps)
• Output Format: FLAC (16-bit PCM, lossless compression)
• Bit Depth: 16-bit (CD quality)
• Channels: Preserved from source (Mono 1.0 or Stereo 2.0)
• Sample Rate: Preserved from source (commonly 44.1kHz or 48kHz)
• Conversion Type: Format conversion (not quality enhancement)

Technology Stack

• Frontend: Gradio 6.3.0
• Audio Processing: pydub 0.25.1
• Audio Engine: FFmpeg
• Language: Python 3.9+

📖 How It Works

The conversion process follows these steps:

graph LR
    A[Upload MP3] --> B[Read Audio Metadata]
    B --> C[Decode MP3 to PCM]
    C --> D[Convert to 16-bit]
    D --> E[Encode as FLAC]
    E --> F[Generate Download Link]