clip-anything 0.0.0-stage → 0.5.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ship at Midnight
+
+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.

package/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+# clip-anything (npm launcher)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A thin launcher for the [Clip Anything](https://github.com/shreyassaw5394/clip-anything) Python CLI: long gameplay recording in, the top N vertical (9:16) highlight clips out, with a `report.json` that says why each moment was picked. Free, local, open source. Nothing is uploaded.
+
+This package contains no video code. Its only job is to find `uvx` (from [uv](https://docs.astral.sh/uv/)) or `pipx` on your PATH and run `uvx clip-anything <your arguments>`. If neither is installed it prints the install lines and exits.
+
+```
+npx clip-anything gameplay.mp4
+```
+
+Needs:
+
+- `uv` (`curl -LsSf https://astral.sh/uv/install.sh | sh`, or `winget install astral-sh.uv`) or `pipx`
+- `ffmpeg` and `ffprobe` on PATH (`brew install ffmpeg`, `sudo apt install ffmpeg`, `winget install Gyan.FFmpeg`)
+- Python 3.11+ (uv fetches one if needed)
+
+All options, exit codes, the config file and the full documentation live in the main README. If you already have uv, `uvx clip-anything gameplay.mp4` is the same thing with one hop fewer.
+
+Privacy: nothing leaves your computer unless you turn on captions (one-time model download, asks first), a local Ollama model, or cloud AI with your own OpenAI/Anthropic key; no account, no telemetry ([docs/privacy.md](https://github.com/shreyassaw5394/clip-anything/blob/main/docs/privacy.md)).
+A free, non-commercial passion project, provided as is without warranty; clip picks, captions and AI titles can be wrong and you are responsible for the rights to what you process and post ([docs/terms.md](https://github.com/shreyassaw5394/clip-anything/blob/main/docs/terms.md)).
+
+Zero dependencies. MIT. Game names appear only to describe what a recording contains; Clip Anything is not affiliated with or endorsed by any game publisher.

package/bin/clip-anything.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+"use strict";
+// Thin launcher for the clip-anything Python CLI. No dependencies.
+// Order: uvx (uv) -> pipx run -> an installed `clip-anything` on PATH.
+// Spawns with an argument array and no shell, so paths with spaces and
+// Windows both work. Everything else is the Python tool's job.
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const PKG = "clip-anything";
+// Until the PyPI release is live, uvx/pipx pull the tool from the tagged source. Set
+// CLIP_ANYTHING_SOURCE to override (a PyPI spec like "clip-anything==0.6.0", or a git URL).
+const SOURCE =
+  process.env.CLIP_ANYTHING_SOURCE ||
+  "git+https://github.com/shreyassaw5394/clip-anything@v0.5.1";
+const IS_WIN = process.platform === "win32";
+
+function which(cmd) {
+  const dirs = (process.env.PATH || "").split(path.delimiter).filter(Boolean);
+  const exts = IS_WIN
+    ? (process.env.PATHEXT || ".EXE;.CMD;.BAT").split(";").filter(Boolean)
+    : [""];
+  for (const dir of dirs) {
+    for (const ext of exts) {
+      const candidate = path.join(dir, cmd + ext);
+      try {
+        fs.accessSync(candidate, fs.constants.X_OK);
+        if (fs.statSync(candidate).isFile()) return candidate;
+      } catch {
+        /* keep looking */
+      }
+    }
+  }
+  return null;
+}
+
+function run(file, args) {
+  // On Windows a .cmd/.bat shim cannot be spawned without a shell, so only
+  // real executables are used here; uv, pipx and the pip console script are.
+  const result = spawnSync(file, args, { stdio: "inherit", windowsHide: true });
+  if (result.error) {
+    process.stderr.write(`clip-anything: could not start ${file}: ${result.error.message}\n`);
+    return 127;
+  }
+  if (result.signal) {
+    process.kill(process.pid, result.signal);
+    return 128;
+  }
+  return result.status == null ? 1 : result.status;
+}
+
+function uvHint() {
+  return IS_WIN
+    ? '  winget install astral-sh.uv   (or: powershell -c "irm https://astral.sh/uv/install.ps1 | iex")'
+    : "  curl -LsSf https://astral.sh/uv/install.sh | sh   (or: brew install uv)";
+}
+
+function ffmpegHint() {
+  if (process.platform === "darwin") return "  brew install ffmpeg";
+  if (IS_WIN) return "  winget install Gyan.FFmpeg";
+  return "  sudo apt install ffmpeg   (or your distro's package)";
+}
+
+function main(argv) {
+  if (!which("ffmpeg") || !which("ffprobe")) {
+    process.stderr.write(
+      "clip-anything: ffmpeg/ffprobe not found on PATH. The tool needs both. Install:\n" +
+        ffmpegHint() +
+        "\n\n"
+    );
+  }
+
+  const uvx = which("uvx");
+  if (uvx) return run(uvx, ["--from", SOURCE, PKG, ...argv]);
+
+  const pipx = which("pipx");
+  if (pipx) return run(pipx, ["run", "--spec", SOURCE, PKG, ...argv]);
+
+  const installed = which(PKG);
+  if (installed && path.resolve(installed) !== path.resolve(__filename)) {
+    return run(installed, argv);
+  }
+
+  process.stderr.write(
+    [
+      "clip-anything: this npm package is only a launcher for the Python tool,",
+      "and neither `uvx` (uv) nor `pipx` is on your PATH.",
+      "",
+      "Install uv (recommended), then run this command again:",
+      uvHint(),
+      "",
+      "Or install the tool directly with pipx or pip:",
+      "  pipx install clip-anything",
+      "  python3 -m pip install --user clip-anything",
+      "",
+      "ffmpeg is also required:",
+      ffmpegHint(),
+      "",
+      "Project: https://github.com/shreyassaw5394/clip-anything",
+      "",
+    ].join("\n")
+  );
+  return 127;
+}
+
+process.exitCode = main(process.argv.slice(2));

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "clip-anything",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.1",
+  "description": "Thin launcher for the clip-anything Python CLI: long gameplay recording in, top N vertical highlight clips out. Runs uvx clip-anything.",
+  "bin": {
+    "clip-anything": "bin/clip-anything.js"
+  },
+  "files": [
+    "bin/clip-anything.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "keywords": [
+    "video",
+    "clips",
+    "highlights",
+    "shorts",
+    "gameplay",
+    "ffmpeg",
+    "launcher"
+  ],
+  "author": "Shreyas Sawant (https://github.com/shreyassaw5394)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shreyassaw5394/clip-anything.git",
+    "directory": "npm"
+  },
+  "homepage": "https://github.com/shreyassaw5394/clip-anything#readme",
+  "bugs": "https://github.com/shreyassaw5394/clip-anything/issues",
+  "scripts": {
+    "test": "node bin/clip-anything.js --version"
+  }
+}