diff --git a/README.md b/README.md
index 4d11aa0..4c9c76e 100644
--- a/README.md
+++ b/README.md
@@ -1,304 +1,196 @@
-# Uncensored AI Studio
+# 🎙️ Speech Transcriber
- Uno studio AI locale premium, senza configurazione, e una GUI offline per Stable Diffusion (generazione immagini), LLM (chat), Whisper (speech-to-text) e Kokoro (text-to-speech). Alimentato da esecuzione accelerata via GPU e NPU su Windows, Linux e macOS.
+ Local AI audio transcription with whisper.cpp — 100% offline, private, and hardware-accelerated.
- 
- 
+
+
+---
+## 📖 Table of Contents
-
-## 📖 Indice
-* [Che cos’è Uncensored AI Studio?](#what-is-uncensored-ai-studio)
-* [Funzionalità principali](#key-features)
-* [Architettura workspace ed engine](#workspace-architecture)
-* [Modelli supportati](#supported-models)
-* [Architettura delle cartelle](#folder-architecture)
-* [Guida introduttiva](#getting-started)
- * [Configurazione Windows](#windows-setup)
- * [Configurazione Linux](#linux-setup)
- * [Configurazione macOS](#macos-setup)
-* [Compatibilità hardware e accelerazione](#hardware-compatibility-acceleration)
-* [Risoluzione problemi e FAQ](#troubleshooting-faq)
-* [Compilazione da sorgente](#building-from-source)
-* [Licenza](#licensing)
+- [What is Speech Transcriber?](#what-is-speech-transcriber)
+- [Features](#features)
+- [Getting Started](#getting-started)
+ - [Windows](#windows)
+ - [Linux](#linux)
+ - [macOS](#macos)
+- [Supported Models](#supported-models)
+- [Architecture](#architecture)
+- [Hardware Acceleration](#hardware-acceleration)
+- [Project Structure](#project-structure)
+- [License](#license)
---
-## 📖 Che cos’è Uncensored AI Studio?
+## What is Speech Transcriber?
-**Uncensored AI Studio** è uno studio AI completamente offline, senza configurazione e autonomo per Windows, Linux e macOS. A differenza dei sistemi AI basati su cloud, funziona interamente sul tuo hardware, senza censura, tracciamento, abbonamenti o requisiti di login.
+**Speech Transcriber** is a fully offline, private audio transcription application powered by [whisper.cpp](https://github.com/ggerganov/whisper.cpp). It runs entirely on your local hardware — no internet, no API keys, no tracking, no subscriptions.
-Unifica quattro grandi funzionalità AI locali in un’unica interfaccia desktop ad alte prestazioni:
-1. **🎨 Generazione immagini (Stable Diffusion):** genera e modifica immagini di alta qualità offline usando pesi modello `.safetensors`, `.gguf` o `.ckpt`.
-2. **💬 Chat testuale (LLM):** conversa in privato con modelli linguistici open-source (formato GGUF) alimentati dai backend ufficiali e ad alte prestazioni `llama.cpp`.
-3. **🎙️ Speech-to-Text (Whisper):** trascrive registrazioni vocali e parlato in testo in tempo reale con un motore `whisper.cpp` integrato.
-4. **🗣️ Text-to-Speech (Kokoro TTS):** converte output testuali in audio vocale altamente naturale e realistico offline usando il modello ONNX `Kokoro-82M`.
+Record audio directly from your microphone or upload audio files in common formats, then transcribe them to text using state-of-the-art Whisper models with optional GPU acceleration.
---
-## 🌟 Funzionalità principali
+## ✨ Features
-* **100% offline e privato:** esegue le inferenze localmente. Non richiede internet, telemetria, logging cloud o chiavi API.
-* **Portabilità senza installazione:** l’intero runtime (Node.js, modelli, backend GPU) è autonomo. Nessuna modifica globale all’ambiente di sistema.
-* **Accelerazione autoconfigurata:** rileva automaticamente le specifiche hardware per caricare backend CUDA (Nvidia), ROCm (AMD), Vulkan (Intel/AMD/NVIDIA), Metal (macOS) o OpenVINO (Intel NPU).
-* **Gestore modelli integrato:** incolla URL Hugging Face per scaricare direttamente i pesi, oppure trascina e rilascia pesi locali per importarli.
-* **Monitor prestazioni live:** monitora l’utilizzo di CPU, RAM, GPU e VRAM in tempo reale direttamente nella web UI.
-* **Galleria output locale:** salva le immagini generate affiancate ai parametri del prompt e ai file JSON dei metadati.
+### Transcription
+- **Microphone recording** — capture audio directly in the browser
+- **File upload** — supports WAV, MP3, M4A, OGG, FLAC, WebM, AAC, M4B, OPUS, WMA
+- **Multi-language support** — auto-detect or specify from 10 languages (English, Spanish, French, German, Italian, Portuguese, Hindi, Japanese, Korean, Chinese)
+- **Timestamps** — optionally display segment timestamps in transcripts
+- **Translation** — translate foreign language speech to English during transcription
+
+### Export
+- **TXT** — clean text file
+- **JSON** — structured data with segments and metadata
+- **Markdown** — formatted transcript with optional timestamps
+
+### Model Management
+- **One-click download** — fetch Whisper models directly from Hugging Face
+- **Local import** — drag-and-drop `.bin` model files
+- **Model catalog** — curated selection of Tiny, Base, and Small models (English-only and Multilingual)
+
+### Hardware Acceleration
+- **Auto-detection** — automatically uses GPU when available, falls back to CPU
+- **Vulkan** — cross-platform GPU acceleration (NVIDIA, AMD, Intel)
+- **CUDA** — NVIDIA GPU acceleration
+- **Metal** — Apple Silicon / Intel Mac GPU acceleration
+- **CPU fallback** — works on any hardware
+
+### Interface
+- **8 color themes** — Light Default, Nord Light, Sakura Blossom, Dark Default, Dracula, Cyberpunk, Emerald Forest, OLED Black
+- **Dark / Light mode** — system preference detection with manual override
+- **Real-time telemetry** — CPU, RAM, and GPU usage monitoring
+- **Hardware tier detection** — automatic system classification (High-End / Balanced / Potato)
---
-## ⚙️ Architettura workspace ed engine
-
-Per evitare di esaurire la RAM o la VRAM di sistema, i motori testuali e quelli per immagini sono mutuamente esclusivi per impostazione predefinita. Puoi passare da un workspace all’altro dentro la UI:
-
-* **Workspace generazione immagini:** usa un nodo backend dedicato `stable-diffusion.cpp`. I pesi dei modelli sono archiviati in `app/models/`.
-* **Workspace chat testuale:** usa un backend server portatile `llama.cpp`. I pesi dei modelli (.gguf) sono archiviati in `app/llm-models/`. Un piccolo modello iniziale Qwen2.5 Coder può essere scaricato direttamente dal pannello Text Chat.
-* **Worker vocale (Whisper):** esegue un processo localizzato `whisper-cli` per convertire il tuo input vocale in testo.
-* **Output audio (Kokoro TTS):** utilizza `kokoro-js` localmente lato server per leggere le risposte con voci naturali.
-
----
-
-## Modelli supportati
-
-L’app è progettata intorno a modelli locali a file singolo che possono essere caricati direttamente dai motori backend inclusi.
-
-### Generazione immagini
-
-| Tipo di modello | Supportato | Inserire i file in | Note |
-| :--- | :--- | :--- | :--- |
-| Checkpoint Stable Diffusion 1.5 | Sì | `app/models/` | Migliore compatibilità. Usa file `.safetensors` o `.ckpt`. |
-| Checkpoint SDXL | Sì | `app/models/` | Supportati come checkpoint a file singolo. Richiedono più RAM/VRAM rispetto a SD 1.5. |
-| Checkpoint SD/SDXL GGUF a file singolo | Limitato | `app/models/` | Sono supportati solo checkpoint completi a file singolo. |
-| Cartelle modelli immagine OpenVINO | Solo Intel NPU | `app/openvino-models/` | Scarica dal Model Manager dopo aver eseguito la configurazione OpenVINO. |
-| Modelli immagine CoreML | Solo Apple Silicon | `app/models/` | Richiede macOS su Apple Silicon e il percorso di configurazione CoreML. |
-| Workflow Flux, HiDream, Hunyuan, Wan, Qwen Image, Z-Image | No | N/A | Di solito richiedono file separati per diffusion, VAE e text encoder e non sono caricamenti one-click di checkpoint in questa app. |
-| File LoRA, ControlNet, solo VAE, solo text encoder o solo diffusion | No | N/A | I file companion non vengono caricati come modelli immagine autonomi. |
-
-Modelli immagine noti e funzionanti disponibili dal Model Manager:
-
-| Nome | Nome file | Tipo | Dimensione approx. | Uso consigliato |
-| :--- | :--- | :--- | :--- | :--- |
-| Juggernaut XL v9 Lightning | `Juggernaut_RunDiffusionPhoto2_Lightning_4Steps.safetensors` | SDXL | 6,6 GB | Fotorealismo di alta qualità su macchine di fascia media/alta. |
-| DreamShaper XL Lightning | `DreamShaperXL_Lightning.safetensors` | SDXL | 6,6 GB | Immagini SDXL generiche, fantasy, render e illustrazione. |
-| DreamShaper 8 | `DreamShaper_8_pruned.safetensors` | SD 1.5 | 2,1 GB | Generazione immagini più veloce e con meno memoria. |
-| CyberRealistic V8 | `CyberRealistic_V8_FP16.safetensors` | SD 1.5 | 2,0 GB | Immagini realistiche SD 1.5 e sistemi con meno memoria. |
-| Rev Animated | `rev-animated-v1-2-2.safetensors` | SD 1.5 | 2,0 GB | Immagini stilizzate/anime SD 1.5. |
-| LCM DreamShaper OpenVINO | `OpenVINO/LCM_Dreamshaper_v7-fp16-ov` | OpenVINO | 2,7 GB | Modello di test Intel Core Ultra NPU. |
-
-### Testo, voce e TTS
-
-| Workspace | File modello supportati | Inserire i file in | Note |
-| :--- | :--- | :--- | :--- |
-| Chat testuale | Modelli `.gguf` llama.cpp | `app/llm-models/` | Usa modelli chat/instruct GGUF a file singolo. I modelli vision possono richiedere anche un file `mmproj` corrispondente. |
-| Speech-to-Text | Modelli whisper.cpp `.bin` | `app/speech-models/` | Usa file modello Whisper GGML/whisper.cpp. |
-| Text-to-Speech | Manifest `.json` Kokoro e asset modello | `app/tts-models/` / `app/tts-runtime/` | Usa la configurazione Kokoro integrata e le voci del Model Manager. |
-
-> [!NOTE]
-> I binari della release Linux sono compilati per sistemi dell’era Ubuntu 24.04 e richiedono `glibc 2.38+` più `GLIBCXX_3.4.32+`. Su VM Ubuntu/Debian più vecchie, un modello come CyberRealistic può essere valido, ma il backend può comunque fallire prima di caricarlo. Aggiorna il sistema operativo della VM oppure compila il backend da sorgente.
-
----
-
-## 📁 Architettura delle cartelle
-
-```
-Uncensored-AI-Studio/
-├── windows.bat # Launcher Windows (punto di ingresso con doppio clic)
-├── linux.sh # Launcher Linux (punto di ingresso da terminale)
-├── mac.sh # Launcher macOS (punto di ingresso da terminale)
-├── LICENSE # Licenza open source MIT
-├── .gitignore # Esclude modelli e immagini di output dal controllo versione
-├── README.md # Documentazione dettagliata del sistema
-├── scripts/
-│ ├── setup/ # Configurazione piattaforma e installer backend
-│ ├── reset/ # Installazione pulita e riparazione ambiente
-│ ├── server/ # Web server UI e gestore ciclo di vita backend
-│ ├── workers/ # Processi worker locali
-│ ├── build/ # Helper opzionali per build da sorgente
-│ └── config/ # Cataloghi configurazione runtime
-└── app/
- ├── frontend/ # Codice sorgente UI (Vite + React)
- ├── models/ # Inserisci qui i pesi immagine (.safetensors, .gguf, .ckpt)
- ├── llm-models/ # Inserisci qui i pesi testuali GGUF
- └── outputs/ # Immagini salvate e metadati parametri
-```
-
----
-
-## 🚀 Guida introduttiva
-
-Assicurati di avere installato un browser web moderno. Segui la guida rapida qui sotto per la tua piattaforma:
-
-### Configurazione Windows
-
-1. **Avvio:** fai doppio clic su **`windows.bat`**.
- > [!NOTE]
- > Al primo avvio, lo script scaricherà automaticamente un runtime Node.js portatile e configurerà binari backend GPU/CPU precompilati.
-2. **Aggiungi modelli:** trascina file `.safetensors`, `.gguf` o `.ckpt` dentro `app/models/` oppure scaricali tramite la scheda **Model Manager** nella UI.
-3. **Genera:** apri `http://localhost:1420` nel browser, seleziona il modello e scrivi un prompt.
-
-### Configurazione Linux
-
-1. **Rendi eseguibile:** apri un terminale nella cartella del progetto e rendi eseguibile lo script:
- ```bash
- chmod +x linux.sh
- ```
-2. **Avvio:** esegui **`./linux.sh`**.
- - **Utenti GPU NVIDIA:** ti verrà chiesto di configurare il backend **CUDA** ad alte prestazioni (scarica precompilato o compila automaticamente da sorgente come fallback).
- - **Prestazioni AMD Radeon:** esegui con **`./linux.sh --max-perf`** per aggiungere il backend ROCm (~1,3 GB di download).
- - **Intel Core Ultra NPU:** esegui con **`./linux.sh --setup-openvino`** per configurare il supporto Intel NPU (richiede driver Intel Linux NPU).
-3. **Aggiungi modelli:** trascina i pesi dentro `app/models/` oppure scaricali tramite la scheda **Model Manager**.
-4. **Genera:** apri `http://localhost:1420` nel browser.
-
-### Configurazione macOS
-
-1. **Rendi eseguibile:** apri un terminale nella cartella del progetto e rendi eseguibile lo script:
- ```bash
- chmod +x mac.sh
- ```
-2. **Avvio:** esegui **`./mac.sh`**.
- > [!IMPORTANT]
- > Il backend macOS precompilato è ottimizzato per **Apple Silicon (M1 o più recente)** e usa accelerazione GPU **Metal**. *(L’hardware macOS Intel non è supportato in alcun modo)*.
-3. **Aggiungi modelli:** trascina i pesi dentro `app/models/` oppure scaricali tramite la scheda **Model Manager**.
-4. **Genera:** apri `http://localhost:1420` nel browser.
-
----
-
-## 🖥️ Compatibilità hardware e accelerazione
+## 🚀 Getting Started
### Windows
-| Produttore GPU | Tecnologia | Stato | Note |
-| :--- | :--- | :--- | :--- |
-| **Nvidia** | CUDA | ✅ Nativo | Mappa `sd-cuda.exe` con ottimizzazioni Nvidia SDK 12. |
-| **AMD Radeon** | Vulkan | ✅ Nativo | Mappa `sd-vulkan.exe` con accelerazione API Vulkan. |
-| **Intel Arc** | Vulkan | ✅ Nativo | Mappa `sd-vulkan.exe` per hardware Intel. |
-| **Integrata / Nessuna** | CPU | ⚠️ Fallback | Esegue sui thread logici della CPU (lento). |
+Double-click **`windows.bat`** or run from terminal:
+
+```bash
+windows.bat
+```
+
+On first run, the app will automatically set up the portable Node.js runtime and whisper.cpp backend. After setup, it opens `http://localhost:1420` in your browser.
### Linux
-| Produttore GPU | Primario | Fallback | Note |
-| :--- | :--- | :--- | :--- |
-| **NVIDIA** | CUDA / Vulkan | Vulkan / CPU | Rileva automaticamente NVIDIA. La configurazione CUDA guidata scarica il precompilato o compila da sorgente. Ripiega su Vulkan per GTX. |
-| **AMD Radeon** | ROCm | Vulkan | ROCm fornisce le migliori prestazioni AMD quando sono disponibili i driver ROCm dell’host. |
-| **Intel Arc / integrata** | Vulkan | CPU | Supporto Vulkan cross-vendor. |
-| **Intel Core Ultra NPU** | OpenVINO NPU | CPU | Richiede driver Intel Linux NPU, kernel 6.6+, Python 3 e `./linux.sh --setup-openvino`. |
-| **Integrata / Nessuna** | CPU | — | Esegue sui thread logici della CPU (lento). |
+Run **`linux.sh`**:
+
+```bash
+./linux.sh
+```
+
+Optional flags:
+- `--max-perf` — enable additional backend downloads for maximum performance
+- `--setup-openvino` — configure Intel NPU acceleration
### macOS
-| Hardware | Primario | Fallback | Note |
-| :--- | :--- | :--- | :--- |
-| **Apple Silicon (M1 o più recente)** | Metal | CPU | Usa il backend ufficiale Darwin arm64 stable-diffusion.cpp. |
-
-> [!IMPORTANT]
-> **Requisiti di sistema e note:**
-> - È richiesto **Windows 10 o Windows 11 a 64 bit** per il runtime Node.js 22 portatile usato dal launcher Windows.
-> - È richiesto **glibc 2.38 o più recente** per i backend Linux precompilati (Ubuntu 24.04, Fedora 40+, ecc.). Lo script di configurazione ti avviserà se la tua glibc è più vecchia.
-> - **Linux OpenVINO NPU:** sono richiesti Intel Core Ultra, Linux x86_64, kernel 6.6+, un dispositivo `/dev/accel/accel0` funzionante, Python 3 con `venv` e il driver Intel Linux NPU.
-
----
-
-## 🛠️ Risoluzione problemi e FAQ
-
-
- Reset ambiente: se una build fallisce o vuoi cancellare le dipendenze
- Esegui scripts/reset/reset.ps1 (Windows) oppure scripts/reset/reset.sh (Linux/macOS). Questo cancellerà cache temporanee di compilazione e pacchetti per riparare il tuo ambiente. (Nota: conserva i pesi dei modelli e le immagini generate).
-
-
-
- I backend Linux non si avviano con GLIBC_2.38 not found
- I binari precompilati richiedono glibc 2.38+ (es. Ubuntu 24.04). Se la tua distribuzione usa una versione più vecchia di glibc, puoi aggiornare il sistema operativo oppure compilare il backend da sorgente (vedi la guida Compilazione da sorgente qui sotto).
-
-
-
- Conflitti porta: indirizzo porta predefinito già occupato
- L’interfaccia web utente funziona sulla porta 1420 per impostazione predefinita. Il gestore backend GPU prova prima ad agganciarsi alla porta 8080, poi rileva automaticamente e passa a una porta libera se 8080 è già occupata.
-
-
-
- Linux ROCm non si carica per GPU AMD Radeon
- Assicurati che l’hardware della tua GPU AMD e il kernel host siano pienamente compatibili con ROCm 7.13. Se ROCm non riesce a inizializzarsi correttamente, l’applicazione passerà automaticamente all’accelerazione Vulkan.
-
-
-
- Linux usa la GPU integrata invece della GPU dedicata
- Su sistemi Linux dual-GPU, l’ordine dei dispositivi Vulkan può mettere la GPU Intel integrata su vulkan0 e la GPU AMD/NVIDIA dedicata su vulkan1. Il launcher ora prova a preferire un dispositivo Vulkan dedicato quando vulkaninfo --summary è disponibile. Per forzare manualmente un dispositivo, avvia l’app con SD_VULKAN_DEVICE=vulkan1 ./linux.sh oppure usa un altro indice come vulkan0/vulkan2.
-
-
-
- Windows esce con codice 3221225781 (0xC0000135)
- Questo codice significa che Windows non è riuscito a trovare una DLL backend richiesta:
-
- - Per AMD/Intel Vulkan: aggiorna il driver GPU a una versione con supporto completo al runtime Vulkan, poi riesegui lo script di configurazione per ripristinare
app/backend/win/vulkan/.
- - Per NVIDIA CUDA: installa o aggiorna il driver grafico NVIDIA, poi riesegui lo script di configurazione per ripristinare le DLL runtime CUDA.
-
-
-
-
- La generazione mostra "server is not responding or crashed"
- Questo indica che il processo del motore backend locale è terminato. Controlla il terminale di avvio (quello in cui hai eseguito windows.bat, ./linux.sh o ./mac.sh) per l’errore console esatto. Le cause comuni includono incompatibilità della versione glibc, driver Vulkan mancanti o problemi di memoria insufficiente del sistema (OOM).
-
-
----
-
-## 🔨 Compilazione da sorgente
-
-Lo script di configurazione (`scripts/setup/setup.sh`) ora automatizza la compilazione e la configurazione del backend CUDA da sorgente quando selezionato. Se vuoi compilare manualmente tutti i backend (CPU, Vulkan e CUDA) in una volta sola, puoi eseguire lo script incluso `scripts/build/build_from_source.sh`.
-
-Per macOS, lo script incluso `scripts/build/build_from_source.sh` compila il backend Metal e lo copia in `app/backend/mac/sd`.
-
-### Requisiti
-- `git`, `cmake`, `make` (o `ninja`) e un compilatore C++17 (`g++` / `clang++`).
-- Per **CUDA**: il toolkit NVIDIA CUDA (`nvcc`) deve essere nel tuo `PATH`.
-- Per **Vulkan**: Vulkan SDK / loader e un driver compatibile.
-- Per **ROCm**: librerie di sviluppo AMD ROCm.
-- Per **macOS Metal**: Apple Command Line Tools o Xcode.
-
-### Comandi di build
+Run **`mac.sh`**:
```bash
-# 1. Clona upstream
-git clone https://github.com/leejet/stable-diffusion.cpp.git
-cd stable-diffusion.cpp
-mkdir build && cd build
-
-# 2. Configura per il tuo backend (scegline UNO)
-# Solo CPU
-cmake .. -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
-
-# CUDA
-cmake .. -DSD_CUDA=ON -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
-
-# Vulkan
-cmake .. -DSD_VULKAN=ON -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
-
-# ROCm
-cmake .. -DSD_HIPBLAS=ON -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
-
-# macOS Metal
-cmake .. -DSD_METAL=ON -DSD_BUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release
-
-# 3. Compila
-cmake --build . --config Release -j$(getconf _NPROCESSORS_ONLN 2>/dev/null || sysctl -n hw.ncpu)
-
-# 4. Copia i binari in questo progetto
-cp bin/sd* /path/to/Uncensored-AI-Studio/app/backend/linux//
+./mac.sh
```
-Dopo la copia, rinomina il binario server per farlo corrispondere a ciò che `scripts/server/serve.cjs` si aspetta:
-- Vulkan: `sd` → `sd-vulkan`
-- ROCm: `sd` → `sd-rocm`
-
-Poi riavvia l’app con `./linux.sh` (Linux) o `./mac.sh` (macOS).
-
---
-## 📝 Licenza
+## 🤖 Supported Models
-Questo progetto è distribuito con licenza MIT - consulta il file [LICENSE](LICENSE). Include [stable-diffusion.cpp](https://github.com/leejet/stable-diffusion.cpp) (licenza MIT). I pesi dei modelli sono soggetti alle licenze dei rispettivi creatori.
+| Model | Size | Language | Quality |
+|-------|------|----------|---------|
+| Whisper Tiny English | 75 MB | English only | Fastest |
+| Whisper Tiny English Q5 | 31 MB | English only | Fast, quantized |
+| Whisper Base English | 142 MB | English only | Balanced |
+| Whisper Base English Q5 | 57 MB | English only | Balanced, quantized |
+| Whisper Small English | 466 MB | English only | High quality |
+| Whisper Tiny Multilingual | 75 MB | All supported | Fastest, multi-lang |
+| Whisper Base Multilingual | 142 MB | All supported | Balanced, multi-lang |
+| Whisper Base Multilingual Q5 | 57 MB | All supported | Balanced, quantized |
+| Whisper Small Multilingual | 466 MB | All supported | High quality, multi-lang |
+
+> **Recommendation:** Start with **Base English Q5** (57 MB) for a good speed/quality tradeoff on English audio. Use **Base Multilingual** for non-English content.
+
+---
+
+## 🏗️ Architecture
+
+```
+whisper/
+├── app/
+│ ├── frontend/ # React + Vite source
+│ │ ├── src/
+│ │ │ ├── components/ # SpeechTranscriber, ModelManager, Settings
+│ │ │ ├── services/api.js # Backend API client
+│ │ │ ├── themes.js # Color theme definitions
+│ │ │ ├── App.jsx # Main app shell
+│ │ │ └── App.css # Material Design 3 styling
+│ │ └── dist/ # Built frontend (served by Node)
+│ ├── speech-models/ # Downloaded Whisper models (.bin)
+│ ├── transcriptions/ # Saved transcription results
+│ └── speech-backend/ # whisper.cpp binaries per platform
+├── scripts/
+│ ├── server/serve.cjs # Node.js server + process manager
+│ ├── setup/ # Platform-specific setup scripts
+│ └── workers/ # Background workers
+├── linux.sh # Linux launcher
+├── mac.sh # macOS launcher
+└── windows.bat # Windows launcher
+```
+
+**Flow:**
+1. User records/uploads audio in the browser (React frontend)
+2. Audio is resampled to 16 kHz mono PCM16 WAV in-browser
+3. Audio is sent to the Node.js server via REST API
+4. Server spawns `whisper-cli` with the selected model and parameters
+5. Transcription result is returned and displayed in the UI
+
+---
+
+## ⚡ Hardware Acceleration
+
+The server automatically detects your hardware and selects the best available backend:
+
+| Priority | Backend | Platform | Requirements |
+|----------|---------|----------|--------------|
+| 1 | **Vulkan** | Windows, Linux | Vulkan-capable GPU (NVIDIA, AMD, Intel) |
+| 2 | **CUDA** | Windows, Linux | NVIDIA GPU with CUDA support |
+| 3 | **Metal** | macOS | Apple Silicon or Intel Mac |
+| 4 | **CPU** | All | Works everywhere |
+
+You can override the backend selection in **Settings → Speech Transcription → Default Backend**.
+
+---
+
+## 📁 Project Structure
+
+- **`app/frontend/`** — React + Vite single-page application
+- **`scripts/server/serve.cjs`** — HTTP server + whisper.cpp process manager
+- **`scripts/setup/`** — Automated setup and repair scripts
+- **`linux.sh` / `mac.sh` / `windows.bat`** — One-click platform launchers
+- **`app/speech-models/`** — Whisper model storage directory
+- **`app/transcriptions/`** — Transcription history and saved results
+
+---
+
+## 📜 License
+
+MIT License — see [LICENSE](./LICENSE) for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- [whisper.cpp](https://github.com/ggerganov/whisper.cpp) — The core transcription engine
+- [OpenAI Whisper](https://github.com/openai/whisper) — The original model architecture
+- [Material Design 3](https://m3.material.io/) — Design system reference
+- [Lucide Icons](https://lucide.dev/) — Beautiful icon set