Ilyas-oufqir/darija-translator-extension

# How to Run the Darija Translator Extension Since this is a Chrome Extension, it cannot be "executed" like a normal program. You need to load it into your browser. ## Prerequisites - Google Chrome or a Chromium-based browser (Edge, Brave). - The Backend Service (`darija-translator-service`) must be running on `localhost`. ## Installation Steps (Load Unpacked) 1. Open your browser connection and navigate to `chrome://extensions`. 2. Enable **Developer mode** (toggle in the top right corner). 3. Click the **Load unpacked** button (top left). 4. Select the directory: `c:\Users\youss\Desktop\darija-translator-extension` ## Usage 1. Go to any website (e.g., Wikipedia). 2. Select some text you want to translate. 3. Click the **Darija Translator** icon in your extension toolbar. - If you don't see it, click the "Puzzle" piece icon and pin the extension. 4. The extension popup will open. 5. Click **Traduire** (Translate). 6. The translation should appear in the popup or a side panel. ## Troubleshooting - **Error: "Failed to fetch" (Erreur de connexion)**: Ensure your backend service is running on port 8080. - Test locally: `Test-NetConnection -ComputerName localhost -Port 8080` - **Microphone Error ("Permission denied")**: - Right-click the extension icon > **Options**. - Click **Verify / Authorize** to grant permission in a new tab. ## Features - **Text Translation**: English to Moroccan Darija. - **Audio Output (TTS)**: Listen to the translation (Generated using Arabic voice). - **Voice Input (STT)**: Dictate your English text directly. - **Context Menu**: Right-click on any text -> "Traduire en Darija". - **Floating Icon**: Select text on any page and click the floating icon to translate quickly.