screenshot-beautify 1.0.0

package/README.md

@@ -0,0 +1,102 @@
+# screenshot-beautify
+
+A CLI tool to beautify screenshots with macOS-style window frames, shadows, and gradient backgrounds.
+
+## Installation
+
+```bash
+npm install -g screenshot-beautify
+```
+
+## Usage
+
+### Single File
+
+```bash
+screenshot-beautify image.png
+screenshot-beautify image.png --preset sunset
+screenshot-beautify image.png --background ~/Pictures/wallpaper.jpg
+screenshot-beautify image.png -o output.png --padding 100
+```
+
+### Watch Mode
+
+Automatically beautify screenshots as they're added to a directory:
+
+```bash
+screenshot-beautify watch ~/Desktop ~/Desktop/beautified --preset ocean
+```
+
+### System Tray Mode (macOS)
+
+Run in the background with a menu bar icon:
+
+```bash
+screenshot-beautify tray ~/Desktop ~/Desktop/beautified --preset sunset
+```
+
+The tray icon lets you:
+- See status and processed count
+- Start/Stop watching
+- Open output folder
+- Quit the app
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--preset <name>` | Use a built-in gradient preset |
+| `--background <path>` | Use a custom image as background |
+| `--padding <number>` | Padding around screenshot (default: 80) |
+| `-o, --output <path>` | Output file path |
+| `--delete-original` | Delete original after beautifying |
+| `--foreground` | Run tray in foreground (for debugging) |
+
+## Presets
+
+List available presets:
+
+```bash
+screenshot-beautify presets
+```
+
+**Available presets:**
+
+| Category | Presets |
+|----------|---------|
+| Warm | `sunset`, `sunrise`, `peach` |
+| Cool | `ocean`, `sky`, `northern` |
+| Dark | `charcoal`, `midnight`, `space` |
+| Vibrant | `neon`, `fire`, `aurora` |
+| Soft | `lavender`, `mint`, `rose` |
+
+## Examples
+
+```bash
+# Basic usage
+screenshot-beautify screenshot.png
+
+# With sunset gradient
+screenshot-beautify screenshot.png --preset sunset
+
+# Watch Desktop and save to a subfolder
+screenshot-beautify watch ~/Desktop ~/Desktop/beautified --preset ocean
+
+# Run in system tray with custom wallpaper background
+screenshot-beautify tray ~/Desktop ~/Desktop/beautified --background ~/wallpaper.jpg
+
+# Custom padding
+screenshot-beautify screenshot.png --padding 120 --preset midnight
+```
+
+## Output
+
+The tool adds:
+- macOS-style window frame with traffic light buttons
+- Rounded corners
+- Drop shadow
+- Gradient or custom image background
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,647 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/beautify.ts
+import sharp5 from "sharp";
+
+// src/background.ts
+import sharp2 from "sharp";
+
+// src/presets.ts
+import sharp from "sharp";
+var GRADIENT_PRESETS = {
+  // Warm tones
+  sunset: {
+    name: "Sunset",
+    colors: ["#ff9a9e", "#fecfef", "#fecfef", "#fad0c4"],
+    angle: 135
+  },
+  sunrise: {
+    name: "Sunrise",
+    colors: ["#f093fb", "#f5576c"],
+    angle: 135
+  },
+  peach: {
+    name: "Peach",
+    colors: ["#ffecd2", "#fcb69f"],
+    angle: 135
+  },
+  // Cool tones
+  ocean: {
+    name: "Ocean",
+    colors: ["#667eea", "#764ba2"],
+    angle: 135
+  },
+  sky: {
+    name: "Sky",
+    colors: ["#a1c4fd", "#c2e9fb"],
+    angle: 135
+  },
+  northern: {
+    name: "Northern Lights",
+    colors: ["#43e97b", "#38f9d7"],
+    angle: 135
+  },
+  // Dark tones
+  charcoal: {
+    name: "Charcoal",
+    colors: ["#2d3436", "#636e72"],
+    angle: 135
+  },
+  midnight: {
+    name: "Midnight",
+    colors: ["#232526", "#414345"],
+    angle: 135
+  },
+  space: {
+    name: "Space",
+    colors: ["#0f0c29", "#302b63", "#24243e"],
+    angle: 135
+  },
+  // Vibrant
+  neon: {
+    name: "Neon",
+    colors: ["#fc00ff", "#00dbde"],
+    angle: 135
+  },
+  fire: {
+    name: "Fire",
+    colors: ["#f12711", "#f5af19"],
+    angle: 135
+  },
+  aurora: {
+    name: "Aurora",
+    colors: ["#00c6fb", "#005bea"],
+    angle: 135
+  },
+  // Soft/Muted
+  lavender: {
+    name: "Lavender",
+    colors: ["#e0c3fc", "#8ec5fc"],
+    angle: 135
+  },
+  mint: {
+    name: "Mint",
+    colors: ["#d4fc79", "#96e6a1"],
+    angle: 135
+  },
+  rose: {
+    name: "Rose",
+    colors: ["#eecda3", "#ef629f"],
+    angle: 135
+  }
+};
+function listPresets() {
+  return Object.keys(GRADIENT_PRESETS);
+}
+async function createPresetBackground(presetName, width, height) {
+  const preset = GRADIENT_PRESETS[presetName];
+  if (!preset) {
+    throw new Error(`Unknown preset: ${presetName}. Available: ${listPresets().join(", ")}`);
+  }
+  const { colors, angle = 135 } = preset;
+  const angleRad = angle * Math.PI / 180;
+  const x1 = Math.round(50 - Math.cos(angleRad) * 50);
+  const y1 = Math.round(50 - Math.sin(angleRad) * 50);
+  const x2 = Math.round(50 + Math.cos(angleRad) * 50);
+  const y2 = Math.round(50 + Math.sin(angleRad) * 50);
+  const stops = colors.map((color, i) => {
+    const offset = i / (colors.length - 1) * 100;
+    return `<stop offset="${offset}%" style="stop-color:${color};stop-opacity:1" />`;
+  }).join("\n          ");
+  const svg = `
+    <svg width="${width}" height="${height}" xmlns="http://www.w3.org/2000/svg">
+      <defs>
+        <linearGradient id="grad" x1="${x1}%" y1="${y1}%" x2="${x2}%" y2="${y2}%">
+          ${stops}
+        </linearGradient>
+      </defs>
+      <rect width="100%" height="100%" fill="url(#grad)" />
+    </svg>
+  `;
+  return sharp(Buffer.from(svg)).png().toBuffer();
+}
+
+// src/background.ts
+async function createBackground(options) {
+  const {
+    width,
+    height,
+    imagePath,
+    preset,
+    // Dark charcoal gradient as default
+    gradientStart = "#2d3436",
+    gradientEnd = "#636e72"
+  } = options;
+  if (imagePath) {
+    return sharp2(imagePath).resize(width, height, {
+      fit: "cover",
+      position: "center"
+    }).png().toBuffer();
+  }
+  if (preset && GRADIENT_PRESETS[preset]) {
+    return createPresetBackground(preset, width, height);
+  }
+  const svg = `
+    <svg width="${width}" height="${height}" xmlns="http://www.w3.org/2000/svg">
+      <defs>
+        <linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="100%">
+          <stop offset="0%" style="stop-color:${gradientStart};stop-opacity:1" />
+          <stop offset="100%" style="stop-color:${gradientEnd};stop-opacity:1" />
+        </linearGradient>
+      </defs>
+      <rect width="100%" height="100%" fill="url(#grad)" />
+    </svg>
+  `;
+  return sharp2(Buffer.from(svg)).png().toBuffer();
+}
+
+// src/frame.ts
+import sharp3 from "sharp";
+async function createFrame(options) {
+  const {
+    width,
+    height,
+    titleBarHeight = 32,
+    cornerRadius = 10,
+    buttonSize = 12
+  } = options;
+  const buttonY = titleBarHeight / 2;
+  const buttonSpacing = 20;
+  const firstButtonX = 16;
+  const closeColor = "#FF5F56";
+  const minimizeColor = "#FFBD2E";
+  const maximizeColor = "#27C93F";
+  const svg = `
+    <svg width="${width}" height="${height}" xmlns="http://www.w3.org/2000/svg">
+      <defs>
+        <clipPath id="roundedCorners">
+          <rect x="0" y="0" width="${width}" height="${height}" rx="${cornerRadius}" ry="${cornerRadius}" />
+        </clipPath>
+      </defs>
+
+      <!-- Window background with rounded corners -->
+      <rect x="0" y="0" width="${width}" height="${height}" rx="${cornerRadius}" ry="${cornerRadius}" fill="#FFFFFF" />
+
+      <!-- Title bar -->
+      <rect x="0" y="0" width="${width}" height="${titleBarHeight}" rx="${cornerRadius}" ry="${cornerRadius}" fill="#E8E8E8" />
+      <!-- Fill bottom corners of title bar -->
+      <rect x="0" y="${cornerRadius}" width="${width}" height="${titleBarHeight - cornerRadius}" fill="#E8E8E8" />
+
+      <!-- Window buttons -->
+      <circle cx="${firstButtonX}" cy="${buttonY}" r="${buttonSize / 2}" fill="${closeColor}" />
+      <circle cx="${firstButtonX + buttonSpacing}" cy="${buttonY}" r="${buttonSize / 2}" fill="${minimizeColor}" />
+      <circle cx="${firstButtonX + buttonSpacing * 2}" cy="${buttonY}" r="${buttonSize / 2}" fill="${maximizeColor}" />
+    </svg>
+  `;
+  return sharp3(Buffer.from(svg)).png().toBuffer();
+}
+
+// src/shadow.ts
+import sharp4 from "sharp";
+async function createShadow(options) {
+  const {
+    width,
+    height,
+    blur = 30,
+    opacity = 0.5,
+    cornerRadius = 10
+  } = options;
+  const shadowWidth = width + blur;
+  const shadowHeight = height + blur;
+  const offsetForSize = blur / 2;
+  const svg = `
+    <svg width="${shadowWidth}" height="${shadowHeight}" xmlns="http://www.w3.org/2000/svg">
+      <rect
+        x="${offsetForSize}"
+        y="${offsetForSize}"
+        width="${width}"
+        height="${height}"
+        rx="${cornerRadius}"
+        ry="${cornerRadius}"
+        fill="rgba(0, 0, 0, ${opacity})"
+      />
+    </svg>
+  `;
+  return sharp4(Buffer.from(svg)).blur(blur).png().toBuffer();
+}
+
+// src/beautify.ts
+async function beautify(inputPath, outputPath, options = {}) {
+  const {
+    padding = 80,
+    cornerRadius = 10,
+    titleBarHeight = 32,
+    shadowBlur = 30,
+    shadowOffsetX = 0,
+    shadowOffsetY = 20,
+    backgroundImage,
+    backgroundPreset,
+    gradientStart = "#2d3436",
+    gradientEnd = "#636e72"
+  } = options;
+  const inputImage = sharp5(inputPath);
+  const metadata = await inputImage.metadata();
+  if (!metadata.width || !metadata.height) {
+    throw new Error("Could not determine image dimensions");
+  }
+  const imgWidth = metadata.width;
+  const imgHeight = metadata.height;
+  const framedWidth = imgWidth;
+  const framedHeight = imgHeight + titleBarHeight;
+  const totalWidth = framedWidth + padding * 2;
+  const totalHeight = framedHeight + padding * 2;
+  const shadowPadding = shadowBlur * 2 + Math.abs(shadowOffsetY);
+  const canvasWidth = totalWidth + shadowPadding;
+  const canvasHeight = totalHeight + shadowPadding;
+  const background = await createBackground({
+    width: canvasWidth,
+    height: canvasHeight,
+    imagePath: backgroundImage,
+    preset: backgroundPreset,
+    gradientStart,
+    gradientEnd
+  });
+  const frame = await createFrame({
+    width: framedWidth,
+    height: framedHeight,
+    titleBarHeight,
+    cornerRadius
+  });
+  const shadow = await createShadow({
+    width: framedWidth,
+    height: framedHeight,
+    blur: shadowBlur,
+    cornerRadius
+  });
+  const frameX = padding + shadowPadding / 2;
+  const frameY = padding + shadowPadding / 2;
+  const shadowX = frameX + shadowOffsetX - shadowBlur / 2;
+  const shadowY = frameY + shadowOffsetY - shadowBlur / 2;
+  const screenshotX = frameX;
+  const screenshotY = frameY + titleBarHeight;
+  const cornerMask = Buffer.from(`
+    <svg width="${imgWidth}" height="${imgHeight}" xmlns="http://www.w3.org/2000/svg">
+      <rect
+        x="0"
+        y="0"
+        width="${imgWidth}"
+        height="${imgHeight}"
+        rx="${cornerRadius}"
+        ry="${cornerRadius}"
+        fill="white"
+      />
+      <!-- Fill top corners to make them square (only bottom should be rounded) -->
+      <rect x="0" y="0" width="${cornerRadius}" height="${cornerRadius}" fill="white"/>
+      <rect x="${imgWidth - cornerRadius}" y="0" width="${cornerRadius}" height="${cornerRadius}" fill="white"/>
+    </svg>
+  `);
+  const roundedScreenshot = await sharp5(inputPath).ensureAlpha().composite([
+    {
+      input: await sharp5(cornerMask).png().toBuffer(),
+      blend: "dest-in"
+    }
+  ]).png().toBuffer();
+  await sharp5(background).composite([
+    // Shadow layer
+    {
+      input: shadow,
+      left: Math.round(shadowX),
+      top: Math.round(shadowY)
+    },
+    // Window frame
+    {
+      input: frame,
+      left: Math.round(frameX),
+      top: Math.round(frameY)
+    },
+    // Screenshot
+    {
+      input: roundedScreenshot,
+      left: Math.round(screenshotX),
+      top: Math.round(screenshotY)
+    }
+  ]).png().toFile(outputPath);
+}
+
+// src/tray.ts
+import { createRequire } from "module";
+import chokidar from "chokidar";
+import { resolve, basename, extname, join } from "path";
+import { existsSync, mkdirSync } from "fs";
+import { exec } from "child_process";
+var require2 = createRequire(import.meta.url);
+var SysTray = require2("systray2").default;
+var IMAGE_EXTENSIONS = [".png", ".jpg", ".jpeg", ".webp", ".gif"];
+function isImageFile(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  return IMAGE_EXTENSIONS.includes(ext);
+}
+function isAlreadyBeautified(filePath) {
+  return basename(filePath).includes("_beautified");
+}
+var ICON_BASE64 = `iVBORw0KGgoAAAANSUhEUgAAABYAAAAWCAYAAADEtGw7AAAACXBIWXMAAAsTAAALEwEAmpwYAAAA6UlEQVR4nO2TywmDQBCG7UkF7SAhJ7UD12JUxEcP7lW0hpAifJySnLQG/YMDOYQVkTWEQPLBD8ssfMwMu4ryZw0AF7xyVt4BFvg+MYATgDvkuQE4Lolv2M910/hPmqZBnufgnKOua6yxSTxNE9I0ha7rUFWVomkafN+nO2lxURQki6IIwzBQwjCkWlmW8mLLsuB5njAFYwy2bcuLDcNAkiRCPY5jmKa5r2PGmNCx67pwHEdezDmnfc577fueEgQB1aqqkheP4yi8ivmcZdmidLP4Sdu21P2cruuwxkd/3nGn/ArgIIiVn+cBsJOTNPMb6GYAAAAASUVORK5CYII=`;
+var watcher = null;
+var processedCount = 0;
+var systray = null;
+var trayReady = false;
+var config;
+async function processFile(filePath) {
+  if (!isImageFile(filePath) || isAlreadyBeautified(filePath)) {
+    return;
+  }
+  const fileName = basename(filePath, extname(filePath));
+  const beautifiedPath = join(config.outputPath, `${fileName}_beautified.png`);
+  try {
+    await beautify(filePath, beautifiedPath, {
+      padding: config.padding || 80,
+      backgroundImage: config.backgroundImage,
+      backgroundPreset: config.backgroundPreset
+    });
+    processedCount++;
+    updateMenu();
+    if (config.deleteOriginal) {
+      const { unlink } = await import("fs/promises");
+      await unlink(filePath);
+    }
+  } catch {
+  }
+}
+function startWatching() {
+  if (watcher) {
+    return;
+  }
+  watcher = chokidar.watch(config.sourcePath, {
+    ignored: /(^|[\/\\])\../,
+    persistent: true,
+    ignoreInitial: true,
+    awaitWriteFinish: {
+      stabilityThreshold: 500,
+      pollInterval: 100
+    }
+  });
+  watcher.on("ready", () => {
+    updateMenu();
+  });
+  watcher.on("add", processFile);
+  watcher.on("error", () => {
+  });
+}
+function stopWatching() {
+  if (watcher) {
+    watcher.close();
+    watcher = null;
+    updateMenu();
+  }
+}
+function openOutputFolder() {
+  const cmd = process.platform === "darwin" ? `open "${config.outputPath}"` : process.platform === "win32" ? `explorer "${config.outputPath}"` : `xdg-open "${config.outputPath}"`;
+  exec(cmd);
+}
+function updateMenu() {
+  if (!systray || !trayReady) return;
+  const isWatching = watcher !== null;
+  try {
+    systray.sendAction({
+      type: "update-item",
+      item: {
+        title: isWatching ? `\u2713 Watching (${processedCount} processed)` : "\u25CB Not watching",
+        enabled: false
+      },
+      seq_id: 0
+    });
+    systray.sendAction({
+      type: "update-item",
+      item: {
+        title: isWatching ? "Stop Watching" : "Start Watching",
+        enabled: true
+      },
+      seq_id: 1
+    });
+  } catch {
+  }
+}
+async function createTray() {
+  systray = new SysTray({
+    menu: {
+      icon: ICON_BASE64,
+      title: "",
+      tooltip: "Screenshot Beautify",
+      items: [
+        {
+          title: "\u25CB Not watching",
+          enabled: false
+        },
+        {
+          title: "Start Watching",
+          enabled: true
+        },
+        {
+          title: "Open Output Folder",
+          enabled: true
+        },
+        SysTray.separator,
+        {
+          title: "Quit",
+          enabled: true
+        }
+      ]
+    },
+    debug: false,
+    copyDir: true
+  });
+  await systray.ready();
+  trayReady = true;
+  systray.onClick((action) => {
+    switch (action.seq_id) {
+      case 1:
+        if (watcher) {
+          stopWatching();
+        } else {
+          startWatching();
+        }
+        break;
+      case 2:
+        openOutputFolder();
+        break;
+      case 4:
+        stopWatching();
+        systray?.kill(false);
+        process.exit(0);
+        break;
+    }
+  });
+  startWatching();
+}
+async function startTray(options) {
+  config = {
+    sourcePath: resolve(options.sourcePath),
+    outputPath: resolve(options.outputPath),
+    padding: options.padding || 80,
+    backgroundImage: options.backgroundImage,
+    backgroundPreset: options.backgroundPreset,
+    deleteOriginal: options.deleteOriginal || false
+  };
+  if (!existsSync(config.sourcePath)) {
+    console.error(`Source directory does not exist: ${config.sourcePath}`);
+    process.exit(1);
+  }
+  if (!existsSync(config.outputPath)) {
+    mkdirSync(config.outputPath, { recursive: true });
+  }
+  await createTray();
+}
+
+// src/index.ts
+import { resolve as resolve2, basename as basename2, dirname, extname as extname2, join as join2 } from "path";
+import chokidar2 from "chokidar";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2 } from "fs";
+var IMAGE_EXTENSIONS2 = [".png", ".jpg", ".jpeg", ".webp", ".gif"];
+function isImageFile2(filePath) {
+  const ext = extname2(filePath).toLowerCase();
+  return IMAGE_EXTENSIONS2.includes(ext);
+}
+function isAlreadyBeautified2(filePath) {
+  return basename2(filePath).includes("_beautified");
+}
+var program = new Command();
+program.name("screenshot-beautify").description("Beautify screenshots with window frames, backgrounds, and shadows").version("1.0.0");
+program.command("presets").description("List available background presets").action(() => {
+  console.log("Available background presets:\n");
+  const presets = listPresets();
+  presets.forEach((name) => {
+    console.log(`  - ${name}`);
+  });
+  console.log("\nUsage: screenshot-beautify <input> --preset sunset");
+});
+program.command("watch <source> <output>").description("Watch a directory and auto-beautify new screenshots").option("--padding <number>", "Padding around the screenshot", "80").option("--background <path>", "Background image path").option("--preset <name>", "Background preset (run 'presets' to see options)").option("--delete-original", "Delete original file after beautifying", false).action(async (source, output, opts) => {
+  try {
+    const sourcePath = resolve2(source);
+    const outputPath = resolve2(output);
+    const padding = parseInt(opts.padding, 10);
+    const backgroundImage = opts.background ? resolve2(opts.background) : void 0;
+    const backgroundPreset = opts.preset;
+    if (!existsSync2(sourcePath)) {
+      console.error(`Source directory does not exist: ${sourcePath}`);
+      process.exit(1);
+    }
+    if (!existsSync2(outputPath)) {
+      mkdirSync2(outputPath, { recursive: true });
+      console.log(`Created output directory: ${outputPath}`);
+    }
+    console.log(`
+\u{1F50D} Watching for screenshots in: ${sourcePath}`);
+    console.log(`\u{1F4C1} Beautified screenshots will be saved to: ${outputPath}`);
+    console.log(`\u2699\uFE0F  Options: padding=${padding}${backgroundPreset ? `, preset=${backgroundPreset}` : ""}${backgroundImage ? `, background=${backgroundImage}` : ""}${opts.deleteOriginal ? ", delete-original=true" : ""}`);
+    console.log(`
+\u2705 File watcher is now running...`);
+    console.log(`   Press Ctrl+C to stop
+`);
+    const watcher2 = chokidar2.watch(sourcePath, {
+      ignored: /(^|[\/\\])\../,
+      persistent: true,
+      ignoreInitial: true,
+      awaitWriteFinish: {
+        stabilityThreshold: 500,
+        pollInterval: 100
+      }
+    });
+    const timestamp = () => (/* @__PURE__ */ new Date()).toLocaleTimeString();
+    const processFile2 = async (filePath) => {
+      if (!isImageFile2(filePath) || isAlreadyBeautified2(filePath)) {
+        return;
+      }
+      const fileName = basename2(filePath, extname2(filePath));
+      const beautifiedPath = join2(outputPath, `${fileName}_beautified.png`);
+      try {
+        console.log(`[${timestamp()}] \u{1F4F8} New screenshot detected: ${basename2(filePath)}`);
+        await beautify(filePath, beautifiedPath, { padding, backgroundImage, backgroundPreset });
+        console.log(`[${timestamp()}] \u2728 Beautified: ${basename2(beautifiedPath)}`);
+        if (opts.deleteOriginal) {
+          const { unlink } = await import("fs/promises");
+          await unlink(filePath);
+          console.log(`[${timestamp()}] \u{1F5D1}\uFE0F  Deleted original: ${basename2(filePath)}`);
+        }
+      } catch (err) {
+        console.error(`[${timestamp()}] \u274C Failed to beautify ${basename2(filePath)}:`, err instanceof Error ? err.message : err);
+      }
+    };
+    watcher2.on("ready", () => {
+      console.log(`[${timestamp()}] \u{1F440} Watching for new files...
+`);
+    });
+    watcher2.on("add", processFile2);
+    watcher2.on("error", (error) => {
+      console.error(`[${timestamp()}] \u274C Watcher error:`, error);
+    });
+    process.on("SIGINT", () => {
+      console.log("\n\u{1F6D1} Stopping watcher...");
+      watcher2.close();
+      process.exit(0);
+    });
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+program.command("tray <source> <output>").description("Run as a system tray app with auto-beautify").option("--padding <number>", "Padding around the screenshot", "80").option("--background <path>", "Background image path").option("--preset <name>", "Background preset (run 'presets' to see options)").option("--delete-original", "Delete original file after beautifying", false).option("--foreground", "Run in foreground (don't detach)", false).option("--_daemon", "Internal: running as daemon", false).action(async (source, output, opts) => {
+  const padding = parseInt(opts.padding, 10);
+  const backgroundImage = opts.background ? resolve2(opts.background) : void 0;
+  const backgroundPreset = opts.preset;
+  if (!opts._daemon && !opts.foreground) {
+    const { spawn } = await import("child_process");
+    const args = [
+      process.argv[1],
+      "tray",
+      source,
+      output,
+      "--padding",
+      opts.padding,
+      "--_daemon"
+    ];
+    if (backgroundImage) args.push("--background", backgroundImage);
+    if (backgroundPreset) args.push("--preset", backgroundPreset);
+    if (opts.deleteOriginal) args.push("--delete-original");
+    const child = spawn(process.execPath, args, {
+      detached: true,
+      stdio: "ignore",
+      env: process.env
+    });
+    child.unref();
+    console.log("\u{1F4F7} Screenshot Beautify started in system tray");
+    console.log(`   Watching: ${resolve2(source)}`);
+    console.log(`   Output: ${resolve2(output)}`);
+    console.log("\nThe app is now running in the background.");
+    console.log("Click the tray icon to control it, or use 'Quit' to stop.");
+    process.exit(0);
+  }
+  await startTray({
+    sourcePath: source,
+    outputPath: output,
+    padding,
+    backgroundImage,
+    backgroundPreset,
+    deleteOriginal: opts.deleteOriginal
+  });
+});
+program.command("file <input>", { isDefault: true }).description("Beautify a single screenshot").option("-o, --output <path>", "Output file path").option("--padding <number>", "Padding around the screenshot", "80").option("--background <path>", "Background image path").option("--preset <name>", "Background preset (run 'presets' to see options)").action(async (input, opts) => {
+  try {
+    const inputPath = resolve2(input);
+    const padding = parseInt(opts.padding || "80", 10);
+    const backgroundImage = opts.background ? resolve2(opts.background) : void 0;
+    const backgroundPreset = opts.preset;
+    const outputPath = opts.output ? resolve2(opts.output) : join2(
+      dirname(inputPath),
+      `${basename2(inputPath, extname2(inputPath))}_beautified.png`
+    );
+    console.log(`Beautifying: ${inputPath}`);
+    await beautify(inputPath, outputPath, { padding, backgroundImage, backgroundPreset });
+    console.log(`Saved to: ${outputPath}`);
+  } catch (error) {
+    console.error("Error:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+program.parse();

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "screenshot-beautify",
+  "version": "1.0.0",
+  "description": "CLI tool to beautify screenshots with window frames, backgrounds, and shadows",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "screenshot-beautify": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "screenshot",
+    "beautify",
+    "cli",
+    "image",
+    "frame",
+    "shadow"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chokidar": "^5.0.0",
+    "commander": "^12.1.0",
+    "sharp": "^0.33.5",
+    "systray2": "^2.1.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}