One master, many platforms
You get one file per platform from a single project: the right length and language, the right canvas, captions sized and placed clear of that app’s buttons, loudness levelled, its own cover, post copy in the right language and within its limits, and a manifest that lists every check.
One cut per platform length
Section titled “One cut per platform length”Not every platform gets the same video. Each platform’s version is cut to that platform’s habits for the kind of video:
- Long cut, with chapters: YouTube and Bilibili (minutes, when the footage carries it).
- Short cut: Shorts, TikTok, Instagram, LinkedIn and Xiaohongshu.
Both cuts are made from the same project, each drafted and rendered for its own length, not cropped from the other. Set your own shortest and longest per platform in Settings › Publishing › Video length; every plan keeps to it. The “Several videos” plan card shows and edits the length per platform and how much the footage can carry (“about 4 min possible”).
One language per platform
Section titled “One language per platform”YouTube is always English: title, captions, narration and post copy. Xiaohongshu, Bilibili and the other Chinese platforms get Chinese. A request for both makes an English version and a Chinese version, and each is offered for its own platforms: the English version’s schedule turns on YouTube, the Chinese version’s Xiaohongshu and Bilibili. Platforms you name in the request win over the composer’s platform chip.
Before you start
Section titled “Before you start”- A clean master: the finished edit with no captions burned in. Text burned into a 16:9 master is cut off on 3:4 and 9:16.
- The captions as a separate file (
cues.jsonor.srt), so each export can place them for its own platform. With two languages, one file per language. - Covers. One per aspect you publish, ideally. See Covers.
- Optional: a
post.jsonwith your title, hook, body, chapters, links and tags, withenandzhblocks if you post in both languages.
Twenty platforms have profiles, from YouTube, TikTok and Instagram to 小红书, 抖音, 视频号 and B站. The full list with sizes and limits is in the platform reference.
In the Mac app
Section titled “In the Mac app”- Say which platforms you want in the request, or add them to the plan: “for Shorts, Xiaohongshu and Douyin”.
- When the clips are done, Package for platforms lets you pick clips and platforms. Each platform gets its own folder with the right video version, cover and copy, checked against that platform’s limits.
- Confirm the list once, then schedule the posts on the Publish board.
With the Claude Code skill
Section titled “With the Claude Code skill”Ask Claude to export for several platforms; it runs the shared exporter:
python3 -m vstudio.export work/master.mp4 --platforms youtube,xiaohongshu:vertical,douyin \ --out exports/ --cues en=work/cues.en.json --cues zh=work/cues.zh.json \ --cover work/cover-16x9.png --cover work/cover-3x4.png --post work/post.jsonFor English-language platforms:
python3 -m vstudio.export work/master.mp4 --platforms x,instagram,instagram:feed \ --cues work/cues.json --cover instagram=work/cover-9x16.png --post work/post.json --lang enIf you finished the edit elsewhere, workflows/polish can polish the master once and then do the same per-platform export.
What happens for each platform
Section titled “What happens for each platform”- Canvas. When the aspect changes, the picture is reframed by following the main face inside the safe area. With no face found, it uses a blurred fill. A master of the same aspect is only scaled.
- Captions come from the track in the platform’s language (English on YouTube and Shorts, Chinese on 小红书, B站 and 抖音) when you give one track per language. A platform whose language has no track gets another track, with a warning. They go inside that platform’s caption box, sized to fit two lines and kept out of its UI: the top bar, the description at the bottom, the button column on the right. If your master has burned-in panels or stamps, add
keepoutstocues.jsonand the captions move above or below them while they’re on screen. - Caption files. Platforms whose upload page takes a caption file (YouTube and Shorts, X, Facebook, LinkedIn) also get
<name>.<lang>.srtnext to the video, one per caption language.--captions sidecarkeeps those videos clean (viewers switch the captions on) and still burns captions where there is no caption upload, such as 小红书 and 抖音. - Loudness. −14 LUFS integrated and −1.5 dBTP true peak by default. Only YouTube publishes a normalisation target; for the others this is a safe convention you can override per platform.
- Encode. H.264 High, yuv420p, AAC 48 kHz, with per-platform quality caps. Files over a platform’s upload cap get a warning.
- Cover. Each target takes the cover closest to its aspect, or the one you name with
--cover douyin=cover_9x16.png. A cover of another aspect is fitted on a blurred pad with a warning. Where the feed crops covers, you get a.feed.jpgpreview. - Post copy. Titles, body and tags are checked against each platform’s limits (YouTube titles 100, X 280 weighted characters, 小红书 titles 20). English content gets English copy on X, Instagram, TikTok and YouTube;
--bilingualwrites English then Chinese. - Manifest.
manifest.jsonrecords sizes, durations, measured loudness, how well the reframe found the face, and every warning.
Outputs land as <platform>-<orientation>.mp4 with .cover.jpg, .post.md and .crop.json next to each, plus .srt caption files where the platform takes them.
Options worth knowing
Section titled “Options worth knowing”| Option | Default | What it does |
|---|---|---|
--platforms |
persona default | Comma list of name[:orientation], for example xiaohongshu:full,douyin. |
--mode |
face | Reframe: face, center, pad-blur or letterbox. |
--cues |
none | One caption track, or one per language: --cues en=cues.en.json --cues zh=cues.zh.json. |
--captions |
both | both burns captions and writes .srt files; sidecar leaves upload-capable platforms clean; burn burns only. |
--no-captions |
off | Don’t burn the cues, because the master already has its captions. |
--lang / --bilingual |
detected | Post copy language: en, zh, or both. |
--account |
standard | Account tier for limits, for example premium on X. |
--encoder |
libx264 | h264_videotoolbox uses the Mac’s hardware encoder. |
Example prompts
Section titled “Example prompts”- “Export this master for YouTube Shorts, Xiaohongshu 3:4 and Douyin, each with its own safe zones and loudness.”
- “A long cut with chapters for YouTube and a 60-second cut for TikTok and Xiaohongshu.”
- “Same video for X and Instagram Reels plus a 4:5 feed cut, English captions and English copy.”
- “The master already has captions, so don’t add new ones. Just reframe, level the audio and make the covers.”
- “Write the post copy for every platform in English and Chinese.”