Quill

Translate, create, and manage with ease.

A modern full-stack workspace for language translation, voice translation, document processing, PDF utilities, file conversion, productivity tools, and activity history — all inside one clean interface.

---

✨ Why Quill?

Quill is designed as a single productivity workspace instead of a collection of disconnected utilities.

It brings together:

• 🌍 Text and voice translation
• 🎙️ Speech-to-text and speech-to-speech translation
• 📄 Multi-page document translation
• 🧩 PDF, image, Word, and Excel utilities
• 🛠️ Everyday calculation and conversion tools
• 🕘 Account-synced activity history
• ⭐ Favorites and saved translations
• 🔔 Notifications
• ⚙️ Detailed application settings
• 🔐 Authentication and account management
• 📥 Export and download workflows

---

🚀 Live Demo

🌐 Quill is Live

https://quill-one-sandy.vercel.app/

No installation is required.
Open the link in a modern browser and start using Quill.

---

🌟 Core Features

Workspace	Features
🌍 Translate	Text translation, voice translation, auto-detection, translation preferences
🎙️ Voice	Speech-to-text, text-to-speech, speech-to-speech
📄 Documents	Multi-page upload, translation, preview and download
🧩 Combine	PDF, image, Word and Excel file operations
🛠️ Tools	Number, currency, unit, data, electrical, health and specific tools
🕘 History	Search, filters, preview, delete, export and account sync
⭐ Favorites	Save, remove and organize important translations
🔔 Notifications	In-app, email and push notification workflows
⚙️ Settings	General, appearance, translation, notifications, privacy, storage and account
🔐 Authentication	JWT, email, Google OAuth and GitHub OAuth

---

🌍 Translation Workspace

Quill provides a unified translation interface for text and speech.

Supported Translation Modes

Mode	Description
Text → Text	Translate written text into another language
Text → Speech	Translate text and generate spoken audio
Speech → Text	Record speech and convert it into text
Speech → Speech	Record speech, translate it, and generate translated audio

Translation Capabilities

• 🌐 25 supported languages
• 🔎 Automatic source-language detection
• 🔄 Source/target language swapping
• ⚡ Automatic translation while typing
• 🕘 Translation history
• 📝 Formatting preservation
• 🎨 Translation style controls
• 🗣️ Formality controls
• 🚀 Translation speed settings
• 📋 Copy translated text
• 📥 Import .txt, .md, and .csv
• 🎤 Voice recording directly from the browser
• 🔊 Audio playback for generated speech
• ⚙️ Engine selection
• 🔁 Fallback translation services
• 🌏 Localized handling of remaining Latin terms for non-Latin languages
• ⭐ Save translations to favorites

Supported Languages

Quill supports the following language workflows:

English, Hindi, Spanish, French, German, Italian, Portuguese, Russian, Japanese, Korean, Chinese, Arabic, Turkish, Dutch, Polish, Swedish, Indonesian, Vietnamese, Ukrainian, Marathi, Tamil, Telugu, Malayalam, Bengali, and Gujarati.

---

🎙️ Voice Translation

Quill includes a complete browser-to-backend speech pipeline.

Speech Workflow

🎤 Microphone
      ↓
🌐 Browser MediaRecorder
      ↓
📤 Uploaded Audio
      ↓
⚙️ FFmpeg / FFprobe
      ↓
🎵 Normalized WAV
      ↓
🧠 Speech Recognition
      ↓
🌍 Translation Engine
      ↓
🔊 Edge TTS / gTTS
      ↓
✅ Translated Audio

Voice features

• 🎤 Browser microphone recording
• 🎵 WebM / OGG / MP4 audio support
• ⚙️ FFmpeg-based audio conversion
• 🎚️ 16 kHz mono WAV normalization
• 🧠 Speech recognition
• 🌐 Automatic language recognition
• 🗣️ Neural voice generation
• 🔄 gTTS fallback
• 🔊 Audio playback
• 🕘 Speech-to-speech history entries

---

🛠️ Smart Tools

Quill also provides a separate workspace for everyday calculation and conversion utilities.

Tool categories

• 🔢 Number • 💱 Currency • 📏 Unit • 🗃️ Data • ⚡ Electrical • ❤️ Health • 🧮 Specific

Examples

The Smart Tools interface supports workflows such as:

• 🔢 Number-base conversion
• 💱 Currency conversion
• 📏 Unit conversion
• 🗃️ Data conversion
• ⚡ Electrical calculations
• ❤️ Health-related calculators
• 🧮 Specific utility calculators

The tool workspace is designed for fast calculations without sending basic values to unnecessary external services.

---

📄 Documents

• 📤 Upload documents and files
• 📑 Multi-page document preview
• 👁️ View original page
• 🌍 View translated page
• 🔎 Auto-detect source language
• 🎯 Select target language
• 📄 Page-by-page translation
• 📊 Progress tracking
• 🕘 Translation history
• 🧠 Layout-aware processing workflow
• 📝 Formatting preservation
• 🔐 Secure download workflow
• 📥 Export formats such as PDF, DOCX, TXT, and HTML

The interface is designed to preserve the layout, borders, and alignment of processed documents wherever supported by the workflow.

---

🧩 Combine & Convert

The Combine & Convert workspace contains document, image, and file transformation tools in one place.

📑 PDF Tools

• 📚 PDF Merge
• ✂️ PDF Split
• ⚡ PDF Compress
• 🔄 Rotate PDF
• 🗂️ Organize PDF
• 💧 Watermark PDF
• 🎨 PDF Color Enhance
• 🔢 N-up PDF

🖼️ Image Tools

• 🖼️ Image Merge
• 📄 Image to PDF
• 🔄 Image Converter
• 🧩 N-up PDF / image-sheet workflows

📦 Supported Image Formats

JPG
JPEG
PNG
WEBP
GIF
BMP
TIFF
ICO
SVG

📘 Document Tools

• 📄 Word Merge
• 🔄 PDF to Word
• 📘 Word to PDF
• 📊 PDF to Excel
• 📈 Excel to PDF

---

🕘 History & Activity Timeline

Quill keeps account-level activity in a dedicated history workspace.

📌 History Features

• 🕘 Activity timeline
• 🌍 Translation history
• 🛠️ Tool activity
• 📄 Document activity
• 🧩 Combine activity
• 🏷️ Category filtering
• 🔎 Search history
• 📄 Export history as PDF
• 🗑️ Delete individual activity
• 🧹 Delete all history
• 🔐 Synced history for authenticated users

📋 Example Activity Types

• 🎙️ Speech to Speech
• 🔢 Number Converter
• 🔄 Rotate PDF
• 🌍 Text Translation
• 📄 Document Translation
• 🧩 Combine / Convert

---

⚙️ Settings

Quill includes a detailed Settings Center for controlling and personalizing the application.

⚙️ General

• 🌍 Default source language
• 🎯 Default target language
• 🔄 Auto swap languages
• ⚡ Auto translate
• 📝 Preserve formatting
• 🕘 Save translation history
• 🎨 Translation style
• 🗣️ Formality level
• 🚀 Translation speed

🎨 Appearance

• ☀️ Light appearance
• 🌙 Dark appearance
• ✨ UI personalization
• 🎨 Theme preferences

🌍 Translation

• 🌐 Default language preferences
• ⚙️ Translation behavior
• 🔌 Engine configuration
• 🎙️ Speech options

🔔 Notifications

• 🔵 In-app notifications
• 📧 Email notification preferences
• ✅ Translation completion notifications
• 📲 Push notification preferences

🔐 Privacy & Security

• 🛡️ Account-aware security controls
• 📦 Data handling preferences
• 🔒 Privacy-oriented configuration

