Skip to content
Back to search

mortiflix

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gtkottman--mortiflix-oss/badge.svg)](/listings/gtkottman--mortiflix-oss)

HTML

<a href="/listings/gtkottman--mortiflix-oss"><img src="/api/listings/gtkottman--mortiflix-oss/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> **Tested mostly on Linux so far.** A Windows version is coming in the next two weeks (by October 20, 2026): the > installer is ready, sessions are next ([docs/WINDOWS.md](docs/WINDOWS.md)). macOS should mostly work but hasn't > been tested yet.

You need **Node 20+** and **ffmpeg**. For real videos you also need one of: - [Claude Code](https://claude.com/claude-code), logged in (your plan pays), or - an [Anthropic API key](https://console.anthropic.com/) (you pay per token).

git clone https://github.com/GTKottman/mortiflix-oss.git && cd mortiflix-oss
npm install
npm link                 # puts `mortiflix` on your PATH (or use: node bin/mortiflix)

mortiflix init           # makes the studio folder (~/Mortiflix) and picks a backend it finds
mortiflix setup          # the walkthrough: Claude, narration, music, assets, 3D (asks before installing anything)
mortiflix demo           # a full walk-through with placeholder work: free, no Claude needed

Then either:

**A. In the terminal**

mortiflix new explainer          # asks the brief's questions
mortiflix run                    # sessions run until something waits on you
mortiflix review                 # read the note, answer questions, pin notes, approve or ask for changes
mortiflix run                    # ...and so on until it's delivered

**B. In the browser**

mortiflix serve                  # http://127.0.0.1:4646

The web studio shows what's waiting on you, a live log of what Claude is doing, and the review room: click a frame to pin a note, pause a video to note a moment, comment on a paragraph of the script, answer the session's questions, and approve. Sessions start by themselves while `serve` runs. To use it from another device, run `mortiflix serve --host 0.0.0.0`: you then get a private link with an access token (put it behind HTTPS if it leaves your network).

**C. In Claude Code**

/plugin marketplace add GTKottman/mortiflix-oss
/plugin install mortiflix@mortiflix
/mortiflix

`/mortiflix` walks you through all of it in the conversation. It installs the CLI if you don't have it, then covers setup, the demo, a new video's brief, and running the studio. At each gate it shows you what the session sent, opens the frames and videos, and turns what you say into pinned notes. It reads them back to you before sending. Jump straight to a part with `/mortiflix demo`, `/mortiflix new explainer`, `/mortiflix review`, `/mortiflix status` or `/mortiflix setup`. If another plugin also has a `/mortiflix`, this one is `/mortiflix:mortiflix`.

Your Claude Code conversation is the guide, not the studio. The video is still made by the studio's own sessions, behind the same gates. The guide asks you at every gate and is told never to decide one for you. Keys never go into the chat: you add them with `mortiflix keys` in a terminal, or in Settings › Keys. The guide asks before it installs anything, opens a port or starts paid work. Only read commands are pre-allowed, so your Claude Code permission settings apply to everything else. From a clone, `claude --plugin-dir ./plugin` loads it without installing.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "mortiflix",
  3. "owner": {
  4. "name": "GTKottman"
  5. },
  6. "metadata": {
  7. "description": "Mortiflix, the open-source motion design studio, from inside Claude Code",
  8. "version": "0.1.0"
  9. },
  10. "plugins": [
  11. {
  12. "name": "mortiflix",
  13. "source": "./plugin",
  14. "description": "/mortiflix walks you through Mortiflix in Claude Code: install, setup, a brief, every review gate, delivery.",
  15. "category": "productivity",
  16. "tags": ["video", "motion-design", "kinetograph", "studio"]
  17. }
  18. ]
  19. }
