wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About
  • What is WinGet?

© 2026 winget.ragerworks.com

Loading...
  1. Go back
  2. Packages
  3. ImageMerge
ImageMerge logo

ImageMerge TamKungZ_

batch-processing cli cross-platform desktop-app file-deduplication file-deduplication-tool file-management gui image-merge image-processing media-organizer nuitka pyside6 python
Use this command to install ImageMerge with WinGet:
winget install --id=TamKungZ.ImageMerge -e

ImageMerge is a GUI tool designed to organize and manage images and videos by merging files from multiple folders into one output directory. The software removes duplicate files using SHA-256 hashing and renames media into a clean, sequential format for easier organization.

Key Features:

  • Merge images and videos from multiple input folders into a single output folder.
  • Remove duplicate files based on SHA-256 checksums to ensure unique content.
  • Rename files in a sequential format (e.g., prefix-0001.jpg or 0001.jpg) for orderly organization.
  • Choose between three operation modes: copy_keep, copy_delete, and move to control how files are processed.
  • Set custom per-folder prefixes to maintain folder-specific naming conventions.
  • Sort output media with images appearing before videos.

Audience & Benefit:
Ideal for photographers, content creators, and anyone managing large collections of digital media. ImageMerge helps users consolidate files from multiple sources, eliminate duplicates, and organize their collection into a clean, sequential structure without manual intervention. The tool streamlines media management by providing a reliable solution to simplify file organization across platforms.

ImageMerge can be installed via winget for Windows users.

README

ImageMergePy

A GUI tool to merge images/videos from multiple folders, remove duplicates with SHA-256, and rename files into a clean sequential format.

Current app version: 1.1.0

Features

  • Merge media from multiple input folders into one output folder
  • De-duplicate files using SHA-256 + file extension
  • Supports 5 operation modes
    • copy_keep: copy only, keep source files
    • copy_delete: copy, then delete source files
    • move: move files from input to output
    • main_folder: organize the output folder first, then optionally merge imported folders
    • inside_folder: organize media already inside the selected folder
  • Set a per-folder prefix
  • Rename files as prefix-0001.jpg or 0001.jpg
  • Keep output ordered with deterministic extension groups: images first, videos last
  • Image sorting groups extensions first: .png, .jpg, .jpeg, .webp, .bmp, .gif, .tiff
  • Within each extension group, numeric names such as 1.png, 02.png, 10.png, and 1(1).jpg are sorted by their number before final renaming
  • Safe temp workspace is enabled by default to stage output changes before applying them
  • New desktop UI built with PySide6
  • Native builds with Nuitka

Requirements

  • Python 3.10+ (recommended)
  • OS-specific native builds are supported on Windows, Linux, and macOS

Install (source)

pip install -r requirements.txt

Install (packaged)

Prebuilt packages are published in GitHub Releases:

  • Release page: https://github.com/TamKungZ/ImageMergePy/releases

Windows

  • Microsoft Store: https://apps.microsoft.com/detail/9ndnkpjpzt67
  • WinGet:
winget install TamKungZ.ImageMerge
  • Download and run ImageMerge-windows-x64.msi
  • Or portable folder: extract ImageMerge-windows-x64.zip, then run ImageMerge.exe
  • Or portable single executable: download ImageMerge-windows-x64-portable.exe
  • Microsoft Store submission asset is also generated as ImageMergeGUI-windows-x64.msix
  • WinGet automation is configured for package id TamKungZ.ImageMerge

Linux

  • Debian/Ubuntu/Zorin: install ImageMerge-linux-x64.deb
sudo apt install ./ImageMerge-linux-x64.deb
  • Fedora/RHEL/openSUSE: install ImageMerge-linux-x64.rpm
sudo rpm -Uvh ./ImageMerge-linux-x64.rpm
  • AppImage: download ImageMerge-linux-x64.AppImage
chmod +x ImageMerge-linux-x64.AppImage
./ImageMerge-linux-x64.AppImage
  • Flatpak bundle: ImageMerge-linux-x64.flatpak
  • Snap artifact: ImageMerge-linux-x64.snap (store publishing workflow is configured)

macOS

brew tap TamKungZ/tap
brew install --cask imagemerge
  • App bundle zip: ImageMerge-macos-app-arm64.zip or ImageMerge-macos-app-x64.zip
  • Binary zip: ImageMerge-macos-binary-arm64.zip or ImageMerge-macos-binary-x64.zip
  • Homebrew cask publishing workflow is configured (imagemerge)

Run (source)

python MainApp.py

Run (CLI)

Use CLI mode without opening GUI:

python MainApp.py --cli --input "/path/to/folderA::full" --input "/path/to/folderB::short" --output "/path/to/output" --mode copy_keep

ImageMerge --cli --input "/path/a::full" --input "/path/b::short" --output "/path/out" --mode copy_keep

