Documentation

1. Introduction

Imger is a high-performance desktop batch image processing software designed to provide a fast and convenient solution for photographers, designers, and general users. It supports batch format conversion, smart resizing, watermarking, and metadata management. All processing is done locally on your machine, ensuring your privacy and data security.

Key Features

• Batch Processing: Process hundreds or thousands of images at once.
• Multi-Format Support: Supports widely used and modern image formats including JPG, PNG, WebP, AVIF, and HEIC.
• Smart Resizing: Offers multiple resizing modes (Fit, Fill, Stretch) with high-quality resampling algorithms.
• Watermark System: Supports custom text and image watermarks with flexible adjustments for position, opacity, and rotation.
• Mobile Upload: Quickly transfer images from your mobile device to the desktop via local network QR code scanning.
• Configuration Management: Save multiple processing presets and switch between them instantly for different scenarios.

---

2. Getting Started

2.1 Interface Overview

Upon launching Imger, you will see the main interface divided into three sections:

1. Left Navigation Bar: Switch between main modules (Library, Settings, Logs, About).
2. Center List Area: Displays the currently selected image list or settings options.
3. Right Preview/Detail Area: Shows image previews or detailed settings configuration.

2.2 Registration & Activation

The software provides a trial mode. To unlock all features or remove trial limitations, please enter your activation code in the "About" section or the registration popup window.

---

3. Image Processing

This is the core function of the software, located on the Library page.

3.1 Importing Images

You can import images using the following methods:

• Select Folder: Click the folder icon to batch import all images from a directory.
• Select Files: Click the file icon to select specific images.
• Mobile Upload: Click the mobile phone icon to start the local server and scan the QR code to upload images directly from your phone.

3.2 Preview & Selection

• Imported images will appear in the center list.
• Clicking on an image in the list will show its preview in the right panel.
• Select All / Clear: Use the toolbar buttons above the list to select all images or clear the current list.

3.3 Start Processing

1. Click the "Start Processing" button above the right preview area.
2. The software will process the selected images based on the currently active Settings.
3. A progress bar will appear during processing. Once complete, a summary of successful and failed items will be displayed.
4. Upon success, the software will automatically open the output folder.

---

4. Settings Configuration

On the Settings page, you can create and manage multiple processing configurations.

4.1 Managing Presets

• New Preset: Click the "+" button above the list to create a new configuration.
• Edit Preset: Click any configuration in the left list to enter edit mode.
• Delete Preset: Click the trash icon next to a configuration to delete it.

4.2 Parameter Details

Basic Information

• Name: Configuration name (Required).
• Description: Brief description (Optional).

Resize Settings

• Enable Resize: Toggle resizing on/off.
• Width/Height: Target width and height.
• Mode:
  • Fit: Fits within target dimensions, maintaining aspect ratio (no distortion).
  • Fill: Fills target dimensions, may crop the image.
  • Stretch: Stretches to target dimensions, may distort the image.
• Filter: Resampling algorithm (e.g., Lanczos, Cubic) determining image quality.
• DPI: Set the output image DPI.

Watermark Settings

• Enable Watermark: Toggle watermarking on/off.
• Type: Choose between Text or Image watermark.
• Text Settings: Configure text content, font, size, and color.
• Image Settings: Select the watermark image path.
• Position: 9-grid position selection (e.g., Bottom-Right, Center).
• Opacity: Transparency (0-100%).
• Rotation: Rotation angle.

Output Settings

• Format: Target format (JPG, PNG, WEBP, AVIF, etc.).
• Quality: Image quality (1-100); higher values mean better quality but larger file size.
• Output Folder: Directory where processed files will be saved.
• Remove EXIF: Whether to remove camera metadata (protects privacy).
• Rename: Enable file renaming. Supports patterns like {name}_edited.{ext}.
• Overwrite: Whether to overwrite existing files with the same name.

---

5. History & Logs

5.1 Library Management

The Library page not only handles new images but also keeps a history of imported files.

• Supports pagination for browsing history.
• Allows re-selecting historical images for re-processing.

5.2 Processing Logs

On the Logs page, you can view past processing records.

• Overview: View start time, success/failure counts, and a summary of settings used for each batch.
• Details: Click on a log entry to see specific results for each image in that batch (success status, error messages, processing time).
• This is helpful for troubleshooting failed images (e.g., unsupported formats, corrupted files).

---

6. FAQ