MaSubs Studio

Selamat datang di MaSubs Studio! Ini adalah sebuah suite yang terdiri dari dua aplikasi Windows untuk membantu Anda dalam membuat dan menambahkan subtitle ke video Anda secara otomatis.

Daftar Isi

1. Penjelasan Aplikasi
   • MaSubs (Transcriber Otomatis)
   • MaSubsBurner (Hardcode Subtitle)
2. Teknologi & Model Whisper
   • Model yang Tersedia dan Spesifikasinya
3. Saran Aplikasi Pendukung
4. Cara Mengunduh & Instalasi
5. Cara Penggunaan
   • Menggunakan MaSubs
   • Menggunakan MaSubsBurner
   • Mengedit Subtitle dengan Subtitle Edit
   • Menggunakan Video di Kdenlive/Shotcut
6. Untuk Pengembang (Menjalankan dari Kode Sumber)

---

1. Penjelasan Aplikasi

MaSubs Studio terdiri dari dua aplikasi utama:

MaSubs (Transcriber Otomatis)

MaSubs adalah aplikasi yang dirancang untuk mentranskripsi file audio atau video menjadi teks secara otomatis dan menghasilkan file subtitle dalam format .srt lengkap dengan timestamp. Aplikasi ini memanfaatkan kecanggihan model Artificial Intelligence (AI) OpenAI Whisper untuk akurasi transkripsi yang tinggi.

Fitur Utama MaSubs:

• Transkripsi otomatis dari berbagai format file audio dan video.
• Pemilihan model Whisper (dari tiny hingga large) untuk keseimbangan antara kecepatan dan akurasi.
• Output berupa teks transkripsi dan file .srt yang siap digunakan.
• Antarmuka pengguna grafis (GUI) yang mudah digunakan.

MaSubsBurner (Hardcode Subtitle)

MaSubsBurner adalah aplikasi pendamping yang berfungsi untuk "membakar" atau melakukan hardcode file subtitle (.srt) yang sudah ada ke dalam file video Anda. Hasilnya adalah sebuah file video baru di mana teks subtitle sudah menjadi bagian permanen dari gambar video.

Fitur Utama MaSubsBurner:

• Menggabungkan file .srt dengan berbagai format video populer.
• Proses hardcoding yang memastikan subtitle tampil di semua pemutar video.
• Antarmuka pengguna grafis (GUI) yang sederhana dan to-the-point.

---

2. Teknologi & Model Whisper

Kedua aplikasi ini dibangun menggunakan Python dengan antarmuka pengguna grafis (GUI) yang dibuat menggunakan PyQt6. Proses transkripsi pada MaSubs ditenagai oleh OpenAI Whisper, sebuah model pengenalan suara otomatis (Automatic Speech Recognition - ASR) yang canggih. Proses manipulasi video pada MaSubsBurner dan pemrosesan audio pada MaSubs difasilitasi oleh FFmpeg yang sudah dibundel di dalam aplikasi.

Model Whisper yang Tersedia dan Spesifikasinya

MaSubs memungkinkan Anda memilih berbagai ukuran model Whisper. Pilihan model mempengaruhi kecepatan transkripsi, akurasi, dan kebutuhan sumber daya sistem (terutama VRAM jika menggunakan GPU).

Model	Kecepatan Relatif	Akurasi Relatif	Estimasi VRAM (GPU)	Catatan
tiny	Sangat Cepat	Cukup	~1 GB	Paling ringan, cocok untuk transkripsi cepat atau perangkat terbatas.
base	Cepat	Baik	~1 GB	Keseimbangan baik antara kecepatan dan akurasi untuk penggunaan umum.
small	Sedang	Sangat Baik	~2 GB	Akurasi lebih tinggi, membutuhkan sumber daya lebih.
medium	Lambat	Luar Biasa	~5 GB	Akurasi sangat tinggi, cocok untuk audio berkualitas tinggi atau kompleks.
large	Sangat Lambat	Terbaik	~10 GB	Model paling akurat dan paling berat.

Catatan Penting:

• Pemrosesan CPU: Semua model dapat dijalankan menggunakan CPU saja, namun prosesnya akan jauh lebih lambat dibandingkan menggunakan GPU (kartu grafis) yang kompatibel (NVIDIA dengan CUDA).
• Unduhan Model: Saat Anda pertama kali memilih dan menggunakan sebuah model di MaSubs, aplikasi akan mengunduh file model tersebut dari internet. Ini hanya terjadi sekali per model. Pastikan ada koneksi internet saat penggunaan pertama.

---

3. Saran Aplikasi Pendukung