💾 Data & Storage

• ⚡ Cache settings
• 🕘 History storage
• 📤 Export preferences
• 💾 Local application data controls

👤 Account

• 👤 Profile information
• 💳 Plan information
• 📊 Billing / activity-related settings

🧑‍💻 Advanced

• 🧑‍💻 Developer-oriented configuration
• ⚙️ Advanced application behavior
• 🔧 Runtime and integration settings

---

🔐 Authentication & Accounts

Quill is designed as a secure, account-based application.

🔑 Authentication Stack

• 🔐 JWT authentication
• 🎫 Access and refresh tokens
• 👤 Django authentication
• 📧 Email-based account flows
• 🔵 Google OAuth
• 🐙 GitHub OAuth
• 🔢 OTP / email verification workflows
• 🕘 Account-specific history
• ⭐ Account-specific favorites
• 🛡️ Protected API endpoints

---

⭐ Favorites

Users can save important translations for quick access later.

📌 Favorites Support

• ⭐ Save translation
• ❌ Remove favorite
• 🕘 Favorite history item
• 📁 Favorite folders
• 👤 User-specific favorite records
• 💾 Persistent favorite data

---

🔔 Notifications

Quill supports multiple notification channels for keeping users informed about important application activity.

🔵 In-App Notifications

• ✅ Translation completion
• 🎙️ Speech translation completion
• 📄 Document translation completion
• 🕘 History-related events

📧 Email Notifications

The backend supports SMTP-based email delivery for:

• 🔐 Account workflows
• 🔢 OTP verification
• ✅ Translation completion
• 📩 Application notifications

📲 Push Notifications

The application can support browser push notifications through VAPID-based subscriptions.

---

🏗️ Architecture

Quill follows a frontend + API backend architecture.

                         ┌─────────────────────────┐
                         │       QUILL FRONTEND    │
                         │                         │
                         │   React + TypeScript    │
                         │      Tailwind CSS       │
                         └────────────┬────────────┘
                                      │
                                      │ REST / JSON
                                      ▼
                         ┌─────────────────────────┐
                         │      DJANGO BACKEND     │
                         │                         │
                         │   Django REST Framework │
                         │    JWT Authentication   │
                         └────────────┬────────────┘
                                      │
                         ┌────────────┴────────────┐
                         │                         │
                         ▼                         ▼
                ┌──────────────────┐      ┌──────────────────┐
                │    PostgreSQL    │      │ External Services│
                │     Database     │      │                  │
                │                  │      │ Translation      │
                └──────────────────┘      │ Speech / Email   │
                                          │ OAuth / APIs     │
                                          └──────────────────┘

💻 Technology Stack

Quill is built using a modern full-stack technology ecosystem combining a responsive React frontend, Django REST backend, database services, speech processing, document processing, and multiple external integrations.

---

🎨 Frontend

Frontend Technologies

• ⚛️ React 19 — Component-based UI development
• 🔷 TypeScript — Strongly typed frontend development
• 🎨 Tailwind CSS — Utility-first responsive styling
• 🧭 React Router — Application routing and navigation
• 🌐 Axios — API communication
• ⚡ React Query — Server-state and API data management
• 🗃️ Zustand — Lightweight client-side state management
• 🎯 Lucide React — Modern application icons
• 🧩 Heroicons — Additional interface icons
• 📄 jsPDF — PDF generation and export
• 📘 Mammoth — DOCX document processing
• 📑 PDF.js — PDF rendering and processing
• 🔥 Firebase — Authentication/integration workflows where required

---

⚙️ Backend

Backend Technologies

