English Français العربية

dramapack

Registre officiel Autres

Short-drama delivery packs, -14 LUFS mastering, subtitle safe areas, clean masters, rights checks.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package dramapack
Claude Code 
claude mcp add dramapack -e 'DRAMAPACK_FFMPEG=<DRAMAPACK_FFMPEG>' -e 'DRAMAPACK_FFPROBE=<DRAMAPACK_FFPROBE>' -e 'DRAMAPACK_VLM_BASE_URL=<DRAMAPACK_VLM_BASE_URL>' -e 'DRAMAPACK_VLM_API_KEY=<your dramapack_vlm_api_key>' -e 'DRAMAPACK_VLM_MODEL=<DRAMAPACK_VLM_MODEL>' -- uvx dramapack==0.2.1 mcp
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dramapack": {
            "command": "uvx",
            "args": [
                "dramapack==0.2.1",
                "mcp"
            ],
            "env": {
                "DRAMAPACK_FFMPEG": "<DRAMAPACK_FFMPEG>",
                "DRAMAPACK_FFPROBE": "<DRAMAPACK_FFPROBE>",
                "DRAMAPACK_VLM_BASE_URL": "<DRAMAPACK_VLM_BASE_URL>",
                "DRAMAPACK_VLM_API_KEY": "<your dramapack_vlm_api_key>",
                "DRAMAPACK_VLM_MODEL": "<DRAMAPACK_VLM_MODEL>"
            }
        }
    }
}

Variables d'environnement

  • DRAMAPACK_FFMPEG Path to ffmpeg (default: ffmpeg on PATH)
  • DRAMAPACK_FFPROBE Path to ffprobe (default: ffprobe on PATH)
  • DRAMAPACK_VLM_BASE_URL Optional: OpenAI-compatible base URL for audit vlm checks (your provider or a local model)
  • DRAMAPACK_VLM_API_KEY secret Optional: API key for that endpoint (any non-empty string for local servers)
  • DRAMAPACK_VLM_MODEL Optional: vision-capable model name for audit vlm checks

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. dramapack
  2. Why
  3. Install
  4. 60-second quickstart
  5. For AI agents
  6. Docs
  7. Please credit

dramapack

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
  • QC before upload: black frames mid-episode, 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 first
dramapack package input/ out/ --title "My Show" --studio "My Studio" --bed tension
dramapack audit out/episodes/01.mp4 --cut input/01.mp4   # QC: black, subtitles, pacing
dramapack 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

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/

Questions fréquentes

Qu'est-ce que dramapack ?

Short-drama delivery packs, -14 LUFS mastering, subtitle safe areas, clean masters, rights checks.

Comment installer dramapack ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add dramapack -e 'DRAMAPACK_FFMPEG=<DRAMAPACK_FFMPEG>' -e 'DRAMAPACK_FFPROBE=<DRAMAPACK_FFPROBE>' -e 'DRAMAPACK_VLM_BASE_URL=<DRAMAPACK_VLM_BASE_URL>' -e 'DRAMAPACK_VLM_API_KEY=<your dramapack_vlm_api_key>' -e 'DRAMAPACK_VLM_MODEL=<DRAMAPACK_VLM_MODEL>' -- uvx dramapack==0.2.1 mcp. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour dramapack ?

Oui. Il attend DRAMAPACK_VLM_API_KEY, à renseigner dans sa configuration.

dramapack est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient dramapack ?

Il est publié par dawnwood-ai. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.