Meskipun MaSubs Studio menyediakan fungsionalitas inti, Anda mungkin memerlukan alat bantu lain untuk alur kerja yang lebih lengkap:

• Subtitle Edit:

  • Gratis dan open-source.
  • Sangat direkomendasikan untuk mengedit file .srt yang dihasilkan oleh MaSubs. Anda bisa memperbaiki kesalahan transkripsi, menyesuaikan timing, memformat teks, dll.
  • Unduh Subtitle Edit

• Kdenlive atau Shotcut:

  • Keduanya adalah editor video gratis, open-source, dan cross-platform.
  • Berguna jika Anda perlu melakukan editing video lebih lanjut, seperti memotong klip, menambahkan efek, atau jika Anda lebih suka menggunakan soft subtitles (subtitle yang bisa diaktifkan/nonaktifkan oleh pemirsa) dengan mengimpor file .srt secara terpisah.
  • Unduh Kdenlive
  • Unduh Shotcut

---

4. Cara Mengunduh & Instalasi

Aplikasi MaSubs dan MaSubsBurner disediakan sebagai file .exe yang portabel dan sudah menyertakan ffmpeg.exe di dalamnya. Anda tidak perlu menginstal dependensi tambahan apa pun untuk menjalankannya.

1. Unduh Aplikasi:
   • Kunjungi halaman Releases di repositori GitHub ini.
   • Unduh file MaSubs.exe dan/atau MaSubsBurner.exe dari rilis terbaru.
2. Jalankan Aplikasi:
   • Setelah diunduh, Anda bisa langsung menjalankan file .exe tersebut. Tidak ada proses instalasi formal yang diperlukan. Simpan file .exe di lokasi yang mudah Anda akses.

PENTING: Ganti PAUTAN_KE_HALAMAN_RELEASES_GITHUB_ANDA di atas dengan pautan sebenarnya ke halaman Releases proyek Anda setelah Anda membuatnya di GitHub.

---

5. Cara Penggunaan

Menggunakan MaSubs

1. Jalankan MaSubs.exe.
2. Klik tombol "1. Pilih File Audio/Video..." untuk memilih file yang ingin Anda transkripsi.
3. Pada bagian "2. Pilih Model Transkripsi:", pilih model Whisper yang Anda inginkan dari menu dropdown. Pertimbangkan keseimbangan antara kecepatan dan akurasi (lihat tabel model).
4. Klik tombol besar "3. Mulai Transkripsi".
5. Tunggu proses selesai. Progress bar akan menunjukkan kemajuan, dan status bar akan memberikan informasi. Aplikasi akan tetap responsif selama proses.
6. Setelah selesai, teks hasil transkripsi akan muncul di area teks.
7. Sebuah file subtitle dengan format .srt (misalnya, nama_video_asli.srt) akan otomatis disimpan di folder yang sama dengan file video/audio sumber Anda.

Menggunakan MaSubsBurner

1. Jalankan MaSubsBurner.exe.
2. Klik tombol "1. Pilih File Video..." untuk memilih file video yang ingin Anda tambahkan subtitle permanen.
3. Klik tombol "2. Pilih File Subtitle (.srt)..." untuk memilih file .srt yang sesuai (bisa hasil dari MaSubs atau dari sumber lain).
4. Klik tombol "3. Mulai Proses & Simpan Video".
5. Sebuah jendela dialog "Simpan Video Sebagai..." akan muncul.
   • Secara default, dialog ini akan terbuka di folder yang sama dengan video input Anda.
   • Nama file output juga akan disarankan secara otomatis (misalnya, nama_video_asli_hardsub.mp4).
   • Anda bisa memilih lokasi penyimpanan dan nama file yang berbeda jika diinginkan. Klik "Simpan".
6. Tunggu proses burning selesai. Progress bar akan aktif.
7. Setelah selesai, sebuah pesan sukses akan muncul, dan file video baru dengan subtitle yang sudah menempel permanen akan tersedia di lokasi yang Anda pilih.

Mengedit Subtitle dengan Subtitle Edit

1. Buka aplikasi Subtitle Edit.
2. Pilih menu File > Open (atau seret file .srt ke jendela aplikasi).
3. Buka file .srt yang dihasilkan oleh MaSubs.
4. Anda sekarang bisa:
   • Memperbaiki kesalahan ketik atau tata bahasa pada teks subtitle.
   • Menyesuaikan waktu (timing) mulai dan selesai untuk setiap baris subtitle agar sinkron dengan audio.
   • Menggabungkan atau memecah baris subtitle.
   • Menggunakan berbagai alat bantu lain yang disediakan Subtitle Edit.
