bbn-video-studio

ปลั๊กอิน BBN Studio สำหรับ Claude Code และ Codex มี 3 สกิล:

music-video และ short-ex-3d ใช้ pipeline เดิม และแบ่งฉากให้ subagent ทำพร้อมกันเมื่อเครื่องมือรองรับ
long-ex เก็บ manifest ของบท/ฉากและไฟล์ไว้ในโฟลเดอร์หัวข้อ เพื่อแก้เฉพาะฉากและทำต่อได้

short-ex-3d คือชื่อใหม่ของ explainer-video; โปรเจกต์วิดีโอที่สร้างไปแล้วไม่ต้องย้ายหรือเปลี่ยนชื่อ
งานอธิบายยาวใช้ long-ex แทนการยืด engine คลิปสั้น

long-ex และ 5 workflow

long-ex ประสานงานทั้งห้าในแผน แต่เรียกใช้เฉพาะส่วนที่เหมาะกับเรื่อง มี runtime และได้รับอนุญาต:

ไม่มีโค้ด/โมเดลของทั้งห้าติดมากับปลั๊กอินนี้ การสร้างวิดีโอจริงขึ้นกับ workflow ที่มีอยู่และการอนุญาตใช้งาน
ถ้า route ขาด runtime, license หรือ spending approval ให้บันทึกว่า blocked และเสนอทางเลือกอย่างตรงไปตรงมา
ทางเลือกที่ BBN เขียนเองไม่ใช่การรัน onetake หรือ renderer ต้นฉบับ ตรวจการออกเสียงและฟอนต์/ซับภาษาไทยแยกเสมอ
รายละเอียดและแหล่งข้อมูล: integration guide
แต่ละ route มี setup, capability checks, input/output และขั้นตอนส่งงานไปยัง skill/guide ต้นฉบับจริง
บันทึก workflow_ref ของ installation ที่อ่าน และ handoff_ref ของคำขอฉาก; validator แบบ --ready ต้องมีทั้งสอง
ดู handoff template การใช้ Lemo เพื่อกำกับภาพอย่างเดียว
ต้องรายงานว่าเป็น direction; จะนับว่า render ผ่าน workflow ใดได้ก็ต่อเมื่อ workflow นั้นรันและคืน artifacts จริง

Manifest ตัวอย่างและ validator ใช้ Python standard library เท่านั้น ไม่ติดตั้งโปรแกรม ไม่เรียก API และไม่เรนเดอร์:

python3 plugins/bbn-video-studio/skills/long-ex/scripts/validate_manifest.py plugins/bbn-video-studio/skills/long-ex/manifest.example.json
python3 -m unittest discover -s tests -v

เพิ่ม --ready เพื่อตรวจหลักฐาน prerequisites ที่บันทึกไว้ ก่อนรันต้องตรวจสิทธิ์และ provider จริงด้วย
Manifest ตัวอย่างเป็นแผน จึงยังไม่ผ่าน --ready

ติดตั้ง

Codex: ใช้ checkout ในเครื่อง

codex plugin marketplace add /absolute/path/to/bbn-video-studio
codex plugin add bbn-video-studio@bbn-video-studio
codex plugin list --marketplace bbn-video-studio --json

ใช้ path ของ checkout ที่มีไฟล์ .agents/plugins/marketplace.json นี้ เปิด task ใหม่เพื่อโหลด skills ที่อัปเดต
ไม่ต้องหยุด task เก่าหรือแก้ installed cache ของ task ที่กำลังรัน ชื่อสกิลใน Codex คือ $music-video, $short-ex-3d, $long-ex
เมื่อต้นฉบับอ้างถึง Agent / SendMessage ของ Claude ให้ใช้เครื่องมือ delegation ที่ host มี โดยรักษา ownership และข้อจำกัดงานหนักเดิม

Claude Code

ใน Claude Code:

