screenshot-beautify

A CLI tool to beautify screenshots with macOS-style window frames, shadows, and gradient backgrounds.

Installation

npm install -g screenshot-beautify

Usage

Single File

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:

screenshot-beautify watch ~/Desktop ~/Desktop/beautified --preset ocean

System Tray Mode (macOS)

Run in the background with a menu bar icon:

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:

screenshot-beautify presets

Available presets:

| Category | Presets | |----------|---------| | Smart | auto - analyzes your screenshot and creates a matching gradient | | Warm | sunset, sunrise, peach | | Cool | ocean, sky, northern | | Dark | charcoal, midnight, space | | Vibrant | neon, fire, aurora | | Soft | lavender, mint, rose |

Auto Preset

The auto preset extracts the dominant colors from your screenshot and generates a complementary gradient background. This ensures your beautified screenshot always looks cohesive without manual color selection.

screenshot-beautify screenshot.png --preset auto

Examples

# Basic usage
screenshot-beautify screenshot.png

# Auto-match background to screenshot colors
screenshot-beautify screenshot.png --preset auto

# 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