@jakende/media-info-cli 0.1.2 → 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jakob Endemann
+
+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

@@ -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
@@ -192,3 +201,7 @@ All generated audio is saved as `.mp3`. Non-MP3 RSS downloads are converted and
 - `media_information_download/tui.py`: terminal UI and non-interactive CLI entry point
 
 This structure keeps new media sources or formats isolated to source handlers, downloaders, and supported format lists.
+
+## License
+
+MIT. See `LICENSE`.

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,8 +1,8 @@
 {
   "name": "@jakende/media-info-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Terminal app for downloading media from YouTube or RSS feeds, converting to MP3, and generating Whisper transcripts.",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "bin": {
     "media-information-download": "bin/media-information-download.js",
     "media-info-download": "bin/media-information-download.js",
@@ -17,6 +17,7 @@
     "requirements.txt",
     "requirements-transcribe.txt",
     "pyproject.toml",
+    "LICENSE",
     "README.md"
   ],
   "scripts": {

package/pyproject.toml

@@ -4,9 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "media-information-download"
-version = "0.1.2"
+version = "0.1.4"
 description = "Terminal app for downloading media from YouTube or RSS feeds, converting to MP3, and generating Whisper transcripts."
 readme = "README.md"
+license = { text = "MIT" }
 requires-python = ">=3.10"
 dependencies = [
   "yt-dlp>=2024.1.1",