/plugin marketplace add Boom-Vitt/bbn-video-studio
/plugin install bbn-video-studio@bbn-video-studio

หรือคำสั่งเดียว (Claude Code 2.1.275 ขึ้นไป): /plugin install bbn-video-studio --marketplace Boom-Vitt/bbn-video-studio

เครื่องที่ต้องมี

• Mac ชิป Apple Silicon, RAM 16 GB ขึ้นไป (32 GB ถ้าจะให้ AI แต่งเพลงในเครื่อง)
• Blender 5 ขึ้นไป, Google Chrome
• brew install node ffmpeg uv yt-dlp (Node 22.12 ขึ้นไป)
• พื้นที่ดิสก์: ~10 GB สำหรับโมเดลเสียงพากย์, อีก ~40 GB ถ้าลง ACE-Step

ตั้งค่าครั้งแรก

X="$(find ~/.claude/plugins -path '*bbn-video-studio*/skills/short-ex-3d/scripts' -type d | head -1)"
"$X/setup.sh"     # Python env: VoxCPM2, mlx-whisper, librosa → ~/.venvs/bbn-video-studio
echo 'export PY=$HOME/.venvs/bbn-video-studio/bin/python' >> ~/.zshrc && source ~/.zshrc
"$X/doctor.sh"    # ต้องขึ้น ok ทุกบรรทัด (ACE-Step ไม่บังคับ)

สร้างเพลง: เลือกได้ 2 ทาง

ทุกครั้งที่จะสร้างเพลง (เพลงร้องของ music-video หรือดนตรีประกอบของ short-ex-3d) Claude จะถามให้เลือก:

1. โอเพนซอร์ส (ฟรี) — ACE-Step 1.5 รันในเครื่อง ไม่ต้องมีบัญชี ใช้ดิสก์ ~40 GB และ RAM 32 GB ติดตั้งตามด้านล่าง
2. phaya API (เสียเครดิต) — คุณภาพระดับ Suno ได้ 2 เวอร์ชันใน 1–2 นาที (3 เครดิต) สมัคร เติมเครดิต และคัดลอก
   API key ได้ที่ https://phaya.io

ใส่ phaya key แบบง่าย (ไม่ต้องตั้ง env) — ได้ทั้ง macOS และ Windows: พิมพ์บอก Claude ว่า "ตั้งค่า phaya key"
→ จะมีหน้าต่างเด้งขึ้นมาให้วาง key (ตัวอักษรถูกซ่อน) กด OK → Claude เช็กกับ phaya ให้ว่าใช้ได้ แล้วเก็บไว้ในเครื่อง
(Mac: Keychain, Windows: เข้ารหัสด้วยบัญชี Windows ของคุณ) ถามครั้งเดียว ไม่ต้องวาง key ในแชท ไม่อยู่ในไฟล์งาน
อยากเปลี่ยน key ก็บอกให้ตั้งใหม่ อยากลบบอกว่า "ลบ phaya key" (หรือเชื่อม phaya connector ใน Claude ก็ได้ ส่วนคนถนัด
terminal ยังตั้ง PHAYA_API_KEY ได้เหมือนเดิม)

ติดตั้ง ACE-Step (ทางที่ 1):

git clone https://github.com/ACE-Step/ACE-Step-1.5.git ~/ACE-Step-1.5 && cd ~/ACE-Step-1.5 && uv sync
uv run acestep-download && uv run acestep-download -m acestep-v15-xl-sft && uv run acestep-download -m acestep-5Hz-lm-4B

ไม่อยากใช้ทั้งสองทาง: short-ex-3d ใช้เพลงที่มีสิทธิ์ใช้งาน วางไว้ที่ music/bed.wav แทนได้

ใช้งาน

