@jakende/media-info-cli 0.1.2 → 0.1.3

package/README.md

@@ -88,10 +88,19 @@ npm install -g @jakende/media-info-cli
 media-info-cli
 ```
 
-On first run, the npm wrapper creates a Python virtual environment in `~/.media-information-download/venv` and installs the Python dependencies there. To use a different venv location:
+On first run, the npm wrapper creates a Python virtual environment in `~/.media-information-download/venv` and installs the Python dependencies there. Npm installs write generated media and transcripts to `~/.media-information-download/output` by default.
+
+To create a Desktop alias/shortcut to the output folder:
+
+```bash
+media-info-cli --desktop-output-alias
+```
+
+To use a different venv or output location:
 
 ```bash
 MEDIA_INFORMATION_DOWNLOAD_VENV=/path/to/venv media-information-download
+MEDIA_OUTPUT_DIR=/path/to/output media-information-download
 ```
 
 ## TUI

package/bin/media-information-download.js

@@ -10,10 +10,14 @@ const packageRoot = path.resolve(__dirname, "..");
 const venvRoot = process.env.MEDIA_INFORMATION_DOWNLOAD_VENV
   ? path.resolve(process.env.MEDIA_INFORMATION_DOWNLOAD_VENV)
   : path.join(os.homedir(), ".media-information-download", "venv");
+const outputRoot = process.env.MEDIA_OUTPUT_DIR
+  ? path.resolve(process.env.MEDIA_OUTPUT_DIR)
+  : path.join(os.homedir(), ".media-information-download", "output");
 const isWindows = process.platform === "win32";
 const venvPython = isWindows
   ? path.join(venvRoot, "Scripts", "python.exe")
   : path.join(venvRoot, "bin", "python");
+const desktopAliasArgs = new Set(["--desktop-output-alias", "--create-desktop-output-alias"]);
 
 function run(command, args, options = {}) {
   const result = spawnSync(command, args, {
@@ -21,6 +25,7 @@ function run(command, args, options = {}) {
     stdio: options.stdio || "inherit",
     env: {
       ...process.env,
+      MEDIA_OUTPUT_DIR: outputRoot,
       MEDIA_INFORMATION_DOWNLOAD_VENV: venvRoot,
       PYTHONPATH: packageRoot,
     },
@@ -92,11 +97,57 @@ function warnIfFfmpegMissing() {
   }
 }
 
+function splitWrapperArgs(args) {
+  return {
+    createDesktopOutputAlias: args.some((arg) => desktopAliasArgs.has(arg)),
+    appArgs: args.filter((arg) => !desktopAliasArgs.has(arg)),
+  };
+}
+
+function pathToFileUrl(value) {
+  return `file:///${value.replace(/\\/g, "/").replace(/^\/+/, "")}`;
+}
+
+function createDesktopOutputAlias() {
+  const desktopPath = path.join(os.homedir(), "Desktop");
+  const aliasName = "Media Information Download Output";
+  const aliasPath = path.join(desktopPath, aliasName);
+
+  fs.mkdirSync(outputRoot, { recursive: true });
+  fs.mkdirSync(desktopPath, { recursive: true });
+  if (fs.existsSync(aliasPath)) {
+    console.log(`Output alias already exists: ${aliasPath}`);
+    return;
+  }
+
+  if (isWindows) {
+    const command = `mklink /J "${aliasPath}" "${outputRoot}"`;
+    const result = spawnSync("cmd", ["/d", "/s", "/c", command], { stdio: "ignore" });
+    if (result.status === 0) {
+      console.log(`Created output alias: ${aliasPath}`);
+      return;
+    }
+
+    const shortcutPath = `${aliasPath}.url`;
+    fs.writeFileSync(shortcutPath, `[InternetShortcut]\nURL=${pathToFileUrl(outputRoot)}\n`, "utf8");
+    console.log(`Created output shortcut: ${shortcutPath}`);
+    return;
+  }
+
+  fs.symlinkSync(outputRoot, aliasPath, "dir");
+  console.log(`Created output alias: ${aliasPath}`);
+}
+
+const wrapperArgs = splitWrapperArgs(process.argv.slice(2));
+
 ensureVenv();
 ensureDependencies();
 warnIfFfmpegMissing();
+if (wrapperArgs.createDesktopOutputAlias) {
+  createDesktopOutputAlias();
+}
 
-const child = run(venvPython, [path.join(packageRoot, "media_tui.py"), ...process.argv.slice(2)]);
+const child = run(venvPython, [path.join(packageRoot, "media_tui.py"), ...wrapperArgs.appArgs]);
 if (child.signal) {
   process.kill(process.pid, child.signal);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jakende/media-info-cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Terminal app for downloading media from YouTube or RSS feeds, converting to MP3, and generating Whisper transcripts.",
   "license": "UNLICENSED",
   "bin": {

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "media-information-download"
-version = "0.1.2"
+version = "0.1.3"
 description = "Terminal app for downloading media from YouTube or RSS feeds, converting to MP3, and generating Whisper transcripts."
 readme = "README.md"
 requires-python = ">=3.10"