• 🐍 Python — Core backend language
• 🌿 Django — Web application framework
• 🔗 Django REST Framework — RESTful API development
• 🔐 Simple JWT — Token-based authentication
• 👤 Django Allauth — Authentication and OAuth workflows
• 🐘 PostgreSQL — Persistent relational database
• ⚡ Celery — Background task processing
• 🗄️ Django Celery Results — Task result management
• 🎬 FFmpeg — Audio/video conversion and normalization
• 🔎 FFprobe — Media inspection and metadata handling
• 🎵 PyDub — Audio manipulation and processing
• 🎙️ SpeechRecognition — Speech-to-text processing
• 🔊 gTTS — Text-to-speech fallback
• 🗣️ Edge TTS — Neural text-to-speech generation
• 🌍 Deep Translator — Translation service integration

---

🔌 External Integrations

Integration Services

• 🔵 Google OAuth — Account authentication
• 🐙 GitHub OAuth — Social authentication
• 📧 Brevo SMTP — Email and OTP delivery
• 🌍 Google Translation Services — Translation provider
• 🔤 MyMemory — Translation fallback
• 🌐 Lingva — Translation fallback
• 🔄 LibreTranslate — Translation fallback
• 🟦 Microsoft Translator — Optional translation provider
• 🔷 DeepL — Optional translation provider
• 🤖 Grok / xAI — Optional AI integration

---

🧱 Technology Overview

┌──────────────────────────────────────────────────────────┐
│                       QUILL                              │
├──────────────────────────────────────────────────────────┤
│                                                          │
│  🎨 Frontend                                            │
│  React • TypeScript • Tailwind CSS • React Query         │
│  Zustand • Axios • PDF.js • Mammoth • jsPDF              │
│                                                          │
│                         ↓                                │
│                                                          │
│  ⚙️ Backend                                              │
│  Python • Django • DRF • Simple JWT • Allauth            │
│                                                          │
│                         ↓                                │
│                                                          │
│  🗄️ Data & Processing                                   │
│  PostgreSQL • Celery • FFmpeg • FFprobe • PyDub          │
│                                                          │
│                         ↓                                │
│                                                          │
│  🔌 External Services                                   │
│  OAuth • Translation APIs • SMTP • Speech Services       │
│                                                          │
└──────────────────────────────────────────────────────────┘

---

📁 Project Structure

Quill/
│
├── frontend/
│   ├── public/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── hooks/
│   │   ├── services/
│   │   ├── store/
│   │   └── ...
│   │
│   ├── package.json
│   ├── package-lock.json
│   └── ...
│
├── backend/
│   ├── quill/
│   ├── users/
│   ├── translation/
│   ├── documents/
│   ├── combine/
│   ├── tools/
│   ├── history/
│   ├── about/
│   ├── settings_app/
│   ├── manage.py
│   └── ...
│
├── assets/
│   └── quill_logo.png
│
├── .gitignore
└── README.md

---

⚡ Local Development

Follow the steps below to run Quill locally.

1. Clone the Repository

git clone https://github.com/Aarush005coder/Quill.git
cd Quill

---

2. Frontend Setup

Open a terminal and navigate to the frontend:

cd frontend

Install the required dependencies:

npm install

Start the development server:

npm start

The frontend will be available at:

http://localhost:3000

Production Build

To create an optimized production build:

npm run build

---

3. Backend Setup

Open a second terminal and navigate to the backend:

cd backend

Create a Python virtual environment:

python -m venv venv

Windows

Activate the virtual environment:

venv\Scripts\activate

Install Dependencies

pip install -r requirements.txt

Run Database Migrations

python manage.py makemigrations
python manage.py migrate

Create Admin User

python manage.py createsuperuser

Start Django Server

python manage.py runserver

The backend API will be available at:

http://127.0.0.1:8000

---

🔄 Local Development Flow

                    👤 Developer
                         │
              ┌──────────┴──────────┐
              │                     │
              ▼                     ▼
      🎨 Frontend Terminal    ⚙️ Backend Terminal
              │                     │
              ▼                     ▼
        npm install             venv
              │                     │
              ▼                     ▼
          npm start          pip install -r
                                    │
                                    ▼
                           python manage.py migrate
                                    │
                                    ▼
                           python manage.py runserver

