Bang Story

Ubah ide cerita jadi video YouTube, langsung dari komputermu.

AI menyusun naskah dan visual, Higgsfield membuat gambar dan video, narator AI mengisi suara,
lalu kamu merapikannya di editor timeline dan mengekspor MP4.

Fitur · Tampilan · Tutorial · Mulai cepat · Kunci API · Pengembangan · Dokumentasi

Bang Story adalah aplikasi desktop untuk kreator konten. Tulis satu ide, misalnya "Bagaimana rasanya hidup di Batavia tahun 1700-an?", lalu aplikasi akan:

• menyusun naskah per adegan;
• membuat gambar dan video AI;
• merekam narasi dan menyamakan caption dengan suaranya;
• merangkai semuanya di editor.

Hasilnya video MP4 yang siap diunggah ke YouTube, Shorts, Reels, atau TikTok.

Semua proyek, gambar, video, dan suara disimpan di komputermu. Kamu memakai kunci API sendiri (bring your own key), jadi biaya AI dibayar langsung ke penyedianya, tanpa server perantara.

1. Ide cerita

• Tulis ide atau sinopsis, lalu atur:
  • durasi (30 detik sampai 10 menit);
  • bahasa dan format (16:9 atau 9:16);
  • gaya visual (2D, 3D, atau realistis);
  • suara narator.
• Pilih model gambar dan video Higgsfield per proyek, lengkap dengan perkiraan kredit.

2. Naskah

• AI menulis alur dan narasi (VO) setiap adegan. Adegan bisa diubah, ditambah, dihapus, dan diurutkan ulang.
• Narasi boleh memakai tag ekspresi suara seperti <short pause>, <chuckles>, atau <whispers>.

3. Storyboard

• Dari naskah final, AI menyiapkan untuk tiap adegan:
  • prompt visual;
  • pemeran beserta lembar karakter;
  • gerak kamera dan transisi;
  • arahan gerak untuk video AI.
• Tersedia 14 model gambar dan 34 model video dari Higgsfield.
• Narasi direkam dalam satu rekaman utuh (Gemini TTS atau ElevenLabs), lalu dipotong otomatis per adegan. Suara dan intonasinya jadi konsisten.

4. Editor

• Timeline seperti editor video biasa:
  • tarik tepi klip untuk mengubah durasinya;
  • Potong (S) dan Hapus (Delete);
  • geser suara, caption, musik, dan overlay.
• Transisi per sambungan klip, dengan pratinjau langsung.
• Gerak kamera untuk klip gambar maupun video.
• Caption karaoke yang mengikuti suara asli lewat Whisper lokal. Pilih dari 15 font, lalu atur warna, ukuran, dan kotak latarnya.
• Musik latar yang otomatis mengecil saat narasi. Tersedia juga pembuat prompt musik untuk Suno atau AI musik lain.
• Overlay logo, watermark, dan teks yang bisa digeser langsung di pratinjau.

5. Ekspor

• MP4 dirender dengan FFmpeg di komputermu, sama dengan yang terlihat di pratinjau.
• Resolusi 720p, 1080p, atau 4K, dengan 30 atau 60 fps.
• Caption langsung di video, dan bisa juga disimpan sebagai file .srt.
• Volume suara disamakan ke −14 LUFS, standar YouTube.

Beranda: tulis ide dan buka proyekmu	Ide cerita: durasi, format, suara, dan gaya visual
Naskah: periksa alur dan narasi tiap adegan	Storyboard: gambar, video, pemeran, dan suara tiap klip
Transisi: pilih per sambungan dan lihat pratinjaunya	Caption: gaya, font, warna, dan ukuran

Cara membuat video dari ide sampai ekspor: tonton di YouTube. Video ini juga bisa diputar dari Pengaturan › Tentang di dalam aplikasi.

• Windows 10/11 64-bit. Aplikasi juga bisa dijalankan dari kode sumber di macOS, tapi belum diuji penuh. Caption akurat (Whisper) dan installer baru tersedia untuk Windows.
• Kunci API (lihat Kunci API) untuk:
  • Higgsfield;
  • satu penyusun cerita;
  • satu penyedia suara narator.
