@gentbajko/slopify

中文文档
4.4.0发布于 2026/11/13Apache-2.0ES Module构建来源已验证近 30 天下载 6727

Turn a prompt into a finished video, locally, with your own provider keys

原始使用文档
文档目录7 节
  1. How to use it
  2. Inworld narration
  3. Options
  4. ffmpeg and the GPL
  5. Telemetry
  6. Supporting the project
  7. Licence

Slopify

slopify.stream  ·  Patreon  ·  Buy Me a Coffee

A prompt and a few keywords in. A narrated slideshow video out. Your keys, your machine, free.

Start contributing to the internet's enshittification today!

npx @gentbajko/slopify@latest

That opens a browser at http://127.0.0.1:6969. Node 26 or newer is required.

For a persistent install that makes slopify available everywhere:

npm install -g @gentbajko/slopify
slopify

Both commands launch the same local app.

For Docker on Linux with Node 26+, Docker Engine and the Docker Compose plugin, use slopify --docker or npx @gentbajko/slopify@latest --docker. It writes one compose.yaml and its .env under ~/.local/share/slopify/docker/slopify/ and starts Slopify at http://127.0.0.1:6969, restarting with Docker. Project files go to Documents/Slopify/Projects (--projects-dir to choose another, --port for the port); the database, keys and logs stay private in the slopify-data volume.

If Claude Code, Codex or Gemini is installed, it asks once before setting up the host CLI bridge, a private helper that runs those CLIs on your machine with their existing logins. Use --host-cli=off for API keys only, or --accept-host-cli to approve without a prompt.

Update with npx @gentbajko/slopify@latest update, Docker or not. Without Docker, update asks the running app to update itself, so it works only while Slopify is running (to just start the newest version, run npx @gentbajko/slopify@latest). It waits for running work, keeps a copy to go back to (the database, or a recovery volume in Docker), and puts the previous version back if the new one doesn't start. Installations made by 2.5.0 or earlier are taken over as they are: same volume, same project folder. See the Docker guide for details.

How to use it

  1. Add provider keys and voices in Settings. They stay in your local Slopify database.
  2. Write reusable article, image and thumbnail prompts in Prompts, using {{keywords}} where each video's subject belongs.
  3. In Play, build an autosaved setup across Content, Outputs, Style and Review. Supply or skip optional stages, preview subtitles, and inspect the estimated cost before Start.
  4. Follow total and per-stage progress in the project workspace. Pause unfinished work to change providers, add review checkpoints, or edit a paused or completed project as a retained revision. Saving does not rebuild until you explicitly ask.
  5. Save Play setups or project revisions as templates. Apply one to a fresh draft or schedule one-off, daily or weekly jobs with keyword variants and a spend ceiling.

The article is the only required output. Slopify can make a narrated or silent slideshow, an audio-only WAV, locally timed English subtitles, or just the intermediate results you select. Uploaded and already completed outputs are reused when their inputs still match.

Inworld narration

In Settings, add the Base64 credentials from Inworld's API Keys page, then add an Inworld voice ID (for example Dennis, or a voice from your workspace). In Play, choose Realtime TTS-2 or Realtime TTS-2 Flash and that voice.

Short text streams immediately. TTS-2 text over 4,000 characters uses one async job, up to 100,000 characters; Inworld caps On-Demand accounts at 10,000. Audio becomes available once that job finishes. Flash uses streamed parts of at most 4,000 characters. For longer articles, select paragraph chunking. Successful status checks keep long jobs alive, and automatic polling/download retries reuse the accepted job. Pausing stops local requests; Inworld may still finish and bill an accepted job. Resuming after a pause or app restart starts a new request for unfinished narration.

See Inworld's async API for account limits. Both model IDs are bundled; Inworld's LLM catalogue does not list TTS models.

Options

