Tint

Apply color tint overlay to images. Great for creating artistic effects, adjusting mood, brand color filters, and vintage looks.

Installation

To install the Image plugin:

Terminal

$ npm install -g @mediaproc/image

Usage

Terminal

$ mediaproc image tint <input> [options]

Basic Usage

Terminal

$ mediaproc image tint photo.jpg

✓ Applied blue tint

$ mediaproc image tint image.png -c red

$ mediaproc image tint pic.jpg -c "#ff6600"

$ mediaproc image tint photo.jpg -c "rgb(255, 0, 128)"

$ mediaproc image tint "photos/*.jpg" -c "#704214"

Options

Option	Alias	Type	Default	Description
`--color <color>`	`-c`	string	`#0000ff`	Tint color (hex, RGB, or name)
`--output <path>`	`-o`	string	-	Output file path (default: `<input>-tinted.<ext>`)
`--quality <quality>`	`-q`	number	`90`	Output quality (1-100)
`--dry-run`		boolean	`false`	Preview without making changes
`--verbose`	`-v`	boolean	`false`	Show detailed output
`--help`		boolean	`false`	Display help information

Color Formats

Hex Colors

Six-digit or three-digit hex codes:

# Six-digit hex
mediaproc image tint photo.jpg -c "#ff0000"  # Red

# Three-digit hex
mediaproc image tint photo.jpg -c "#f00"     # Red (shorthand)

# Without hash (also works)
mediaproc image tint photo.jpg -c "ff0000"

RGB Colors

RGB format with values 0-255:

# Standard RGB
mediaproc image tint photo.jpg -c "rgb(255, 0, 0)"  # Red

# With spaces
mediaproc image tint photo.jpg -c "rgb(255, 128, 0)"  # Orange

Named Colors

Common color names:

# Basic colors
mediaproc image tint photo.jpg -c red
mediaproc image tint photo.jpg -c blue
mediaproc image tint photo.jpg -c green
mediaproc image tint photo.jpg -c yellow

# Extended names
mediaproc image tint photo.jpg -c orange
mediaproc image tint photo.jpg -c purple
mediaproc image tint photo.jpg -c cyan
mediaproc image tint photo.jpg -c magenta

Common Tints

Sepia (Vintage)

Warm vintage tone:

mediaproc image tint photo.jpg -c "#704214"

Effect: Classic vintage/antique look

Blue (Cool)

Cool, calm atmosphere:

mediaproc image tint photo.jpg -c "#0066cc"

Mood: Cool, professional, calm

Orange (Warm)

Warm sunset effect:

mediaproc image tint photo.jpg -c "#ff6600"

Mood: Warm, inviting, sunset

Purple (Creative)

Artistic, creative vibe:

mediaproc image tint photo.jpg -c "#9933cc"

Effect: Artistic, mysterious, creative

Green (Fresh)

Nature, fresh feel:

mediaproc image tint photo.jpg -c "#00cc66"

Mood: Natural, fresh, organic

Cyan (Modern)

Modern, tech look:

mediaproc image tint photo.jpg -c "#00ffff"

Effect: Modern, digital, tech

Pink (Soft)

Soft, romantic tone:

mediaproc image tint photo.jpg -c "#ff66cc"

Mood: Soft, romantic, dreamy

Yellow (Bright)

Bright, cheerful mood:

mediaproc image tint photo.jpg -c "#ffcc00"

Effect: Bright, happy, energetic

Examples

1. Default Blue Tint

Apply default blue tint:

mediaproc image tint photo.jpg

Result: Cool blue tone

2. Vintage Sepia

Classic sepia tone:

mediaproc image tint old-photo.jpg -c "#704214" -o vintage.jpg

Vintage: Warm antique look

3. Sunset Effect

Warm orange glow:

mediaproc image tint landscape.jpg -c "#ff6600"

Sunset: Warm evening atmosphere

4. Cool Blue Mood

Professional cool tone:

mediaproc image tint corporate.jpg -c "#0066cc"

Corporate: Professional, trustworthy

5. Creative Purple

Artistic purple tint:

mediaproc image tint art.png -c "#9933cc" -o creative.png

Artistic: Creative, unique

6. Brand Color

Apply brand color filter:

mediaproc image tint product.jpg -c "#ff1744"

Branding: Consistent brand look

7. Nature Green

Fresh green tone:

mediaproc image tint outdoor.jpg -c "#00cc66"

Nature: Fresh, organic feel

8. Romantic Pink

Soft romantic tint:

mediaproc image tint wedding.jpg -c "#ff66cc"

Romance: Soft, dreamy atmosphere

9. Cyberpunk Cyan

Futuristic cyan tint:

mediaproc image tint cityscape.jpg -c "#00ffff"

Futuristic: Modern, tech vibe

10. Warm Red

Dramatic red tone:

mediaproc image tint portrait.jpg -c "#cc0000"

Dramatic: Bold, intense

11. Batch Brand Tint

Apply consistent brand color:

mediaproc image tint "products/*.jpg" -c "#ff1744"

Consistency: Uniform brand look

12. Custom Color

Specific brand hex:

mediaproc image tint image.jpg -c "#4a90e2" -o branded.jpg

Custom: Exact brand color

13. Verbose Output

See processing details:

mediaproc image tint photo.jpg -c orange --verbose

Info: Dimensions and color applied

14. Preview Tint

Check before processing:

mediaproc image tint photo.jpg -c purple --dry-run

Safety: Verify output path

15. High Quality

Maximum quality tint:

mediaproc image tint photo.jpg -c sepia -q 100

Quality: No compression loss

Use Cases

1. Vintage/Retro Effects

Create vintage photography look:

# Sepia tone
mediaproc image tint modern-photo.jpg -c "#704214" -o vintage.jpg

# Classic old photo effect

Photography: Nostalgic aesthetic

2. Mood Adjustment

Adjust emotional tone:

# Cool, calm mood
mediaproc image tint photo.jpg -c "#0066cc"

# Warm, inviting mood
mediaproc image tint photo.jpg -c "#ff6600"

Atmosphere: Control emotional response

3. Brand Consistency

Apply brand colors to images:

# Company brand color
mediaproc image tint "marketing/*.jpg" -c "#ff1744"

# Consistent brand identity

Marketing: Unified brand look

Create cohesive Instagram feed:

# Consistent tint across posts
mediaproc image tint post1.jpg -c "#ff6600" -o feed1.jpg
mediaproc image tint post2.jpg -c "#ff6600" -o feed2.jpg

# Unified aesthetic

Social Media: Cohesive visual theme

5. Film/Cinema Effects

Movie color grading looks:

# Matrix-style green
mediaproc image tint scene.jpg -c "#00ff00"

# Blade Runner blue/cyan
mediaproc image tint scene.jpg -c "#00ffff"

Cinematic: Film color grading

6. Time of Day Simulation

Simulate different lighting:

# Golden hour (sunset)
mediaproc image tint photo.jpg -c "#ff9900"

# Blue hour (dusk)
mediaproc image tint photo.jpg -c "#0066ff"

Lighting: Time-of-day effects

7. Product Photography

Enhance product appeal:

# Warm, inviting for food
mediaproc image tint food.jpg -c "#ff8800"

# Cool, modern for tech
mediaproc image tint gadget.jpg -c "#0099ff"

E-commerce: Appeal enhancement

8. Album Art

Create music album aesthetics:

# Purple creative vibe
mediaproc image tint album-photo.jpg -c "#9933cc"

# Unique visual identity

Music: Distinctive album look

9. Website Theming

Match website color scheme:

# Website accent color
mediaproc image tint hero-image.jpg -c "#4a90e2"

# Consistent design

Web Design: Visual consistency

10. Event Photography

Create event-specific atmosphere:

# Wedding: soft pink
mediaproc image tint wedding.jpg -c "#ffccdd"

# Corporate: professional blue
mediaproc image tint conference.jpg -c "#003366"

Events: Appropriate mood

Combining with Other Commands

Grayscale + Tint

Create duotone effect:

# Convert to grayscale
mediaproc image grayscale photo.jpg -o gray.jpg

# Apply tint
mediaproc image tint gray.jpg -c "#ff6600" -o duotone.jpg

Duotone: Stylized two-tone effect

Adjust + Tint

Enhance then tint:

# Increase contrast
mediaproc image linear photo.jpg -a 1.2 -o enhanced.jpg