• Node.js 22 atau lebih baru, hanya kalau menjalankan dari kode sumber.

Butuh Node.js versi LTS dan koneksi internet saat pertama kali dibuka.

• Windows: klik 2x START - WIN.bat.
• macOS: klik 2x START - MAC.command. Kalau muncul pesan tidak punya izin, buka Terminal di folder ini dan jalankan chmod +x "START - MAC.command" sekali. Kalau macOS memblokirnya, klik kanan file itu › Open.

Saat pertama kali dibuka, START memasang semua kebutuhan (npm install), mengunduh Electron, dan menyusun aplikasinya. Ini butuh beberapa menit. Setelah itu aplikasi langsung terbuka setiap kali START diklik. Kalau folder ini dipindah ke OS lain, START otomatis memasang ulang kebutuhannya.

Kalau kode di src diubah, hapus folder out (atau jalankan npm run build) supaya START menyusun ulang aplikasinya.

npm install
npm run dev

npm run dist

Hasilnya ada di dist/BangStory-Setup-<versi>.exe. Untuk folder siap jalan tanpa installer, jalankan npx electron-builder --win --dir.

Setelah aplikasi terbuka, isi kunci API di Pengaturan › Layanan AI dan kunci. Lalu tulis idemu di beranda dan klik Mulai.

Setiap bagian (penyusun cerita, suara narator) punya satu dropdown penyedia. Hanya penyedia yang dipilih yang dipakai. Kunci dienkripsi dengan Windows DPAPI (safeStorage) dan hanya dikirim ke layanannya masing-masing.

• Daftar model penyusun cerita diambil langsung dari penyedia setelah kuncinya disimpan, lalu dipilih lewat dropdown yang bisa dicari.
• Endpoint custom menerima server apa pun yang kompatibel dengan OpenAI API, misalnya:
  • Ollama (http://localhost:11434/v1);
  • LM Studio, vLLM, atau DeepSeek;
  • xAI Grok (https://api.x.ai/v1).

npm install          # pasang dependensi
npm run dev          # mode pengembangan dengan hot reload
npm run typecheck    # pemeriksaan TypeScript (strict)
npm run build        # build ke folder out/
npm run dist         # installer Windows ke folder dist/

src/
  main/       proses utama: database, layanan AI, FFmpeg, Whisper, file
  preload/    jembatan aman window.api
  shared/     aturan yang dipakai pratinjau dan ekspor (gerak kamera, caption, timeline, model)
  renderer/   tampilan React
resources/    font caption, whisper.cpp, file lisensi
docs/         dokumentasi pengembang

Ingin mengembangkan sendiri, atau dibantu AI agent seperti Claude Code, Codex, atau Cursor? Mulai dari sini:

• AGENTS.md: ringkasan proyek, perintah, peta kode, dan aturan yang tidak boleh dilanggar. Claude Code membacanya lewat CLAUDE.md.
• docs/:
  • arsitektur dan model data;
  • alur produksi, editor, dan ekspor;
  • layanan AI dan cara menguji;
  • konvensi, keputusan teknis, dan masalah yang diketahui.
• CHANGELOG.md: riwayat versi.

Laporan bug, ide fitur, dan pull request sangat diterima.

1. Baca AGENTS.md dan docs/konvensi.md dulu.
2. Buat perubahan yang kecil dan fokus. Pastikan npm run typecheck dan npm run build bersih.
3. Uji perubahan tampilan atau ekspor dengan dev harness (docs/pengembangan.md).
4. Catat perubahan di CHANGELOG.md, dan catat keputusan teknis baru di docs/keputusan-teknis.md.

Kode Bang Story memakai lisensi MIT. Komponen pihak ketiga yang ikut terpasang memakai lisensinya sendiri:

Teks lisensinya ada di resources/licenses. Lisensi FFmpeg disalin dari paket ffmpeg-static saat installer dibuat. Logo penyedia layanan adalah merek milik pemiliknya masing-masing.