Skip to content

MNSH-Nexo/NexoraX-Subtitle-Translator

Repository files navigation

NexoraX Studio


English

🌟 NexoraX Studio is a professional tool for translating and editing subtitles using advanced AI models. It supports SRT and ASS formats with a user-friendly interface.

Table of Contents

  • ✨ Features
  • 🚀 Installation
  • 📖 Usage
  • 📄 Supported Formats
  • 🧠 AI Models
  • 🔑 API Key Management
  • 🔒 Security
  • 🤝 Contributing
  • 📜 License
  • 📸 Example Output

✨ Features

  • Supports SRT and ASS subtitle formats.
  • AI-powered translation with Google Gemini, Grok, ChatGPT, and DeepSeek.
  • Customizable translation settings.
  • Real-time subtitle preview with video player.
  • Secure API key management with encryption.
  • Offline editing with limited features.
  • Efficient processing for large files.
  • Search and replace functionality.
  • Modern UI with light/dark mode.

🚀 Installation

  1. Clone the repository:

    git clone https://github.com/MNSH-Nexo/NexoraX-studio
    cd nexorax-studio
  2. Install dependencies:

    npm install
  3. Build the project:

    npm run build
  4. Run the development server:

    npm run dev
  5. Access the app at http://localhost:3000.

📖 Usage

  • Upload an SRT or ASS subtitle file.
  • Select an AI model (e.g., Google Gemini).
  • Enter API keys.
  • Set target language and optional video context.
  • Click "Translate" to process.
  • Edit subtitles with search/replace tools.
  • Preview with a video upload.
  • Download the translated file.

📄 Supported Formats

  • SRT (SubRip)
  • ASS (Advanced SubStation Alpha)

🧠 AI Models

  • Google Gemini: Fast and reliable (Flash, Pro).
  • Grok (xAI): Natural, context-sensitive.
  • ChatGPT (OpenAI): Conversational AI.
  • DeepSeek: Advanced language processing.

🔑 API Key Management

  • Encryption: AES, RSA, HMAC.
  • Multiple Keys: Distribute to bypass rate limits.
  • Status: Track usage (available, in use, cooldown).

🔒 Security

  • Data Encryption: Multi-layer protection.
  • Input Sanitization: Prevents attacks.
  • Secure Storage: Encrypted browser session.

🤝 Contributing

  1. Fork the repository.
  2. Create a feature or bugfix branch.
  3. Submit a pull request with details.

Follow coding standards and include tests.

📜 License

Licensed under the MIT License.

📸 Example Output

Input (SRT):

1
00:00:01,000 --> 00:00:03,000
Hello, welcome to my video!

2
00:00:04,000 --> 00:00:06,000
This is a test subtitle.

Translated Output (SRT, Persian):

1
00:00:01,000 --> 00:00:03,000
سلام، به ویدیوی من خوش آمدید!

2
00:00:04,000 --> 00:00:06,000
این یک زیرنویس آزمایشی است.

فارسی

🌟 این NexoraX Studio ابزاری حرفه‌ای برای ترجمه و ویرایش زیرنویس با استفاده از مدل‌های پیشرفته هوش مصنوعی است. این ابزار از فرمت‌های SRT و ASS پشتیبانی کرده و رابط کاربری ساده‌ای دارد.

فهرست مطالب

  • ✨ ویژگی‌ها
  • 🚀 نصب
  • 📖 استفاده
  • 📄 فرمت‌های پشتیبانی‌شده
  • 🧠 مدل‌های هوش مصنوعی
  • 🔑 مدیریت کلید API
  • 🔒 امنیت
  • 🤝 مشارکت
  • 📜 مجوز
  • 📸 نمونه خروجی

✨ ویژگی‌ها

  • پشتیبانی از فرمت‌های زیرنویس SRT و ASS.
  • ترجمه با هوش مصنوعی (Google Gemini، Grok، ChatGPT، DeepSeek).
  • تنظیمات سفارشی برای ترجمه.
  • پیش‌نمایش زنده زیرنویس با پخش‌کننده ویدیو.
  • مدیریت امن کلیدهای API با رمزنگاری.
  • ویرایش آفلاین با قابلیت‌های محدود.
  • پردازش کارآمد برای فایل‌های بزرگ.
  • ابزار جستجو و جایگزینی.
  • رابط کاربری مدرن با حالت روشن و تاریک.

🚀 نصب

  1. مخزن را کلون کنید:

    git clone https://github.com/MNSH-Nexo/NexoraX-studio
    cd nexorax-studio
  2. وابستگی‌ها را نصب کنید:

    npm install
  3. پروژه را بیلد کنید:

    npm run build
  4. سرور توسعه را اجرا کنید:

    npm run dev
  5. به آدرس http://localhost:3000 در مرورگر بروید.

📖 استفاده

  1. فایل زیرنویس SRT یا ASS را بارگذاری کنید.
  2. مدل هوش مصنوعی (مثلاً Google Gemini) را انتخاب کنید.
  3. کلیدهای API را وارد کنید.
  4. زبان مقصد و زمینه ویدیویی (اختیاری) را تنظیم کنید.
  5. روی «ترجمه» کلیک کنید.
  6. زیرنویس‌ها را با ابزار جستجو/جایگزینی ویرایش کنید.
  7. با بارگذاری ویدیو پیش‌نمایش کنید.
  8. فایل ترجمه‌شده را دانلود کنید.

📄 فرمت‌های پشتیبانی‌شده

  • SRT (SubRip)
  • ASS (Advanced SubStation Alpha)

🧠 مدل‌های هوش مصنوعی

  • گوگل جمینای: سریع و مطمئن (Flash، Pro).
  • گروک (xAI): طبیعی و حساس به زمینه.
  • چت‌جی‌پی‌تی (OpenAI): هوش مصنوعی مکالمه‌ای.
  • دیپ‌سیک: پردازش پیشرفته زبان.

🔑 مدیریت کلید API

  • رمزنگاری: AES، RSA، HMAC.
  • کلیدهای متعدد: توزیع برای دور زدن محدودیت‌ها.
  • وضعیت: پیگیری استفاده (در دسترس، در حال استفاده، خنک شدن).

🔒 امنیت

  • رمزنگاری داده: حفاظت چندلایه.
  • پاک‌سازی ورودی: جلوگیری از حملات.
  • ذخیره‌سازی امن: رمزنگاری‌شده در جلسه مرورگر.

🤝 مشارکت

  1. مخزن را فورک کنید.
  2. شاخه‌ای برای ویژگی یا رفع اشکال بسازید.
  3. درخواست pull با توضیحات ارسال کنید.

به استانداردهای کدنویسی پایبند باشید و تست‌ها را اضافه کنید.

📜 مجوز

تحت مجوز MIT منتشر شده است.

📸 نمونه خروجی

ورودی (SRT):

1
00:00:01,000 --> 00:00:03,000
Hello, welcome to my video!

2
00:00:04,000 --> 00:00:06,000
This is a test subtitle.

خروجی ترجمه‌شده (SRT، فارسی):

1
00:00:01,000 --> 00:00:03,000
سلام، به ویدیوی من خوش آمدید!

2
00:00:04,000 --> 00:00:06,000
این یک زیرنویس آزمایشی است.