dramapack

dramapack

[tests] [License: Apache-2.0] [MCP server]

dramapack turns short-drama episodes (vertical dramas, micro dramas, AI dramas) into a platform-ready delivery package — TikTok Drama Center / DramaWave / ReelShort submission pack, -14 LUFS mastering, burned subtitles inside the subtitle safe area, clean masters, 3:4 covers, local QC (black frames, subtitle/speech alignment, optional bring-your-own vision-model checks) and music/font rights check — from the command line or as an MCP server for AI agents.

Read in Chinese · Docs · Reference

Why

Between "the episode is rendered" and "the platform accepted it", the same things go wrong for every short-drama studio:

• Submission packs: numbered episodes, same-name SRTs, 3:4 covers, a clean master, edit evidence, chain of title, AI disclosure. Dozens of manual steps per series. → delivery package guide
• Phone-speaker loudness: raw AI renders sit at -20 to -27 LUFS; the feed around them is near -14. And ffmpeg loudnorm silently goes dynamic on dialogue and lifts the noise floor by 30-50 dB. → -14 LUFS guide
• Subtitle safe areas: ffmpeg's default 384x288 ASS canvas scales every size ~6.7x; fixed margins land under the player bar or exceed TikTok Drama Center's 70%-width rule. → safe-area guide
• Clean masters that are really the same edit as the subtitled one. → clean master guide
• Rights hygiene: no major-label music, commercial-free fonts only. → rights checklist
• TikTok Drama Center rejections: a dark band along one edge (black bars, code 4) and frame 0 as the default episode cover. --target tiktok-dc lifts the edges and opens every episode on a 1 s cover still. → Drama Center section
• QC before upload: black frames mid-episode, dark edge bands, subtitles that drift from the speech, speech nobody subtitled, likely subtitle typos; optionally AI visual defects (hands, faces, identity drift, garbled text) and content-policy flags with your own vision model or a local one. Free, local, no account; no network calls unless you opt in. Lip-sync is not covered. → local QC guide

Install

Requires Python >= 3.10 and ffmpeg (with libass + libx264) on PATH. For CJK subtitles install Noto CJK fonts (apt install fonts-noto-cjk).

pip install dramapack# or run without installing:uvx dramapack --help

Optional dialogue-density metrics and subtitle/speech alignment: pip install "dramapack[speech]".

60-second quickstart

# input/ holds 01.mp4 02.mp4 ... (un-subtitled cuts) and 01.srt 02.srt ...dramapack check-rights --input input/          # music + fonts: fix red firstdramapack package input/ out/ --title "My Show" --studio "My Studio" --bed tensiondramapack audit out/episodes/01.mp4 --cut input/01.mp4   # QC: black, subtitles, pacingdramapack inspect out/episodes/01.mp4          # LUFS, true peak, specs

out/ now holds episodes/ (subtitled, -14 LUFS) with same-name .srt, clean/ (no subtitles, same edit), covers/ (3:4), timeline/, docs/ (chain of title to sign, AI disclosure), manifest.json and a README for the recipient. Add --platform-pairs for two-episodes-per-file cuts. Optional show.json / rights.json / covers / timelines: see examples/input/ and the reference.

For AI agents

claude mcp add dramapack -- dramapack mcp

MCP tools: inspect, master, package, audit, check_rights. Each returns JSON with ok and a green/yellow/red status. Every CLI subcommand also takes --json; exit codes are stable (0 ok, 1 red, 2 usage, 3 failure). The repo doubles as a Claude Code plugin (.claude-plugin/, skills/dramapack/) and has an MCP Registry entry (server.json). → agent guide · AGENTS.md · llms.txt

Docs

• How to build a TikTok Drama Center delivery package
• Why short dramas should be mastered at -14 LUFS (and why not loudnorm)
• Keeping burned subtitles inside the safe area
• What is a clean master and why distributors ask for it
• Music and font rights checklist for overseas short dramas
• How to QC a short drama locally before delivery
• Using dramapack from an AI agent (MCP)
• Reference: input formats, CLI, JSON, exit codes, thresholds

Please credit

dramapack is released under the Apache License 2.0. Use it for anything, including commercial work. We'd appreciate two things. These are requests, not license conditions:

• Keep the generator credit dramapack writes into delivery packs ("generator" in manifest.json and the one-line "Packaged with dramapack by Dawnwood" footers).
• Mention "dramapack by Dawnwood" when you describe a production pipeline that uses it.

See NOTICE. To cite it: CITATION.cff.

Built and used in production by Dawnwood, an AI drama studio — https://dawnwood.ai/open-source/