FlagEnvironment variableDefault
--portSLOPIFY_PORT6969
--hostSLOPIFY_HOST127.0.0.1
--data-dirSLOPIFY_DATA_DIR~/.slopify
--projects-dir (Docker only)SLOPIFY_DOCKER_PROJECTS_DIRremembered path; otherwise <Documents>/Slopify/Projects (custom names: <Documents>/Slopify/<container>/Projects); installs from before 3.0 keep ~/Slopify/Projects
--no-openSLOPIFY_NO_OPENthe browser opens
--docker—run locally; with the flag, install or update the Docker version
update—update the running app (it must be running), or the Docker installation if you have one
—SLOPIFY_FFMPEGthe bundled binary

There is no login. Binding to anything but 127.0.0.1 hands the app and every key in it to whoever reaches the port, and the CLI says so on startup.

Native installations keep slopify.db, projects/, staging/ and logs/ under their configured data directory. Docker places only projects in its remembered host folder; keep both that folder and the named private volume when backing up an installation. The portable settings archive is not a project/history backup.

ffmpeg and the GPL

No separate FFmpeg installation is required. The ffmpeg-static dependency downloads a prebuilt binary to node_modules/ffmpeg-static/ at install time. Docker includes the checked binary, licence and source notice in the image, ready on first launch.

Slopify checks that ffmpeg runs before starting. If the install-time download is missing, it downloads the same platform build into <data-dir>/bin/, keeping the licence and source notice beside it. Later launches reuse that copy. If recovery fails, check your connection and antivirus quarantine, or choose your own executable.

That binary is a separate program, run as a child process with an argument array. It is licensed under the GPL-3.0-or-later. Slopify does not link against it, does not embed it, and does not distribute it inside this package; its licence text and the location of its corresponding source ship beside it in ffmpeg-static. Slopify's own code is Apache-2.0 and stays Apache-2.0. Anyone redistributing the downloaded binary takes on the GPL's obligations for it, including offering that corresponding source.

Point SLOPIFY_FFMPEG at your own build to use that instead.

In Windows PowerShell:

$env:SLOPIFY_FFMPEG = 'C:\tools\ffmpeg\bin\ffmpeg.exe'
npx @gentbajko/slopify@latest

Telemetry

Slopify sends anonymous counters to a collector: installs, projects created, stages completed, images and videos made, audio seconds, provider and model names, token counts, and the time each of those happened. Every event carries a random id of its own and this machine's random id, and nothing else.

Never your keys, prompts, keywords, titles, article text, filenames, or anything about your machine. A notice says all of this the first time you run it, before the machine id exists, and the Usage screen shows you your own numbers at any time.

Supporting the project

Slopify is free and always will be. If it is worth something to you, there is Patreon and Buy Me a Coffee. The people who do are listed in SUPPORTERS.md.

Licence

Apache-2.0 (see LICENSE and NOTICE; keep the NOTICE when redistributing). The ffmpeg binary fetched at install time is a separate GPL-3.0-or-later program, as described above.

Source, issues and the full guide: https://github.com/GentBajko/slopify

版本与发布记录

@gentbajko/slopify 共发布 142 个版本,首次发布于 2026/09/03;过去 12 个月发布了 142 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.4.0latest2026/11/133 天前
4.3.52026/11/133 天前
4.3.42026/11/106 天前
4.3.32026/11/106 天前
4.3.22026/11/106 天前
4.3.12026/11/097 天前

关于 @gentbajko/slopify 的常见问题

@gentbajko/slopify 是什么?

Turn a prompt into a finished video, locally, with your own provider keys

如何安装 @gentbajko/slopify?

在项目目录运行 npm install @gentbajko/slopify,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 slopify,可以用 npx slopify 直接运行。

@gentbajko/slopify 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gentbajko__slopify 是否存在。

@gentbajko/slopify 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@gentbajko/slopify 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=26。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gentbajko/slopify 可以商用吗?

@gentbajko/slopify 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@gentbajko/slopify 的下载量有多少?

根据 npm 官方下载统计,@gentbajko/slopify 在 2026/10/16 – 2026/11/14 这 30 天内被下载 6,727 次,日均约 224 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gentbajko/slopify 还在维护吗?

最新版本 4.4.0 发布于 2026/11/13(3 天前);至今共发布 142 个版本,其中过去 12 个月发布了 142 个;首次发布于 2026/09/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。