Skip to main content

UzDublyaj

Ingliz, rus va koreys tilidagi video darsliklarni o'zbek tiliga o'giruvchi dastur: subtitr va ovozli dublyaj.

YouTube havolasini yoki kompyuterdagi video faylni berasiz, UzDublyaj esa videoni o'zbekcha subtitr bilan yoki o'zbekcha ovoz bilan qaytaradi. Asosan dasturlash va IT darsliklari uchun yaratilgan: kod, buyruqlar va texnik atamalar tarjimada buzilmaydi.

English: UzDublyaj translates English, Russian and Korean video tutorials (YouTube links or local files) into Uzbek — with burned-in subtitles and/or an AI voice-over — using the Google Gemini API.


Imkoniyatlar

  • 🎬 Manba — YouTube havola yoki kompyuterdagi video fayl (mp4, mkv, mov va boshqalar)
  • 🌐 Video tili — ingliz, rus yoki koreys tili; har safar menyuda tanlanadi
  • 📝 Subtitr — o'zbekcha va asl tildagi .srt fayllar, subtitr chizilgan video
  • 🎙️ Dublyaj — o'zbekcha ovoz; asl ovoz fonda past ovozda qoladi
  • 💻 IT atamalari — commit, Docker, router kabi so'zlar va kod asl holida qoladi. Rus va koreys videolarida ham коммит, 파이썬 kabi talaffuzlar commit, Python deb yoziladi
  • 💾 Kesh — har bir bosqich saqlanadi: to'xtab qolsa, tugagan joyidan davom etadi va tayyor qism uchun qayta to'lanmaydi
  • 🚦 Limitlarga moslashish — Google limitlarida kutadi, zaxira modelga o'tadi va holatni bitta qatorda ko'rsatib turadi
  • 💵 Xarajat hisobi — har ish oxirida taxminan qancha sarflanganini ko'rsatadi

Qanday ishlaydi

Video / YouTube havola
   │  yt-dlp, ffmpeg
   ▼
Audio ──► Nutqni matnga aylantirish (gemini-3.5-transcribe, so'z vaqtlari bilan)
   ▼
Gaplarga bo'lish ──► O'zbekchaga tarjima (gemini-3.8-flash)
   │                 ingliz / rus / koreys → o'zbek
   ▼
 ├─► .srt subtitr ──► subtitr chizilgan video
 └─► o'zbekcha ovoz (gemini-3.8-flash-tts) ──► vaqtga moslash ──► dublyaj video

Talablar

  • Windows 10/11, Linux yoki macOS
  • Python 3.10 yoki undan yangi versiya (Windows'da o'rnatishda "Add python.exe to PATH" belgisini qo'ying)
  • Gemini API kaliti — Google AI Studio. Ovoz berish uchun to'lov ulangan (Tier 1 va undan yuqori) loyiha tavsiya etiladi.

ffmpeg alohida o'rnatilmaydi, u kutubxonalar bilan birga avtomatik keladi.

O'rnatish

pip install uzdublyaj

Boshqa Python loyihalaringizga aralashmasligi uchun pipx bilan o'rnatish ham qulay: pipx install uzdublyaj.

API kalit. Birinchi ishga tushirishda dastur kalitni o'zi so'raydi va sozlamalar fayliga saqlaydi. Boshqa yo'llar: GEMINI_API_KEY muhit o'zgaruvchisi yoki joriy papkadagi .env fayli (GEMINI_API_KEY=..., namuna: .env.example).

Windows'da repo orqali (pip'siz):

  1. Loyihani yuklab oling:
    git clone https://github.com/Abror5555/uzdublyaj.git
    cd uzdublyaj
    
  2. setup.bat ni ishga tushiring. U env virtual muhitini yaratadi va dasturni barcha kutubxonalari bilan o'rnatadi.
  3. run.bat ni ishga tushiring. Bu usulda natijalar avvalgidek repo ichidagi output/ papkasiga tushadi.

Ishlatish

uzdublyaj buyrug'ini (yoki Windows'da run.bat ni) ishga tushiring, havola yoki fayl yo'lini kiriting (faylni oynaga sudrab tashlasangiz ham bo'ladi), so'ng video tilini va rejimni tanlang:

Video qaysi tilda?
  1) Ingliz tili
  2) Rus tili
  3) Koreys tili

Terminal orqali:

uzdublyaj "https://www.youtube.com/watch?v=..."
uzdublyaj "https://www.youtube.com/watch?v=..." --lang ru
uzdublyaj "C:\Videos\dars.mp4" --lang ko --mode sub
uzdublyaj havola1 havola2 --mode dub --output D:\Tarjimalar

Repo ichidan ishlatsangiz, uzdublyaj o'rniga python main.py yozasiz.

Til (--lang) Video tili
en ingliz tili (standart)
ru rus tili
ko koreys tili

Standart tilni sozlamalardagi SOURCE_LANGUAGE bilan o'zgartirish mumkin.

Rejim Natija
srt faqat .uz.srt va asl tildagi .en.srt / .ru.srt / .ko.srt fayllar
sub o'zbekcha subtitr chizilgan video
dub o'zbekcha ovozli video (ichida o'chirib-yoqsa bo'ladigan subtitr ham bor)
all ikkala video ham (standart)

Natijalar standart holatda uy papkangizdagi UzDublyaj papkasiga tushadi (Windows'da C:\Users\<ism>\UzDublyaj, repo orqali ishlatilganda — output/). Boshqa papka: --output PAPKA yoki sozlamalardagi OUTPUT_DIR.

  • tayyor videolar — <natijalar>/videos/
  • .srt va oraliq fayllar — <natijalar>/<video nomi>/ (rus va koreys videolari uchun <video nomi>/ru/ va <video nomi>/ko/, shunda tillar keshi aralashmaydi)

Sozlamalar

Sozlamalar config.json faylida saqlanadi. Uning joyini ko'rish (yo'q bo'lsa, namuna bilan yaratish) uchun:

uzdublyaj --config

Windows'da fayl %LOCALAPPDATA%\uzdublyaj\config.json, Linux va macOS'da ~/.config/uzdublyaj/config.json da bo'ladi. Faylga kerakli sozlamalarni yozasiz:

{
  "GEMINI_API_KEY": "AIza...",
  "SOURCE_LANGUAGE": "ru",
  "TTS_VOICE": "Kore",
  "SUBTITLE_MODE": "soft"
}

Eng ko'p ishlatiladigan sozlamalar:

Sozlama Ma'nosi
SOURCE_LANGUAGE standart video tili: "en", "ru" yoki "ko"
TTS_VOICE ovoz: Charon, Kore, Puck, Iapetus, Sadaltager va boshqalar
ORIGINAL_VOLUME asl ovozning fondagi balandligi (0 — butunlay o'chiq)
SUBTITLE_MODE "burn" — videoga chiziladi, "soft" — alohida yo'lak (tezroq)
KEEP_TERMS tarjima qilinmaydigan atamalar ro'yxati
MAX_VIDEO_HEIGHT YouTube'dan yuklanadigan sifat (720 — tezroq)
CHUNK_MINUTES nutqni aniqlashda audio bo'lagi uzunligi, daqiqa
OUTPUT_DIR natijalar papkasi

Barcha sozlamalar va ularning standart qiymatlari: src/uzdublyaj/config.py. Qo'shimcha sozlamalar ham config.json ga yoziladi:

{
  "DUB_BLOCK_SECONDS": 20,
  "TTS_TIMEOUT": 180,
  "FALLBACK_MODELS": {"gemini-3.8-flash": "gemini-3.5-flash",
                      "gemini-3.8-flash-tts": "gemini-3.8-flash-lite-tts"}
}

DUB_BLOCK_SECONDS — nechta soniyalik gaplar bitta ovoz so'roviga yig'iladi (0 — har gap alohida), TTS_TIMEOUT — bitta ovoz so'rovini maksimal kutish (soniya).

Avval kalitni repo ichidagi config.py ga yozgan bo'lsangiz: endi u uzdublyaj --config ko'rsatgan faylga yoki .env ga yoziladi.

Xarajat va limitlar

Taxminiy xarajat (2026-yil narxlari bo'yicha), 10 daqiqalik video uchun:

Narx
Subtitr (nutqni aniqlash + tarjima) ~$0.07
Dublyaj (qo'shimcha) ~$0.15

Google har bir model uchun so'rovlar sonini cheklaydi. Masalan, Tier 1 da ovoz modellari uchun limit daqiqasiga 10 va kuniga 100 so'rov. Bu cheklov hisobdagi pulga bog'liq emas. Kunlik limit Toshkent vaqti bilan soat 12:00 da (Tinch okeani vaqti bilan yarim tunda) yangilanadi. Limit tugasa, UzDublyaj zaxira modelga o'tadi; u ham tugasa, tayyor qismni saqlab to'xtaydi. Limitlaringizni AI Studio'dagi Rate limit sahifasida ko'rasiz.

Loyiha tuzilmasi

main.py               repo ichidan ishga tushirish (python main.py)
setup.bat / run.bat   o'rnatish va ishga tushirish (Windows)
src/uzdublyaj/
  cli.py              menyu, buyruq qatori va bosqichlar
  config.py           standart sozlamalar va config.json ni yuklash
  downloader.py       YouTube'dan yuklash (yt-dlp) yoki mahalliy fayl
  transcriber.py      nutqni matnga aylantirish, so'z vaqtlari bilan
  segmenter.py        so'zlarni gaplarga bo'lish
  languages.py        video tillari (ingliz, rus, koreys) va ularning sozlamalari
  translator.py       o'zbekchaga tarjima va qisqartirish
  subtitles.py        .srt fayllar
  dubber.py           ovoz berish, vaqtga moslash va audio yig'ish
  gemini_client.py    Gemini API, qayta urinishlar, limitlar va xarajat hisobi
  ffmpeg_utils.py     ffmpeg buyruqlari

Cheklovlar

  • Rus va koreys tillarida nutqni aniqlash sifati videoning ovoziga bog'liq. Shovqinli yoki musiqali videolarda ba'zi so'zlar noto'g'ri eshitilishi mumkin; tarjimon ularni kontekstdan to'g'rilashga harakat qiladi.
  • Koreys tilida o'zbekcha tarjima ko'pincha asl gapdan uzunroq chiqadi, shuning uchun dublyajda tezlashtirish va qisqartirish ko'proq uchrashi mumkin.
  • Sun'iy ovoz asl nutqqa to'liq mos kelmasligi mumkin: o'zbekcha matn odatda uzunroq bo'ladi, shuning uchun ba'zi joylar biroz tezlashtiriladi yoki qisqartiriladi.
  • Ovoz ~20 soniyalik bloklar bilan beriladi. Blok ichida nutq asl gapdan 1–2 soniya oldin yoki keyin ketishi mumkin, har yangi blokda esa video bilan qayta tenglashadi.
  • Uzun videolarda ovoz modellarining kunlik limiti yetmasligi mumkin. Unda ish keyingi kuni qolgan joyidan davom ettiriladi.

Ishlab chiqish

git clone https://github.com/Abror5555/uzdublyaj.git
cd uzdublyaj
pip install -e ".[dev]"
pytest          # internet va API kalitsiz testlar

PyPI'ga chiqarish (muallif uchun)

Yangi versiya GitHub Actions orqali chiqariladi (.github/workflows/publish.yml): src/uzdublyaj/__init__.py dagi __version__ ni oshiring va GitHub'da shu raqamli yangi Release (masalan v0.1.1) chiqaring — testlar o'tsa, paket PyPI'ga avtomatik yuklanadi.

Mualliflik huquqi haqida

UzDublyaj shaxsiy o'rganish uchun mo'ljallangan. Boshqalarning videolarini tarjima qilib qayta joylashdan oldin muallifdan ruxsat oling va YouTube foydalanish shartlariga rioya qiling.

Litsenziya

MIT — LICENSE fayliga qarang.

Metadata

Release files for uzdublyaj 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for uzdublyaj 0.1.0
File Size Uploaded Provenance Actions
uzdublyaj-0.1.0.tar.gz 34.7 kB With provenance Details for uzdublyaj-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for uzdublyaj 0.1.0
File Interpreter ABI Platform Actions
uzdublyaj-0.1.0-py3-none-any.whl Python 3 none any Details for uzdublyaj-0.1.0-py3-none-any.whl

Total release size: 72.9 kB

Release files / uzdublyaj-0.1.0.tar.gz

Download URL uzdublyaj-0.1.0.tar.gz
Size 34.7 kB
Tags Source
SHA-256 checksum
How to use checksums
1ba63665e58338415876f7dafdc53231329fcfd936ffc26f39c926413c04e1d8
BLAKE2b-256 checksum
How to use checksums
56f27cac1f6e531187e6a2a48517c1a2e755afc7989c03f0c5e2c4831ae27d92
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / uzdublyaj-0.1.0-py3-none-any.whl

Download URL uzdublyaj-0.1.0-py3-none-any.whl
Size 38.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d45634d167601c04369c6d256c432739210a41c4d6cdbcb2c63b571669d928d1
BLAKE2b-256 checksum
How to use checksums
b80656b9c9891eac16fea6afc47276e85c058190f1885d4e50bae7a7c7c4904e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Security for uzdublyaj 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for uzdublyaj-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page