5. Setelah selesai mengedit, simpan perubahan Anda (File > Save). File .srt yang sudah diedit ini siap digunakan oleh MaSubsBurner atau diimpor ke editor video.

Menggunakan Video di Kdenlive/Shotcut

• Untuk Video yang Sudah di-Hardcode oleh MaSubsBurner:

  1. Buka Kdenlive atau Shotcut.
  2. Impor file video yang sudah memiliki subtitle permanen (hasil dari MaSubsBurner) ke dalam proyek Anda.
  3. Subtitle sudah menjadi bagian dari video dan akan selalu tampil. Anda bisa melanjutkan proses editing video lainnya.

• Untuk Soft Subtitles (Menggunakan File .srt Terpisah):

  1. Buka Kdenlive atau Shotcut.
  2. Impor file video asli (tanpa subtitle) ke dalam proyek Anda.
  3. Cari fitur untuk menambahkan track subtitle atau mengimpor file subtitle.
     • Di Kdenlive: Anda bisa menambahkan track baru, lalu klik kanan pada track tersebut dan pilih "Add Subtitle File" atau sejenisnya.
     • Di Shotcut: Anda mungkin perlu menggunakan filter "Text: SubRip" atau "Text: Rich" dan mengimpor konten dari file .srt.
  4. Arahkan ke file .srt yang Anda miliki (bisa dari MaSubs atau yang sudah diedit).
  5. Subtitle akan muncul sebagai track terpisah, memungkinkan pemirsa untuk mengaktifkan atau menonaktifkannya jika format output video mendukungnya.

---

6. Untuk Pengembang (Menjalankan dari Kode Sumber)

Jika Anda ingin menjalankan aplikasi dari kode sumber (.py):

1. Persyaratan:
   • Python (disarankan versi 3.9+)
   • pip (biasanya sudah terinstal bersama Python)
2. Clone Repositori:

   git clone https://github.com/madhasoeki/MaSubs-Studio.git
   cd MaSubs-Studio

3. Untuk MaSubs:
   • Masuk ke folder MaSubs: cd MaSubs
   • Buat dan aktifkan virtual environment:

     python -m venv venv
     venv\Scripts\activate  # Untuk Windows
     # source venv/bin/activate  # Untuk macOS/Linux

   • Instal dependensi:

     pip install openai-whisper PyQt6

   • (Opsional untuk bundling jika menjalankan build dari source) Letakkan ffmpeg.exe dan ffprobe.exe di folder MaSubs.
   • Jalankan: python main_app.py
4. Untuk MaSubsBurner:
   • Masuk ke folder MaSubsBurner: cd MaSubsBurner (dari root repositori)
   • Buat dan aktifkan virtual environment:

     python -m venv venv
     venv\Scripts\activate

   • Instal dependensi:

     pip install ffmpeg-python PyQt6

   • (Opsional untuk bundling jika menjalankan build dari source) Letakkan ffmpeg.exe dan ffprobe.exe di folder MaSubsBurner.
   • Jalankan: python main_burner.py

Struktur Proyek (Jika Anda Mengunduh Seluruh Kode Sumber):

MaSubs-Studio/ ├── MaSubs/ # Aplikasi transkripsi otomatis │ ├── core_logic.py # Logika inti untuk transkripsi │ ├── main_app.py # Entrypoint untuk aplikasi MaSubs │ ├── main_app.spec # File spec PyInstaller untuk build .exe │ ├── logo.ico # Ikon aplikasi (opsional) │ ├── ffmpeg.exe # FFmpeg untuk bundling (opsional) │ └── ffprobe.exe # FFprobe untuk bundling (opsional) ├── MaSubsBurner/ # Aplikasi hardcode subtitle ke video │ ├── burner_logic.py # Logika inti untuk proses burning subtitle │ ├── main_burner.py # Entrypoint untuk aplikasi MaSubsBurner │ ├── main_burner.spec # File spec PyInstaller untuk build .exe │ ├── logo_burner.ico # Ikon aplikasi MaSubsBurner (opsional) │ ├── ffmpeg.exe # FFmpeg untuk bundling (opsional) │ └── ffprobe.exe # FFprobe untuk bundling (opsional) ├── README.md # Dokumentasi dan petunjuk penggunaan └── .gitignore # Daftar file/direktori yang diabaikan Git

Saran .gitignore (Jika Anda Mengelola Kode Sumber):

# Virtual Environments
venv/
*/venv/

# PyInstaller - Direktori output build dan .exe
build/
*/build/
dist/
*/dist/

# Python cache
__pycache__/
*.py[cod]

# IDE/Editor specific
.vscode/
.idea/
*.swp

# File spesifik aplikasi
*.log
*.tmp