Ir al contenido

One master, many platforms

Esta página aún no está traducida; aquí tienes la versión en inglés.

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.

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”).

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.

  • 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.json or .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.json with your title, hook, body, chapters, links and tags, with en and zh blocks 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.

  1. Say which platforms you want in the request, or add them to the plan: “for Shorts, Xiaohongshu and Douyin”.
  2. 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.
  3. Confirm the list once, then schedule the posts on the Publish board.

Ask Claude to export for several platforms; it runs the shared exporter:

Terminal window
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.json

For English-language platforms:

Terminal window
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 en

If you finished the edit elsewhere, workflows/polish can polish the master once and then do the same per-platform export.

  • 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 keepouts to cues.json and 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>.srt next to the video, one per caption language. --captions sidecar keeps 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.jpg preview.
  • 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; --bilingual writes English then Chinese.
  • Manifest. manifest.json records 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.

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.
  • “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.”