---

🌐 Local URLs

Service	URL
🎨 Frontend	http://localhost:3000
⚙️ Backend API	http://127.0.0.1:8000
🔧 Django Admin	http://127.0.0.1:8000/admin/

---

🔑 Environment Variables

Quill uses environment variables to keep sensitive configuration and service credentials outside the source code.

⚠️ Never commit production secrets to GitHub.

---

🎨 Frontend Environment

Create a file named:

frontend/.env

Local Development

REACT_APP_API_URL=http://127.0.0.1:8000/api

Production

For the deployed application, use the Render backend:

REACT_APP_API_URL=https://quill-a52m.onrender.com/api

🚫 Do not use localhost or 127.0.0.1 in production.

---

⚙️ Backend Environment

Create a file named:

backend/.env

Example configuration:

# ─── Django ──────────────────────────────────────────────
SECRET_KEY=your-secret-key
DEBUG=True

ALLOWED_HOSTS=localhost,127.0.0.1

# ─── Application URLs ───────────────────────────────────
BACKEND_URL=http://127.0.0.1:8000
FRONTEND_URL=http://localhost:3000

# ─── PostgreSQL ──────────────────────────────────────────
DB_NAME=quill
DB_USER=postgres
DB_PASSWORD=your-db-password
DB_HOST=localhost
DB_PORT=5432

# ─── Google OAuth ────────────────────────────────────────
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# ─── GitHub OAuth ────────────────────────────────────────
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=

# ─── Brevo SMTP ──────────────────────────────────────────
BREVO_SMTP_HOST=smtp-relay.brevo.com
BREVO_SMTP_PORT=587
BREVO_SMTP_USE_TLS=True
BREVO_SMTP_LOGIN=
BREVO_SMTP_KEY=

DEFAULT_FROM_EMAIL=Quill <your-email@example.com>

# ─── AI / Translation Services ──────────────────────────
GROK_API_KEY=
DEEPL_API_KEY=

MICROSOFT_TRANSLATOR_KEY=
MICROSOFT_TRANSLATOR_REGION=eastus

🔐 Production Environment

Production credentials should be configured through the hosting platform's Environment Variables section instead of being committed to GitHub.

---

🗄️ Database

Quill uses PostgreSQL for persistent application data.

Make sure PostgreSQL is running before starting the Django backend.

Create Migrations

python manage.py makemigrations

Apply Migrations

python manage.py migrate

Create Admin Account

python manage.py createsuperuser

---

🎙️ FFmpeg Setup

Voice translation and audio processing require:

• 🎬 FFmpeg
• 🔎 FFprobe

Verify Installation

Run:

ffmpeg -version

and:

ffprobe -version

The backend also supports explicit FFmpeg path configuration and automatic detection of common Windows installation layouts.

Audio Processing Pipeline

🎤 Browser Audio
      ↓
📤 Uploaded Audio
      ↓
⚙️ FFmpeg
      ↓
🔎 FFprobe
      ↓
🎵 Normalized WAV
      ↓
🧠 Speech Recognition
      ↓
🌍 Translation
      ↓
🔊 TTS

---

🌐 Deployment

Quill uses a separated frontend and backend deployment architecture.

🎨 Frontend — Vercel

The React frontend is deployed on Vercel.

Current Frontend

https://quill-one-sandy.vercel.app/

Typical Vercel Configuration

Setting	Value
Framework	Create React App
Root Directory	frontend
Build Command	npm run build
Output Directory	build
Install Command	npm install

Production Environment Variable

REACT_APP_API_URL=https://quill-a52m.onrender.com/api

🚫 Do not use http://127.0.0.1:8000/api in production.

---

⚙️ Backend — Render

The Django backend is deployed on Render.

Current Backend

https://quill-a52m.onrender.com/

API Base URL

