Settings - BuxarTranslate Documentation

File: settings.html
Purpose: Description of all settings and extension configuration

🎛️ Available Settings

translateTo (Target Translation Language)

Description: Main language to which text will be translated

Default: "en" (English)

Values: Any of 100+ supported languages (en, ru, de, fr, es, it, zh, ja, ko, etc.)

Effect: Determines context menu item language and translation result

autoDetectLanguage (Auto Language Detection)

Description: Automatic detection of source text language

Default: true

Values: true / false

Effect: When enabled, automatically detects source text language

windowDisplayTime (Window Display Time)

Description: Time in seconds until automatic translation window closure

Default: 30

Range: 5 - 300 seconds

Effect: Determines how long translation window remains open

userLang (Interface Language)

Description: Extension interface language

Default: "auto" (system language)

Values: "auto", "en", "ru", "de", "es", "it", "fr"

Effect: Determines language of all labels and extension interface

🔧 Configuration via Popup

1. Open settings popup

Click BuxarTranslate icon in Thunderbird top right corner

2. Select target language

Use dropdown or search to select translation language

                    // Language selection example
                    - Open "🎯 Target Language" dropdown
                    - Enter language name in search or select from list
                    - Use quick languages for frequent options
                

3. Configure display time

Set comfortable automatic translation window close time

                    // Recommended values:
                    - 10-15 seconds: for quick viewing
                    - 30 seconds: standard usage  
                    - 60+ seconds: for working with long texts
                

4. Select interface language

Set preferred language for extension interface

5. Save settings

Click "💾 Save Settings" button to apply changes

⚡ Quick Languages

Quick languages system allows instant switching between most frequently used languages:

Automatic Updates

System automatically adds used languages to quick access panel

Limit of 5 Languages

Panel displays up to 5 most frequently used languages

Instant Switching

Click on quick language button immediately applies it as target

Visual Indicator

Currently selected language is highlighted in quick languages panel

💾 Settings Storage

All settings are stored in browser local storage using WebExtension API:

// Settings storage structure
{
  "translateTo": "en",
  "autoDetectLanguage": true,
  "windowDisplayTime": 30,
  "userLang": "auto",
  "recentLanguages": ["en", "ru", "es", "fr", "de"],
  "lastTranslation": {
    "original": "Привет мир",
    "translated": "Hello world", 
    "sourceLang": "ru",
    "targetLang": "en",
    "timestamp": 1700000000000,
    "translator": "google"
  }
}
            

🔄 Reset Settings

To reset settings to default values:

Open Developer Tools (F12)
Go to "Storage" or "Application" tab
Find BuxarTranslate extension storage
Delete all keys or reinstall extension

← Back: Usage Next: Technical Details →

⚙️ BuxarTranslate Settings