/bbn-video-studio:music-video แต่งเพลงล้อเลียนชีวิตออฟฟิศที่ทุกคนส่งบอตไปประชุมแทน
/bbn-video-studio:short-ex-3d หัวข้อ: พร้อมเพย์ทำงานยังไง
/bbn-video-studio:long-ex อธิบายพร้อมเพย์ให้คนเริ่มต้นเข้าใจใน 3 นาที แบ่งเป็นบท พร้อมแหล่งอ้างอิง

หรือพิมพ์ธรรมดา เช่น "ทำ MV เพลง…", "ทำคลิปสั้น 3D อธิบายว่า…", "ทำวิดีโออธิบายยาวแบ่งเป็นบท…" agent จะเลือกสกิลเอง

หนึ่งคลิปใช้เวลาหลายชั่วโมงและใช้ token มาก ระหว่างทาง Claude จะส่งภาพนิ่งของแต่ละฉากมาให้ติหรือสั่งแก้ได้

ข้อควรรู้

• งานหนักทีละงาน: โมเดลเสียง โมเดลเพลง และการเรนเดอร์กินแรมมาก
• Blender: เปิดแบบไม่มีหน้าต่างตัวเดียว (blender/bridge.py, port 9878) ให้ทุก subagent ใช้ร่วมกัน ห้ามเปิดแยก
• เสียงพากย์: เป็นเสียงสังเคราะห์ ห้ามโคลนเสียงใครโดยไม่ได้รับอนุญาตเป็นลายลักษณ์อักษร
• โลโก้แบรนด์: ไม่ได้แนบมาใน repo ให้ดาวน์โหลด SVG ทางการต่อเรื่อง ห้ามวาดใหม่หรือเปลี่ยนสี และใส่เครดิตว่าเป็นเครื่องหมายการค้าของเจ้าของ
• ข้อเท็จจริงในบท: ต้องมีแหล่งที่มา ตรวจซ้ำก่อนโพสต์
• เพลงอ้างอิง: เลียนแบบได้แค่โครงสร้างและฝีมือ ห้ามลอกเนื้อร้อง ทำนอง หรือภาพ

License

โค้ดในนี้ใช้ MIT (ดู LICENSE) ส่วนที่ดาวน์โหลดเพิ่มมี license ของตัวเอง: VoxCPM2 (Apache-2.0), ACE-Step (MIT), three.js (MIT), ฟอนต์ IBM Plex Sans Thai / Kanit / Sriracha (OFL) เสียงเอฟเฟกต์ใน sfx/ สังเคราะห์ด้วยโค้ด ชื่อแบรนด์ที่กล่าวถึงเป็นเครื่องหมายการค้าของเจ้าของ

English

BBN Studio is a Claude Code and Codex plugin with three workflows. music-video: write a song, generate it with local
ACE-Step 1.5 or phaya/Suno, and build a synced kinetic-typography three.js MV (1920×1080). short-ex-3d: a ≤45 s
vertical (9:16) 3D explainer: hook-first narrated script, open-source designed TTS voice (VoxCPM2), photoreal Blender
EEVEE plates rendered through one shared headless Blender bridge, three.js overlays, captions, music and SFX. Scenes are
built in parallel when the host supports subagents; output lands in ~/Downloads. short-ex-3d is the renamed
explainer-video skill; existing generated projects need no migration. long-ex plans and produces chaptered
explanations, defaulting to 16:9, 1–5 minutes at 1920×1080/24 fps, with a resumable scene manifest, shared direction,
narration/captions and QA. It coordinates HyperFrames, onetake, Collage B-roll, Claude Animation Base and Lemo-Opuscar
as external optional routes. No upstream renderer is bundled. onetake requires separately verified commercial-license
evidence; collage requires creative approvals and separately authorized paid generation. Missing routes remain blocked.
Thai by default, other languages work. Requires an Apple Silicon Mac, Blender 5+, Chrome, Node 22.12+, ffmpeg and uv.
Install: /plugin marketplace add Boom-Vitt/bbn-video-studio, then /plugin install bbn-video-studio@bbn-video-studio.

Made by BoomBigNose