clip-join 1.0.0 → 1.0.1

package/README.md

@@ -29,34 +29,47 @@ flags, no config, just a clean keyboard-driven flow from folder to finished file
 Optionally, add a **crossfade transition** between clips (press `t` on the arrange screen).
 It's off by default; enabling it re-encodes the output (transitions can't be done losslessly).
 
-Every joined file is written to the **`output/`** folder with a timestamped default
-name (`joined_output_YYYY-MM-DD_HHMMSS.mp4`), so repeated joins never overwrite one another.
+Every joined file is written to a fixed **ClipJoin** folder in your home —
+`~/Movies/ClipJoin` on macOS, `~/Videos/ClipJoin` on Linux/Windows — so `clipjoin`
+saves to the same predictable place no matter which directory you run it from. Files
+get a timestamped default name (`joined_output_YYYY-MM-DD_HHMMSS.mp4`), so repeated
+joins never overwrite one another. Point it elsewhere for a run with `--out`:
+
+```bash
+clipjoin --out ~/Desktop         # write joined videos to ~/Desktop instead
+```
 
 ## Install
 
-The fastest way — one line, and you get a global `clipjoin` command
+Install globally with npm — you get a `clipjoin` command anywhere
 (`clip-join` works too, they're the same thing):
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/BrenoHA/clip-join/main/install.sh | bash
+npm install -g clip-join   # then run: clipjoin
+npx clip-join              # or run once without installing
 ```
 
-The installer checks for Node and ffmpeg (guiding you if either is missing), then
-installs ClipJoin globally. Prefer to do it yourself? Any of these also work:
+**ffmpeg is required** (it bundles `ffprobe`) — install it with your package
+manager if you don't have it:
 
 ```bash
-npm install -g clip-join   # global `clipjoin` (or `clip-join`) command
-npx clip-join              # run once without installing
+brew install ffmpeg        # macOS
+sudo apt install ffmpeg    # Debian/Ubuntu
 ```
 
-**ffmpeg is still required** (it bundles `ffprobe`) — install it with your package
-manager if you don't have it:
+<details>
+<summary>Optional: one-line installer</summary>
+
+Prefer a single command that also checks Node + ffmpeg for you and fixes PATH?
 
 ```bash
-brew install ffmpeg        # macOS
-sudo apt install ffmpeg    # Debian/Ubuntu
+curl -fsSL https://raw.githubusercontent.com/BrenoHA/clip-join/main/install.sh | bash
 ```
 
+It just wraps `npm install -g clip-join` with a few pre-flight checks.
+
+</details>
+
 ## Requirements
 
 - **Node.js 18+**
@@ -105,7 +118,7 @@ total duration, size, and whether the join will be lossless):
 | `↑ ↓`             | Move the cursor                               |
 | `space` / `Enter` | Toggle a clip in/out of the join              |
 | `Shift+↑ ↓`       | Reorder the selected clip                     |
-| `o`               | Rename the output file (saved into `output/`) |
+| `o`               | Rename the output file (saved to the ClipJoin folder) |
 | `t`               | Toggle the transition (None / Crossfade)      |
 | `j`               | **▶ Start the join**                          |
 | `esc`             | Back to the browser                           |
@@ -165,8 +178,8 @@ conventions, and the PR process.
   slightly different per-clip encoding perfectly. If playback looks off, the clips likely
   need re-encoding (ClipJoin falls back automatically when stream copy fails).
 - **Original files are never modified or deleted.**
-- Output names are always confined to `output/` (a path typed into the rename field is
-  reduced to its basename).
+- Output names are always confined to the output folder (a path typed into the rename
+  field is reduced to its basename); use `--out <dir>` to change the folder itself.
 
 ## License
 

package/dist/config.js

@@ -1,3 +1,4 @@
+import os from "node:os";
 import path from "node:path";
 export const DEFAULT_EXTS = ["mp4", "mov", "m4v", "avi", "mkv"];
 /**
@@ -11,8 +12,27 @@ export const TRANSITIONS = [
     { id: "none", label: "None" },
     { id: "crossfade", label: "Crossfade", xfade: "fade" },
 ];
-/** Every joined video is written here, relative to where ClipJoin is launched. */
-export const OUTPUT_DIR = path.resolve(process.cwd(), "output");
+/**
+ * Default home for joined videos: a fixed, always-writable folder under the
+ * user's home so `clipjoin` behaves identically from any directory (rather than
+ * scattering `output/` folders wherever it happens to be launched).
+ *   macOS → ~/Movies/ClipJoin   ·   Linux/Windows → ~/Videos/ClipJoin
+ */
+export function defaultOutputDir() {
+    const parent = process.platform === "darwin" ? "Movies" : "Videos";
+    return path.join(os.homedir(), parent, "ClipJoin");
+}
+// The active output directory. Defaults per-platform; overridden at startup by
+// the `--out <dir>` flag via setOutputDir().
+let outputDir = defaultOutputDir();
+/** Absolute directory every joined video (and its chapters file) is written to. */
+export function getOutputDir() {
+    return outputDir;
+}
+/** Point output at a specific directory (from `--out`). Resolved to absolute. */
+export function setOutputDir(dir) {
+    outputDir = path.resolve(dir);
+}
 export const REENCODE_CRF = 18;
 export const REENCODE_PRESET = "veryfast";
 /**

package/dist/core/output.js

@@ -1,21 +1,21 @@
 import { promises as fs } from "node:fs";
 import path from "node:path";
-import { OUTPUT_DIR, defaultOutputName } from "../config.js";
+import { getOutputDir, defaultOutputName } from "../config.js";
 import { humanClock } from "./format.js";
 /**
- * Resolve a user-supplied name to an absolute path inside OUTPUT_DIR. Only the
- * basename is honored, so "../evil.mp4" or an absolute path can't escape output/.
+ * Resolve a user-supplied name to an absolute path inside the output dir. Only
+ * the basename is honored, so "../evil.mp4" or an absolute path can't escape it.
  */
 export function resolveOutputPath(name) {
     let base = path.basename(name.trim());
     // basename() strips separators; "." / ".." would still resolve to or above
-    // OUTPUT_DIR, so fall back to the default for those (and for an empty name).
+    // the output dir, so fall back to the default for those (and for an empty name).
     if (!base || base === "." || base === "..")
         base = defaultOutputName();
-    return path.join(OUTPUT_DIR, base);
+    return path.join(getOutputDir(), base);
 }
 export async function ensureOutputDir() {
-    await fs.mkdir(OUTPUT_DIR, { recursive: true });
+    await fs.mkdir(getOutputDir(), { recursive: true });
 }
 /** Build the line-per-chapter text content for the given (included) clips. */
 function buildChaptersContent(clips) {

package/dist/index.js

@@ -2,6 +2,24 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { render } from "ink";
 import { App } from "./ui/App.js";
-const folderArg = process.argv[2];
+import { setOutputDir } from "./config.js";
+// Minimal arg parsing: one optional positional (start folder) plus `--out <dir>`
+// (aliases: `-o`, `--out=<dir>`) to redirect where joined videos are written.
+let folderArg;
+const argv = process.argv.slice(2);
+for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--out" || arg === "-o") {
+        const dir = argv[++i];
+        if (dir)
+            setOutputDir(dir);
+    }
+    else if (arg.startsWith("--out=")) {
+        setOutputDir(arg.slice("--out=".length));
+    }
+    else if (!arg.startsWith("-") && folderArg === undefined) {
+        folderArg = arg;
+    }
+}
 const { waitUntilExit } = render(_jsx(App, { initialFolder: folderArg }));
 await waitUntilExit();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clip-join",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "ClipJoin — an interactive terminal UI for joining videos into one file.",
   "type": "module",
   "license": "MIT",