README.md

---
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.

![Gradio](https://img.shields.io/badge/Gradio-6.3.0-orange)
![Python](https://img.shields.io/badge/Python-3.9+-blue)
![License](https://img.shields.io/badge/License-MIT-green)
![FFmpeg](https://img.shields.io/badge/FFmpeg-Required-important)

## 🌐 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:

```mermaid
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]