Update README.md

README.md

@@ -4,50 +4,87 @@ emoji: 🎵
 colorFrom: blue
 colorTo: purple
 sdk: gradio
-sdk_version: 6.0.2
+sdk_version: 6.1.0
 app_file: app.py
 pinned: false
 ---
 
-# 🎵 Audio Forensic Analyzer
+# 🎧 Audio Forensic Analyzer  
+A complete forensic-grade audio analysis tool running entirely in HuggingFace Spaces.  
+Uploads any audio file and generates a **detailed PNG report + Markdown summary**.
 
-Comprehensive audio quality analysis tool with automatic detection of compression, filtering, clipping, and spectral anomalies.
+---
+
+## 🚀 Features
+
+### 🔍 Forensic Analysis
+- Full spectrogram visualization  
+- Peak, RMS, Crest Factor  
+- Noise floor & SNR  
+- Zero-Crossing Rate  
+- Loudness (LUFS, ITU BS.1770)  
+
+### 🎚 Spectral Analysis
+- 4096-point STFT  
+- Energy distribution across speech bands  
+- 85% and 95% rolloff  
+- Highest usable frequency (–60 dB)  
+- Spectral centroid, bandwidth, flatness  
+
+### 🧪 Artifact Detection
+Detects:
+- Low-pass filters (LPF)  
+- High-pass filters (HPF)  
+- Brick-wall filtering  
+- Compression / Over-compression  
+- Noise reduction artifacts  
+- Spectral notches  
+- Clipping  
+- De-esser behavior  
+- Multiband compression  
+
+### 🤖 Synthetic Voice Probability (Informational Only)
+A lightweight heuristic AI-vs-Human estimator using:
+- MFCC stability  
+- Pitch jitter  
+- HF spectral smoothness  
+
+Does **NOT** affect scoring.  
+Displayed in the PNG report as a separate block.
 
-## Features
+---
+
+## 📊 Output
 
-✅ **Comprehensive Analysis**
-- Time-domain statistics (peak, RMS, crest factor, SNR)
-- Spectral analysis (centroid, bandwidth, rolloff)
-- Energy distribution across frequency bands
-- Integrated loudness (LUFS) measurement
+The tool generates:
 
-✅ **Automatic Detection**
-- Digital clipping
-- Over-compression and limiting
-- High-pass/Low-pass filtering
-- Brick-wall filters
-- Spectral notches
+### 1. **PNG Forensic Report**
+Includes:
+- Spectrogram  
+- File metadata  
+- Time-domain metrics  
+- Spectral details  
+- Energy distribution chart  
+- Issue list  
+- Quality score, grade, and recommendation  
+- Synthetic voice probability block  
 
-✅ **Professional Reports**
-- High-quality PNG report with spectrogram
-- Energy distribution charts
-- Quality scoring (A-F grades)
-- Saved as `{filename}_report.png` in `reports/` folder
+### 2. **Markdown Summary**
+Clean, readable, fully formatted analysis results.
+
+---
 
-## How to Use
+## 📁 Usage
 
-1. Upload an audio file (WAV, MP3, FLAC, OGG, M4A, AAC)
-2. Click "Analyze Audio" or wait for auto-analysis
-3. View the comprehensive report and download it
+1. Upload any audio file (WAV, MP3, FLAC, AAC, OGG, M4A).  
+2. Click **Analyze Audio**.  
+3. View the PNG report and the summary.  
+
+Works fully offline inside the Space — no external API calls.
+
+---
 
-## Report Contents
+## 🛠 Project Structure
 
-- **Spectrogram:** Visual frequency representation
-- **File Info:** Sample rate, channels, duration
-- **Time-Domain:** Peak/RMS levels, crest factor, SNR
-- **Spectral Stats:** Frequency distribution and rolloffs
-- **Energy Chart:** Bar chart of frequency bands
-- **Issues:** Automatic problem detection with severity levels
-- **Quality Score:** Overall grade (A-F) and score (0-100)
+All files live in the root directory (HF Spaces-friendly):
 
-Reports are automatically saved in the `reports/` folder with your original filename + `_report.png` suffix.