# Apply tint
mediaproc image tint enhanced.jpg -c sepia

Enhancement: Better tint results

Tint + Vignette

Tint with vignette:

# Apply tint
mediaproc image tint photo.jpg -c "#0066cc" -o tinted.jpg

# Add vignette
mediaproc image vignette tinted.jpg

Artistic: Focus with tint

Multiple Tints

Layer multiple tints (subtle):

# First tint
mediaproc image tint photo.jpg -c "#ff9900" -o warm.jpg

# Second subtle tint
mediaproc image tint warm.jpg -c "#ffcccc" -o layered.jpg

Complex: Layered color effects

Tint + Border

Tint with colored border:

# Apply tint
mediaproc image tint photo.jpg -c sepia -o tinted.jpg

# Matching border
mediaproc image border tinted.jpg --width 20 --color "#704214"

Framing: Coordinated look

Technical Details

Tint Algorithm

Process:

Parse color specification (hex/RGB/name)
Convert color to RGB values
Apply multiplicative tint to each pixel
Maintain luminosity (brightness levels)
Output tinted image

Color Blending:

Multiplies each RGB channel by tint color
Preserves relative brightness
Maintains image detail
Uniform tint across entire image

Color Conversion

Hex to RGB:

#ff0000 → RGB(255, 0, 0)
#f00 → RGB(255, 0, 0)

Named Colors:

Standard CSS/HTML color names
Converted to RGB internally
Case-insensitive

Performance

Fast operation: ~50-150ms per image
Small images: ~50-80ms
Large images (4K): ~100-200ms
Minimal memory overhead
Batch processing efficient

Color Accuracy

Accurate color reproduction
Maintains original luminosity
Consistent across image
No banding or artifacts

Best Practices

1. Subtle Tints Work Best

Avoid overly strong tints:

# Good: Subtle sepia
mediaproc image tint photo.jpg -c "#704214"

# Avoid: Too strong (unless intentional)

2. Match Tint to Content

Choose appropriate colors:

Portraits: Warm tones (#ff9900, #ff6600)
Landscapes: Cool blues (#0066cc) or greens
Products: Brand colors
Vintage: Sepia (#704214)

3. Test on Single Image First

Try before batch processing:

# Test first
mediaproc image tint test.jpg -c "#ff6600"

# If good, batch process
mediaproc image tint "all/*.jpg" -c "#ff6600"

4. Consider Original Colors

Tint interacts with existing colors:

Dark images: Tint less visible
Light images: Tint more apparent
Colorful images: Complex interactions

5. Use High Quality for Finals

Preserve quality:

# Maximum quality
mediaproc image tint final.jpg -c sepia -q 95

6. Consistent Tint for Collections

Same tint for related images:

# Consistent look
mediaproc image tint "series/*.jpg" -c "#ff6600"

7. Combine with Other Effects

Layer effects for best results:

# Enhance → Tint → Vignette
# Build up effects gradually

Troubleshooting

Issue: Tint Too Strong

Problem: Color overwhelming

Cause: Strong tint color

Solution: Use subtle colors or reduce in editing

# Subtle tints work better
# Try lighter shades

Issue: Tint Not Visible

Problem: Can't see tint effect

Cause: Dark image or subtle tint on colorful image

Solution: Try stronger tint or lighter base image

Issue: Wrong Color

Problem: Color doesn't match expected

Cause: Incorrect color specification

Solution: Verify color format

# Check hex format
mediaproc image tint photo.jpg -c "#ff0000"  # Include #

# Or use named colors
mediaproc image tint photo.jpg -c red

Issue: Muddy Colors

Problem: Colors look dull or muddy

Cause: Tint on already colorful image

Solution: Convert to grayscale first for cleaner result

# Better: Grayscale then tint
mediaproc image grayscale photo.jpg -o gray.jpg
mediaproc image tint gray.jpg -c "#ff6600"

Issue: Inconsistent Batch Results

Problem: Tint looks different across images

Cause: Different source image colors/brightness

Solution: This is expected; tint interacts with source

# Normalize brightness first (optional)
# Then apply tint

grayscale - Convert to grayscale before tinting
sepia - Dedicated sepia effect
modulate - Adjust saturation/hue
linear - Adjust contrast before tinting
vignette - Combine with vignette