https://quill-a52m.onrender.com/api

The production backend requires:

• 🐘 PostgreSQL
• 🔐 Environment variables
• 📁 Persistent media/storage strategy
• 🎬 FFmpeg where required
• 🌐 HTTPS
• 🔒 CORS configuration
• 📦 Static file handling
• ⚙️ Production WSGI/ASGI configuration

---

📊 Current Production Architecture

                         👤 User
                            │
                            ▼
              ┌────────────────────────────┐
              │          Vercel            │
              │      React Frontend        │
              │                            │
              │ quill-one-sandy.vercel.app │
              └────────────┬───────────────┘
                           │
                           │ REST / JSON
                           ▼
              ┌────────────────────────────┐
              │          Render            │
              │      Django Backend        │
              │                            │
              │   quill-a52m.onrender.com  │
              └────────────┬───────────────┘
                           │
                           ▼
              ┌────────────────────────────┐
              │        PostgreSQL          │
              │        Data Layer          │
              └────────────────────────────┘

---

📍 Production URLs

Service	URL
🌐 Live Frontend	https://quill-one-sandy.vercel.app/
⚙️ Backend	https://quill-a52m.onrender.com/
🔗 API Base URL	https://quill-a52m.onrender.com/api
💻 GitHub Repository	https://github.com/Aarush005coder/Quill

---

📊 Project Highlights

Feature	Status
🌍 Text Translation	✅
🎙️ Speech to Text	✅
🗣️ Speech to Speech	✅
🔊 Text to Speech	✅
🔎 Auto Language Detection	✅
🌐 25 Languages	✅
🕘 Translation History	✅
⭐ Favorites	✅
📄 Document Translation	✅
📑 Multi-page Documents	✅
📚 PDF Merge	✅
✂️ PDF Split	✅
⚡ PDF Compress	✅
🔄 Rotate PDF	✅
🗂️ Organize PDF	✅
💧 Watermark PDF	✅
🎨 PDF Color Enhance	✅
🔢 N-up PDF	✅
🖼️ Image Merge	✅
📄 Image to PDF	✅
🔄 Image Converter	✅
📘 Word Merge	✅
🔄 PDF to Word	✅
📄 Word to PDF	✅
📊 PDF to Excel	✅
📈 Excel to PDF	✅
🔢 Number Tools	✅
💱 Currency Tools	✅
📏 Unit Tools	✅
🗃️ Data Tools	✅
⚡ Electrical Tools	✅
❤️ Health Tools	✅
🧮 Specific Tools	✅
🔔 In-App Notifications	✅
📧 Email Notifications	✅
📲 Push Notifications	✅
🔵 Google OAuth	✅
🐙 GitHub OAuth	✅
🔐 JWT Authentication	✅
🐘 PostgreSQL	✅
⚛️ React Frontend	✅
🌿 Django REST API	✅
▲ Vercel Deployment	✅
🚀 Render Deployment	✅

---

🎨 UI Philosophy

Quill follows a modern workspace-oriented design system focused on clarity, consistency, usability, and responsiveness.

Design Principles

• ✨ Clean and minimal interface
• 🌙 Dark / light appearance support
• 🧱 Soft borders
• 🌫️ Subtle shadows
• 🔵 Rounded cards and controls
• 🎨 Blue / cyan / purple accent system
• 📱 Responsive layouts
• 👁️ Clear visual hierarchy
• 🧩 Dedicated workspaces
• ⚡ Fast and focused interactions
• 🎯 Consistent iconography
• ♿ Accessible controls
• 🧹 Minimal visual clutter

The goal is to make Quill feel like a professional SaaS productivity platform, rather than a collection of disconnected utilities.

---

🧭 Main Workspaces