README.md · README · 311 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center"><img src="web/img/mark.png" width="96" alt="Mortiflix"></p>
  2. <h1 align="center">Mortiflix</h1>
  3. <p align="center"><b>A motion design studio on your own machine.</b><br>
  4. Claude makes the video step by step. You approve every stage.</p>
  5. > [!WARNING]
  6. > **Postiz has been removed from Mortiflix.** On October 21, 2026, Railway had a security breach that affects
  7. > sensitive applications like Postiz, the free, open-source publishing service Mortiflix offered. If you set up
  8. > Postiz, revoke its API key in Postiz and check the social accounts you connected to it.
  9. >
  10. > From now on, Mortiflix publishes through **[Upload-Post](https://upload-post.com)** only. You make an account with
  11. > them, and it has a **free plan** ($0/mo, 10 uploads a month), so you can start without paying. See
  12. > [Publishing](#publishing-optional).
  13. > [!IMPORTANT]
  14. > **This is v0.0.1 of Mortiflix UI, the desktop app, and it is expected to have bugs.** Work over the coming month will
  15. > solve those. Please [open an issue](https://github.com/GTKottman/mortiflix-oss/issues) when you hit one.
  16. **[Download Mortiflix UI](https://mortiflix.com/download)** for Windows or Linux. macOS comes later.
  17. <p align="center"><img src="docs/screenshots/motion.png" width="800" alt="Mortiflix UI on the Motion stage"></p>
  18. <p align="center"><a href="https://youtu.be/53bRoQENmSA"><img src="docs/media/how-to-use-mortiflix.gif" width="720" alt="How to use Mortiflix: tap to watch the video"></a><br>
  19. <b>▶ <a href="https://youtu.be/53bRoQENmSA">Watch: How to use Mortiflix</a></b> (3:07). This video was made with Mortiflix.</p>
  20. ---
  21. Most "AI video" tools are one prompt and a slot machine. Mortiflix works like a real motion design studio:
  22. a brief, a script, style frames, a transition board, an animatic, a final, and **you review each stage** before the next one starts.
  23. You pin a note on the exact spot of a frame or the exact moment of a video. The next version answers every note,
  24. one by one, and shows you what changed.
  25. It's built for **one person**: you write the briefs, you review every stage, and the studio runs on your machine.
  26. The work is done by Claude through **your own Claude Code login or your own Anthropic API key**. Mortiflix is
  27. the harness around it: the pipelines, the gates, the review room, and the memory that carries a project across
  28. sessions and days.
  29. ```
  30. brief ──▶ script ──▶ style frames ──▶ animatic ──▶ build ──▶ final ──▶ delivered
  31. ▲ ▲ ▲ ▲ ▲
  32. └── you ───┴──── you ───┴───── you ────┴──────── you ────────┘
  33. approve, pin notes, answer questions (the session stops at every gate)
  34. ```
  35. ## Mortiflix UI
  36. The desktop app (source in [`app/`](app)) takes one project through six stages: Script, Voice & music, Look, Motion,
  37. Sound and Finish. **Assets** shows every file a project made, what each AI call was sent and answered, and how far each
  38. of your settings reaches.
  39. | | |
  40. |---|---|
  41. | ![Create a video](docs/screenshots/new.png) Create a video | ![Script](docs/screenshots/script.png) Script |
  42. | ![Voice & music](docs/screenshots/voice.png) Voice & music | ![Look](docs/screenshots/look.png) Look |
  43. | ![Motion](docs/screenshots/motion.png) Motion | ![Sound](docs/screenshots/sound.png) Sound |
  44. | ![Finish](docs/screenshots/finish.png) Finish | ![Assets](docs/screenshots/assets.png) Assets |
  45. ## Why it's built this way
  46. - **Sessions end at gates.** A Claude session works until it has something for you to review, submits it, writes a
  47. handoff and stops. When you respond, a fresh session picks up from the journal. Waiting on you costs nothing,
  48. for hours or for days.
  49. - **The rules live in code, not in the prompt.** Only you can approve a step you review. A submission is refused if
  50. it doesn't report every error check for its kind of work, or if it doesn't answer each note you left on the last
  51. version. What you reviewed is copied out of the session's reach, so it can't change afterwards.
  52. - **It learns your studio.** When you point out a real mistake, the session proposes a new check ("text never
  53. touches the frame edge"). Approve it once and every future video runs it. Your taste carries across projects in
  54. `TASTE.md`.
  55. - **Pipelines are folders.** A pipeline is a `pipeline.json` (steps, how each is reviewed, the error checks), a
  56. `PIPELINE.md` (the craft), and skills. Anyone can write one: that's the point of open-sourcing it.
  57. ## Quick start
  58. > **Tested mostly on Linux so far.** A Windows version is coming in the next two weeks (by October 20, 2026): the
  59. > installer is ready, sessions are next ([docs/WINDOWS.md](docs/WINDOWS.md)). macOS should mostly work but hasn't
  60. > been tested yet.
  61. You need **Node 20+** and **ffmpeg**. For real videos you also need one of:
  62. - [Claude Code](https://claude.com/claude-code), logged in (your plan pays), or
  63. - an [Anthropic API key](https://console.anthropic.com/) (you pay per token).
  64. ```sh
  65. git clone https://github.com/GTKottman/mortiflix-oss.git && cd mortiflix-oss
  66. npm install
  67. npm link # puts `mortiflix` on your PATH (or use: node bin/mortiflix)
  68. mortiflix init # makes the studio folder (~/Mortiflix) and picks a backend it finds
  69. mortiflix setup # the walkthrough: Claude, narration, music, assets, 3D (asks before installing anything)
  70. mortiflix demo # a full walk-through with placeholder work: free, no Claude needed
  71. ```
  72. Then either:
  73. **A. In the terminal**
  74. ```sh
  75. mortiflix new explainer # asks the brief's questions
  76. mortiflix run # sessions run until something waits on you
  77. mortiflix review # read the note, answer questions, pin notes, approve or ask for changes
  78. mortiflix run # ...and so on until it's delivered
  79. ```
  80. **B. In the browser**
  81. ```sh
  82. mortiflix serve # http://127.0.0.1:4646
  83. ```
  84. The web studio shows what's waiting on you, a live log of what Claude is doing, and the review room: click a frame
  85. to pin a note, pause a video to note a moment, comment on a paragraph of the script, answer the session's questions,
  86. and approve. Sessions start by themselves while `serve` runs. To use it from another device, run
  87. `mortiflix serve --host 0.0.0.0`: you then get a private link with an access token (put it behind HTTPS if it leaves
  88. your network).
  89. **C. In Claude Code**
  90. ```
  91. /plugin marketplace add GTKottman/mortiflix-oss
  92. /plugin install mortiflix@mortiflix
  93. /mortiflix
  94. ```
  95. `/mortiflix` walks you through all of it in the conversation. It installs the CLI if you don't have it, then
  96. covers setup, the demo, a new video's brief, and running the studio. At each gate it shows you what the session
  97. sent, opens the frames and videos, and turns what you say into pinned notes. It reads them back to you before
  98. sending. Jump straight to a part with `/mortiflix demo`, `/mortiflix new explainer`, `/mortiflix review`,
  99. `/mortiflix status` or `/mortiflix setup`. If another plugin also has a `/mortiflix`, this one is
  100. `/mortiflix:mortiflix`.
  101. Your Claude Code conversation is the guide, not the studio. The video is still made by the studio's own sessions,
  102. behind the same gates. The guide asks you at every gate and is told never to decide one for you. Keys
  103. never go into the chat: you add them with `mortiflix keys` in a terminal, or in Settings › Keys. The guide asks
  104. before it installs anything, opens a port or starts paid work. Only read commands are pre-allowed, so your Claude
  105. Code permission settings apply to everything else. From a clone, `claude --plugin-dir ./plugin` loads it
  106. without installing.
  107. ## Backends
  108. | Backend | What runs | Who pays |
  109. |---|---|---|
  110. | `claude-code` | `claude -p` in the project folder, with your login | your Claude plan |
  111. | `anthropic-api` | Mortiflix's own agent loop on the Claude API: a persistent shell, a file editor that can *show* Claude the frames it renders, web search, prompt caching, compaction for long sessions | your API key, per token |
  112. | `demo` | a scripted stand-in that walks every gate with placeholder frames and a test-pattern video | nobody |
  113. Pick one with `mortiflix init --backend …`, `mortiflix config backend …`, or Settings in the web studio.
  114. Each project shows what its Claude work cost: on a Claude plan, what it **would have cost** at API prices (you didn't
  115. pay that); with an API key through Claude Code, about what you spent.
  116. ## Your keys
  117. Mortiflix runs on your own accounts: there's nothing to sign up for. `mortiflix init` asks for your keys, and
  118. `mortiflix keys` changes them any time (Settings › Keys in the web studio does the same):
  119. ```
  120. Anthropic API key only for the anthropic-api backend (Claude Code uses your own login)
  121. ElevenLabs API key only for ElevenLabs narration, sound effects and music
  122. Upload-Post API key only for `mortiflix publish` through Upload-Post (optional; sessions never get it)
  123. Other keys anything a pipeline's tools read from the environment, e.g. GEMINI_API_KEY
  124. ```
  125. Typing is hidden, each key is checked with a free API call before it's saved, and they're written to the studio
  126. folder only (`secrets.json` and `session.env`, mode 600). If a project needs a key you haven't added, it asks
  127. **before it starts** (`mortiflix new`, or the web studio's Start button) instead of failing halfway through.
  128. For scripts: `echo "$KEY" | mortiflix keys set elevenlabs`.
  129. ## What it can make today
  130. | Pipeline | Steps you review | Good for |
  131. |---|---|---|
  132. | `explainer` | brief → script → style frames → transitions → animatic → music → final | 30 s to 2 min explainers, narrated or not, with an original score |
  133. | `social-short` | brief → hook frames → transitions → final | 45 s to 3 min vertical shorts: hook first, works with sound off |
  134. | `logo-sting` | directions → final | a 3–8 s logo animation; the quickest real run |
  135. | `song` | blueprint → final | an instrumental song from a genre and a topic: researched genre, checked score, MIDI, an instrument per channel, a mastered track |
  136. They write the video with Remotion's React API and render it with [Kinetograph](https://github.com/GTKottman/kinetograph)
  137. (native, no Chrome; renders queued through `mfx render`), then check every render with ffmpeg (`qc.mjs`: format, black
  138. or frozen frames, loudness, a frame sheet Claude has to look at). Kinetograph has its own license (PolyForm Small
  139. Business 1.0.0: free for individuals and small businesses, a commercial license above that). Check it for your case.
  140. ## Narration
  141. Pick a voice in **Settings › Narration** (or `mortiflix voice`):
  142. - **ElevenLabs**: connect your key and choose from your voices, the default voices or the Voice Library, with
  143. Eleven v4 by default and every option the API offers (models, stability and similarity, language, text
  144. normalization, pronunciation dictionaries, audio format, data-residency servers), plus sound effects and music
  145. beds. Settings shows your plan, credits, and whether you may use the audio commercially (the free plan doesn't).
  146. - **Your own voice**: you read the script yourself, one short line at a time, in the **recording booth**: in the web
  147. studio (hold Space to record, listen back, keep the best take), in a terminal (`mortiflix record <project>`), or by
  148. importing files you recorded elsewhere (`mortiflix record <project> --import <folder>`). The studio asks for you when
  149. the script is ready and carries on once every line has a kept take.
  150. - **None**: on-screen text and music.
  151. Generated lines are checked by speech to text and retaken if words go missing; word timings drive the animation.
  152. Details: [docs/VOICE.md](docs/VOICE.md).
  153. ## Transitions
  154. Before the animatic, every project gets a **transition board**: for each change from one style frame to the next,
  155. the object or idea on screen that carries it, why the cut happens there, the word it lands on, and real in-between
  156. frames rendered from the two style frames and the chosen transition. Transitions come from the
  157. [remotion-transitions](https://github.com/GTKottman/remotion-transitions) library (installed by setup), or are new
  158. ones inspired by it. The screen never goes blank: no dip to a flat colour, no flash to white. A check reads every
  159. 10% of every transition and fails any frame that does.
  160. ## Setup: music, assets, 3D and the Craft apps
  161. `mortiflix setup` (or **Settings › Setup**) explains each part, why it's needed and what it installs, then asks.
  162. Everything goes into the studio folder, never system-wide. Full details: [docs/SETUP.md](docs/SETUP.md).
  163. - **Music.** One music engine writes songs (the `song` pipeline) and video scores, in stages you can follow:
  164. the genre researched (songs), a blueprint, the score in [Strudel](https://strudel.cc) as notes only, a machine
  165. check (harmony locked to the chart, the intensity curve as planned, every hit within a frame of the picture), the
  166. **MIDI** captured, an **instrument chosen for every channel** and auditioned, then a measured master. Every decision
  167. is written down in a music sheet. For videos, the recommended finish is yours: download the MIDI pack, make the
  168. sound in your own DAW, import your master. [docs/MUSIC.md](docs/MUSIC.md)
  169. - **Assets.** If you have a website you use for assets, list it: sessions search it and download what fits in your
  170. own Chrome, with your own login, through browser-use's [browser-harness](https://github.com/browser-use/browser-harness),
  171. recording every asset's source and licence. Without one, sessions make every visual themselves.
  172. - **3D.** Blender with the studio's toolkits, in its own profile (your Blender setup is never touched): MoBlend
  173. (MoGraph), Camera, Animate, Math, Circuits, Camera Flight for flying the camera yourself (`mortiflix blender`), and
  174. **Nova FX**, Mortiflix's own particle engine (particles, fire, sparks, fireworks), which builds on Linux only for now.
  175. - **Craft apps.** Optional: EffectCraft, PhotoCraft, VectorCraft, LightCraft and seven more, the
  176. open-source (MIT/Apache-2.0) remakes of the Adobe apps by the team behind [ArtCraft](https://github.com/storytold).
  177. `mortiflix craft install` pulls their official builds, checked against each release's SHA256SUMS. Sessions drive
  178. them through each app's own MCP server and hand you files you can open and change (PSD, SVG, comps, edits).
  179. `mortiflix craft register` adds the servers to your own Claude Code too. [docs/SETUP.md](docs/SETUP.md#craft-apps)
  180. ## Publishing (optional)
  181. Once you approve a final, the video is yours to download. If you'd rather post it straight from the studio, Mortiflix
  182. publishes through **[Upload-Post](https://upload-post.com)**. It's a hosted service: you make an account there and
  183. connect your social accounts under a profile. Turn it on in setup (`mortiflix setup publish uploadpost`, or
  184. Settings › Setup) and add its key with `mortiflix keys set uploadpost`.
  185. Upload-Post's **free plan** ($0/mo) is enough to start, and paid plans are there if you need more:
  186. - 10 uploads/mo
  187. - Instagram, LinkedIn, YouTube, Facebook, X, Threads, Pinterest, Bluesky, Google Business + 12 more
  188. - Schedule posts
  189. - Analytics
  190. - 2 profiles
  191. - Video editor API (FFmpeg): 30 min/mo
  192. - AI Shorts Uploader: 10 analyses/mo
  193. Mortiflix used to offer two publishing services. The free, open-source one, Postiz, was removed after the Railway
  194. security breach of October 21, 2026 (see the warning at the top). Upload-Post, the one that needs an account, is the
  195. one we're staying with.
  196. Then:
  197. ```sh
  198. mortiflix publish <project> # where the brief said (TikTok / Reels / Shorts), asks first
  199. mortiflix publish <project> --to linkedin,x --title "…" # somewhere else, with your own caption
  200. mortiflix publish <project> --at 2026-10-20T18:00 --timezone Europe/Madrid # scheduled
  201. mortiflix publish <project> --status # per platform, with the links once they're live
  202. ```
  203. Only you publish: it's a command you run, never something a session can reach (`mfx` has no way to it), and only a
  204. delivered project's approved final goes out. It shows what goes where and asks before sending (`--yes` skips the
  205. question in scripts). Running it again never posts the same video twice (`--again` does, on purpose). `--profile` is the Upload-Post profile your accounts are connected
  206. under; it's remembered after the first time.
  207. Publishing was started by [@mutonby](https://github.com/mutonby) ([#3](https://github.com/GTKottman/mortiflix-oss/pull/3)),
  208. who works on Upload-Post and built it.
  209. ## Make your own pipeline
  210. ```sh
  211. cp -r pipelines/logo-sting ~/Mortiflix/pipelines/my-pipeline # the studio's own pipelines override built-ins
  212. $EDITOR ~/Mortiflix/pipelines/my-pipeline/pipeline.json
  213. mortiflix pipelines # validates it
  214. mortiflix new my-pipeline --backend demo # walk its gates for free
  215. ```
  216. Read **[docs/PIPELINES.md](docs/PIPELINES.md)**. This is where help is most wanted: music videos, product films,
  217. data stories, kinetic type, 3D in Blender, captions for existing footage. If you can describe how a good studio
  218. makes it, it can be a pipeline.
  219. ## How it works
  220. - [OVERVIEW.html](OVERVIEW.html): the whole project on one page, with UML diagrams (download it and open it in a browser)
  221. - [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md): the runner, the bridge (`mfx`), the gates, the session brief, the backends
  222. - [docs/PIPELINES.md](docs/PIPELINES.md): the pipeline format and how to write a good one
  223. - [harness/GATES.md](harness/GATES.md): the protocol every session follows
  224. - [docs/SECURITY.md](docs/SECURITY.md): what a session can and can't reach, and the web server's guards
  225. - [docs/COMPUTE.md](docs/COMPUTE.md): where the tokens, time and disk go, measured on a real project
  226. - [docs/VOICE.md](docs/VOICE.md): narration with ElevenLabs (the only generated voice), your own voice, and every option
  227. - [docs/SETUP.md](docs/SETUP.md): every part of setup, what it installs and where
  228. - [docs/MUSIC.md](docs/MUSIC.md): how the music step writes, checks and renders a score
  229. ## Where it came from
  230. Mortiflix began as a hosted motion design studio, where every video was made stage by stage behind the same kind of
  231. gates, with clients approving each one. This repository is that process, boiled down to one machine and opened up,
  232. so it can be improved by more people than one studio.
  233. Not here yet (from the hosted studio, contributions welcome): workflow
  234. preferences learned from your pins, redo rounds on a delivered video, share links, music in the social-short pipeline,
  235. and more pipelines (codebase explainers, 3D music videos, real estate films).
  236. ## Contributing
  237. See [CONTRIBUTING.md](CONTRIBUTING.md). Tests run in about a second (`npm test`) and never call the network.
  238. ## License
  239. [AGPL-3.0](LICENSE). If you run a modified Mortiflix as a service for others, share your changes.
  240. The bundled fonts (Sora, Unbounded) are under the SIL Open Font License (`web/fonts/`).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.