howznguyen/shorts-kit

选用指南

AI 根据 README 整理 · 2026/11/5 23:56:33

使用方式

通过命令行操作，如`bun run tts`、`bun run render`等，或通过编码代理交互式生成视频。

查看 README 依据

| --- | --- | | `bun run new <id> --flow <A..T>` | scaffold `src/videos/<id>/` from a flow's beats | | `bun run dev <id>` | Remotion Studio for that video | | `bun run tts <id> [--force]` | synthesise the whole script, write the audio and `voice.json` | | `bun run from <file\|dir>...` | "here is my video, edit it": scaffold, transcribe every clip, cut, storyboard stub, and the questions only the speaker can answer | | `bun run ingest <id> <file>` | recorded voice instead of TTS (a filmed take or a voice recording): Whisper transcript and proposed cuts |

部署要求

需要Bun 1.3或更高版本、ffmpeg和ffprobe，以及一个编码代理（如Claude Code、Codex、OpenCode）。语音引擎可选：英语默认使用Edge在线语音（免费无需密钥），越南语可使用VieNeu-TTS（免费离线，需Python 3.10+），或ElevenLabs（需API密钥）。

查看 README 依据

 ## Requirements - [Bun](https://bun.sh) 1.3 or later - [ffmpeg](https://ffmpeg.org) and ffprobe on your `PATH` - A coding agent: [Claude Code](https://claude.com/claude-code), Codex, OpenCode, ... - A voice. The default depends on the video's language; pick another any time: - **English → `edge`** (Microsoft Edge online voices): free, no key. The service sometimes stops answering; `bun run tts` retries.

- **Vietnamese → `vieneu`** ([VieNeu-TTS](https://github.com/pnnbao97/VieNeu-TTS)): free and offline on CPU, 25 preset voices or clone your own. Needs Python 3.10+. - [ElevenLabs](https://elevenlabs.io): best quality in either language, needs an API key. - `say` (built into macOS): free and offline, for testing only. The example uses it so the kit runs with no network. - **Your own recording** (optional): needs [whisper.cpp](https://github.com/ggml-org/whisper.cpp) (`whisper-cli`) and its `large-v3-turbo` model, below. Install the tools: ```bash # macOS

已知限制

作者明确说明：该工具包无法为用户选择主题，且不负责上传视频，用户需自行上传。

查看 README 依据

zero to about 120k views on its best video in two months. Every rule keeps the reason it exists, because most of them were written after a published video broke it. They are defaults: change them for your own channel. ## Results The channel these rules came from, two months in. The best videos and the flops sit side by side on purpose: topics close to the audience carried it (tens of thousands of views), topics that drifted from the channel's niche got a few hundred. The kit cannot pick your topic for you.

- Pick the topic. Topic choice moves views more than anything in this kit. - Approve the script, listen to the voice once end to end, and approve the storyboard. - Look at the stills and the render. The agent catches layout bugs, not dull videos. - Upload, set the cover, and paste the pinned comment (it carries the credits). - After posting, give your agent the numbers so `sk-improve` can adjust your rules. ## Community Made a video with the kit, stuck on a step, or want a second pair of eyes on a script before you post? Come say hi: