ossclip 0.1.0

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 Muhammad Ahsan Ayaz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Note (not part of the MIT grant above, which covers this repository's own
+code): rendering depends on Remotion, which is source-available under its own
+two-tier licence — see https://github.com/remotion-dev/remotion/blob/main/LICENSE.md.

package/README.md

@@ -0,0 +1,38 @@
+# ossclip
+
+**A local-first CLI that turns a talking-head take into a finished short.** It cuts silence and filler words, writes word-timed kinetic captions, frames on the measured face, and has an LLM plan **code-rendered on-screen graphics** — title cards, stat cards, diagrams, terminal and chat mockups — from what was actually said.
+
+Transcription is local (whisper.cpp), rendering is local (Remotion); the only network calls are the LLM planning ones, on your own key or your existing Claude Code subscription. Vertical 9:16 by default, landscape 16:9 with `--aspect`.
+
+![A produced frame](https://raw.githubusercontent.com/AhsanAyaz/ossclip/main/docs/site/assets/render-example.png)
+
+```sh
+npm install -g ossclip
+ossclip doctor             # checks every prerequisite, prints the exact fix per line
+```
+
+`ossclip doctor` checks Node ≥ 22, `ffmpeg`/`ffprobe`, [whisper.cpp](https://github.com/ggml-org/whisper.cpp) (`whisper-cli`), the transcription model, and an LLM provider — printing the per-platform install command for anything missing.
+
+```sh
+# The whole thing: cut + captions + LLM-planned graphics + cover
+ossclip produce input.mp4 --produce -o out.mp4
+
+# Just the cut and captions — no LLM, no network
+ossclip produce input.mp4 -o out.mp4
+
+# Long-form in, one short out: the strongest ~60s window, chosen by the producer
+ossclip produce podcast.mp4 --produce --clip 60 -o clip.mp4
+
+# Edit what it produced — direct manipulation, in the browser
+ossclip edit "<work directory>"
+```
+
+**Scope, honestly:** ossclip is at its best polishing a take you have already cut down. `--clip` selects a single strongest window from long-form input — one clip, not N.
+
+AI can make mistakes: the cut, the captions and every graphic are generated — review the output before publishing.
+
+**Full documentation, flags, keybinds and the findings log:** [github.com/AhsanAyaz/ossclip](https://github.com/AhsanAyaz/ossclip)
+
+## Licence
+
+MIT. Rendering depends on [Remotion](https://www.remotion.dev/), which is source-available under [its own two-tier licence](https://github.com/remotion-dev/remotion/blob/main/LICENSE.md) — for-profit companies above its stated size need a company licence.

package/bin/ossclip.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// The published entry point (R18 §90b). The CLI — and the Remotion render
+// entry it hands to @remotion/bundler — are TypeScript SOURCES: Remotion
+// bundles the composition from .tsx at render time, so shipping sources is
+// the design, and tsx runs them. tsx is registered here as a library from
+// this package's own dependencies — a plain `#!/usr/bin/env tsx` shebang
+// would demand a GLOBAL tsx, which a fresh `npm i -g ossclip` does not have.
+import { register } from "tsx/esm/api";
+
+register();
+await import("../src/index.ts");