┌────────────────────── QUILL ──────────────────────┐
│                                                   │
│  🏠 Overview                                      │
│  🌍 Translate                                     │
│  🛠️ Tools                                         │
│  📄 Documents                                     │
│  🧩 Combine                                       │
│  🕘 History                                       │
│  ℹ️ About                                         │
│  ⚙️ Settings                                      │
│                                                   │
└───────────────────────────────────────────────────┘

---

🔄 Typical User Workflows

🌍 Text Translation

🌍 Choose Source Language
        ↓
🎯 Choose Target Language
        ↓
📝 Enter Text
        ↓
⚡ Translate
        ↓
👁️ Review Result
        ↓
📋 Copy / 🔊 Listen / ⭐ Save

🎙️ Voice Translation

🎤 Record Voice
      ↓
📤 Upload Audio
      ↓
⚙️ Convert Audio
      ↓
🧠 Speech Recognition
      ↓
🌍 Translate
      ↓
🔊 Generate Speech
      ↓
▶️ Play Audio

📄 Document Translation

📤 Upload Document
      ↓
🔎 Detect / Select Language
      ↓
🎯 Choose Target Language
      ↓
📑 Process Pages
      ↓
🌍 Translate
      ↓
👁️ Review
      ↓
📥 Download

🧩 File Conversion

🛠️ Choose Tool
      ↓
📤 Upload Files
      ↓
⚙️ Configure
      ↓
🚀 Process
      ↓
👁️ Preview
      ↓
📥 Download

---

🧠 Translation Engine Strategy

Quill supports multiple translation services with fallback strategies to improve reliability.

🌍 Requested Translation Engine
            ↓
      Primary Service
            ↓
        If Failed
            ↓
       🔤 MyMemory
            ↓
        If Failed
            ↓
        🌐 Lingva
            ↓
        If Failed
            ↓
     🔄 LibreTranslate
            ↓
        If Failed
            ↓
      🌍 Google

This architecture helps prevent a failure from a single translation provider from breaking the complete translation workflow.

---

🧠 Speech Processing Strategy

Quill normalizes browser-recorded audio before speech recognition.

🎤 Browser Audio
      ↓
⚙️ FFmpeg Decode
      ↓
🎚️ Mono Audio
      ↓
⏱️ 16 kHz Sample Rate
      ↓
🎵 PCM WAV
      ↓
🔇 Silence / Signal Analysis
      ↓
🧠 Speech Recognition

Generated speech follows:

🌍 Translated Text
      ↓
🗣️ Edge TTS
      ↓
If Failed
      ↓
🔊 gTTS Fallback
      ↓
🎵 MP3
      ↓
💾 Stored Media
      ↓
🔗 Audio URL

---

🛡️ Reliability & Error Handling

Quill includes defensive handling for:

• ⚠️ Invalid uploaded files
• 🌍 Unsupported languages
• 🔌 Translation provider failures
• 🎙️ Speech recognition failures
• 🔊 TTS failures
• 🎬 FFmpeg conversion failures
• 🌐 API errors
• 🔐 Authentication failures
• 🗄️ Database/history operations
• 🔔 Notification failures

The goal is to keep the application resilient even when an optional external service becomes unavailable.

---

Availability depends on the specific operation and processing workflow.

---

🤝 Contributing

Contributions are welcome.

1. Create a Feature Branch

git checkout -b feature/your-feature

2. Add Your Changes

git add .

3. Commit Your Changes

git commit -m "Add your feature"

4. Push the Branch

git push origin feature/your-feature

Then open a Pull Request on GitHub.

---

📜 License

Add the license that matches your intended distribution model before publishing the project publicly.

A LICENSE file can be placed in the repository root before publishing the project.

---

👨‍💻 Author

Aarush Khandelwal

AI & Data Science Developer

MBM University, Jodhpur

---

✨ Quill

One place for translation, tools & documents.

Built with React, TypeScript, Tailwind CSS, Django, Python, and PostgreSQL.

⭐ Star the repository if you like the project.

Made with ❤️ by **Aarush Khandelwal**