CLI options:

  • --input PATH[::PREFIX] (repeatable)
  • --output PATH
  • --mode copy_keep|copy_delete|move|main_folder|inside_folder
  • --clear-output
  • --remove-duplicates
  • --no-safe-temp
  • --lang ar|de|en|es|fr|id|ja|ko|ru|th|vi|zh

In packaged builds, run the same options directly from the app binary (Windows/Linux/macOS).

Sorting Rules

ImageMerge assigns output numbers after sorting media in a stable, predictable order:

  1. Images are processed before videos.
  2. Image files are grouped by extension in this order: .png, .jpg, .jpeg, .webp, .bmp, .gif, .tiff.
  3. Files inside the same extension group are sorted by numeric filename when possible.
  4. Existing prefixes are preserved when reorganizing files already named like trip-0001.jpg.
  5. Video files use their own extension order after images.

Example:

1.png      -> 0001.png
02.png     -> 0002.png
10.png     -> 0003.png
12.png     -> 0004.png
1.jpg      -> 0005.jpg
1(1).jpg   -> 0006.jpg
1.webp     -> 0007.webp

This means modified date will not cause .webp files to jump before .png or .jpg groups during normal merge numbering.

Source Layout

MainApp.py is kept as the launch entry point. The application code is split under src/media_merge/:

  • config.py: metadata, constants, fonts, language discovery
  • media_ops.py: media scanning, sorting, duplicate detection, renaming, copy/move logic
  • cli.py: command-line interface
  • worker.py: Qt worker thread wrapper
  • ui/app.py: main PySide6 window
  • ui/widgets.py: reusable UI widgets

Build (Nuitka)

Install dependencies first:

pip install -r requirements.txt

Then use the build scripts (or run python build_nuitka.py directly):

./build.sh

build.bat

Build step will auto-generate embedded_locales.py from locales/*.json before compiling.

Windows build also reads app_metadata.json and injects version/company/product metadata into the executable.

build_nuitka.py detects the current OS and builds native output:

  • Windows: PE executable (ImageMerge.exe) under dist/windows/ImageMerge.dist/
    • Local build.bat also builds a portable onefile executable at dist/windows-onefile/ImageMerge.exe
  • Linux: ELF binary (ImageMerge) under dist/linux/ImageMerge.dist/
  • macOS:
    • Mach-O binary under dist/macos-binary/ImageMerge.dist/
    • .app bundle under dist/macos-app/ImageMerge.app

Note: cross-compiling to another OS is not configured; run the build on each target OS.

Architecture notes:

  • Default CI runners currently publish x64 artifacts.
  • The build scripts recognize these architecture labels: x86, x64, arm, arm64.
  • To declare a target architecture in local/self-hosted builds, set IMAGEMERGE_TARGET_ARCH (cross-compilation toolchains are not auto-configured).

Default build mode is standalone for reliability.

To force onefile mode (experimental on some Windows + Python/Nuitka versions):

$env:IMAGEMERGE_ONEFILE=1
./build.bat

If onefile fails during payload step, update packaging deps and retry:

python -m pip install -U "Nuitka[onefile]" zstandard

Also exclude your build folder from Windows Defender/antivirus scan during build.

Windows Metadata + Trust

Set app metadata in app_metadata.json:

  • company_name, product_name, file_description
  • file_version, product_version
  • icon_ico (optional .ico path)

Optional signing is supported during build:

$env:IMAGEMERGE_SIGN=1
$env:IMAGEMERGE_SIGN_PFX="C:\secure\codesign.pfx"
$env:IMAGEMERGE_SIGN_PASSWORD=""
$env:IMAGEMERGE_SIGN_TIMESTAMP="http://timestamp.digicert.com"
./build.bat

For better SmartScreen reputation in production:

  • Use a valid OV/EV code-signing certificate (EV is fastest for reputation).
  • Keep publisher name consistent across releases.
  • Sign both executable and installer.
  • Avoid frequent publisher/certificate changes.

Notes

  • UI translations are embedded in code (no external locale files required at runtime).
  • Source translation files are in locales/en.json and locales/th.json; embedded module is generated to embedded_locales.py.
  • Kanit fonts are embedded in code and loaded at runtime (no external font files required at runtime).
  • Set IMAGEMERGE_LANG=en or IMAGEMERGE_LANG=th to force language.

Screenshots

  <img src="https://dev.tamkungz.me/assets-image/imagemerge/imagemerge-start.png" width="100%" />


  <img src="https://dev.tamkungz.me/assets-image/imagemerge/imagemerge-mode.png" width="100%" />




  <img src="https://dev.tamkungz.me/assets-image/imagemerge/imagemerge-options.png" width="100%" />


  <img src="https://dev.tamkungz.me/assets-image/imagemerge/imagemerge-add.png" width="100%" />

By TamKungZ_

Versions
1.1.1
1.0.2
Website
github.com
License
Last updated
8/21/2026
Download latest version
Loading...