Skip to content
AmelioratesDevelopmentPublic

About

MetaMover aims to organize cluttered DCIM folders, SD cards and cell phones. Essentially, it uses image EXIF data to create a folder structure such as year, month, date and camera model. Your images are then organized into the said structure. It handles duplicates really well and can place images that don't contain EXIF data into a separate folder.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

34 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MetaMover

MetaMover is a C++/Qt application designed to organize and manage photo files. It helps users move their photos from a source directory, such as a DCIM folder on an SD card or mobile phone, to a target directory, like an external drive or a cloud folder. MetaMover can handle duplicates, invalid metadata, and supports various output folder structures based on EXIF data.

MetaMover GUI

Introduction

MetaMover is a tool that addresses the common issue of cluttered photo directories. By scanning specified source directories, it identifies photo files, processes EXIF data, handles duplicates, and organizes photos into structured folders. This tool is perfect for users looking to transfer photos to organized directories efficiently.

Usage

To get started with MetaMover, follow these steps:

  1. Download and Extract:

    • Download the MetaMover zip file from the GitHub repository.
    • Extract the zip file to your preferred location.
  2. Run the Application:

    • Navigate to the extracted directory and find the executable file.
    • Double-click the executable to launch MetaMover. If you encounter a Windows Defender warning, click "Run anyway" to proceed.
  3. Specify Directories:

    • Source Directory: Select the directory containing your photos.
    • Include Sub-Directories: Opt to include sub-directories in the scan.
    • Invalid Meta Folder: Specify a folder for files with invalid EXIF data.
  4. Set Output Options:

    • Output Directory: Choose the destination directory for organized photos.
    • Duplicate Handling: Decide how to handle duplicates (e.g., move to a folder, overwrite, or append a copy number).
  5. Scan and Transfer:

    • Click "Scan for Files" to initiate the scan.
    • Select an output folder structure (e.g., by camera model, year, month, and day).
    • Choose the EXIF data matching option.
    • Click "Copy" to transfer the photos to the organized directory.
  6. View Results:

    • After the transfer, navigate to the output directory to see your organized photos.
    • Check the duplicates and invalid meta folders if applicable.

For a visual demonstration, watch the MetaMover Demo Video.

MetaMover Demo Video

Developer Environment

To set up the development environment for MetaMover, follow these steps:

Prerequisites

  • Qt 6.7.1 (or compatible version)
  • LLVM-MinGW toolchain
  • CMake 3.5 or higher

Installing Qt, CMake, and LLVM-MinGW

  1. Install Qt:

    • Download the Qt Online Installer from the Qt website.
    • Run the installer and select the components to install.
      • Ensure you select Qt 6.7.1 and include LLVM-MinGW, etc.
  2. Install CMake:

    • Download CMake from the CMake website.
    • Run the installer and follow the on-screen instructions to complete the installation.

Setting Up the Environment

Create a script to set up the environment variables for Qt and CMake.

Windows

Create setup_env.bat:

@echo off
setlocal

:: Set the Qt installation directory
set QT_DIR=C:\Qt\6.7.1\mingw_64
set PATH=%QT_DIR%\bin;%PATH%

:: Set CMake prefix path
set CMAKE_PREFIX_PATH=%QT_DIR%

:: Optionally set the LLVM-MinGW toolchain path
set LLVM_MINGW_DIR=C:\path\to\llvm-mingw
set PATH=%LLVM_MINGW_DIR%\bin;%PATH%

:: Launch a new command prompt with these settings
cmd

Unix-based Systems

Create setup_env.sh:

#!/bin/bash

# Set the Qt installation directory
export QT_DIR=/path/to/Qt/6.7.1/gcc_64
export PATH=$QT_DIR/bin:$PATH

# Set CMake prefix path
export CMAKE_PREFIX_PATH=$QT_DIR

# Optionally set the LLVM-MinGW toolchain path
export LLVM_MINGW_DIR=/path/to/llvm-mingw
export PATH=$LLVM_MINGW_DIR/bin:$PATH

# Launch a new shell with these settings
$SHELL

Building the Project

  1. Clone the Repository:

    git clone https://github.com/your-repo/MetaMover.git
    cd MetaMover
  2. Set up the environment:

    • Run setup_env.bat on Windows
    • Run ./setup_env.sh on Unix-based systems
  3. Build the Project:

    cmake.exe -S . -B build
    cmake --build build

Running the Application

  • After building, navigate to the build directory and run the executable:
    ./MetaMover

By following these steps, you can set up and build the MetaMover project on your development environment.

About

MetaMover aims to organize cluttered DCIM folders, SD cards and cell phones. Essentially, it uses image EXIF data to create a folder structure such as year, month, date and camera model. Your images are then organized into the said structure. It handles duplicates really well and can place images that don't contain EXIF data into a separate folder.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages